Use less signatures and more default values.

serhiy-storchaka · serhiy-storchaka · commit 72157aa99fbe · 2025-08-10T21:09:51.000+03:00
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
@@ -182,10 +182,8 @@ are always available.  They are listed here in alphabetical order.
    .. versionadded:: 3.7
 
 .. _func-bytearray:
-.. class:: bytearray()
-           bytearray(source)
-           bytearray(source, encoding)
-           bytearray(source, encoding, errors)
+.. class:: bytearray(source=b'')
+           bytearray(source, encoding, errors='strict')
    :noindex:
 
    Return a new array of bytes.  The :class:`bytearray` class is a mutable
@@ -215,10 +213,8 @@ are always available.  They are listed here in alphabetical order.
 
 
 .. _func-bytes:
-.. class:: bytes()
-           bytes(source)
-           bytes(source, encoding)
-           bytes(source, encoding, errors)
+.. class:: bytes(source=b'')
+           bytes(source, encoding, errors='strict')
    :noindex:
 
    Return a new "bytes" object which is an immutable sequence of integers in
@@ -848,7 +844,7 @@ are always available.  They are listed here in alphabetical order.
 
 
 .. _func-frozenset:
-.. class:: frozenset(iterable=set(), /)
+.. class:: frozenset(iterable=(), /)
    :noindex:
 
    Return a new :class:`frozenset` object, optionally with elements taken from
@@ -1146,8 +1142,7 @@ are always available.  They are listed here in alphabetical order.
 
 
 .. _func-list:
-.. class:: list()
-           list(iterable, /)
+.. class:: list(iterable=(), /)
    :noindex:
 
    Rather than being a function, :class:`list` is actually a mutable
@@ -1763,7 +1758,7 @@ are always available.  They are listed here in alphabetical order.
             return f"Person('{self.name}', {self.age})"
 
 
-.. function:: reversed(sequence, /)
+.. function:: reversed(object, /)
 
    Return a reverse :term:`iterator`.  The argument must be an object which has
    a :meth:`~object.__reversed__` method or supports the sequence protocol (the
@@ -1799,8 +1794,7 @@ are always available.  They are listed here in alphabetical order.
 
 
 .. _func-set:
-.. class:: set()
-           set(iterable, /)
+.. class:: set(iterable=(), /)
    :noindex:
 
    Return a new :class:`set` object, optionally with elements taken from
@@ -1940,10 +1934,8 @@ are always available.  They are listed here in alphabetical order.
    single: string; str() (built-in function)
 
 .. _func-str:
-.. class:: str()
-           str(object)
-           str(object, encoding)
-           str(object, encoding, errors)
+.. class:: str(object='')
+           str(object, encoding, errors='strict')
            str(object, *, errors)
    :noindex:
 
@@ -2059,8 +2051,7 @@ are always available.  They are listed here in alphabetical order.
 
 
 .. _func-tuple:
-.. class:: tuple()
-           tuple(iterable, /)
+.. class:: tuple(iterable=(), /)
    :noindex:
 
    Rather than being a function, :class:`tuple` is actually an immutable
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
@@ -1312,8 +1312,7 @@ Lists are mutable sequences, typically used to store collections of
 homogeneous items (where the precise degree of similarity will vary by
 application).
 
-.. class:: list()
-           list(iterable, /)
+.. class:: list(iterable=(), /)
 
    Lists may be constructed in several ways:
 
@@ -1394,8 +1393,7 @@ built-in). Tuples are also used for cases where an immutable sequence of
 homogeneous data is needed (such as allowing storage in a :class:`set` or
 :class:`dict` instance).
 
-.. class:: tuple()
-           tuple(iterable, /)
+.. class:: tuple(iterable=(), /)
 
    Tuples may be constructed in a number of ways:
 
@@ -1698,10 +1696,8 @@ multiple fragments.
 .. index::
    single: string; str (built-in class)
 
-.. class:: str()
-           str(object)
-           str(object, encoding)
-           str(object, encoding, errors)
+.. class:: str(object='')
+           str(object, encoding, errors='strict')
            str(object, *, errors)
 
    Return a :ref:`string <textseq>` version of *object*.  If *object* is not
@@ -2895,10 +2891,8 @@ binary protocols are based on the ASCII text encoding, bytes objects offer
 several methods that are only valid when working with ASCII compatible
 data and are closely related to string objects in a variety of other ways.
 
-.. class:: bytes()
-           bytes(source)
-           bytes(source, encoding)
-           bytes(source, encoding, errors)
+.. class:: bytes(source=b'')
+           bytes(source, encoding, errors='strict')
 
    Firstly, the syntax for bytes literals is largely the same as that for string
    literals, except that a ``b`` prefix is added:
@@ -3008,10 +3002,8 @@ Bytearray Objects
 :class:`bytearray` objects are a mutable counterpart to :class:`bytes`
 objects.
 
-.. class:: bytearray()
-           bytearray(source)
-           bytearray(source, encoding)
-           bytearray(source, encoding, errors)
+.. class:: bytearray(source=b'')
+           bytearray(source, encoding, errors='strict')
 
    There is no dedicated literal syntax for bytearray objects, instead
    they are always created by calling the constructor:
