This will tell the class to store the value of this attribute as a weakened
reference. If an attribute is a weakened reference, it B<cannot> also be
-coerced. Note that when a weak ref expires, the attribute is still considered
-to be set for purposes of predicate, default, etc.
+coerced. Note that when a weak ref expires, the attribute's value becomes
+undefined, and is still considered to be set for purposes of predicate,
+default, etc.
=item I<lazy =E<gt> (1|0)>
Creates a method to perform a basic test to see if a value has been set in the
attribute. See the L<predicate option docs in
Class::MOP::Attribute|Class::MOP::Attribute/predicate> for more information.
-Note that the predicate will return true even for a C<weak_ref> attribute whose
-value has expired.
+
+Note that the predicate will return true even for a C<weak_ref> attribute
+whose value has expired.
=item I<lazy_build> => (0|1)