- add a mention of attributeevents in the validates doc

diff --git a/doc/build/orm/mapper_config.rst b/doc/build/orm/mapper_config.rst
index d69cff6426ba0070ffc52e32d2f8638efddbd7f5..a88f3d7e7522377428547356b4f74f4873b39ad6 100644 (file)
--- a/doc/build/orm/mapper_config.rst
+++ b/doc/build/orm/mapper_config.rst
@@ -386,6 +386,11 @@ Validators also receive collection events, when items are added to a collection:
             assert '@' in address.email
             return address
 
+Note that the :func:`~.validates` decorator is a convenience function built on 
+top of attribute events.   An application that requires more control over
+configuration of attribute change behavior can make use of this system,
+described at :class:`~.AttributeEvents`.
+
 .. autofunction:: validates
 
 .. _synonyms: