From: Dave Rolsky <autarch@houseabsolute.urth.org>
Date: Tue, 17 Mar 2009 15:32:58 +0000 (-0500)
Subject: docs for CMOP::Method::Constructor
X-Git-Tag: 0.80_01~37
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=3fd960d9ce7deb282c65c1e578376f0d4f4cbca0;p=gitmo%2FClass-MOP.git

docs for CMOP::Method::Constructor
---

diff --git a/lib/Class/MOP/Method/Constructor.pm b/lib/Class/MOP/Method/Constructor.pm
index 2aecc43..d027938 100644
--- a/lib/Class/MOP/Method/Constructor.pm
+++ b/lib/Class/MOP/Method/Constructor.pm
@@ -197,58 +197,58 @@ Class::MOP::Method::Constructor - Method Meta Object for constructors
 
 =head1 DESCRIPTION
 
-This is a subclass of C<Class::MOP::Method> which deals with
-class constructors. This is used when making a class immutable
-to generate an optimized constructor.
+This is a subclass of C<Class::MOP::Method> which generates
+constructor methods.
 
 =head1 METHODS
 
 =over 4
 
-=item B<new (metaclass => $meta, options => \%options)>
+=item B<< Class::MOP::Method::Constructor->new(%options) >>
 
-=item B<options>
+This creates a new constructor object. It accepts a hash reference of
+options.
 
-This returns the options HASH which is passed into C<new>.
+=over 8
 
-=item B<associated_metaclass>
+=item * metaclass
 
-This returns the metaclass which is passed into C<new>.
+This should be a L<Class::MOP::Class> object. It is required.
 
-=item B<attributes>
+=item * name
 
-This returns the list of attributes which are associated with the
-metaclass which is passed into C<new>.
+The method name (without a package name). This is required.
 
-=item B<meta_instance>
+=item * package_name
 
-This returns the meta instance which is associated with the
-metaclass which is passed into C<new>.
+The package name for the method. This is required.
 
-=item B<is_inline>
+=item * is_inline
 
-This returns a boolean, but since constructors are very rarely
-not inlined, this always returns true for now.
+This indicates whether or not the constructor should be inlined. This
+defaults to false.
 
-=item B<can_be_inlined>
+=back
 
-This method always returns true in this class. It exists so that
-subclasses (like in Moose) can override and do some sort of checking
-to determine whether or not inlining the constructor is safe.
+=item B<< $metamethod->is_inline >>
 
-=item B<initialize_body>
+Returns a boolean indicating whether or not the constructor is
+inlined.
 
-This creates the code reference for the constructor itself.
+=item B<< $metamethod->associated_metaclass >>
 
-=back
+This returns the L<Class::MOP::Class> object for the method.
 
-=head2 Method Generators 
+=item B<< $metamethod->is_inline >>
 
-=over 4
+Returns a boolean indicating whether or not the constructor is
+inlined.
 
-=item B<generate_constructor_method>
+=item B<< $metamethod->can_be_inlined >>
 
-=item B<generate_constructor_method_inline>
+This method always returns true in this class. It exists so that
+subclasses (as in Moose) can do some sort of checking to determine
+whether or not inlining the constructor is safe.
 
 =back
 
diff --git a/xt/pod_coverage.t b/xt/pod_coverage.t
index 1db4714..c63c4a7 100644
--- a/xt/pod_coverage.t
+++ b/xt/pod_coverage.t
@@ -73,6 +73,15 @@ my %trustme = (
             initialize_body
             )
     ],
+
+    'Class::MOP::Method::Accessor' => [
+        qw( attributes
+            generate_constructor_method
+            generate_constructor_method_inline
+            initialize_body
+            meta_instance
+            )
+    ],
 );
 
 for my $module ( sort @modules ) {