From: Dave Rolsky Date: Wed, 30 Jul 2008 16:24:49 +0000 (+0000) Subject: Fix all references to cookbook recipes X-Git-Tag: 0_55~21 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=5cfe38055a8397c20063f7e76c29f0734f86890b;p=gitmo%2FMoose.git Fix all references to cookbook recipes --- diff --git a/lib/Moose.pm b/lib/Moose.pm index 2d8458a..9b0fb44 100644 --- a/lib/Moose.pm +++ b/lib/Moose.pm @@ -424,7 +424,7 @@ for information on how to define a new type, and how to retrieve type meta-data) This will attempt to use coercion with the supplied type constraint to change the value passed into any accessors or constructors. You B have supplied -a type constraint in order for this to work. See L +a type constraint in order for this to work. See L for an example. =item I $role_name> @@ -509,7 +509,7 @@ want installed locally, and its value is the name of the original method in the class being delegated to. This can be very useful for recursive classes like trees. Here is a -quick example (soon to be expanded into a Moose::Cookbook::Recipe): +quick example (soon to be expanded into a Moose::Cookbook recipe): package Tree; use Moose; @@ -573,7 +573,7 @@ This tells the class to use a custom attribute metaclass for this particular attribute. Custom attribute metaclasses are useful for extending the capabilities of the I keyword: they are the simplest way to extend the MOP, but they are still a fairly advanced topic and too much to cover here, see -L for more information. +L for more information. The default behavior here is to just load C<$metaclass_name>; however, we also have a way to alias to a shorter name. This will first look to see if @@ -735,13 +735,13 @@ method call and the C pseudo-package; it is really your choice. The keyword C, much like C, is a no-op outside of the context of an C method. You can think of C as being the inverse of C; the details of how C and C work is best described in -the L. +the L. =item B An C method, is a way of explicitly saying "I am augmenting this method from my superclass". Once again, the details of how C and -C work is best described in the L. +C work is best described in the L. =item B diff --git a/lib/Moose/Cookbook.pod b/lib/Moose/Cookbook.pod index d422731..f5bd6d4 100644 --- a/lib/Moose/Cookbook.pod +++ b/lib/Moose/Cookbook.pod @@ -34,7 +34,7 @@ modifier in a subclass. Demonstrates several attribute features, including types, weak references, predicates ("does this object have a foo?"), defaults, and -lazy attribute construction. +lazy attribute uction. =item L - Subtypes, and modeling a simple B class hierarchy @@ -122,7 +122,7 @@ composable attribute functionality. I -=item L - The meta-class example (TODO) +=item L - The meta-class example (TODO) I diff --git a/lib/Moose/Cookbook/FAQ.pod b/lib/Moose/Cookbook/FAQ.pod index 5fd9f78..2518660 100644 --- a/lib/Moose/Cookbook/FAQ.pod +++ b/lib/Moose/Cookbook/FAQ.pod @@ -84,7 +84,7 @@ pairs or a hash reference. You can override it to take positional args, or any other format To change the handling of individual parameters, there are I -(See the L for a complete example and +(See the L for a complete example and explaination of coercions). With coercions it is possible to morph argument values into the correct expected types. This approach is the most flexible and robust, but does have a slightly higher learning @@ -204,7 +204,7 @@ coerce the value into a C object using the code in found in the C block. For a more comprehensive example of using coercions, see the -L. +L. If you need to deflate your attribute, the current best practice is to add an C modifier to your accessor. Here is some example code: diff --git a/lib/Moose/Cookbook/Snack/Types.pod b/lib/Moose/Cookbook/Snack/Types.pod index 172c972..c971155 100644 --- a/lib/Moose/Cookbook/Snack/Types.pod +++ b/lib/Moose/Cookbook/Snack/Types.pod @@ -36,7 +36,7 @@ Moose::Cookbook::Snack::Types - Snippets of code for using Types and Type Constr =head1 DESCRIPTION -This is the Point example from (L) with added +This is the Point example from (L) with added type checking. If we try to assign a string value to an attribute that is defined as @@ -51,7 +51,7 @@ check the value we are about to set, before we try and set it. =over 4 -=item L +=item L =item L @@ -72,4 +72,4 @@ L This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. -=cut \ No newline at end of file +=cut diff --git a/lib/Moose/Meta/Attribute.pm b/lib/Moose/Meta/Attribute.pm index cb75d30..e9247e5 100644 --- a/lib/Moose/Meta/Attribute.pm +++ b/lib/Moose/Meta/Attribute.pm @@ -761,7 +761,7 @@ Any coercion to convert values is done before checking the type constraint. To check a value against a type constraint before setting it, fetch the attribute instance using L, fetch the type_constraint from the attribute using L -and call L. See L +and call L. See L for an example. =back diff --git a/lib/Moose/Meta/TypeConstraint/Union.pm b/lib/Moose/Meta/TypeConstraint/Union.pm index ba0c088..08ac2de 100644 --- a/lib/Moose/Meta/TypeConstraint/Union.pm +++ b/lib/Moose/Meta/TypeConstraint/Union.pm @@ -111,7 +111,7 @@ Moose::Meta::TypeConstraint::Union - A union of Moose type constraints =head1 DESCRIPTION This metaclass represents a union of Moose type constraints. More -details to be explained later (possibly in a Cookbook::Recipe). +details to be explained later (possibly in a Cookbook recipe). This actually used to be part of Moose::Meta::TypeConstraint, but it is now better off in it's own file.