Merge commit 'd6bcf5e' into feature/2093-docs-revamp

1 files changed, 8 insertions, 2 deletions

diff --git a/docs/userguide/declarative_config.txt b/docs/userguide/declarative_config.txt
index b40d3a4a..2aa1c717 100644
--- a/docs/userguide/declarative_config.txt
+++ b/docs/userguide/declarative_config.txt
@@ -92,7 +92,7 @@ Metadata and options are set in the config sections of the same name.
 * In some cases, complex values can be provided in dedicated subsections for
   clarity.
 
-* Some keys allow ``file:``, ``attr:``, and ``find:`` and ``find_namespace:`` directives in
+* Some keys allow ``file:``, ``attr:``, ``find:``, and ``find_namespace:`` directives in
   order to cover common usecases.
 
 * Unknown keys are ignored.
@@ -146,6 +146,12 @@ Special directives:
 
 * ``attr:`` - Value is read from a module attribute.  ``attr:`` supports
   callables and iterables; unsupported types are cast using ``str()``.
+
+  In order to support the common case of a literal value assigned to a variable
+  in a module containing (directly or indirectly) third-party imports,
+  ``attr:`` first tries to read the value from the module by examining the
+  module's AST.  If that fails, ``attr:`` falls back to importing the module.
+
 * ``file:`` - Value is read from a list of files and then concatenated
 
 
@@ -237,4 +243,4 @@ data_files               dict                                 40.6.0
 
 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`.
\ No newline at end of file
+refers to all packages, in lieu of the empty string used in `setup.py`.