--- a/common/mixins.py	Mon Nov 23 14:13:53 2009 +0100
+++ b/common/mixins.py	Thu Dec 03 17:17:43 2009 +0100
@@ -194,7 +194,12 @@
         return dict( (attr, getattr(self, attr)) for attr in self.allowed_massmail_keys() )
 
 
+"""pluggable mixins system: plug classes registered in MI_REL_TRIGGERS on entity
+classes which have the relation described by the dict's key.
 
+NOTE: pluggable mixins can't override any method of the 'explicit' user classes tree
+(eg without plugged classes). This includes bases Entity and AnyEntity classes.
+"""
 MI_REL_TRIGGERS = {
     ('primary_email',   'subject'): EmailableMixIn,
     ('use_email',   'subject'): EmailableMixIn,