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

Doc/howto/index.rst

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

Doc/whatsnew/3.8.rst

@@ -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

Misc/NEWS.d/next/Tools-Demos/2022-07-23-00-33-28.gh-issue-95065.NfCCpp.rst

@@ -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.

Misc/NEWS.d/next/Tools-Demos/2023-08-07-16-30-48.gh-issue-95065.-im4R5.rst

@@ -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>`__

Misc/NEWS.d/next/Tools-Demos/2023-08-15-19-50-49.gh-issue-107704.Uu84vd.rst

@@ -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.

Misc/NEWS.d/next/Tools-Demos/2023-08-25-22-40-12.gh-issue-108494.4RbDdu.rst

@@ -1,3 +1,5 @@
-:ref:`Argument Clinic <howto-clinic>` now has a partial support of the
+`Argument Clinic <https://devguide.python.org/development-tools/clinic/>`__
-:ref:`Limited API <limited-c-api>`: see :ref:`clinic-howto-limited-capi`.
+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.