X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMooseX%2FMetaDescription.pm;h=a2b0b88f3cc8451be2a308a7a14c01edf49a2a86;hb=8055bcebda1fb858d27c347036918a25f9f7b368;hp=dc4a2b00b39a2bedfcfed1832c32b7e153cc2bb5;hpb=91297cb4d55bab5d38c404df82637282a5450661;p=gitmo%2FMooseX-MetaDescription.git

diff --git a/lib/MooseX/MetaDescription.pm b/lib/MooseX/MetaDescription.pm
index dc4a2b0..a2b0b88 100644
--- a/lib/MooseX/MetaDescription.pm
+++ b/lib/MooseX/MetaDescription.pm
@@ -16,14 +16,50 @@ __END__
 
 =head1 NAME
 
-MooseX::MetaDescription - A Moosey solution to this problem
+MooseX::MetaDescription - A framework for adding additional metadata to Moose classes
 
 =head1 SYNOPSIS
 
-  use MooseX::MetaDescription;
+    package Foo;
+    use metaclass 'MooseX::MetaDescription::Meta::Class';
+    use Moose;
+    
+    # add class-level metadata
+    __PACKAGE__->meta->description->{'Hello'} = 'World';
+
+    has 'bar' => (
+        metaclass   => 'MooseX::MetaDescription::Meta::Attribute',
+        is          => 'ro',
+        isa         => 'Str',   
+        default     => sub { Bar->new() },
+        # add attribute level metadata
+        description => {
+            node_type   => 'element',
+        }
+    );
+
+    ...
+    
+    $foo->meta->description; # { 'Hello' => 'World' }
+    
+    my $bar = $foo->meta->get_attribute('bar');
+    
+    # access the desciption HASH directly
+    $bar->description; # { node_type   => 'element' }    
+    
+    # or access the instance of MooseX::MetaDescription::Description
+    $bar->metadescription;
+    
+    # access the original attribute metaobject from the metadesc too
+    $bar->metadescription->descriptor == $bar;
 
 =head1 DESCRIPTION
 
+MooseX::MetaDescription allows you to add arbitrary out of band 
+metadata to your Moose classes and attributes. This will allow 
+you to track out of band data along with attributes, which is 
+very useful for say serializing Moose classes in HTML or XML.
+
 =head1 METHODS 
 
 =over 4
@@ -40,6 +76,9 @@ to cpan-RT.
 
 =head1 AUTHOR
 
+Code and Design originally by Jonathan Rockway in the Ernst module, 
+extracted and refactored by:
+
 Stevan Little E<lt>stevan.little@iinteractive.comE<gt>
 
 =head1 COPYRIGHT AND LICENSE