summaryrefslogtreecommitdiffstats
path: root/Lib
diff options
context:
space:
mode:
Diffstat (limited to 'Lib')
-rw-r--r--Lib/pydoc_data/topics.py148
1 files changed, 88 insertions, 60 deletions
diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index d43b5c6..cec9b8b 100644
--- a/Lib/pydoc_data/topics.py
+++ b/Lib/pydoc_data/topics.py
@@ -1,5 +1,5 @@
# -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Tue Feb 6 21:21:08 2024
+# Autogenerated by Sphinx on Tue Apr 2 09:24:48 2024
# as part of the release process.
topics = {'assert': 'The "assert" statement\n'
'**********************\n'
@@ -792,9 +792,9 @@ topics = {'assert': 'The "assert" statement\n'
'\n'
'object.__dir__(self)\n'
'\n'
- ' Called when "dir()" is called on the object. A '
- 'sequence must be\n'
- ' returned. "dir()" converts the returned sequence to a '
+ ' Called when "dir()" is called on the object. An '
+ 'iterable must be\n'
+ ' returned. "dir()" converts the returned iterable to a '
'list and\n'
' sorts it.\n'
'\n'
@@ -821,8 +821,8 @@ topics = {'assert': 'The "assert" statement\n'
'returned.\n'
'\n'
'The "__dir__" function should accept no arguments, and '
- 'return a\n'
- 'sequence of strings that represents the names accessible '
+ 'return an\n'
+ 'iterable of strings that represents the names accessible '
'on module. If\n'
'present, this function overrides the standard "dir()" '
'search on a\n'
@@ -4492,7 +4492,7 @@ topics = {'assert': 'The "assert" statement\n'
'reflection,\n'
' and "__eq__()" and "__ne__()" are their own reflection. '
'If the\n'
- ' operands are of different types, and right operand’s '
+ ' operands are of different types, and the right operand’s '
'type is a\n'
' direct or indirect subclass of the left operand’s type, '
'the\n'
@@ -4502,6 +4502,11 @@ topics = {'assert': 'The "assert" statement\n'
'is not\n'
' considered.\n'
'\n'
+ ' When no appropriate method returns any value other than\n'
+ ' "NotImplemented", the "==" and "!=" operators will fall '
+ 'back to\n'
+ ' "is" and "is not", respectively.\n'
+ '\n'
'object.__hash__(self)\n'
'\n'
' Called by built-in function "hash()" and for operations '
@@ -4957,22 +4962,23 @@ topics = {'assert': 'The "assert" statement\n'
'the\n'
'current directory, it is read with "\'utf-8\'" encoding and '
'executed as\n'
- 'if it had been typed at the debugger prompt. This is '
- 'particularly\n'
- 'useful for aliases. If both files exist, the one in the home\n'
- 'directory is read first and aliases defined there can be '
- 'overridden by\n'
- 'the local file.\n'
- '\n'
- 'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" '
- 'encoding.\n'
- 'Previously, it was read with the system locale encoding.\n'
+ 'if it had been typed at the debugger prompt, with the exception '
+ 'that\n'
+ 'empty lines and lines starting with "#" are ignored. This is\n'
+ 'particularly useful for aliases. If both files exist, the one '
+ 'in the\n'
+ 'home directory is read first and aliases defined there can be\n'
+ 'overridden by the local file.\n'
'\n'
'Changed in version 3.2: ".pdbrc" can now contain commands that\n'
'continue debugging, such as "continue" or "next". Previously, '
'these\n'
'commands had no effect.\n'
'\n'
+ 'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" '
+ 'encoding.\n'
+ 'Previously, it was read with the system locale encoding.\n'
+ '\n'
'h(elp) [command]\n'
'\n'
' Without argument, print the list of available commands. With '
@@ -8110,7 +8116,7 @@ topics = {'assert': 'The "assert" statement\n'
'"__rsub__()"\n'
' method, "type(y).__rsub__(y, x)" is called if '
'"type(x).__sub__(x,\n'
- ' y)" returns *NotImplemented*.\n'
+ ' y)" returns "NotImplemented".\n'
'\n'
' Note that ternary "pow()" will not try calling '
'"__rpow__()" (the\n'
@@ -8153,14 +8159,18 @@ topics = {'assert': 'The "assert" statement\n'
'the result\n'
' (which could be, but does not have to be, *self*). If a '
'specific\n'
- ' method is not defined, the augmented assignment falls '
- 'back to the\n'
- ' normal methods. For instance, if *x* is an instance of '
- 'a class\n'
- ' with an "__iadd__()" method, "x += y" is equivalent to '
- '"x =\n'
- ' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and '
- '"y.__radd__(x)" are\n'
+ ' method is not defined, or if that method returns '
+ '"NotImplemented",\n'
+ ' the augmented assignment falls back to the normal '
+ 'methods. For\n'
+ ' instance, if *x* is an instance of a class with an '
+ '"__iadd__()"\n'
+ ' method, "x += y" is equivalent to "x = x.__iadd__(y)" . '
+ 'If\n'
+ ' "__iadd__()" does not exist, or if "x.__iadd__(y)" '
+ 'returns\n'
+ ' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" '
+ 'are\n'
' considered, as with the evaluation of "x + y". In '
'certain\n'
' situations, augmented assignment can result in '
@@ -8241,7 +8251,7 @@ topics = {'assert': 'The "assert" statement\n'
'Every object has an identity, a type and a value. An object’s\n'
'*identity* never changes once it has been created; you may think '
'of it\n'
- 'as the object’s address in memory. The ‘"is"’ operator compares '
+ 'as the object’s address in memory. The "is" operator compares '
'the\n'
'identity of two objects; the "id()" function returns an integer\n'
'representing its identity.\n'
@@ -8306,7 +8316,7 @@ topics = {'assert': 'The "assert" statement\n'
'Note that the use of the implementation’s tracing or debugging\n'
'facilities may keep objects alive that would normally be '
'collectable.\n'
- 'Also note that catching an exception with a ‘"try"…"except"’ '
+ 'Also note that catching an exception with a "try"…"except" '
'statement\n'
'may keep objects alive.\n'
'\n'
@@ -8321,8 +8331,9 @@ topics = {'assert': 'The "assert" statement\n'
'release the external resource, usually a "close()" method. '
'Programs\n'
'are strongly recommended to explicitly close such objects. The\n'
- '‘"try"…"finally"’ statement and the ‘"with"’ statement provide\n'
- 'convenient ways to do this.\n'
+ '"try"…"finally" statement and the "with" statement provide '
+ 'convenient\n'
+ 'ways to do this.\n'
'\n'
'Some objects contain references to other objects; these are '
'called\n'
@@ -8699,10 +8710,7 @@ topics = {'assert': 'The "assert" statement\n'
'The try statement.\n'
'\n'
'Changed in version 3.3: "None" is now permitted as "Y" in "raise X\n'
- 'from Y".\n'
- '\n'
- 'New in version 3.3: The "__suppress_context__" attribute to '
- 'suppress\n'
+ 'from Y".Added the "__suppress_context__" attribute to suppress\n'
'automatic display of the exception context.\n'
'\n'
'Changed in version 3.11: If the traceback of the active exception '
@@ -9479,8 +9487,8 @@ topics = {'assert': 'The "assert" statement\n'
'reflection,\n'
' and "__eq__()" and "__ne__()" are their own reflection. '
'If the\n'
- ' operands are of different types, and right operand’s type '
- 'is a\n'
+ ' operands are of different types, and the right operand’s '
+ 'type is a\n'
' direct or indirect subclass of the left operand’s type, '
'the\n'
' reflected method of the right operand has priority, '
@@ -9489,6 +9497,11 @@ topics = {'assert': 'The "assert" statement\n'
'is not\n'
' considered.\n'
'\n'
+ ' When no appropriate method returns any value other than\n'
+ ' "NotImplemented", the "==" and "!=" operators will fall '
+ 'back to\n'
+ ' "is" and "is not", respectively.\n'
+ '\n'
'object.__hash__(self)\n'
'\n'
' Called by built-in function "hash()" and for operations '
@@ -9730,9 +9743,9 @@ topics = {'assert': 'The "assert" statement\n'
'\n'
'object.__dir__(self)\n'
'\n'
- ' Called when "dir()" is called on the object. A sequence '
+ ' Called when "dir()" is called on the object. An iterable '
'must be\n'
- ' returned. "dir()" converts the returned sequence to a '
+ ' returned. "dir()" converts the returned iterable to a '
'list and\n'
' sorts it.\n'
'\n'
@@ -9759,8 +9772,8 @@ topics = {'assert': 'The "assert" statement\n'
'returned.\n'
'\n'
'The "__dir__" function should accept no arguments, and '
- 'return a\n'
- 'sequence of strings that represents the names accessible on '
+ 'return an\n'
+ 'iterable of strings that represents the names accessible on '
'module. If\n'
'present, this function overrides the standard "dir()" search '
'on a\n'
@@ -11023,7 +11036,7 @@ topics = {'assert': 'The "assert" statement\n'
'"__rsub__()"\n'
' method, "type(y).__rsub__(y, x)" is called if '
'"type(x).__sub__(x,\n'
- ' y)" returns *NotImplemented*.\n'
+ ' y)" returns "NotImplemented".\n'
'\n'
' Note that ternary "pow()" will not try calling '
'"__rpow__()" (the\n'
@@ -11066,14 +11079,17 @@ topics = {'assert': 'The "assert" statement\n'
'the result\n'
' (which could be, but does not have to be, *self*). If a '
'specific\n'
- ' method is not defined, the augmented assignment falls '
- 'back to the\n'
- ' normal methods. For instance, if *x* is an instance of a '
- 'class\n'
- ' with an "__iadd__()" method, "x += y" is equivalent to "x '
- '=\n'
- ' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and '
- '"y.__radd__(x)" are\n'
+ ' method is not defined, or if that method returns '
+ '"NotImplemented",\n'
+ ' the augmented assignment falls back to the normal '
+ 'methods. For\n'
+ ' instance, if *x* is an instance of a class with an '
+ '"__iadd__()"\n'
+ ' method, "x += y" is equivalent to "x = x.__iadd__(y)" . '
+ 'If\n'
+ ' "__iadd__()" does not exist, or if "x.__iadd__(y)" '
+ 'returns\n'
+ ' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" are\n'
' considered, as with the evaluation of "x + y". In '
'certain\n'
' situations, augmented assignment can result in unexpected '
@@ -12356,9 +12372,8 @@ topics = {'assert': 'The "assert" statement\n'
'\n'
'New in version 3.3: The "\'rb\'" prefix of raw bytes literals has '
'been\n'
- 'added as a synonym of "\'br\'".\n'
- '\n'
- 'New in version 3.3: Support for the unicode legacy literal\n'
+ 'added as a synonym of "\'br\'".Support for the unicode legacy '
+ 'literal\n'
'("u\'value\'") was reintroduced to simplify the maintenance of '
'dual\n'
'Python 2.x and 3.x codebases. See **PEP 414** for more '
@@ -13065,14 +13080,18 @@ topics = {'assert': 'The "assert" statement\n'
'contains\n'
'the numbers 0, 1, …, *n*-1. Item *i* of sequence *a* is selected '
'by\n'
- '"a[i]".\n'
+ '"a[i]". Some sequences, including built-in sequences, interpret\n'
+ 'negative subscripts by adding the sequence length. For example,\n'
+ '"a[-2]" equals "a[n-2]", the second to last item of sequence a '
+ 'with\n'
+ 'length "n".\n'
'\n'
'Sequences also support slicing: "a[i:j]" selects all items with '
'index\n'
'*k* such that *i* "<=" *k* "<" *j*. When used as an expression, a\n'
- 'slice is a sequence of the same type. This implies that the index '
- 'set\n'
- 'is renumbered so that it starts at 0.\n'
+ 'slice is a sequence of the same type. The comment above about '
+ 'negative\n'
+ 'indexes also applies to negative slice positions.\n'
'\n'
'Some sequences also support “extended slicing” with a third “step”\n'
'parameter: "a[i:j:k]" selects all items of *a* with index *x* where '
@@ -13809,7 +13828,9 @@ topics = {'assert': 'The "assert" statement\n'
'name |\n'
'+----------------------------------------------------+----------------------------------------------------+\n'
'| codeobject.co_qualname | The fully '
- 'qualified function name |\n'
+ 'qualified function name New in version |\n'
+ '| | '
+ '3.11. |\n'
'+----------------------------------------------------+----------------------------------------------------+\n'
'| codeobject.co_argcount | The total '
'number of positional *parameters* |\n'
@@ -14025,6 +14046,14 @@ topics = {'assert': 'The "assert" statement\n'
'tools.\n'
' The PEP that introduced the "co_lines()" method.\n'
'\n'
+ 'codeobject.replace(**kwargs)\n'
+ '\n'
+ ' Return a copy of the code object with new values for the '
+ 'specified\n'
+ ' fields.\n'
+ '\n'
+ ' New in version 3.8.\n'
+ '\n'
'\n'
'Frame objects\n'
'-------------\n'
@@ -15570,9 +15599,8 @@ topics = {'assert': 'The "assert" statement\n'
'objects\n'
'based on the sequence of values they define (instead of '
'comparing\n'
- 'based on object identity).\n'
- '\n'
- 'New in version 3.3: The "start", "stop" and "step" attributes.\n'
+ 'based on object identity).Added the "start", "stop" and "step"\n'
+ 'attributes.\n'
'\n'
'See also:\n'
'\n'