summaryrefslogtreecommitdiffstats
path: root/Doc/extending
diff options
context:
space:
mode:
authorAdam Turner <9087854+AA-Turner@users.noreply.github.com>2022-10-05 15:22:28 (GMT)
committerGitHub <noreply@github.com>2022-10-05 15:22:28 (GMT)
commit0e72606dd4cf3023a4f8c2fe3c58082592b253f7 (patch)
tree3f73db99e426c2089f75d0670cb3054c9311b00c /Doc/extending
parent09aea94d291fed2f3e96558dcd6db04014c3e2fb (diff)
downloadcpython-0e72606dd4cf3023a4f8c2fe3c58082592b253f7.zip
cpython-0e72606dd4cf3023a4f8c2fe3c58082592b253f7.tar.gz
cpython-0e72606dd4cf3023a4f8c2fe3c58082592b253f7.tar.bz2
gh-93738: Documentation C syntax (Function glob patterns -> literal markup) (#97774)
Diffstat (limited to 'Doc/extending')
-rw-r--r--Doc/extending/extending.rst6
1 files changed, 3 insertions, 3 deletions
diff --git a/Doc/extending/extending.rst b/Doc/extending/extending.rst
index 2e3362b..0ef899f 100644
--- a/Doc/extending/extending.rst
+++ b/Doc/extending/extending.rst
@@ -157,16 +157,16 @@ since you should be able to tell from the return value.
When a function *f* that calls another function *g* detects that the latter
fails, *f* should itself return an error value (usually ``NULL`` or ``-1``). It
-should *not* call one of the :c:func:`PyErr_\*` functions --- one has already
+should *not* call one of the ``PyErr_*`` functions --- one has already
been called by *g*. *f*'s caller is then supposed to also return an error
-indication to *its* caller, again *without* calling :c:func:`PyErr_\*`, and so on
+indication to *its* caller, again *without* calling ``PyErr_*``, and so on
--- the most detailed cause of the error was already reported by the function
that first detected it. Once the error reaches the Python interpreter's main
loop, this aborts the currently executing Python code and tries to find an
exception handler specified by the Python programmer.
(There are situations where a module can actually give a more detailed error
-message by calling another :c:func:`PyErr_\*` function, and in such cases it is
+message by calling another ``PyErr_*`` function, and in such cases it is
fine to do so. As a general rule, however, this is not necessary, and can cause
information about the cause of the error to be lost: most operations can fail
for a variety of reasons.)