[Zope3-checkins] SVN: Zope3/trunk/src/zope/app/registration/browser/ add docstrings and comments

[Fred L. Drake, Jr.]

Log message for revision 27753:
  add docstrings and comments


Changed:
  U   Zope3/trunk/src/zope/app/registration/browser/__init__.py
  U   Zope3/trunk/src/zope/app/registration/browser/configure.zcml


-=-
Modified: Zope3/trunk/src/zope/app/registration/browser/__init__.py
===================================================================
--- Zope3/trunk/src/zope/app/registration/browser/__init__.py	2004-10-05 18:10:17 UTC (rev 27752)
+++ Zope3/trunk/src/zope/app/registration/browser/__init__.py	2004-10-05 18:13:50 UTC (rev 27753)
@@ -33,7 +33,13 @@
 from zope.security.proxy import removeSecurityProxy
 
 class RegistrationView(BrowserView):
+    """View for registerable objects that have at most one registration.
 
+    If the object has more than one registration, this performs a
+    redirection to the 'registrations.html' view.
+
+    """
+
     def __init__(self, context, request):
         super(RegistrationView, self).__init__(context, request)
         useconfig = IRegistered(self.context)
@@ -68,6 +74,7 @@
 
 
 class Registered(object):
+    """View for registerable objects that more than one registration."""
 
     def __init__(self, context, request):
         self.context = context

Modified: Zope3/trunk/src/zope/app/registration/browser/configure.zcml
===================================================================
--- Zope3/trunk/src/zope/app/registration/browser/configure.zcml	2004-10-05 18:10:17 UTC (rev 27752)
+++ Zope3/trunk/src/zope/app/registration/browser/configure.zcml	2004-10-05 18:13:50 UTC (rev 27753)
@@ -67,7 +67,11 @@
       class="zope.app.exception.browser.user.UserErrorView" />
 
 
-<!-- Generic page for objects that keep track of their registrations -->
+<!-- Generic page for objects that keep track of their registrations.
+     Objects that need to override one of these may need to override
+     both.  The "registrations.html" page is only used for objects
+     that have more than one registration.
+     -->
 
   <page
       for="zope.app.registration.interfaces.IRegisterable"