gh-87864: Use correct function definition syntax in the docs (#103312)

diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index 3d74d550dc345a57eb63d8be16ad26de1c930367..53e8cdcae1cd66a251c3e55281138beaeb0d1f56 100644 (file)
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -214,7 +214,7 @@ Glossary
       A callable is an object that can be called, possibly with a set
       of arguments (see :term:`argument`), with the following syntax::
 
-         callable(argument1, argument2, ...)
+         callable(argument1, argument2, argumentN)
 
       A :term:`function`, and by extension a :term:`method`, is a callable.
       An instance of a class that implements the :meth:`~object.__call__`

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 8797485cd05d8306689f12497bfdf915ebec650f..7792e598c1155cdf9e8306161faf5a1801d3f660 100644 (file)
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1681,7 +1681,7 @@ are always available.  They are listed here in alphabetical order.
 
       class C:
           @staticmethod
-          def f(arg1, arg2, ...): ...
+          def f(arg1, arg2, argN): ...
 
    The ``@staticmethod`` form is a function :term:`decorator` -- see
    :ref:`function` for details.

diff --git a/Lib/abc.py b/Lib/abc.py
index 42048ddb855381f7ec7f10be2aa1b7d437107989..f8a4e11ce9c3b1e7a8afeae5626a73af81a7a208 100644 (file)
--- a/Lib/abc.py
+++ b/Lib/abc.py
@@ -18,7 +18,7 @@ def abstractmethod(funcobj):
 
         class C(metaclass=ABCMeta):
             @abstractmethod
-            def my_abstract_method(self, ...):
+            def my_abstract_method(self, arg1, arg2, argN):
                 ...
     """
     funcobj.__isabstractmethod__ = True

diff --git a/Objects/funcobject.c b/Objects/funcobject.c
index ce5d7bda32c0320f1686c3c1d3d2ed3e61eef83d..78c1144afca2eba9f254f065016900883291e880 100644 (file)
--- a/Objects/funcobject.c
+++ b/Objects/funcobject.c
@@ -942,7 +942,7 @@ functools_wraps(PyObject *wrapper, PyObject *wrapped)
 
      class C:
          @classmethod
-         def f(cls, arg1, arg2, ...):
+         def f(cls, arg1, arg2, argN):
              ...
 
    It can be called either on the class (e.g. C.f()) or on an instance
@@ -1066,7 +1066,7 @@ To declare a class method, use this idiom:\n\
 \n\
   class C:\n\
       @classmethod\n\
-      def f(cls, arg1, arg2, ...):\n\
+      def f(cls, arg1, arg2, argN):\n\
           ...\n\
 \n\
 It can be called either on the class (e.g. C.f()) or on an instance\n\
@@ -1138,7 +1138,7 @@ PyClassMethod_New(PyObject *callable)
 
      class C:
          @staticmethod
-         def f(arg1, arg2, ...):
+         def f(arg1, arg2, argN):
              ...
 
    It can be called either on the class (e.g. C.f()) or on an instance
@@ -1260,7 +1260,7 @@ To declare a static method, use this idiom:\n\
 \n\
      class C:\n\
          @staticmethod\n\
-         def f(arg1, arg2, ...):\n\
+         def f(arg1, arg2, argN):\n\
              ...\n\
 \n\
 It can be called either on the class (e.g. C.f()) or on an instance\n\