summaryrefslogtreecommitdiff
path: root/docs/userguide
diff options
context:
space:
mode:
authorAnderson Bravalheri <andersonbravalheri@gmail.com>2022-03-06 00:53:14 +0000
committerAnderson Bravalheri <andersonbravalheri@gmail.com>2022-03-09 15:07:57 +0000
commit2dab062b06422c271d69283dbc5a713c2a2a35c5 (patch)
treeb2cdd7441bef296ba6ab54c093abfc5a9a3b9f41 /docs/userguide
parente495568f12265a6fbc1a68e66331173dbf11d871 (diff)
downloadpython-setuptools-git-2dab062b06422c271d69283dbc5a713c2a2a35c5.tar.gz
Mark features related auto-discovery and pyproject metadata as experimental
Diffstat (limited to 'docs/userguide')
-rw-r--r--docs/userguide/package_discovery.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/userguide/package_discovery.rst b/docs/userguide/package_discovery.rst
index 99e45bed..16661a3f 100644
--- a/docs/userguide/package_discovery.rst
+++ b/docs/userguide/package_discovery.rst
@@ -46,6 +46,10 @@ the following sections.
Automatic discovery
===================
+.. warning:: Automatic discovery is an **experimental** future and might change
+ (or be completely removed) in the future.
+ See :ref:`custom-discovery` for a stable way of configuring ``setuptools``.
+
By default setuptools will consider 2 popular project layouts, each one with
its own set of advantages and disadvantages [#layout1]_ [#layout2]_.
@@ -166,6 +170,8 @@ Also note that you can customise your project layout by explicitly setting
place.
+.. custom-discovery::
+
Custom discovery
================