summaryrefslogtreecommitdiff
path: root/docs/deprecated
diff options
context:
space:
mode:
authorAnderson Bravalheri <andersonbravalheri@gmail.com>2022-11-23 14:01:46 +0000
committerAnderson Bravalheri <andersonbravalheri@gmail.com>2022-11-23 14:01:46 +0000
commit917b7613d5a1917035389c30516677bab2d81ba4 (patch)
tree06de98f809c340821e113c4a01d86cc10eb2760e /docs/deprecated
parenta79f3473bb84ee1cc5af6996d1aee81c99d21175 (diff)
parent0e24a27d322e52082167cc2ac01859b4d885a4e6 (diff)
downloadpython-setuptools-git-917b7613d5a1917035389c30516677bab2d81ba4.tar.gz
Docs: Add note about global `distutils.cfg` (#3689)
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 e106ce97..63c8ff07 100644
--- a/docs/deprecated/distutils-legacy.rst
+++ b/docs/deprecated/distutils-legacy.rst
@@ -7,6 +7,15 @@ Since the 60.0.0 release, Setuptools includes a local, vendored copy of distutil
SETUPTOOLS_USE_DISTUTILS=stdlib
+.. warning::
+ Please note that this also affects how ``distutils.cfg`` files inside stdlib's ``distutils``
+ package directory are processed.
+ Unless ``SETUPTOOLS_USE_DISTUTILS=stdlib``, they will have no effect on the build process.
+
+ You can still use a global user config file, ``~/.pydistutils.cfg`` (POSIX) or ``%USERPROFILE%/pydistutils.cfg`` (Windows),
+ or use the environment variable :doc:`DIST_EXTRA_CONFIG <deprecated/distutils/configfile>` to point to another
+ supplementary configuration file.
+
Prefer Setuptools
-----------------