summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPablo Woolvett <pablowoolvett@gmail.com>2021-02-04 13:59:15 -0300
committerPablo Woolvett <pablowoolvett@gmail.com>2021-02-04 13:59:15 -0300
commit14f91af8370eaa1c7c7c19510aa9d4d5a65c069d (patch)
treeacb459452c1b0e4e42fb75cbdd1dbb068cbd563c
parentc121d289da5d19cf6df2bf6b64ac28916a060161 (diff)
downloadpython-setuptools-git-14f91af8370eaa1c7c7c19510aa9d4d5a65c069d.tar.gz
docs(userguide): Marker example for extras_require
Signed-off-by: Pablo Woolvett <pablowoolvett@gmail.com>
-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"