From: Jay Kuri <jayk@jay-kuris-macbook.local>
Date: Tue, 23 Jun 2009 21:23:02 +0000 (-0600)
Subject: Doc patch to better explain BUILD arguments better
X-Git-Tag: 0.84~46
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=f882492b6f1c403a8ec0a698aa23e1b39c252ed9;p=gitmo%2FMoose.git

Doc patch to better explain BUILD arguments better
---

diff --git a/lib/Moose/Manual/Construction.pod b/lib/Moose/Manual/Construction.pod
index 5baad74..fe18792 100644
--- a/lib/Moose/Manual/Construction.pod
+++ b/lib/Moose/Manual/Construction.pod
@@ -91,6 +91,13 @@ object creation.
       debug( 'Made a new person - SSN = ', $self->ssn, );
   }
 
+Note that while it is not shown here, the C<BUILD> method receives  
+not only the created object, but also a hashref of the original 
+arguments passed to new (or the results of your C<BUILDARGS>, 
+if you have overridden the default C<BUILDARGS>.)  This can be 
+useful if you need to venture beyond what the default 
+initialization behavior and coercions can accomplish.
+
 =head3 BUILD and parent classes
 
 The interaction between multiple C<BUILD> methods in an inheritance