# HG changeset patch
# User Sylvain Thénault <sylvain.thenault@logilab.fr>
# Date 1259313791 -3600
# Node ID 0585694c189676a7a5fe309501111f254a9d2c9a
# Parent  25d5830b953182209da66e1ec96655805f48fbd9
some doc

diff -r 25d5830b9531 -r 0585694c1896 common/mixins.py
--- a/common/mixins.py	Fri Nov 27 09:36:58 2009 +0100
+++ b/common/mixins.py	Fri Nov 27 10:23:11 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,