summaryrefslogtreecommitdiff
path: root/docs/userguide/pyproject_config.rst
diff options
context:
space:
mode:
authorAnderson Bravalheri <andersonbravalheri@gmail.com>2022-06-07 22:16:34 +0100
committerAnderson Bravalheri <andersonbravalheri@gmail.com>2022-06-16 21:37:17 +0100
commit2734a357dad91dcddf3a8e4e5779c5e68da621eb (patch)
tree829efa1370f4cdcf9bd88dde258e46cad1810db5 /docs/userguide/pyproject_config.rst
parent61b941337ece67ef766b549c4147137988c4cdb7 (diff)
downloadpython-setuptools-git-2734a357dad91dcddf3a8e4e5779c5e68da621eb.tar.gz
Clarify warnings and notes in documentation about experimental pyproject.toml
Diffstat (limited to 'docs/userguide/pyproject_config.rst')
-rw-r--r--docs/userguide/pyproject_config.rst13
1 files changed, 6 insertions, 7 deletions
diff --git a/docs/userguide/pyproject_config.rst b/docs/userguide/pyproject_config.rst
index 8558f5d7..dcf284d5 100644
--- a/docs/userguide/pyproject_config.rst
+++ b/docs/userguide/pyproject_config.rst
@@ -4,13 +4,7 @@
Configuring setuptools using ``pyproject.toml`` files
-----------------------------------------------------
-.. note:: New in 61.0.0 (**experimental**)
-
-.. warning::
- Support for declaring :doc:`project metadata
- <PyPUG:specifications/declaring-project-metadata>` or configuring
- ``setuptools`` via ``pyproject.toml`` files is still experimental and might
- change in future releases.
+.. note:: New in 61.0.0
.. important::
For the time being, ``pip`` still might require a ``setup.py`` file
@@ -75,6 +69,11 @@ The ``project`` table contains metadata fields as described by
Setuptools-specific configuration
=================================
+.. warning::
+ Support for declaring configurations not standardized by :pep:`621`
+ (i.e. the ``[tool.setuptools]`` table),
+ is still **experimental** and might change in future releases.
+
While the standard ``project`` table in the ``pyproject.toml`` file covers most
of the metadata used during the packaging process, there are still some
``setuptools``-specific configurations that can be set by users that require