Index: /main/waeup.sirp/trunk/src/waeup/sirp/browser/captcha.py
===================================================================
--- /main/waeup.sirp/trunk/src/waeup/sirp/browser/captcha.py	(revision 7298)
+++ /main/waeup.sirp/trunk/src/waeup/sirp/browser/captcha.py	(revision 7299)
@@ -189,4 +189,15 @@
 ##
 class IdCaptcha(object):
+    """The IdCaptcha allows all solutions that equal a challenge.
+
+    The challenge is a permutation of 'abcdefg'.
+
+    It is of no use for real world but for tests. In tests we cannot
+    easily solve really strong captchas. But we can use a captcha that
+    works like a real one but is easy to solve even for machines.
+
+    It is called IdCaptcha because solutions and challenges for this
+    captcha type are mapped by identitiy function.
+    """
     grok.implements(ICaptcha)
 
@@ -197,4 +208,6 @@
 
     def verify(self, request):
+        """Verify that a solution sent equals the challenge.
+        """
         form = getattr(request, 'form', {})
         solution=form.get(self.sol_field, None)
@@ -205,4 +218,6 @@
 
     def display(self, error_code=None):
+        """Display challenge and input field for solution as HTML.
+        """
         challenge = list('abcdef')
         random().shuffle(challenge)
