# HG changeset patch
# User Franz Glasner <fzglas.hg@dom66.de>
# Date 1637270945 -3600
# Node ID 88239f28415c550740a68eb9aea0908a017648bc
# Parent  a50f8fb16b05e51a3eae9a3a80a9d155ad3700dc
Docs

diff -r a50f8fb16b05 -r 88239f28415c configmix/config.py
--- a/configmix/config.py	Thu Nov 18 22:14:34 2021 +0100
+++ b/configmix/config.py	Thu Nov 18 22:29:05 2021 +0100
@@ -654,6 +654,9 @@
     def jailed(self, rootpath=None, root=None):
         """Return a "jailed" configuration.
 
+        :return: a jailed (aka restricted) configuration
+        :rtype: _JailedConfiguration
+
         """
         if rootpath is not None and root is not None:
             raise ValueError("only one of `rootpath' or `root' can be given")
@@ -675,7 +678,11 @@
 
 class _JailedConfiguration(object):
 
-    """Chrooted into a subtree of the configuration  -- no namespace support"""
+    """A jailed and restricted variant of :class:`Configuration`.
+
+    No namespace support.
+
+    """
 
     __slots__ = ("_base", "_path", "_pathstr")
 
diff -r a50f8fb16b05 -r 88239f28415c docs/apidoc.rst
--- a/docs/apidoc.rst	Thu Nov 18 22:14:34 2021 +0100
+++ b/docs/apidoc.rst	Thu Nov 18 22:29:05 2021 +0100
@@ -28,6 +28,11 @@
 .. automodule:: configmix.config
    :members:
    :ignore-module-all:
+   :private-members: _JailedConfiguration
+
+   .. autoclass:: _JailedConfiguration
+      :members:
+      :undoc-members:
 
 
 Module :mod:`configmix.constants`