From: Ben Hutton <relequestual@gmail.com>
Date: Thu, 7 Aug 2014 10:17:42 +0000 (+0100)
Subject: Add extra doc line expanding on the role of the prefetch attribute
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=556e90d7851914e1c55c4be665cd2acf91df1f7e;p=dbsrgits%2FDBIx-Class-Historic.git

Add extra doc line expanding on the role of the prefetch attribute
---

diff --git a/lib/DBIx/Class.pm b/lib/DBIx/Class.pm
index 91e2807..05f2f49 100644
--- a/lib/DBIx/Class.pm
+++ b/lib/DBIx/Class.pm
@@ -510,6 +510,8 @@ rafl: Florian Ragwitz <rafl@debian.org>
 
 rainboxx: Matthias Dietrich <perl@rb.ly>
 
+Relequestual: Ben Hutton <relequestual@gmail.com>
+
 rbo: Robert Bohne <rbo@cpan.org>
 
 rbuels: Robert Buels <rmb32@cornell.edu>
diff --git a/lib/DBIx/Class/ResultSet.pm b/lib/DBIx/Class/ResultSet.pm
index cdbbd6c..d15696d 100644
--- a/lib/DBIx/Class/ResultSet.pm
+++ b/lib/DBIx/Class/ResultSet.pm
@@ -4366,8 +4366,10 @@ For a more in-depth discussion, see L</PREFETCHING>.
 
 This attribute is a shorthand for specifying a L</join> spec, adding all
 columns from the joined related sources as L</+columns> and setting
-L</collapse> to a true value. For example, the following two queries are
-equivalent:
+L</collapse> to a true value. It can be thought of as a rough B<superset>
+of the L</join> attribute.
+
+For example, the following two queries are equivalent:
 
   my $rs = $schema->resultset('Artist')->search({}, {
     prefetch => { cds => ['genre', 'tracks' ] },