--- a/req.py	Mon Apr 07 15:57:47 2014 +0200
+++ b/req.py	Fri Apr 25 12:22:07 2014 +0200
@@ -345,7 +345,20 @@
 
     @cached
     def user_data(self):
-        """returns a dictionary with this user's information"""
+        """returns a dictionary with this user's information.
+
+        The keys are :
+
+        login
+            The user login
+
+        name
+            The user name, returned by user.name()
+
+        email
+            The user principal email
+
+        """
         userinfo = {}
         user = self.user
         userinfo['login'] = user.login