mirror of https://github.com/python/cpython
docs: Change links to label refs (#98454)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
This commit is contained in:
parent
0ca6a4d640
commit
268129a74f
|
@ -1,5 +1,7 @@
|
||||||
.. highlight:: c
|
.. highlight:: c
|
||||||
|
|
||||||
|
.. _howto-clinic:
|
||||||
|
|
||||||
**********************
|
**********************
|
||||||
Argument Clinic How-To
|
Argument Clinic How-To
|
||||||
**********************
|
**********************
|
||||||
|
|
|
@ -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.
|
||||||
|
|
||||||
|
|
|
@ -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,
|
||||||
|
|
|
@ -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
|
|
||||||
|
|
|
@ -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__*
|
||||||
""""""""""""""""""""""""""
|
""""""""""""""""""""""""""
|
||||||
|
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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
|
||||||
~~~~
|
~~~~
|
||||||
|
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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>`_
|
|
||||||
|
|
||||||
..
|
..
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue