From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Thu, 30 Jun 2011 14:18:37 +0000 (-0400)
Subject: - add a mention of attributeevents in the validates doc
X-Git-Tag: rel_0_7_2~43
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=aaa3cebe7224231ca396b1dc812525336dde745e;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

- 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 d69cff6426..a88f3d7e75 100644
--- 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: