add docs for various service managers

keystone/catalog.py

@@ -1,5 +1,7 @@
 # vim: tabstop=4 shiftwidth=4 softtabstop=4
 
+"""Main entry point into the Catalog service."""
+
 from keystone import config
 from keystone import manager
 
@@ -8,5 +10,15 @@ CONF = config.CONF
 
 
 class Manager(manager.Manager):
+    """Default pivot point for the Catalog backend.
+
+    See :mod:`keystone.manager.Manager` for more details on how this
+    dynamically calls the backend.
+
+    See :mod:`keystone.backends.base.Catalog` for more details on the
+    interface provided by backends.
+
+    """
+
     def __init__(self):
         super(Manager, self).__init__(CONF.catalog.driver)

keystone/ec2.py

@@ -1,5 +1,7 @@
 # vim: tabstop=4 shiftwidth=4 softtabstop=4
 
+"""Main entry point into the EC2 Credentials service."""
+
 from keystone import config
 from keystone import manager
 
@@ -8,5 +10,15 @@ CONF = config.CONF
 
 
 class Manager(manager.Manager):
+    """Default pivot point for the EC2 Credentials backend.
+
+    See :mod:`keystone.manager.Manager` for more details on how this
+    dynamically calls the backend.
+
+    See :mod:`keystone.backends.base.Ec2` for more details on the
+    interface provided by backends.
+
+    """
+
     def __init__(self):
         super(Manager, self).__init__(CONF.ec2.driver)

keystone/identity.py

@@ -12,7 +12,13 @@ CONF = config.CONF
 class Manager(manager.Manager):
     """Default pivot point for the Identity backend.
 
-    See :mod:`keystone.manager.Manager` for more details.
+    See :mod:`keystone.manager.Manager` for more details on how this
+    dynamically calls the backend.
+
+    See :mod:`keystone.backends.base.Identity` for more details on the
+    interface provided by backends.
+
     """
+
     def __init__(self):
         super(Manager, self).__init__(CONF.identity.driver)

keystone/policy.py

@@ -1,5 +1,7 @@
 # vim: tabstop=4 shiftwidth=4 softtabstop=4
 
+"""Main entry point into the Policy service."""
+
 from keystone import config
 from keystone import manager
 
@@ -8,5 +10,15 @@ CONF = config.CONF
 
 
 class Manager(manager.Manager):
+    """Default pivot point for the Policy backend.
+
+    See :mod:`keystone.manager.Manager` for more details on how this
+    dynamically calls the backend.
+
+    See :mod:`keystone.backends.base.Policy` for more details on the
+    interface provided by backends.
+
+    """
+
     def __init__(self):
         super(Manager, self).__init__(CONF.policy.driver)

keystone/token.py

@@ -1,5 +1,7 @@
 # vim: tabstop=4 shiftwidth=4 softtabstop=4
 
+"""Main entry point into the Token service."""
+
 from keystone import config
 from keystone import manager
 
@@ -8,5 +10,15 @@ CONF = config.CONF
 
 
 class Manager(manager.Manager):
+    """Default pivot point for the Token backend.
+
+    See :mod:`keystone.manager.Manager` for more details on how this
+    dynamically calls the backend.
+
+    See :mod:`keystone.backends.base.Token` for more details on the
+    interface provided by backends.
+
+    """
+
     def __init__(self):
         super(Manager, self).__init__(CONF.token.driver)