From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Sat, 9 Dec 2006 04:16:15 +0000 (+0000)
Subject: clarify docs for query.instances() [ticket:386]
X-Git-Tag: rel_0_3_2~4
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9fa58e7c3021824bd4de32eef92436f682b1d25c;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

clarify docs for query.instances() [ticket:386]
---

diff --git a/doc/build/content/adv_datamapping.txt b/doc/build/content/adv_datamapping.txt
index ffe09e06d1..b16b1853d8 100644
--- a/doc/build/content/adv_datamapping.txt
+++ b/doc/build/content/adv_datamapping.txt
@@ -662,32 +662,32 @@ Both TreeNode examples above are available in functional form in the `examples/a
 
 ### Result-Set Mapping {@name=resultset}
 
-Take any result set and feed it into a mapper to produce objects.  Multiple mappers can be combined to retrieve unrelated objects from the same row in one step.  The `instances` method on mapper takes a ResultProxy object, which is the result type generated from SQLEngine, and delivers object instances.
+Take any result set and feed it into a Query to produce objects.  Multiple mappers can be combined to retrieve unrelated objects from the same row in one step.  The `instances` method on Query takes a ResultProxy object, which is the result type generated from SQLEngine, and delivers object instances.  (note: this method has been moved off of Mapper, where it is deprecated).
 
     {python}
     class User(object):
         pass
 
-    User.mapper = mapper(User, users_table)
+    mapper(User, users_table)
     
     # select users
     c = users_table.select().execute()
 
     # get objects
-    userlist = User.mapper.instances(c)
+    userlist = session.query(User).instances(c)
     
     {python}
     # define a second class/mapper
     class Address(object):
         pass
         
-    Address.mapper = mapper(Address, addresses_table)
+    mapper(Address, addresses_table)
 
     # select users and addresses in one query
     s = select([users_table, addresses_table], users_table.c.user_id==addresses_table.c.user_id)
 
     # execute it, and process the results with the User mapper, chained to the Address mapper
-    r = User.mapper.instances(s.execute(), Address.mapper)
+    r = session.query(User).instances(s.execute(), class_mapper(Address))
     
     # result rows are an array of objects, one for each mapper used
     for entry in r: