Fix more.

serhiy-storchaka · serhiy-storchaka · commit 0f032ab55f9c · 2025-06-05T11:40:14.000+03:00
diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst
@@ -1182,9 +1182,9 @@ ConfigParser Objects
       in the same manner as the option.
 
       .. versionchanged:: 3.2
-         Arguments *raw*, *vars* and *fallback* are keyword only to protect
-         users from trying to use the third argument as the *fallback* fallback
-         (especially when using the mapping protocol).
+         Parameters *raw*, *vars* and *fallback* are keyword-only to protect
+         users from trying to use the third positional argument as the
+         *fallback* (especially when using the mapping protocol).
 
 
    .. method:: getint(section, option, *, raw=False, vars=None[, fallback])
diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
@@ -172,10 +172,9 @@ attributes (see :ref:`import-mod-attrs` for module attributes):
 |                 |                   | references to local       |
 |                 |                   | variables                 |
 +-----------------+-------------------+---------------------------+
-| code            | co_argcount       | number of arguments (not  |
-|                 |                   | including keyword only    |
-|                 |                   | arguments, \* or \*\*     |
-|                 |                   | args)                     |
+| code            | co_argcount       | number of positional      |
+|                 |                   | parameters (not including |
+|                 |                   | var-positional parameter) |
 +-----------------+-------------------+---------------------------+
 |                 | co_code           | string of raw compiled    |
 |                 |                   | bytecode                  |
@@ -206,12 +205,12 @@ attributes (see :ref:`import-mod-attrs` for module attributes):
 |                 |                   | variables (referenced via |
 |                 |                   | a function's closure)     |
 +-----------------+-------------------+---------------------------+
-|                 | co_posonlyargcount| number of positional only |
-|                 |                   | arguments                 |
+|                 | co_posonlyargcount| number of positional-only |
+|                 |                   | parameters                |
 +-----------------+-------------------+---------------------------+
-|                 | co_kwonlyargcount | number of keyword only    |
-|                 |                   | arguments (not including  |
-|                 |                   | \*\* arg)                 |
+|                 | co_kwonlyargcount | number of keyword-only    |
+|                 |                   | parameters (not including |
+|                 |                   | var-positional parameter) |
 +-----------------+-------------------+---------------------------+
 |                 | co_name           | name with which this code |
 |                 |                   | object was defined        |
@@ -956,7 +955,7 @@ function.
       |    Name                | Meaning                                      |
       +========================+==============================================+
       | *POSITIONAL_ONLY*      | Value must be supplied as a positional       |
-      |                        | argument. Positional only parameters are     |
+      |                        | argument. Positional-only parameters are     |
       |                        | those which appear before a ``/`` entry (if  |
       |                        | present) in a Python function definition.    |
       +------------------------+----------------------------------------------+
@@ -971,7 +970,7 @@ function.
       |                        | Python function definition.                  |
       +------------------------+----------------------------------------------+
       | *KEYWORD_ONLY*         | Value must be supplied as a keyword argument.|
-      |                        | Keyword only parameters are those which      |
+      |                        | Keyword-only parameters are those which      |
       |                        | appear after a ``*`` or ``*args`` entry in a |
       |                        | Python function definition.                  |
       +------------------------+----------------------------------------------+
diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
@@ -1603,7 +1603,7 @@ inherited by child processes.
    automatically protected by a lock, so it will not necessarily be
    "process-safe".
 
-   Note that *lock* is a keyword only argument.
+   Note that *lock* is a keyword-only parameter.
 
    Note that an array of :data:`ctypes.c_char` has *value* and *raw*
    attributes which allow one to use it to store and retrieve strings.
diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst
@@ -879,7 +879,7 @@ will always bind to the first parameter. For example::
     TypeError: foo() got multiple values for argument 'name'
     >>>
 
-But using ``/`` (positional only arguments), it is possible since it allows ``name`` as a positional argument and ``'name'`` as a key in the keyword arguments::
+But using ``/`` (positional-only parameters), it is possible since it allows ``name`` as a positional argument and ``'name'`` as a key in the keyword arguments::
 
     >>> def foo(name, /, **kwds):
     ...     return 'name' in kwds
diff --git a/Include/cpython/code.h b/Include/cpython/code.h
@@ -73,10 +73,10 @@ typedef struct {
     int co_flags;                  /* CO_..., see below */                     \
                                                                                \
     /* The rest are not so impactful on performance. */                        \
-    int co_argcount;              /* #arguments, except *args */               \
-    int co_posonlyargcount;       /* #positional only arguments */             \
-    int co_kwonlyargcount;        /* #keyword only arguments */                \
-    int co_stacksize;             /* #entries needed for evaluation stack */   \
+    int co_argcount;              /* # of positional parameters, except *args */ \
+    int co_posonlyargcount;       /* # of positional-only parameters */        \
+    int co_kwonlyargcount;        /* # of keyword-only parameters, except **kwargs */ \
+    int co_stacksize;             /* # of entries needed for evaluation stack */ \
     int co_firstlineno;           /* first source line number */               \
                                                                                \
     /* redundant values (derived from co_localsplusnames and                   \
diff --git a/Lib/inspect.py b/Lib/inspect.py
@@ -401,8 +401,8 @@ def iscode(object):
     """Return true if the object is a code object.
 
     Code objects provide these attributes:
-        co_argcount         number of arguments (not including *, ** args
-                            or keyword only arguments)
+        co_argcount         number of positional parameters (not including
+                            var-positional parameter)
         co_code             string of raw compiled bytecode
         co_cellvars         tuple of names of cell variables
         co_consts           tuple of constants used in the bytecode
@@ -413,8 +413,9 @@ def iscode(object):
                             | 256=iterable_coroutine | 512=async_generator
                             | 0x4000000=has_docstring
         co_freevars         tuple of names of free variables
-        co_posonlyargcount  number of positional only arguments
-        co_kwonlyargcount   number of keyword only arguments (not including ** arg)
+        co_posonlyargcount  number of positional-only parameters
+        co_kwonlyargcount   number of keyword-only parameters (not including
+                            var-keyword parameter)
         co_lnotab           encoded mapping of line numbers to bytecode indices
         co_name             name with which this code object was defined
         co_names            tuple of names other than arguments and function locals
diff --git a/Misc/NEWS.d/3.10.0a4.rst b/Misc/NEWS.d/3.10.0a4.rst
@@ -432,7 +432,7 @@ and the last exception was always silently ignored.
 .. nonce: qdEtZv
 .. section: Library
 
-Fixed lib2to3.pgen2 to be able to parse PEP-570 positional only argument
+Fixed lib2to3.pgen2 to be able to parse PEP-570 positional-only parameter
 syntax.
 
 ..
diff --git a/Misc/NEWS.d/3.6.0a2.rst b/Misc/NEWS.d/3.6.0a2.rst
@@ -484,7 +484,7 @@ lot of small objects.
 .. nonce: bHIfFA
 .. section: Library
 
-New keyword only parameters in reset_mock call.
+New keyword-only parameters in :meth:`!reset_mock` call.
 
 ..
 
diff --git a/Misc/NEWS.d/3.6.4rc1.rst b/Misc/NEWS.d/3.6.4rc1.rst
@@ -1039,7 +1039,7 @@ of browsing python files that do not end in .py.
 .. nonce: LxN4Vb
 .. section: IDLE
 
-IDLE - Make _htest, _utest parameters keyword only.
+IDLE - Make _htest, _utest parameters keyword-only.
 
 ..
 
diff --git a/Misc/NEWS.d/3.7.0a2.rst b/Misc/NEWS.d/3.7.0a2.rst
@@ -606,7 +606,7 @@ of browsing python files that do not end in .py.
 .. nonce: LxN4Vb
 .. section: IDLE
 
-IDLE - Make _htest, _utest parameters keyword only.
+IDLE - Make _htest, _utest parameters keyword-only.
 
 ..
 
diff --git a/Misc/NEWS.d/3.8.0b1.rst b/Misc/NEWS.d/3.8.0b1.rst
@@ -58,7 +58,7 @@ Pablo Galindo.
 Make the *co_argcount* attribute of code objects represent the total number
 of positional parameters (including positional-only parameters). The value of
 *co_posonlyargcount* can be used to distinguish which parameters are
-positional only, and the difference (*co_argcount* - *co_posonlyargcount*)
+positional-only, and the difference (*co_argcount* - *co_posonlyargcount*)
 is the number of positional-or-keyword parameters. Patch by Pablo Galindo.
 
 ..
@@ -768,7 +768,7 @@ Taskaya
 .. nonce: u7cxu7
 .. section: Library
 
-PDB command ``args`` now  display positional only arguments. Patch contributed
+PDB command ``args`` now also displays values of positional-only parameters. Patch contributed
 by Rémi Lapeyre.
 
 ..
@@ -778,7 +778,7 @@ by Rémi Lapeyre.
 .. nonce: JkZORP
 .. section: Library
 
-PDB command ``args`` now  display keyword only arguments. Patch contributed by
+PDB command ``args`` now also displays values of keyword-only parameters. Patch contributed by
 Rémi Lapeyre.
 
 ..
diff --git a/Misc/NEWS.d/3.9.0a1.rst b/Misc/NEWS.d/3.9.0a1.rst
@@ -2791,9 +2791,9 @@ Abhilash Raj.
 .. nonce: RUcxaK
 .. section: Library
 
-The *dist* argument for statistics.quantiles() is now positional only. The
+The *dist* parameter in :finc:`statistics.quantiles` is now positional-only. The
 current name doesn't reflect that the argument can be either a dataset or a
-distribution.  Marking the parameter as positional avoids confusion and
+distribution.  Marking the parameter as positional-only avoids confusion and
 makes it possible to change the name later.
 
 ..
diff --git a/Misc/NEWS.d/3.9.0a3.rst b/Misc/NEWS.d/3.9.0a3.rst
@@ -128,7 +128,7 @@ Port _json extension module to multiphase initialization (:pep:`489`).
 .. nonce: 74jLh9
 .. section: Core and Builtins
 
-Fix constant folding optimization for positional only arguments - by Anthony
+Fix constant folding optimization for positional-only parameters - by Anthony
 Sottile.
 
 ..
