pythongh-115937: Remove implementation details from inspect.signature…

…() docs Co-authored-by: Carol Willing <[email protected]> Co-authored-by: Gregory P. Smith <[email protected]> Co-authored-by: Jelle Zijlstra <[email protected]>
erlend-aasland · Feb 28, 2024 · 72823f5 · 72823f5
1 parent 3ea78fd
commit 72823f5
Showing 1 changed file with 6 additions and 3 deletions.
diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
@@ -665,9 +665,6 @@ function.
    Accepts a wide range of Python callables, from plain functions and classes to
    :func:`functools.partial` objects.
 
-   If the passed object has a ``__signature__`` attribute, this function
-   returns it without further computations.
-
    For objects defined in modules using stringized annotations
    (``from __future__ import annotations``), :func:`signature` will
    attempt to automatically un-stringize the annotations using
@@ -702,6 +699,12 @@ function.
       Python.  For example, in CPython, some built-in functions defined in
       C provide no metadata about their arguments.
 
+   .. note::
+
+      We may use the :attr:`!__signature__` attribute to create the signature.
+      The exact semantics are an implementation detail and are subject to
+      unannounced changes. Consult the source code for current semantics.
+
 
 .. class:: Signature(parameters=None, *, return_annotation=Signature.empty)