summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJason R. Coombs <jaraco@jaraco.com>2021-02-25 20:44:36 -0500
committerGitHub <noreply@github.com>2021-02-25 20:44:36 -0500
commitaad7fde133bf1cf67a0c50645d27f6a2004da612 (patch)
treef782d5e8b615fe31de982537a29b7f73efa57422 /docs
parent8dd11d18ab971599b809ea5dc62ad96c9abb92f5 (diff)
parent65db33b158a377a2d3f74ea28478a66a3097f273 (diff)
downloadpython-setuptools-git-aad7fde133bf1cf67a0c50645d27f6a2004da612.tar.gz
Merge pull request #2561 from pwoolvett/fix/2553
docs(userguide): Marker example for extras_require
Diffstat (limited to 'docs')
-rw-r--r--docs/userguide/declarative_config.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/userguide/declarative_config.rst b/docs/userguide/declarative_config.rst
index bc66869b..f2e8b81f 100644
--- a/docs/userguide/declarative_config.rst
+++ b/docs/userguide/declarative_config.rst
@@ -243,6 +243,19 @@ data_files dict 40.6.0
**find_namespace directive** - The ``find_namespace:`` directive is supported since Python >=3.3.
+
Notes:
1. In the ``package_data`` section, a key named with a single asterisk (``*``)
refers to all packages, in lieu of the empty string used in ``setup.py``.
+
+2. In the ``extras_require`` section, values are parsed as ``list-semi``. This implies that in
+order to include markers, they **must** be *dangling*:
+
+.. code-block:: ini
+
+ [options.extras_require]
+ rest = docutils>=0.3; pack ==1.1, ==1.3
+ pdf =
+ ReportLab>=1.2
+ RXP
+ importlib-metadata; python_version < "3.8"