From a9a5400313089a48c9e8eebdbdde62d79682e982 Mon Sep 17 00:00:00 2001
From: "Jason R. Coombs" <jaraco@jaraco.com>
Date: Mon, 1 Jul 2024 10:05:17 -0400
Subject: [PATCH] Add a section on interpolation.

Closes #1648
---
 docs/userguide/declarative_config.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/userguide/declarative_config.rst b/docs/userguide/declarative_config.rst
index 342f18460e..2f650e1746 100644
--- a/docs/userguide/declarative_config.rst
+++ b/docs/userguide/declarative_config.rst
@@ -133,6 +133,24 @@ value associated with ``""`` in the ``package_dir`` dictionary.
    Please see :doc:`package discovery </userguide/package_discovery>` for more
    details.
 
+Interpolation
+=============
+
+Config files are parsed using :mod:`configparser` with
+`interpolation <https://docs.python.org/3/library/configparser.html#interpolation-of-values>`_
+enabled. As a result, one config value may reference another. This
+feature may be used, for example, in defining extras:
+
+.. code-block:: ini
+
+    [options.extras_require]
+    tester =
+        pytest==3.3.2
+        pytest-sugar
+    dev =
+        pytest-xdist
+        %(tester)s
+
 Specifying values
 =================