I think this is a bit clearer: "within the same query", makes it sound like one SQL...

diff --git a/lib/sqlalchemy/orm/__init__.py b/lib/sqlalchemy/orm/__init__.py
index c69fabf14c6774d4c8786e5e5367cf52971d210f..d616a07653743f5dff83a61bf1489c5d03ea8743 100644 (file)
--- a/lib/sqlalchemy/orm/__init__.py
+++ b/lib/sqlalchemy/orm/__init__.py
@@ -425,10 +425,9 @@ def relationship(argument, secondary=None, **kwargs):
         the join is "outer" or not is determined by the ``innerjoin``
         parameter.
 
-      * ``subquery`` - items should be loaded "eagerly" within the same
-        query as that of the parent, using a second SQL statement
-        which issues a JOIN to a subquery of the original
-        statement.
+      * ``subquery`` - items should be loaded "eagerly" as the parents are
+        loaded, using one additional SQL statement, which issues a JOIN to a
+        subquery of the original statement, for each collection requested.
 
       * ``noload`` - no loading should occur at any time.  This is to
         support "write-only" attributes, or attributes which are