From a04edbe7e4b59a2af7b714196f9fe5f25dec20c2 Mon Sep 17 00:00:00 2001 From: Anderson Bravalheri Date: Thu, 17 Nov 2022 14:00:31 +0000 Subject: [PATCH] Add note about global distutils.cfg --- docs/deprecated/distutils-legacy.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/deprecated/distutils-legacy.rst b/docs/deprecated/distutils-legacy.rst index e106ce97b4..63c8ff07c0 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 ` to point to another + supplementary configuration file. + Prefer Setuptools -----------------