Document ATTR_QUERY_LIMIT

manual/new/docs/en/dql-doctrine-query-language/limit-and-offset-clauses.txt

@@ -17,7 +17,7 @@ foreach($users as $user) {
 
 Propably the most complex feature DQL parser has to offer is its LIMIT clause parser. Not only does the DQL LIMIT clause parser take care of LIMIT database portability it is capable of limiting the number of records instead of rows by using complex query analysis and subqueries.  
 
-
+
 +++ Driver portability
 
 DQL LIMIT clause is portable on all supported databases. Special attention have been paid to following facts:
@@ -28,10 +28,16 @@ DQL LIMIT clause is portable on all supported databases. Special attention have
 * Pgsql needs the order by fields to be preserved in SELECT clause, hence LS-algorithm needs to take this into consideration when pgsql driver is used
 * Oracle only allows < 30 object identifiers (= table/column names/aliases), hence the limit subquery must use as short aliases as possible and it must avoid alias collisions with the main query.
 
-
+
 +++ The limit-subquery-algorithm
 
-The limit-subquery-algorithm is an algorithm that DQL parser uses internally when one-to-many / many-to-many relational data is being fetched simultaneously. This kind of special algorithm is needed for the LIMIT clause to limit the number of records instead of sql result set rows. 
+The limit-subquery-algorithm is an algorithm that DQL parser uses internally when one-to-many / many-to-many relational data is being fetched simultaneously. This kind of special algorithm is needed for the LIMIT clause to limit the number of records instead of sql result set rows.
+
+This behaviour can be overwritten using the configuration system (at global, connection or table level) using:
+<code type="php">
+$table->setAttribute(Doctrine::ATTR_QUERY_LIMIT, Doctrine::LIMIT_ROWS);
+$table->setAttribute(Doctrine::ATTR_QUERY_LIMIT, Doctrine::LIMIT_RECORDS); // revert
+</code>
 
 In the following example we have users and phonenumbers with their relation being one-to-many. Now lets say we want fetch the first 20 users and all their related phonenumbers.