diff options
author | Adam Turner <9087854+AA-Turner@users.noreply.github.com> | 2022-10-05 15:22:28 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-10-05 15:22:28 (GMT) |
commit | 0e72606dd4cf3023a4f8c2fe3c58082592b253f7 (patch) | |
tree | 3f73db99e426c2089f75d0670cb3054c9311b00c /Doc/extending | |
parent | 09aea94d291fed2f3e96558dcd6db04014c3e2fb (diff) | |
download | cpython-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.rst | 6 |
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.) |