--- a/configmix/config.py	Sat Mar 24 22:09:44 2018 +0100
+++ b/configmix/config.py	Sun Mar 25 16:45:15 2018 +0200
@@ -55,10 +55,11 @@
     """
 
     def getvar(self, varname, default=_MARKER):
-        """Get a variable of the form ``[[ns1.]ns2.]name`` - including
+        """Get a variable of the form ``[ns:][[key1.]key2.]name`` - including
         variables from other namespaces.
 
         No variable expansion is done and no filters are applied.
+
         """
         varns, varname = self._split_ns(varname)
         try:
@@ -78,7 +79,12 @@
     def getvar_s(self, varname, default=_MARKER):
         """Get a variable - including variables from other namespaces.
 
-        Variables will be substituted recursively in the result.
+        `varname` is interpreted as in :meth:`.getvar`. But variables
+        will be expanded recursively within the variable values and
+        filters are applied.
+
+        For more details see chapter :ref:`variable-expansion`.
+
         """
         try:
             obj = self.getvar(varname)