--- a/web/formfields.py	Fri Aug 26 17:28:32 2011 +0200
+++ b/web/formfields.py	Mon Sep 05 16:48:37 2011 +0200
@@ -148,7 +148,9 @@
        bool flag telling if this field is linked to a specific entity
     :attr:`role`
        when the field is linked to an entity attribute or relation, tells the
-       role of the entity in the relation (eg 'subject' or 'object')
+       role of the entity in the relation (eg 'subject' or 'object'). If this is
+       not an attribute or relation of the edited entity, `role` should be
+       `None`.
     :attr:`fieldset`
        optional fieldset to which this field belongs to
     :attr:`order`