X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMoose%2FManual%2FBestPractices.pod;h=bdf5ffe416a0aaf99b1ed8d34cc53530f1096391;hb=8b3c8a92f073be4d107f7c709bcb36d048eff1d4;hp=0a5b51bb474f13d2353eb20a8110e5c667cb9a2f;hpb=8e5dd3fb4d0102f0e91b658540172825831ee49d;p=gitmo%2FMoose.git diff --git a/lib/Moose/Manual/BestPractices.pod b/lib/Moose/Manual/BestPractices.pod index 0a5b51b..bdf5ffe 100644 --- a/lib/Moose/Manual/BestPractices.pod +++ b/lib/Moose/Manual/BestPractices.pod @@ -1,8 +1,10 @@ -=pod +package Moose::Manual::BestPractices; + +# ABSTRACT: Get the most out of Moose -=head1 NAME +__END__ -Moose::Manual::BestPractices - Get the most out of Moose +=pod =head1 RECOMMENDATIONS @@ -32,9 +34,10 @@ definitions by making your class immutable. 1; The C bit is simply good code hygiene, as it removes -imported symbols from you class's namespace at the end of your package's -compile cycle, including Moose keywords. Once the class has been -built, these keywords are not needed. +imported symbols from your class's namespace at the end of your package's +compile cycle, including Moose keywords. Once the class has been built, these +keywords are not needed. (This is preferred to placing C at the end +of your package). The C call allows Moose to speed up a lot of things, most notably object construction. The trade-off is that you can no longer change @@ -217,19 +220,4 @@ hand, rather than defining a real coercion, there is no introspectable metadata. This sort of thing is particularly problematic for MooseX extensions which rely on introspection to do the right thing. -=head1 AUTHOR - -Yuval (nothingmuch) Kogman - -Dave Rolsky Eautarch@urth.orgE - -=head1 COPYRIGHT AND LICENSE - -Copyright 2009-2010 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