[libclass-tiny-perl] 16/19: document prepare_class and create_attributes

[gregor herrmann]

This is an automated email from the git hooks/post-receive script.

gregoa pushed a commit to annotated tag release-0.004
in repository libclass-tiny-perl.

commit 0edb30615e86052a7dc195871079751542c36b3a
Author: David Golden <dagolden at cpan.org>
Date:   Wed Aug 21 16:29:18 2013 -0400

    document prepare_class and create_attributes
---
 README.pod        | 7 ++++++-
 lib/Class/Tiny.pm | 7 ++++++-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/README.pod b/README.pod
index b51a010..a9e51a2 100644
--- a/README.pod
+++ b/README.pod
@@ -239,7 +239,7 @@ values and errors are ignored.
         $self->cleanup();
     }
 
-=head2 Introspection
+=head2 Introspection and internals
 
 You can retrieve an unsorted list of valid attributes known to Class::Tiny
 for a class and its superclasses with the C<get_all_attributes_for> class
@@ -248,6 +248,11 @@ method.
     my @attrs = Class::Tiny->get_all_attributes_for("Employee");
     # @attrs contains qw/name ssn/
 
+The C<import> method uses two class methods, C<prepare_class> and
+C<create_attributes> to set up the C<@ISA> array and attributes.  Anyone
+attempting to extend Class::Tiny itself should use these instead of mocking up
+a call to C<import>.
+
 =for :stopwords cpan testmatrix url annocpan anno bugtracker rt cpants kwalitee diff irc mailto metadata placeholders metacpan
 
 =head1 SUPPORT
diff --git a/lib/Class/Tiny.pm b/lib/Class/Tiny.pm
index 439746c..1da59d9 100644
--- a/lib/Class/Tiny.pm
+++ b/lib/Class/Tiny.pm
@@ -327,7 +327,7 @@ values and errors are ignored.
         $self->cleanup();
     }
 
-=head2 Introspection
+=head2 Introspection and internals
 
 You can retrieve an unsorted list of valid attributes known to Class::Tiny
 for a class and its superclasses with the C<get_all_attributes_for> class
@@ -336,6 +336,11 @@ method.
     my @attrs = Class::Tiny->get_all_attributes_for("Employee");
     # @attrs contains qw/name ssn/
 
+The C<import> method uses two class methods, C<prepare_class> and
+C<create_attributes> to set up the C<@ISA> array and attributes.  Anyone
+attempting to extend Class::Tiny itself should use these instead of mocking up
+a call to C<import>.
+
 =cut
 
 # vim: ts=4 sts=4 sw=4 et:

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-perl/packages/libclass-tiny-perl.git