X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMoose%2FCookbook.pod;h=bd31a4b47d2c859696fb977c20b23494b900328d;hb=cbf699885253e076d24a3b1edb8bd8b98d154b5f;hp=dab57608ebace323cc9ea1760aee60124df2c135;hpb=dab940632264ba728cdd882436a2c972f001fecf;p=gitmo%2FMoose.git diff --git a/lib/Moose/Cookbook.pod b/lib/Moose/Cookbook.pod index dab5760..bd31a4b 100644 --- a/lib/Moose/Cookbook.pod +++ b/lib/Moose/Cookbook.pod @@ -1,9 +1,11 @@ +package Moose::Cookbook; -=pod +# ABSTRACT: How to cook a Moose + +__END__ -=head1 NAME -Moose::Cookbook - How to cook a Moose +=pod =head1 DESCRIPTION @@ -18,10 +20,9 @@ explains Moose concepts without being too code-heavy. =head2 Basic Moose -These recipes will give you a good idea of what Moose is capable of, -starting with simple attribute declaration, and moving on to more -powerful features like laziness, types, type coercion, method -modifiers, and more. +These recipes will give you a good overview of Moose's capabilities, starting +with simple attribute declaration, and moving on to more powerful features like +laziness, types, type coercion, method modifiers, and more. =over 4 @@ -59,27 +60,26 @@ the usual method overriding style "inside-out". Making a class immutable greatly increases the speed of accessors and object construction. -=item L - Managing complex relations with trigger (TODO) - -I - -Work off of this http://code2.0beta.co.uk/moose/svn/Moose/trunk/t/200_examples/007_Child_Parent_attr_inherit.t - -=item L - Builder methods and lazy_build +=item L - Builder methods and lazy_build The builder feature provides an inheritable and role-composable way to provide a default attribute value. -=item L - Operator overloading, subtypes, and coercion +=item L - Operator overloading, subtypes, and coercion Demonstrates using operator overloading, coercion, and subtypes to model how eye color is determined during reproduction. -=item L - Using BUILDARGS and BUILD to hook into object construction +=item L - Using BUILDARGS and BUILD to hook into object construction This recipe demonstrates the use of C and C to hook into object construction. +=item L - Extending a non-Moose base class + +In this recipe, we make a Moose-based subclass of L, a +module which does not use Moose itself. + =back =head2 Moose Roles @@ -119,13 +119,6 @@ you extend the object system provided by Moose. If you're wondering what all this "meta" stuff is, and why you should care about it, read this "recipe". -=item L - A meta-attribute, attributes with labels - -One way to extend Moose is to provide your own attribute -metaclasses. Attribute metaclasses let you extend attribute -declarations (with C) and behavior to provide additional -attribute functionality. - =item L - Labels implemented via attribute traits Extending Moose's attribute metaclass is a great way to add @@ -133,13 +126,6 @@ functionality. However, attributes can only have one metaclass. Applying roles to the attribute metaclass lets you provide composable attribute functionality. -=item L - Adding a "table" attribute to the metaclass - -If you want to store more information about your classes, you'll have -to extend C. Doing so is simple, but you'll -probably also want to provide some sugar, so see -L as well. - =item L - The "table" attribute implemented as a metaclass trait This recipe takes the class metaclass we saw in the previous recipe @@ -156,7 +142,7 @@ This recipe shows an example of how you create your own meta-instance class. The meta-instance determines the internal structure of object instances and provide access to attribute slots. -=item L - Hooking into immutabilization (TODO) +=item Moose::Cookbook::Meta::Recipe8 - Hooking into immutabilization (TODO) Moose has a feature known as "immutabilization". By calling C<< __PACKAGE__->meta()->make_immutable() >> after defining your class @@ -227,17 +213,4 @@ object class. =back -=head1 AUTHOR - -Stevan Little Estevan@iinteractive.comE - -=head1 COPYRIGHT AND LICENSE - -Copyright 2006-2009 by Infinity Interactive, Inc. - -L - -This library is free software; you can redistribute it and/or modify -it under the same terms as Perl itself. - =cut