correct the documentation for required

diff --git a/lib/Moose.pm b/lib/Moose.pm
index e64915f..3c24df2 100644 (file)
--- a/lib/Moose.pm
+++ b/lib/Moose.pm
@@ -437,9 +437,11 @@ is expected to have consumed.
 
 =item I<required =E<gt> (1|0)>
 
-This marks the attribute as being required. This means a I<defined> value must be
-supplied during class construction, and the attribute may never be set to
-C<undef> with an accessor.
+This marks the attribute as being required. This means a value must be
+supplied during class construction or be lazy with either a default or a
+builder. Note that c<required> does not say anything about the attribute's
+value, so it could be C<undef>.
+
 
 =item I<weak_ref =E<gt> (1|0)>
 

diff --git a/lib/Moose/Manual/Attributes.pod b/lib/Moose/Manual/Attributes.pod
index 4ee76e5..174c624 100644 (file)
--- a/lib/Moose/Manual/Attributes.pod
+++ b/lib/Moose/Manual/Attributes.pod
@@ -160,9 +160,9 @@ required, simply set the C<required> option to true:
 There are a couple caveats worth mentioning in regards to what
 "required" actually means.
 
-Basically, all it says is that this attribute (C<name>) must be provided
-to the constructor. It does not say anything about its value, so it
-could be C<undef>.
+Basically, all it says is that this attribute (C<name>) must be provided to
+the constructor, or be lazy with either a default or a builder. It does not
+say anything about its value, so it could be C<undef>.
 
 If you define a clearer method on a required attribute, the clearer
 I<will> work, so even a required attribute can be unset after object