summaryrefslogtreecommitdiff
path: root/docs/deprecated
diff options
context:
space:
mode:
authorJason R. Coombs <jaraco@jaraco.com>2021-11-07 04:51:27 -0500
committerGitHub <noreply@github.com>2021-11-07 04:51:27 -0500
commit8af23a41194ae747faf3e60f9cc19141b5e7ad24 (patch)
treec72f6115bb7915d1f1ca5f2b72b3932eaef0babb /docs/deprecated
parentdec4d0b3edd20614dced9c5c9203e755a4f9addd (diff)
parent172ea3681ce1f2b7da1044c5215cb8058b866324 (diff)
downloadpython-setuptools-git-8af23a41194ae747faf3e60f9cc19141b5e7ad24.tar.gz
Merge pull request #2858 from abravalheri/issue-2698
Re-export `errors` from `distutils`
Diffstat (limited to 'docs/deprecated')
-rw-r--r--docs/deprecated/distutils-legacy.rst9
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/deprecated/distutils-legacy.rst b/docs/deprecated/distutils-legacy.rst
index a5d96260..94104fe8 100644
--- a/docs/deprecated/distutils-legacy.rst
+++ b/docs/deprecated/distutils-legacy.rst
@@ -18,8 +18,17 @@ As Distutils is deprecated, any usage of functions or objects from distutils is
``distutils.cmd.Command`` → ``setuptools.Command``
+``distutils.command.{build_clib,build_ext,build_py,sdist}`` → ``setuptools.command.*``
+
``distutils.log`` → (no replacement yet)
``distutils.version.*`` → ``packaging.version.*``
+``distutils.errors.*`` → ``setuptools.errors.*`` [#errors]_
+
If a project relies on uses of ``distutils`` that do not have a suitable replacement above, please search the `Setuptools issue tracker <https://github.com/pypa/setuptools/issues/>`_ and file a request, describing the use-case so that Setuptools' maintainers can investigate. Please provide enough detail to help the maintainers understand how distutils is used, what value it provides, and why that behavior should be supported.
+
+
+.. [#errors] Please notice errors related to the command line usage of
+ ``setup.py``, such as ``DistutilsArgError``, are intentionally not exposed
+ by setuptools, since this is considered a deprecated practice.