From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Mon, 15 Jun 2009 22:39:45 +0000 (+0000)
Subject: assoc proxy object appends to list automatically [ticket:1351]
X-Git-Tag: rel_0_5_5~14
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=adde312c2a774495d68819765cd07372e384efb6;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

assoc proxy object appends to list automatically [ticket:1351]
---

diff --git a/doc/build/reference/ext/associationproxy.rst b/doc/build/reference/ext/associationproxy.rst
index 37cee21799..87489a9e86 100644
--- a/doc/build/reference/ext/associationproxy.rst
+++ b/doc/build/reference/ext/associationproxy.rst
@@ -177,10 +177,12 @@ relation.
     user = User('log')
     kw1  = Keyword('new_from_blammo')
 
-    # Adding a Keyword requires creating a UserKeyword association object
-    user.user_keywords.append(UserKeyword(user, kw1))
+    # Creating a UserKeyword association object will add a Keyword.
+    # the "user" reference assignment in the UserKeyword() constructor
+    # populates "user_keywords" via backref.
+    UserKeyword(user, kw1)
 
-    # And accessing Keywords requires traversing UserKeywords
+    # Accessing Keywords requires traversing UserKeywords
     print user.user_keywords[0]
     # <__main__.UserKeyword object at 0xb79bbbec>