--- a/docs/introduction.rst	Wed Nov 10 02:43:23 2021 +0100
+++ b/docs/introduction.rst	Wed Nov 10 09:37:44 2021 +0100
@@ -256,7 +256,9 @@
 possible variables names and return the first one that is found.
 
 For example -- these methods for retrieving the first found variables
-can be used and are equivalent::
+can be used and are equivalent (Note that a caller that wants to use
+variables from a non-default namespace must use a sequence of dicts
+here)::
 
   value1 = config.getfirstvar_s("key1.subkey2", "key3.subkey4", default=None, namespace=None)
   value2 = config.getfirstvarl_s(*[["key1", "subkey2"], ["key3", "subkey4"]], default=None)