GH-107518: Remove the Argument Clinic How-To (#109900)

* Remove the content of the Argument Clinic HOWTO
* Update cross-references to the Argument Clinic
* Add a note directing readers to the devguide
This commit is contained in:
Adam Turner 2023-10-11 13:57:51 +01:00 committed by GitHub
parent f83fa0b9eb
commit d1f7fae424
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 18 additions and 2068 deletions

File diff suppressed because it is too large Load Diff

View File

@ -28,7 +28,6 @@ Currently, the HOWTOs are:
urllib2.rst
argparse.rst
ipaddress.rst
clinic.rst
instrumentation.rst
perf_profiling.rst
annotations.rst

View File

@ -123,7 +123,7 @@ There is a new function parameter syntax ``/`` to indicate that some
function parameters must be specified positionally and cannot be used as
keyword arguments. This is the same notation shown by ``help()`` for C
functions annotated with Larry Hastings'
:ref:`Argument Clinic <howto-clinic>` tool.
`Argument Clinic <devguide.python.org/development-tools/clinic/>`__ tool.
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

View File

@ -1,6 +1,8 @@
It is now possible to deprecate passing parameters positionally with
Argument Clinic, using the new ``* [from X.Y]`` syntax.
(To be read as *"keyword-only from Python version X.Y"*.)
See :ref:`clinic-howto-deprecate-positional` for more information.
See `documentation in the Python Developer's Guide
<https://devguide.python.org/development-tools/clinic/#clinic-howto-deprecate-positional>`__
for more information.
Patch by Erlend E. Aasland with help from Alex Waygood,
Nikita Sobolev, and Serhiy Storchaka.

View File

@ -1,2 +1,3 @@
Argument Clinic now supports overriding automatically generated signature by
using directive ``@text_signature``. See :ref:`clinic-howto-override-signature`.
using directive ``@text_signature``. See `documentation in the Python Developer's Guide
<https://devguide.python.org/development-tools/clinic/#clinic-howto-override-signature>`__

View File

@ -1,4 +1,6 @@
It is now possible to deprecate passing keyword arguments for
keyword-or-positional parameters with Argument Clinic, using the new ``/
[from X.Y]`` syntax. (To be read as *"positional-only from Python version
X.Y"*.) See :ref:`clinic-howto-deprecate-keyword` for more information.
X.Y"*.) See `documentation in the Python Developer's Guide
<https://devguide.python.org/development-tools/clinic/#clinic-howto-deprecate-keyword>`__
for more information.

View File

@ -1,3 +1,5 @@
:ref:`Argument Clinic <howto-clinic>` now has a partial support of the
:ref:`Limited API <limited-c-api>`: see :ref:`clinic-howto-limited-capi`.
`Argument Clinic <https://devguide.python.org/development-tools/clinic/>`__
now has a partial support of the :ref:`Limited API <limited-c-api>`: see
`documentation in the Python Developer's Guide
<https://devguide.python.org/development-tools/clinic/#clinic-howto-limited-capi>`__
Patch by Victor Stinner.