Skip to content

Commit 3316374

Browse files
committed
Add missing intersphinx prefixes to cross-references
Seven :ref: targets in the extension, clinic, and documentation pages resolved to nothing because their labels live in the CPython docs. Prefix them with the python: intersphinx name.
1 parent dce8cdf commit 3316374

4 files changed

Lines changed: 7 additions & 7 deletions

File tree

‎developer-workflow/extension-modules.rst‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -615,7 +615,7 @@ using `Podman <https://podman.io/docs/installation>`__.
615615
Missing ``Py_BUILD_CORE`` define when using internal headers
616616
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
617617

618-
By default, the CPython :ref:`Stable ABI <stable-abi>` is exposed via
618+
By default, the CPython :ref:`Stable ABI <python:stable-abi>` is exposed via
619619
:code:`#include "Python.h"`. In some cases, this may be insufficient
620620
and internal headers from :cpy-file:`Include/internal` are needed;
621621
in particular, those headers require the :c:macro:`!Py_BUILD_CORE`
@@ -650,7 +650,7 @@ Restricting to the Limited API
650650
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
651651

652652
In order for non-CPython implementations to benefit from new extension modules,
653-
it is recommended to use the :ref:`Limited API <limited-c-api>`. Instead of
653+
it is recommended to use the :ref:`Limited API <python:limited-c-api>`. Instead of
654654
exposing the entire Stable ABI, define the :c:macro:`Py_LIMITED_API` macro
655655
*before* the :code:`#include "Python.h"` directive:
656656

‎development-tools/clinic/howto.rst‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -219,7 +219,7 @@ of these arguments, along with their meanings:
219219

220220
*converter*
221221
Only supported by the ``object`` converter. Specifies the name of a
222-
:ref:`C "converter function" <o_ampersand>`
222+
:ref:`C "converter function" <python:o_ampersand>`
223223
to use to convert this object to a native type.
224224

225225
*encoding*
@@ -677,7 +677,7 @@ How to use the "defining class" converter
677677
-----------------------------------------
678678

679679
Argument Clinic facilitates gaining access to the defining class of a method.
680-
This is useful for :ref:`heap type <heap-types>` methods that need to fetch
680+
This is useful for :ref:`heap type <python:heap-types>` methods that need to fetch
681681
module level state. Use :c:func:`PyType_FromModuleAndSpec` to associate a new
682682
heap type with a module. You can now use :c:func:`PyType_GetModuleState` on
683683
the defining class to fetch the module state, for example from a module method.
@@ -1267,7 +1267,7 @@ How to use the Limited C API
12671267

12681268
If Argument Clinic :term:`input` is located within a C source file
12691269
that contains ``#define Py_LIMITED_API``, Argument Clinic will generate C code
1270-
that uses the :ref:`Limited API <limited-c-api>` to parse arguments. The
1270+
that uses the :ref:`Limited API <python:limited-c-api>` to parse arguments. The
12711271
advantage of this is that the generated code will not use private functions.
12721272
However, this *can* result in Argument Clinic generating less efficient code
12731273
in some cases. The extent of the performance penalty will depend

‎development-tools/clinic/index.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,7 +193,7 @@ The CLI supports the following options:
193193

194194
.. option:: --limited
195195

196-
Use the :ref:`Limited API <limited-c-api>` to parse arguments in the generated C code.
196+
Use the :ref:`Limited API <python:limited-c-api>` to parse arguments in the generated C code.
197197
See :ref:`clinic-howto-limited-capi`.
198198

199199
.. option:: FILE ...

‎documentation/start-documenting.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ written using the :ref:`reStructuredText format <markup>` and contained in the
2525
If you're interested in contributing to Python's documentation, there's no
2626
need to write reStructuredText if you're not so inclined; plain text
2727
contributions are more than welcome as well. Send an e-mail to
28-
docs@python.org or open an issue on the :ref:`tracker <reporting-bugs>`.
28+
docs@python.org or open an issue on the :ref:`tracker <python:reporting-bugs>`.
2929

3030

3131
Introduction

0 commit comments

Comments
 (0)