Sep 26, 2024 · May 21, 2024 · May 21, 2024 · May 21, 2024 · May 21, 2024 · May 21, 2024
diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst
      >>> basetwo('10010')
      18

   If``Placeholder`` sentinels are present in *args*, they will be filled first
   If:data:`Placeholder` sentinels are present in *args*, they will be filled first
   when :func:`partial` is called. This allows custom selection of positional arguments
   to be pre-filled when constructing :ref:`partial object<partial-objects>`.
   If``Placeholder`` sentinels are used, all of them must be filled at call time:
   If:data:`Placeholder` sentinels are used, all of them must be filled at call time:

      >>> from functools import partial, Placeholder
      >>> say_to_world = partial(print, Placeholder,'world!')
      >>> say_to_world = partial(print, Placeholder,Placeholder, "world!")
      >>> say_to_world.placeholder_count
      1
      >>> say_to_world('Hello')
      Hello world!
      2
      >>> say_to_world('Hello', 'dear')
      Hello dear world!

   Calling ``say_to_world('Hello')`` would result in :exc:`TypeError`.

   .. versionchanged:: 3.14
      Support for ``Placeholder`` in *args*
      Support for :data:`Placeholder` in *args*

 .. data:: Placeholder

   This is a singleton object that is used as a sentinel for representing a
   gap in positional arguments when calling :func:`partial`.
   It has similar features as :data:`None`:

      >>> type(Placeholder)() is Placeholder
      True

 .. class:: partialmethod(func, /, *args, **keywords)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -378,20 +378,31 @@ The :mod:`functools` module defines the following functions:
		>>> basetwo('10010')
		18

		If``Placeholder`` sentinels are present in args, they will be filled first
		If:data:`Placeholder` sentinels are present in args, they will be filled first
		when :func:`partial` is called. This allows custom selection of positional arguments
		to be pre-filled when constructing :ref:`partial object<partial-objects>`.
		If``Placeholder`` sentinels are used, all of them must be filled at call time:
		If:data:`Placeholder` sentinels are used, all of them must be filled at call time:
dg-pb marked this conversation as resolved. OutdatedShow resolvedHide resolved

		>>> from functools import partial, Placeholder
dg-pb marked this conversation as resolved. OutdatedShow resolvedHide resolved picnixz marked this conversation as resolved. OutdatedShow resolvedHide resolved
		>>> say_to_world = partial(print, Placeholder,'world!')
		>>> say_to_world = partial(print, Placeholder,Placeholder, "world!")
		>>> say_to_world.placeholder_count
		1
		>>> say_to_world('Hello')
		Hello world!
		2
		>>> say_to_world('Hello', 'dear')
		Hello dear world!

		Calling ``say_to_world('Hello')`` would result in :exc:`TypeError`.
dg-pb marked this conversation as resolved. OutdatedShow resolvedHide resolved

		.. versionchanged:: 3.14
		Support for ``Placeholder`` in args
		Support for :data:`Placeholder` in args
dg-pb marked this conversation as resolved. OutdatedShow resolvedHide resolved

		.. data:: Placeholder

		This is a singleton object that is used as a sentinel for representing a
		gap in positional arguments when calling :func:`partial`.
		It has similar features as :data:`None`:
dg-pb marked this conversation as resolved. OutdatedShow resolvedHide resolved

		>>> type(Placeholder)() is Placeholder
		True

		.. class:: partialmethod(func, /, args, *keywords)

Expand Down