docs: Change links to label refs (#98454)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
This commit is contained in:
Stanley 2022-10-25 20:26:28 -07:00 committed by GitHub
parent 0ca6a4d640
commit 268129a74f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
10 changed files with 15 additions and 11 deletions

View File

@ -1,5 +1,7 @@
.. highlight:: c .. highlight:: c
.. _howto-clinic:
********************** **********************
Argument Clinic How-To Argument Clinic How-To
********************** **********************

View File

@ -461,7 +461,7 @@ Module State Access from Slot Methods, Getters and Setters
.. After adding to limited API: .. After adding to limited API:
If you use the `limited API <https://docs.python.org/3/c-api/stable.html>__, If you use the :ref:`limited API <stable>,
you must update ``Py_LIMITED_API`` to ``0x030b0000``, losing ABI you must update ``Py_LIMITED_API`` to ``0x030b0000``, losing ABI
compatibility with earlier versions. compatibility with earlier versions.

View File

@ -191,7 +191,7 @@ Module contents
.. versionchanged:: 3.11 .. versionchanged:: 3.11
If a field name is already included in the ``__slots__`` If a field name is already included in the ``__slots__``
of a base class, it will not be included in the generated ``__slots__`` of a base class, it will not be included in the generated ``__slots__``
to prevent `overriding them <https://docs.python.org/3/reference/datamodel.html#notes-on-using-slots>`_. to prevent :ref:`overriding them <datamodel-note-slots>`.
Therefore, do not use ``__slots__`` to retrieve the field names of a Therefore, do not use ``__slots__`` to retrieve the field names of a
dataclass. Use :func:`fields` instead. dataclass. Use :func:`fields` instead.
To be able to determine inherited slots, To be able to determine inherited slots,

View File

@ -360,7 +360,7 @@ Because `Distribution Package <https://packaging.python.org/en/latest/glossary/#
is not available through :data:`sys.path` searches, or is not available through :data:`sys.path` searches, or
package loaders directly, package loaders directly,
the metadata for a distribution is found through import the metadata for a distribution is found through import
system `finders`_. To find a distribution package's metadata, system :ref:`finders <finders-and-loaders>`. To find a distribution package's metadata,
``importlib.metadata`` queries the list of :term:`meta path finders <meta path finder>` on ``importlib.metadata`` queries the list of :term:`meta path finders <meta path finder>` on
:data:`sys.meta_path`. :data:`sys.meta_path`.
@ -396,4 +396,3 @@ a custom finder, return instances of this derived ``Distribution`` in the
.. _`entry point API`: https://setuptools.readthedocs.io/en/latest/pkg_resources.html#entry-points .. _`entry point API`: https://setuptools.readthedocs.io/en/latest/pkg_resources.html#entry-points
.. _`metadata API`: https://setuptools.readthedocs.io/en/latest/pkg_resources.html#metadata-api .. _`metadata API`: https://setuptools.readthedocs.io/en/latest/pkg_resources.html#metadata-api
.. _`finders`: https://docs.python.org/3/reference/import.html#finders-and-loaders

View File

@ -1904,6 +1904,8 @@ Attribute lookup speed can be significantly improved as well.
and *__weakref__* for each instance. and *__weakref__* for each instance.
.. _datamodel-note-slots:
Notes on using *__slots__* Notes on using *__slots__*
"""""""""""""""""""""""""" """"""""""""""""""""""""""

View File

@ -16,8 +16,8 @@ re-used.
.. deprecated:: 3.6 .. deprecated:: 3.6
``pyvenv`` was the recommended tool for creating virtual environments for ``pyvenv`` was the recommended tool for creating virtual environments for
Python 3.3 and 3.4, and is `deprecated in Python 3.6 Python 3.3 and 3.4, and is
<https://docs.python.org/dev/whatsnew/3.6.html#id8>`_. :ref:`deprecated in Python 3.6 <whatsnew36-venv>`.
.. versionchanged:: 3.5 .. versionchanged:: 3.5
The use of ``venv`` is now recommended for creating virtual environments. The use of ``venv`` is now recommended for creating virtual environments.

View File

@ -395,7 +395,7 @@ This section has just been a quick overview of the new features, giving enough
of an explanation to start you programming, but many details have been of an explanation to start you programming, but many details have been
simplified or ignored. Where should you go to get a more complete picture? simplified or ignored. Where should you go to get a more complete picture?
https://docs.python.org/dev/howto/descriptor.html is a lengthy tutorial introduction to The :ref:`descriptorhowto` is a lengthy tutorial introduction to
the descriptor features, written by Guido van Rossum. If my description has the descriptor features, written by Guido van Rossum. If my description has
whetted your appetite, go read this tutorial next, because it goes into much whetted your appetite, go read this tutorial next, because it goes into much
more detail about the new features while still remaining quite easy to read. more detail about the new features while still remaining quite easy to read.

View File

@ -2052,6 +2052,8 @@ tkinter
The :mod:`tkinter.tix` module is now deprecated. :mod:`tkinter` users The :mod:`tkinter.tix` module is now deprecated. :mod:`tkinter` users
should use :mod:`tkinter.ttk` instead. should use :mod:`tkinter.ttk` instead.
.. _whatsnew36-venv:
venv venv
~~~~ ~~~~

View File

@ -122,8 +122,8 @@ Positional-only parameters
There is a new function parameter syntax ``/`` to indicate that some There is a new function parameter syntax ``/`` to indicate that some
function parameters must be specified positionally and cannot be used as function parameters must be specified positionally and cannot be used as
keyword arguments. This is the same notation shown by ``help()`` for C keyword arguments. This is the same notation shown by ``help()`` for C
functions annotated with Larry Hastings' `Argument Clinic functions annotated with Larry Hastings'
<https://docs.python.org/3/howto/clinic.html>`_ tool. :ref:`Argument Clinic <howto-clinic>` tool.
In the following example, parameters *a* and *b* are positional-only, In the following example, parameters *a* and *b* are positional-only,
while *c* or *d* can be positional or keyword, and *e* or *f* are while *c* or *d* can be positional or keyword, and *e* or *f* are

View File

@ -805,8 +805,7 @@ event loop only if called from the main thread.
.. section: Documentation .. section: Documentation
Add an entry for ``__module__`` in the "function" & "method" sections of the Add an entry for ``__module__`` in the "function" & "method" sections of the
`inspect docs types and members table :mod:`inspect` docs' :ref:`inspect-types` table.
<https://docs.python.org/3/library/inspect.html#types-and-members>`_
.. ..