From: Jess Robinson <castaway@desert-island.me.uk>
Date: Thu, 12 Mar 2009 22:33:42 +0000 (+0000)
Subject: Add doc on how conditions and attrs are merged when chaining.
X-Git-Tag: v0.08100~42
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=8dad109e6bb7fdaa9b97f9bbc3019ad94f1c7892;p=dbsrgits%2FDBIx-Class.git

Add doc on how conditions and attrs are merged when chaining.
---

diff --git a/lib/DBIx/Class/ResultSet.pm b/lib/DBIx/Class/ResultSet.pm
index 8854542..dd911ad 100644
--- a/lib/DBIx/Class/ResultSet.pm
+++ b/lib/DBIx/Class/ResultSet.pm
@@ -102,6 +102,21 @@ another.
     });
   }
 
+=head3 Resolving conditions and attributes
+
+When a resultset is chained from another resultset, conditions and
+attributes with the same keys need resolving.
+
+L</join>, L</prefetch>, L</+select>, L</+as> attributes are merged
+into the existing ones from the original resultset.
+
+The L</where>, L</having> attribute, and any search conditions are
+merged with an SQL C<AND> to the existing condition from the original
+resultset.
+
+All other attributes are overridden by any new ones supplied in the
+search attributes.
+
 =head2 Multiple queries
 
 Since a resultset just defines a query, you can do all sorts of