this speling test is really useful. fixed a whole bunch of types in the cookbook

[gitmo/Moose.git] / lib / Moose / Manual / Classes.pod

diff --git a/lib/Moose/Manual/Classes.pod b/lib/Moose/Manual/Classes.pod
index d91e41a..f2cd397 100644 (file)
--- a/lib/Moose/Manual/Classes.pod
+++ b/lib/Moose/Manual/Classes.pod
@@ -66,7 +66,7 @@ classes, C<extends>:
 
   has 'username' => ( is => 'rw' );
 
-ote, that each call to C<extends> will I<reset> your parents. For
+Note that each call to C<extends> will I<reset> your parents. For
 multiple inheritance you must provide all the parents at once,
 C<extends 'Foo', 'Bar'>.
 
@@ -103,6 +103,18 @@ class's metaclass object.
 
   __PACKAGE__->meta->make_immutable;
 
+=head2 Immutabilization and C<new()>
+
+If you override C<new()> in your class, then the immutabilization code
+will not be able to provide an optimized constructor for your
+class. Instead, you should use C<BUILD()> method, which will be called
+from the inlined constructor.
+
+Alternately, if you really need to provide a different C<new()>, you
+can also provide your own immutabilization method. Doing so requires
+extending the Moose metaclasses, and is well beyond the scope of this
+manual.
+
 =head1 AUTHOR
 
 Dave Rolsky E<lt>autarch@urth.orgE<gt>