From a490b4b0a6b3883378a8268013063c802e292bd1 Mon Sep 17 00:00:00 2001 From: James Date: Wed, 18 Oct 2023 09:57:20 -0500 Subject: [PATCH] Fix dead setuptools links (#22) * Fix dead setuptools links * More comprehensive phrasing re distutils * Link to top of document --- doc/source/cdef.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/source/cdef.rst b/doc/source/cdef.rst index 0253a498..13573ce2 100644 --- a/doc/source/cdef.rst +++ b/doc/source/cdef.rst @@ -80,7 +80,8 @@ In order of complexity: * Finally, you can (but don't have to) use CFFI's **Distutils** or **Setuptools integration** when writing a ``setup.py``. For - Distutils (only in out-of-line API mode): + Distutils (only in out-of-line API mode; deprecated since + Python 3.10): .. code-block:: python @@ -94,7 +95,7 @@ In order of complexity: ext_modules=[foo_build.ffibuilder.distutils_extension()], ) - For Setuptools (out-of-line, but works in ABI or API mode; + For Setuptools (out-of-line only, but works in ABI or API mode; recommended): .. code-block:: python @@ -431,9 +432,9 @@ list of extra .c files compiled and linked together (the file first argument to ``sources``). See the distutils documentations for `more information about the other arguments`__. -.. __: http://docs.python.org/distutils/setupscript.html#library-options -.. _distutils: http://docs.python.org/distutils/setupscript.html#describing-extension-modules -.. _setuptools: https://pythonhosted.org/setuptools/setuptools.html +.. __: https://setuptools.pypa.io/en/stable/userguide/ext_modules.html#building-extension-modules +.. _distutils: http://docs.python.org/3.11/distutils/setupscript.html#describing-extension-modules +.. _setuptools: https://setuptools.pypa.io/ An extra keyword argument processed internally is ``source_extension``, defaulting to ``".c"``. The file generated will