From: Jess Robinson <castaway@desert-island.me.uk>
Date: Wed, 2 Dec 2009 13:19:40 +0000 (+0000)
Subject: Added note about prefetch and has_many related objects
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=4c4964c14a9d0b6568102ee9e2dcb14f3bb0fd17;p=dbsrgits%2FDBIx-Class-Historic.git

Added note about prefetch and has_many related objects
---

diff --git a/lib/DBIx/Class/Manual/Joining.pod b/lib/DBIx/Class/Manual/Joining.pod
index 3ad2064..0cf86bd 100644
--- a/lib/DBIx/Class/Manual/Joining.pod
+++ b/lib/DBIx/Class/Manual/Joining.pod
@@ -106,6 +106,11 @@ Another common use for joining to related tables, is to fetch the data
 from both tables in one query, preventing extra round-trips to the
 database. See the example above in L</WHAT ARE JOINS>.
 
+Three techniques are described here. Of the three, only the
+C<prefetch> technique will deal sanely with fetching related objects
+over a C<has_many> relation. The others work fine for 1 to 1 type
+relationships.
+
 =head2 Whole related objects
 
 To fetch entire related objects, eg CDs and all Track data, use the