--- a/selectors.py	Fri Apr 02 16:10:17 2010 +0200
+++ b/selectors.py	Fri Apr 02 16:10:35 2010 +0200
@@ -74,6 +74,9 @@
         print '%s -> %s for %s(%s)' % (selname, ret, vobj, vobj.__regid__)
 
 def lltrace(selector):
+    """use this decorator on your selectors so the becomes traceable with
+    :class:`traced_selection`
+    """
     # don't wrap selectors if not in development mode
     if CubicWebConfiguration.mode == 'system': # XXX config.debug
         return selector