Index: /waeup/branches/ulif-rewrite/src/waeup/permissions.txt
===================================================================
--- /waeup/branches/ulif-rewrite/src/waeup/permissions.txt	(revision 4127)
+++ /waeup/branches/ulif-rewrite/src/waeup/permissions.txt	(revision 4127)
@@ -0,0 +1,21 @@
+WAeUP permissions and roles
+***************************
+
+Permissions and roles used in a WAeUP portal.
+
+:Test-Layer: unit
+
+
+Before we can do something useful with roles and permissions, we have
+to register them. This can be done simply by grokking the `waeup`
+package:
+
+    >>> import grok
+    >>> grok.testing.grok('waeup')
+
+We can get all roles defined in a WAeUP portal:
+
+    >>> from waeup.permissions import getRoles
+    >>> getRoles()
+    ['waeup.PortalManager', 'waeup.PortalUser']
+
