From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Mon, 22 Jun 2026 20:08:34 +0000 (+0200) Subject: [3.14] gh-62480: De-personalize docs on using the C API (GH-151784) X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=912a68b639882aa11c10636117ff0dda3bd6b1fc;p=thirdparty%2FPython%2Fcpython.git [3.14] gh-62480: De-personalize docs on using the C API (GH-151784) (cherry picked from commit 1c5a11018ad605072b2efac67f3ca87b41b622c6) Co-authored-by: Rafael Weingartner-Ortner <38643099+RafaelWO@users.noreply.github.com> Co-authored-by: Stan Ulbrych --- diff --git a/Doc/extending/extending.rst b/Doc/extending/extending.rst index f9b65643dfe8..23e0064c6c93 100644 --- a/Doc/extending/extending.rst +++ b/Doc/extending/extending.rst @@ -545,10 +545,8 @@ calling the Python callback functions from a C callback. Other uses are also imaginable. Fortunately, the Python interpreter is easily called recursively, and there is a -standard interface to call a Python function. (I won't dwell on how to call the -Python parser with a particular string as input --- if you're interested, have a -look at the implementation of the :option:`-c` command line option in -:file:`Modules/main.c` from the Python source code.) +standard interface to call a Python function. (If you're interested in how to call the +Python parser with a particular string as input, see :ref:`veryhigh`.) Calling a Python function is easy. First, the Python program must somehow pass you the Python function object. You should provide a function (or some other @@ -938,7 +936,7 @@ and the object is freed. An alternative strategy is called :dfn:`automatic garbage collection`. (Sometimes, reference counting is also referred to as a garbage collection -strategy, hence my use of "automatic" to distinguish the two.) The big +strategy, hence the use of "automatic" to distinguish the two.) The big advantage of automatic garbage collection is that the user doesn't need to call :c:func:`free` explicitly. (Another claimed advantage is an improvement in speed or memory usage --- this is no hard fact however.) The disadvantage is that for