|
1 | 1 | # -*- coding: utf-8 -*- |
2 | | -# Autogenerated by Sphinx on Thu Feb 15 14:30:52 2024 |
| 2 | +# Autogenerated by Sphinx on Tue Mar 12 18:35:04 2024 |
3 | 3 | # as part of the release process. |
4 | 4 | topics = {'assert': 'The "assert" statement\n' |
5 | 5 | '**********************\n' |
|
4724 | 4724 | 'reflection,\n' |
4725 | 4725 | ' and "__eq__()" and "__ne__()" are their own reflection. ' |
4726 | 4726 | 'If the\n' |
4727 | | - ' operands are of different types, and right operand’s ' |
| 4727 | + ' operands are of different types, and the right operand’s ' |
4728 | 4728 | 'type is a\n' |
4729 | 4729 | ' direct or indirect subclass of the left operand’s type, ' |
4730 | 4730 | 'the\n' |
|
4734 | 4734 | 'is not\n' |
4735 | 4735 | ' considered.\n' |
4736 | 4736 | '\n' |
| 4737 | + ' When no appropriate method returns any value other than\n' |
| 4738 | + ' "NotImplemented", the "==" and "!=" operators will fall ' |
| 4739 | + 'back to\n' |
| 4740 | + ' "is" and "is not", respectively.\n' |
| 4741 | + '\n' |
4737 | 4742 | 'object.__hash__(self)\n' |
4738 | 4743 | '\n' |
4739 | 4744 | ' Called by built-in function "hash()" and for operations ' |
|
5223 | 5228 | 'overridden by\n' |
5224 | 5229 | 'the local file.\n' |
5225 | 5230 | '\n' |
5226 | | - 'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" ' |
5227 | | - 'encoding.\n' |
5228 | | - 'Previously, it was read with the system locale encoding.\n' |
5229 | | - '\n' |
5230 | 5231 | 'Changed in version 3.2: ".pdbrc" can now contain commands that\n' |
5231 | 5232 | 'continue debugging, such as "continue" or "next". Previously, ' |
5232 | 5233 | 'these\n' |
5233 | 5234 | 'commands had no effect.\n' |
5234 | 5235 | '\n' |
| 5236 | + 'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" ' |
| 5237 | + 'encoding.\n' |
| 5238 | + 'Previously, it was read with the system locale encoding.\n' |
| 5239 | + '\n' |
5235 | 5240 | 'h(elp) [command]\n' |
5236 | 5241 | '\n' |
5237 | 5242 | ' Without argument, print the list of available commands. With ' |
|
8756 | 8761 | '"__rsub__()"\n' |
8757 | 8762 | ' method, "type(y).__rsub__(y, x)" is called if ' |
8758 | 8763 | '"type(x).__sub__(x,\n' |
8759 | | - ' y)" returns *NotImplemented*.\n' |
| 8764 | + ' y)" returns "NotImplemented".\n' |
8760 | 8765 | '\n' |
8761 | 8766 | ' Note that ternary "pow()" will not try calling ' |
8762 | 8767 | '"__rpow__()" (the\n' |
|
8799 | 8804 | 'the result\n' |
8800 | 8805 | ' (which could be, but does not have to be, *self*). If a ' |
8801 | 8806 | 'specific\n' |
8802 | | - ' method is not defined, the augmented assignment falls ' |
8803 | | - 'back to the\n' |
8804 | | - ' normal methods. For instance, if *x* is an instance of ' |
8805 | | - 'a class\n' |
8806 | | - ' with an "__iadd__()" method, "x += y" is equivalent to ' |
8807 | | - '"x =\n' |
8808 | | - ' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and ' |
8809 | | - '"y.__radd__(x)" are\n' |
| 8807 | + ' method is not defined, or if that method returns ' |
| 8808 | + '"NotImplemented",\n' |
| 8809 | + ' the augmented assignment falls back to the normal ' |
| 8810 | + 'methods. For\n' |
| 8811 | + ' instance, if *x* is an instance of a class with an ' |
| 8812 | + '"__iadd__()"\n' |
| 8813 | + ' method, "x += y" is equivalent to "x = x.__iadd__(y)" . ' |
| 8814 | + 'If\n' |
| 8815 | + ' "__iadd__()" does not exist, or if "x.__iadd__(y)" ' |
| 8816 | + 'returns\n' |
| 8817 | + ' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" ' |
| 8818 | + 'are\n' |
8810 | 8819 | ' considered, as with the evaluation of "x + y". In ' |
8811 | 8820 | 'certain\n' |
8812 | 8821 | ' situations, augmented assignment can result in ' |
|
8887 | 8896 | 'Every object has an identity, a type and a value. An object’s\n' |
8888 | 8897 | '*identity* never changes once it has been created; you may think ' |
8889 | 8898 | 'of it\n' |
8890 | | - 'as the object’s address in memory. The ‘"is"’ operator compares ' |
| 8899 | + 'as the object’s address in memory. The "is" operator compares ' |
8891 | 8900 | 'the\n' |
8892 | 8901 | 'identity of two objects; the "id()" function returns an integer\n' |
8893 | 8902 | 'representing its identity.\n' |
|
8952 | 8961 | 'Note that the use of the implementation’s tracing or debugging\n' |
8953 | 8962 | 'facilities may keep objects alive that would normally be ' |
8954 | 8963 | 'collectable.\n' |
8955 | | - 'Also note that catching an exception with a ‘"try"…"except"’ ' |
| 8964 | + 'Also note that catching an exception with a "try"…"except" ' |
8956 | 8965 | 'statement\n' |
8957 | 8966 | 'may keep objects alive.\n' |
8958 | 8967 | '\n' |
|
8967 | 8976 | 'release the external resource, usually a "close()" method. ' |
8968 | 8977 | 'Programs\n' |
8969 | 8978 | 'are strongly recommended to explicitly close such objects. The\n' |
8970 | | - '‘"try"…"finally"’ statement and the ‘"with"’ statement provide\n' |
8971 | | - 'convenient ways to do this.\n' |
| 8979 | + '"try"…"finally" statement and the "with" statement provide ' |
| 8980 | + 'convenient\n' |
| 8981 | + 'ways to do this.\n' |
8972 | 8982 | '\n' |
8973 | 8983 | 'Some objects contain references to other objects; these are ' |
8974 | 8984 | 'called\n' |
|
9345 | 9355 | 'The try statement.\n' |
9346 | 9356 | '\n' |
9347 | 9357 | 'Changed in version 3.3: "None" is now permitted as "Y" in "raise X\n' |
9348 | | - 'from Y".\n' |
9349 | | - '\n' |
9350 | | - 'New in version 3.3: The "__suppress_context__" attribute to ' |
9351 | | - 'suppress\n' |
| 9358 | + 'from Y".Added the "__suppress_context__" attribute to suppress\n' |
9352 | 9359 | 'automatic display of the exception context.\n' |
9353 | 9360 | '\n' |
9354 | 9361 | 'Changed in version 3.11: If the traceback of the active exception ' |
|
10133 | 10140 | 'reflection,\n' |
10134 | 10141 | ' and "__eq__()" and "__ne__()" are their own reflection. ' |
10135 | 10142 | 'If the\n' |
10136 | | - ' operands are of different types, and right operand’s type ' |
10137 | | - 'is a\n' |
| 10143 | + ' operands are of different types, and the right operand’s ' |
| 10144 | + 'type is a\n' |
10138 | 10145 | ' direct or indirect subclass of the left operand’s type, ' |
10139 | 10146 | 'the\n' |
10140 | 10147 | ' reflected method of the right operand has priority, ' |
|
10143 | 10150 | 'is not\n' |
10144 | 10151 | ' considered.\n' |
10145 | 10152 | '\n' |
| 10153 | + ' When no appropriate method returns any value other than\n' |
| 10154 | + ' "NotImplemented", the "==" and "!=" operators will fall ' |
| 10155 | + 'back to\n' |
| 10156 | + ' "is" and "is not", respectively.\n' |
| 10157 | + '\n' |
10146 | 10158 | 'object.__hash__(self)\n' |
10147 | 10159 | '\n' |
10148 | 10160 | ' Called by built-in function "hash()" and for operations ' |
|
11682 | 11694 | '"__rsub__()"\n' |
11683 | 11695 | ' method, "type(y).__rsub__(y, x)" is called if ' |
11684 | 11696 | '"type(x).__sub__(x,\n' |
11685 | | - ' y)" returns *NotImplemented*.\n' |
| 11697 | + ' y)" returns "NotImplemented".\n' |
11686 | 11698 | '\n' |
11687 | 11699 | ' Note that ternary "pow()" will not try calling ' |
11688 | 11700 | '"__rpow__()" (the\n' |
@@ -11725,14 +11737,17 @@ |
11725 | 11737 | 'the result\n' |
11726 | 11738 | ' (which could be, but does not have to be, *self*). If a ' |
11727 | 11739 | 'specific\n' |
11728 | | - ' method is not defined, the augmented assignment falls ' |
11729 | | - 'back to the\n' |
11730 | | - ' normal methods. For instance, if *x* is an instance of a ' |
11731 | | - 'class\n' |
11732 | | - ' with an "__iadd__()" method, "x += y" is equivalent to "x ' |
11733 | | - '=\n' |
11734 | | - ' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and ' |
11735 | | - '"y.__radd__(x)" are\n' |
| 11740 | + ' method is not defined, or if that method returns ' |
| 11741 | + '"NotImplemented",\n' |
| 11742 | + ' the augmented assignment falls back to the normal ' |
| 11743 | + 'methods. For\n' |
| 11744 | + ' instance, if *x* is an instance of a class with an ' |
| 11745 | + '"__iadd__()"\n' |
| 11746 | + ' method, "x += y" is equivalent to "x = x.__iadd__(y)" . ' |
| 11747 | + 'If\n' |
| 11748 | + ' "__iadd__()" does not exist, or if "x.__iadd__(y)" ' |
| 11749 | + 'returns\n' |
| 11750 | + ' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" are\n' |
11736 | 11751 | ' considered, as with the evaluation of "x + y". In ' |
11737 | 11752 | 'certain\n' |
11738 | 11753 | ' situations, augmented assignment can result in unexpected ' |
|
13080 | 13095 | '\n' |
13081 | 13096 | 'New in version 3.3: The "\'rb\'" prefix of raw bytes literals has ' |
13082 | 13097 | 'been\n' |
13083 | | - 'added as a synonym of "\'br\'".\n' |
13084 | | - '\n' |
13085 | | - 'New in version 3.3: Support for the unicode legacy literal\n' |
| 13098 | + 'added as a synonym of "\'br\'".Support for the unicode legacy ' |
| 13099 | + 'literal\n' |
13086 | 13100 | '("u\'value\'") was reintroduced to simplify the maintenance of ' |
13087 | 13101 | 'dual\n' |
13088 | 13102 | 'Python 2.x and 3.x codebases. See **PEP 414** for more ' |
|
14765 | 14779 | 'tools.\n' |
14766 | 14780 | ' The PEP that introduced the "co_lines()" method.\n' |
14767 | 14781 | '\n' |
| 14782 | + 'codeobject.replace(**kwargs)\n' |
| 14783 | + '\n' |
| 14784 | + ' Return a copy of the code object with new values for the ' |
| 14785 | + 'specified\n' |
| 14786 | + ' fields.\n' |
| 14787 | + '\n' |
| 14788 | + ' Code objects are also supported by the generic function\n' |
| 14789 | + ' "copy.replace()".\n' |
| 14790 | + '\n' |
| 14791 | + ' New in version 3.8.\n' |
| 14792 | + '\n' |
14768 | 14793 | '\n' |
14769 | 14794 | 'Frame objects\n' |
14770 | 14795 | '-------------\n' |
|
16109 | 16134 | '\n' |
16110 | 16135 | ' For sorting examples and a brief sorting tutorial, see ' |
16111 | 16136 | 'Sorting\n' |
16112 | | - ' HOW TO.\n' |
| 16137 | + ' Techniques.\n' |
16113 | 16138 | '\n' |
16114 | 16139 | ' **CPython implementation detail:** While a list is being ' |
16115 | 16140 | 'sorted,\n' |
|
16324 | 16349 | 'objects\n' |
16325 | 16350 | 'based on the sequence of values they define (instead of ' |
16326 | 16351 | 'comparing\n' |
16327 | | - 'based on object identity).\n' |
16328 | | - '\n' |
16329 | | - 'New in version 3.3: The "start", "stop" and "step" attributes.\n' |
| 16352 | + 'based on object identity).Added the "start", "stop" and "step"\n' |
| 16353 | + 'attributes.\n' |
16330 | 16354 | '\n' |
16331 | 16355 | 'See also:\n' |
16332 | 16356 | '\n' |
|
0 commit comments