summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--changelog.d/2553.doc.rst1
-rw-r--r--docs/userguide/declarative_config.rst13
2 files changed, 14 insertions, 0 deletions
diff --git a/changelog.d/2553.doc.rst b/changelog.d/2553.doc.rst
new file mode 100644
index 00000000..fa03329a
--- /dev/null
+++ b/changelog.d/2553.doc.rst
@@ -0,0 +1 @@
+Added userguide example for markers in extras_require -- by :user:`pwoolvett`
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"