X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMoose%2FCookbook.pod;h=2b5992321585d3936237edaac668683237530eba;hb=174418c2f3ea3979f16f4f96edc35ee4d762e0c0;hp=d4a649f95f8a45eb9e163126835777e2fc6da922;hpb=1068dcb5ae2ecd32b9ef2d27cfd73959c0a3d244;p=gitmo%2FMoose.git

diff --git a/lib/Moose/Cookbook.pod b/lib/Moose/Cookbook.pod
index d4a649f..2b59923 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
 
@@ -24,61 +26,61 @@ laziness, types, type coercion, method modifiers, and more.
 
 =over 4
 
-=item L<Moose::Cookbook::Basics::Recipe1> - The (always classic) B<Point> example
+=item L<Moose::Cookbook::Basics::Point_AttributesAndSubclassing>
 
-A simple Moose-based class. Demonstrates Moose attributes and subclassing.
+A simple Moose-based class. Demonstrates basic Moose attributes and subclassing.
 
-=item L<Moose::Cookbook::Basics::Recipe2> - A simple B<BankAccount> example
+=item L<Moose::Cookbook::Basics::BankAccount_MethodModifiersAndSubclassing>
 
-A slightly more complex Moose class. Demonstrates using a method
-modifier in a subclass.
+A slightly more complex Moose class. Demonstrates using a method modifier in a
+subclass.
 
-=item L<Moose::Cookbook::Basics::Recipe3> - A lazy B<BinaryTree> example
+=item L<Moose::Cookbook::Basics::BinaryTree_AttributeFeatures>
 
 Demonstrates several attribute features, including types, weak
 references, predicates ("does this object have a foo?"), defaults,
 laziness, and triggers.
 
-=item L<Moose::Cookbook::Basics::Recipe4> - Subtypes, and modeling a simple B<Company> class hierarchy
-
-Introduces the creation and use of custom types, a C<BUILD> method,
-and the use of C<override> in a subclass.
+=item L<Moose::Cookbook::Basics::Company_Subtypes>
 
-=item L<Moose::Cookbook::Basics::Recipe5> - More subtypes, coercion in a B<Request> class
+Introduces the creation and use of custom types, a C<BUILD> method, and the
+use of C<override> in a subclass. This recipe also shows how to model a set of
+classes that could be used to model companies, people, employees, etc.
 
-More type examples, including the use of type coercions.
+=item L<Moose::Cookbook::Basics::HTTP_SubtypesAndCoercion>
 
-=item L<Moose::Cookbook::Basics::Recipe6> - The augment/inner example
-
-Demonstrates the use of C<augment> method modifiers, a way of turning
-the usual method overriding style "inside-out".
+This recipe covers more subtype creation, including the use of type coercions.
 
 =item L<Moose::Cookbook::Basics::Recipe7> - Making Moose fast with immutable
 
 Making a class immutable greatly increases the speed of accessors and
 object construction.
 
-=item L<Moose::Cookbook::Basics::Recipe8> - Managing complex relations with trigger (TODO)
-
-I<abstract goes here>
-
-Work off of this http://code2.0beta.co.uk/moose/svn/Moose/trunk/t/200_examples/007_Child_Parent_attr_inherit.t
-
-=item L<Moose::Cookbook::Basics::Recipe9> - Builder methods and lazy_build
+=item L<Moose::Cookbook::Basics::Recipe8> - Builder methods and lazy_build
 
 The builder feature provides an inheritable and role-composable way to
 provide a default attribute value.
 
-=item L<Moose::Cookbook::Basics::Recipe10> - Operator overloading, subtypes, and coercion
+=item L<Moose::Cookbook::Basics::Recipe9> - Operator overloading, subtypes, and coercion
 
 Demonstrates using operator overloading, coercion, and subtypes to
 model how eye color is determined during reproduction.
 
-=item L<Moose::Cookbook::Basics::Recipe11> - Using BUILDARGS and BUILD to hook into object construction
+=item L<Moose::Cookbook::Basics::Recipe10> - Using BUILDARGS and BUILD to hook into object construction
 
 This recipe demonstrates the use of C<BUILDARGS> and C<BUILD> to hook
 into object construction.
 
+=item L<Moose::Cookbook::Basics::Recipe11> - Extending a non-Moose base class
+
+In this recipe, we make a Moose-based subclass of L<DateTime>, a
+module which does not use Moose itself.
+
+=item L<Moose::Cookbook::Basics::Document_AugmentAndInner>
+
+Demonstrates the use of C<augment> method modifiers, a way of turning
+the usual method overriding style "inside-out".
+
 =back
 
 =head2 Moose Roles
@@ -118,13 +120,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<Moose::Cookbook::Meta::Recipe2> - 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<has>) and behavior to provide additional
-attribute functionality.
-
 =item L<Moose::Cookbook::Meta::Recipe3> - Labels implemented via attribute traits
 
 Extending Moose's attribute metaclass is a great way to add
@@ -132,13 +127,6 @@ functionality. However, attributes can only have one metaclass.
 Applying roles to the attribute metaclass lets you provide
 composable attribute functionality.
 
-=item L<Moose::Cookbook::Meta::Recipe4> - Adding a "table" attribute to the metaclass
-
-If you want to store more information about your classes, you'll have
-to extend C<Moose::Meta::Class>. Doing so is simple, but you'll
-probably also want to provide some sugar, so see
-L<Moose::Cookbook::Extending::Recipe2> as well.
-
 =item L<Moose::Cookbook::Meta::Recipe5> - The "table" attribute implemented as a metaclass trait
 
 This recipe takes the class metaclass we saw in the previous recipe
@@ -155,7 +143,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<Moose::Cookbook::Meta::Recipe8> - 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
@@ -226,17 +214,4 @@ object class.
 
 =back
 
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2009 by Infinity Interactive, Inc.
-
-L<http://www.iinteractive.com>
-
-This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself.
-
 =cut