Python 3.13.3v3.13.3

1 files changed, 73 insertions, 47 deletions

diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index a8f4ea0..b725792 100644
--- a/Lib/pydoc_data/topics.py
+++ b/Lib/pydoc_data/topics.py
@@ -1,4 +1,4 @@
-# Autogenerated by Sphinx on Sat Feb 22 02:02:02 2025
+# Autogenerated by Sphinx on Tue Apr  8 15:54:03 2025
 # as part of the release process.
 
 topics = {
@@ -2689,7 +2689,7 @@ section The standard type hierarchy):
    parameter_list_no_posonly ::= defparameter ("," defparameter)* ["," [parameter_list_starargs]]
                                  | parameter_list_starargs
    parameter_list_starargs   ::= "*" [star_parameter] ("," defparameter)* ["," [parameter_star_kwargs]]
-                                 "*" ("," defparameter)+ ["," [parameter_star_kwargs]]
+                                 | "*" ("," defparameter)+ ["," [parameter_star_kwargs]]
                                  | parameter_star_kwargs
    parameter_star_kwargs     ::= "**" parameter [","]
    parameter                 ::= identifier [":" expression]
@@ -3787,7 +3787,7 @@ and local names are offered as arguments of the "p" command.
 You can also invoke "pdb" from the command line to debug other
 scripts.  For example:
 
-   python -m pdb myscript.py
+   python -m pdb [-c command] (-m module | pyfile) [args ...]
 
 When invoked as a module, pdb will automatically enter post-mortem
 debugging if the program being debugged exits abnormally.  After post-
@@ -3796,12 +3796,20 @@ restart the program.  Automatic restarting preserves pdb’s state (such
 as breakpoints) and in most cases is more useful than quitting the
 debugger upon program’s exit.
 
-Changed in version 3.2: Added the "-c" option to execute commands as
-if given in a ".pdbrc" file; see Debugger Commands.
+-c, --command <command>
 
-Changed in version 3.7: Added the "-m" option to execute modules
-similar to the way "python -m" does. As with a script, the debugger
-will pause execution just before the first line of the module.
+   To execute commands as if given in a ".pdbrc" file; see Debugger
+   Commands.
+
+   Changed in version 3.2: Added the "-c" option.
+
+-m <module>
+
+   To execute modules similar to the way "python -m" does. As with a
+   script, the debugger will pause execution just before the first
+   line of the module.
+
+   Changed in version 3.7: Added the "-m" option.
 
 Typical usage to execute a statement under control of the debugger is:
 
@@ -5153,14 +5161,16 @@ format specification typically modifies the result.
 
 The general form of a *standard format specifier* is:
 
-   format_spec     ::= [[fill]align][sign]["z"]["#"]["0"][width][grouping_option]["." precision][type]
-   fill            ::= <any character>
-   align           ::= "<" | ">" | "=" | "^"
-   sign            ::= "+" | "-" | " "
-   width           ::= digit+
-   grouping_option ::= "_" | ","
-   precision       ::= digit+
-   type            ::= "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "s" | "x" | "X" | "%"
+   format_spec ::= [options][width][grouping]["." precision][type]
+   options     ::= [[fill]align][sign]["z"]["#"]["0"]
+   fill        ::= <any character>
+   align       ::= "<" | ">" | "=" | "^"
+   sign        ::= "+" | "-" | " "
+   width       ::= digit+
+   grouping    ::= "," | "_"
+   precision   ::= digit+
+   type        ::= "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g"
+                   | "G" | "n" | "o" | "s" | "x" | "X" | "%"
 
 If a valid *align* value is specified, it can be preceded by a *fill*
 character that can be any character and defaults to a space if
@@ -5202,13 +5212,13 @@ the following:
 +-----------+------------------------------------------------------------+
 | Option    | Meaning                                                    |
 |===========|============================================================|
-| "'+'"     | indicates that a sign should be used for both positive as  |
+| "'+'"     | Indicates that a sign should be used for both positive as  |
 |           | well as negative numbers.                                  |
 +-----------+------------------------------------------------------------+
-| "'-'"     | indicates that a sign should be used only for negative     |
+| "'-'"     | Indicates that a sign should be used only for negative     |
 |           | numbers (this is the default behavior).                    |
 +-----------+------------------------------------------------------------+
-| space     | indicates that a leading space should be used on positive  |
+| space     | Indicates that a leading space should be used on positive  |
 |           | numbers, and a minus sign on negative numbers.             |
 +-----------+------------------------------------------------------------+
 
@@ -5231,26 +5241,10 @@ point character appears in the result of these conversions only if a
 digit follows it. In addition, for "'g'" and "'G'" conversions,
 trailing zeros are not removed from the result.
 
-The "','" option signals the use of a comma for a thousands separator
-for floating-point presentation types and for integer presentation
-type "'d'". For other presentation types, this option is an error. For
-a locale aware separator, use the "'n'" integer presentation type
-instead.
-
-Changed in version 3.1: Added the "','" option (see also **PEP 378**).
-
-The "'_'" option signals the use of an underscore for a thousands
-separator for floating-point presentation types and for integer
-presentation type "'d'".  For integer presentation types "'b'", "'o'",
-"'x'", and "'X'", underscores will be inserted every 4 digits.  For
-other presentation types, specifying this option is an error.
-
-Changed in version 3.6: Added the "'_'" option (see also **PEP 515**).
-
-*width* is a decimal integer defining the minimum total field width,
-including any prefixes, separators, and other formatting characters.
-If not specified, then the field width will be determined by the
-content.
+The *width* is a decimal integer defining the minimum total field
+width, including any prefixes, separators, and other formatting
+characters. If not specified, then the field width will be determined
+by the content.
 
 When no explicit alignment is given, preceding the *width* field by a
 zero ("'0'") character enables sign-aware zero-padding for numeric
@@ -5260,6 +5254,32 @@ of "'0'" with an *alignment* type of "'='".
 Changed in version 3.10: Preceding the *width* field by "'0'" no
 longer affects the default alignment for strings.
 
+The *grouping* option after the *width* field specifies a digit group
+separator for the integral part of a number. It can be one of the
+following:
+
++-----------+------------------------------------------------------------+
+| Option    | Meaning                                                    |
+|===========|============================================================|
+| "','"     | Inserts a comma every 3 digits for integer presentation    |
+|           | type "'d'" and floating-point presentation types,          |
+|           | excluding "'n'". For other presentation types, this option |
+|           | is not supported.                                          |
++-----------+------------------------------------------------------------+
+| "'_'"     | Inserts an underscore every 3 digits for integer           |
+|           | presentation type "'d'" and floating-point presentation    |
+|           | types, excluding "'n'". For integer presentation types     |
+|           | "'b'", "'o'", "'x'", and "'X'", underscores are inserted   |
+|           | every 4 digits. For other presentation types, this option  |
+|           | is not supported.                                          |
++-----------+------------------------------------------------------------+
+
+For a locale aware separator, use the "'n'" presentation type instead.
+
+Changed in version 3.1: Added the "','" option (see also **PEP 378**).
+
+Changed in version 3.6: Added the "'_'" option (see also **PEP 515**).
+
 The *precision* is a decimal integer indicating how many digits should
 be displayed after the decimal point for presentation types "'f'" and
 "'F'", or before and after the decimal point for presentation types
@@ -5304,8 +5324,8 @@ The available integer presentation types are:
    |           | as well.                                                   |
    +-----------+------------------------------------------------------------+
    | "'n'"     | Number. This is the same as "'d'", except that it uses the |
-   |           | current locale setting to insert the appropriate number    |
-   |           | separator characters.                                      |
+   |           | current locale setting to insert the appropriate digit     |
+   |           | group separators.                                          |
    +-----------+------------------------------------------------------------+
    | None      | The same as "'d'".                                         |
    +-----------+------------------------------------------------------------+
@@ -5376,8 +5396,8 @@ The available presentation types for "float" and "Decimal" values are:
    |           | and NaN are uppercased, too.                               |
    +-----------+------------------------------------------------------------+
    | "'n'"     | Number. This is the same as "'g'", except that it uses the |
-   |           | current locale setting to insert the appropriate number    |
-   |           | separator characters.                                      |
+   |           | current locale setting to insert the appropriate digit     |
+   |           | group separators for the integral part of a number.        |
    +-----------+------------------------------------------------------------+
    | "'%'"     | Percentage. Multiplies the number by 100 and displays in   |
    |           | fixed ("'f'") format, followed by a percent sign.          |
@@ -5500,10 +5520,16 @@ Replacing "%x" and "%o" and converting the value to different bases:
    >>> "int: {0:d};  hex: {0:#x};  oct: {0:#o};  bin: {0:#b}".format(42)
    'int: 42;  hex: 0x2a;  oct: 0o52;  bin: 0b101010'
 
-Using the comma as a thousands separator:
+Using the comma or the underscore as a digit group separator:
 
    >>> '{:,}'.format(1234567890)
    '1,234,567,890'
+   >>> '{:_}'.format(1234567890)
+   '1_234_567_890'
+   >>> '{:_b}'.format(1234567890)
+   '100_1001_1001_0110_0000_0010_1101_0010'
+   >>> '{:_x}'.format(1234567890)
+   '4996_02d2'
 
 Expressing a percentage:
 
@@ -5563,7 +5589,7 @@ section The standard type hierarchy):
    parameter_list_no_posonly ::= defparameter ("," defparameter)* ["," [parameter_list_starargs]]
                                  | parameter_list_starargs
    parameter_list_starargs   ::= "*" [star_parameter] ("," defparameter)* ["," [parameter_star_kwargs]]
-                                 "*" ("," defparameter)+ ["," [parameter_star_kwargs]]
+                                 | "*" ("," defparameter)+ ["," [parameter_star_kwargs]]
                                  | parameter_star_kwargs
    parameter_star_kwargs     ::= "**" parameter [","]
    parameter                 ::= identifier [":" expression]
@@ -11567,7 +11593,7 @@ class dict(iterable, **kwargs)
       to be a mutable object such as an empty list.  To get distinct
       values, use a dict comprehension instead.
 
-   get(key, default=None)
+   get(key, default=None, /)
 
       Return the value for *key* if *key* is in the dictionary, else
       *default*. If *default* is not given, it defaults to "None", so
@@ -11608,7 +11634,7 @@ class dict(iterable, **kwargs)
 
       Added in version 3.8.
 
-   setdefault(key, default=None)
+   setdefault(key, default=None, /)
 
       If *key* is in the dictionary, return its value.  If not, insert
       *key* with a value of *default* and return *default*.  *default*