]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
Fix the PyGetSetDef documentation (GH-116056)
authorSerhiy Storchaka <storchaka@gmail.com>
Tue, 5 Mar 2024 15:48:20 +0000 (17:48 +0200)
committerGitHub <noreply@github.com>
Tue, 5 Mar 2024 15:48:20 +0000 (17:48 +0200)
closure is not a function pointer, it is a user data pointer.

Doc/c-api/structures.rst

index e2943f18ddc601035c33a4354b69a671eec7af4a..f9461ab01f60492cbf34e68b074cc84a42d8a0e6 100644 (file)
@@ -702,12 +702,12 @@ Defining Getters and Setters
 
    .. c:member:: void* closure
 
-      Optional function pointer, providing additional data for getter and setter.
+      Optional user data pointer, providing additional data for getter and setter.
 
 .. c:type:: PyObject *(*getter)(PyObject *, void *)
 
    The ``get`` function takes one :c:expr:`PyObject*` parameter (the
-   instance) and a function pointer (the associated ``closure``):
+   instance) and a user data pointer (the associated ``closure``):
 
    It should return a new reference on success or ``NULL`` with a set exception
    on failure.
@@ -715,7 +715,7 @@ Defining Getters and Setters
 .. c:type:: int (*setter)(PyObject *, PyObject *, void *)
 
    ``set`` functions take two :c:expr:`PyObject*` parameters (the instance and
-   the value to be set) and a function pointer (the associated ``closure``):
+   the value to be set) and a user data pointer (the associated ``closure``):
 
    In case the attribute should be deleted the second parameter is ``NULL``.
    Should return ``0`` on success or ``-1`` with a set exception on failure.