Dzil-ize all the .pod files so they can be pod-woven
Dave Rolsky [Tue, 28 Dec 2010 15:40:29 +0000 (10:40 -0500)]
48 files changed:
lib/Moose/Cookbook.pod
lib/Moose/Cookbook/Basics/Recipe1.pod
lib/Moose/Cookbook/Basics/Recipe10.pod
lib/Moose/Cookbook/Basics/Recipe11.pod
lib/Moose/Cookbook/Basics/Recipe2.pod
lib/Moose/Cookbook/Basics/Recipe3.pod
lib/Moose/Cookbook/Basics/Recipe4.pod
lib/Moose/Cookbook/Basics/Recipe5.pod
lib/Moose/Cookbook/Basics/Recipe6.pod
lib/Moose/Cookbook/Basics/Recipe7.pod
lib/Moose/Cookbook/Basics/Recipe8.pod
lib/Moose/Cookbook/Basics/Recipe9.pod
lib/Moose/Cookbook/Extending/Recipe1.pod
lib/Moose/Cookbook/Extending/Recipe2.pod
lib/Moose/Cookbook/Extending/Recipe3.pod
lib/Moose/Cookbook/Extending/Recipe4.pod
lib/Moose/Cookbook/Meta/Recipe1.pod
lib/Moose/Cookbook/Meta/Recipe2.pod
lib/Moose/Cookbook/Meta/Recipe3.pod
lib/Moose/Cookbook/Meta/Recipe4.pod
lib/Moose/Cookbook/Meta/Recipe5.pod
lib/Moose/Cookbook/Meta/Recipe6.pod
lib/Moose/Cookbook/Meta/Recipe7.pod
lib/Moose/Cookbook/Roles/Recipe1.pod
lib/Moose/Cookbook/Roles/Recipe2.pod
lib/Moose/Cookbook/Roles/Recipe3.pod
lib/Moose/Cookbook/Snack/Keywords.pod
lib/Moose/Cookbook/Snack/Types.pod
lib/Moose/Cookbook/Style.pod
lib/Moose/Intro.pod
lib/Moose/Manual.pod
lib/Moose/Manual/Attributes.pod
lib/Moose/Manual/BestPractices.pod
lib/Moose/Manual/Classes.pod
lib/Moose/Manual/Concepts.pod
lib/Moose/Manual/Construction.pod
lib/Moose/Manual/Contributing.pod
lib/Moose/Manual/Delegation.pod
lib/Moose/Manual/Delta.pod
lib/Moose/Manual/FAQ.pod
lib/Moose/Manual/MOP.pod
lib/Moose/Manual/MethodModifiers.pod
lib/Moose/Manual/MooseX.pod
lib/Moose/Manual/Roles.pod
lib/Moose/Manual/Types.pod
lib/Moose/Manual/Unsweetened.pod
lib/Moose/Spec/Role.pod
lib/Moose/Unsweetened.pod

index 8591887..275cfc3 100644 (file)
@@ -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
 
@@ -225,17 +227,4 @@ object class.
 
 =back
 
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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
index 367a000..6e403e3 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Basics::Recipe1;
 
-=pod
+# ABSTRACT: The (always classic) B<Point> example.
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Basics::Recipe1 - The (always classic) B<Point> example.
+=pod
 
 =head1 SYNOPSIS
 
@@ -223,21 +225,6 @@ L<http://www.gigamonkeys.com/book/object-reorientation-generic-functions.html>
 
 =back
 
-=head1 AUTHORS
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 my $point = Point->new( x => 1, y => 2 );
index db4c25b..93797b4 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Basics::Recipe10;
 
-=pod
+# ABSTRACT: Using BUILDARGS and BUILD to hook into object construction
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Basics::Recipe10 - Using BUILDARGS and BUILD to hook into object construction
+=pod
 
 =head1 SYNOPSIS
 
@@ -114,17 +116,4 @@ The C<BUILDARGS> method lets us expand on Moose's built-in parameter
 handling for constructors. The C<BUILD> method lets us implement
 logical constraints across the whole object after it is created.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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
index b4595e0..3ad4d00 100644 (file)
@@ -1,3 +1,9 @@
+package Moose::Cookbook::Basics::Recipe11;
+
+# ABSTRACT: Extending a non-Moose base class
+
+__END__
+
 
 =pod
 
@@ -10,10 +16,6 @@ use Test::Requires {
 
 =end testing-SETUP
 
-=head1 NAME
-
-Moose::Cookbook::Basics::Recipe11 - Extending a non-Moose base class
-
 =head1 SYNOPSIS
 
   package My::DateTime;
@@ -108,19 +110,6 @@ since they're not Moose attributes. Nor will you be able to inline a
 constructor, since you need to explicitly use the metaclass's object
 constructor.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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.
-
 =begin testing
 
 my $dt = My::DateTime->new( year => 1970, month => 2, day => 24 );
index abb50ec..e4e643e 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Basics::Recipe2;
 
-=pod
+# ABSTRACT: A simple B<BankAccount> example
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Basics::Recipe2 - A simple B<BankAccount> example
+=pod
 
 =head1 SYNOPSIS
 
@@ -212,21 +214,6 @@ L<http://www.gigamonkeys.com/book/object-reorientation-generic-functions.html>
 
 =back
 
-=head1 AUTHORS
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 my $savings_account;
index 84e7da5..fc4152b 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Basics::Recipe3;
 
-=pod
+# ABSTRACT: A lazy B<BinaryTree> example
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Basics::Recipe3 - A lazy B<BinaryTree> example
+=pod
 
 =head1 SYNOPSIS
 
@@ -214,21 +216,6 @@ L<Moose::Cookbook::Basics::Recipe8> for details.
 
 =back
 
-=head1 AUTHORS
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 use Scalar::Util 'isweak';
index 0a10695..7570e9a 100644 (file)
@@ -1,3 +1,9 @@
+package Moose::Cookbook::Basics::Recipe4;
+
+# ABSTRACT: Subtypes, and modeling a simple B<Company> class hierarchy
+
+__END__
+
 
 =pod
 
@@ -10,10 +16,6 @@ use Test::Requires {
 
 =end testing-SETUP
 
-=head1 NAME
-
-Moose::Cookbook::Basics::Recipe4 - Subtypes, and modeling a simple B<Company> class hierarchy
-
 =head1 SYNOPSIS
 
   package Address;
@@ -289,21 +291,6 @@ methods it finds in the correct order.
 
 =back
 
-=head1 AUTHORS
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 {
index 7a6f3ed..d381182 100644 (file)
@@ -1,3 +1,9 @@
+package Moose::Cookbook::Basics::Recipe5;
+
+# ABSTRACT: More subtypes, coercion in a B<Request> class
+
+__END__
+
 
 =pod
 
@@ -11,10 +17,6 @@ use Test::Requires {
 
 =end testing-SETUP
 
-=head1 NAME
-
-Moose::Cookbook::Basics::Recipe5 - More subtypes, coercion in a B<Request> class
-
 =head1 SYNOPSIS
 
   package Request;
@@ -203,21 +205,6 @@ opposed to from a plain C<ArrayRef>
 
 =back
 
-=head1 AUTHORS
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 my $r = Request->new;
index 9d4d633..9b9c66a 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Basics::Recipe6;
 
-=pod
+# ABSTRACT: The augment/inner example
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Basics::Recipe6 - The augment/inner example
+=pod
 
 =head1 SYNOPSIS
 
@@ -118,21 +120,6 @@ The C<augment> modifier is a powerful tool for creating a set of
 nested wrappers. It's not something you will need often, but when you
 do, it is very handy.
 
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2007-2010 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.
-
 =begin testing
 
 my $tps_report = TPSReport->new;
index ff88781..618816a 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Basics::Recipe7;
 
-=pod
+# ABSTRACT: Making Moose fast with immutable
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Basics::Recipe7 - Making Moose fast with immutable
+=pod
 
 =head1 SYNOPSIS
 
@@ -33,17 +35,4 @@ We strongly recommend you make your classes immutable. It makes your
 code much faster, with a small compile-time cost. This will be
 especially noticeable when creating many objects.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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
index d748da9..750fd41 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Basics::Recipe8;
 
-=pod
+# ABSTRACT: Builder methods and lazy_build
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Basics::Recipe8 - Builder methods and lazy_build
+=pod
 
 =head1 SYNOPSIS
 
@@ -109,17 +111,4 @@ functionality. It also separates the default-generating code into a
 well-defined method. Sprinkling your attribute definitions with
 anonymous subroutines can be quite ugly and hard to follow.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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
index 8f6558a..5057408 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Basics::Recipe9;
 
-=pod
+# ABSTRACT: Operator overloading, subtypes, and coercion
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Basics::Recipe9 - Operator overloading, subtypes, and coercion
+=pod
 
 =head1 SYNOPSIS
 
@@ -253,12 +255,6 @@ Had this been a real project we'd probably want:
 
 =back
 
-=head1 AUTHORS
-
-Aran Clary Deltac <bluefeet@cpan.org>
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
 =head1 LICENSE
 
 This work is licensed under a Creative Commons Attribution 3.0 Unported License.
index 9c87567..cd97263 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Extending::Recipe1;
 
-=pod
+# ABSTRACT: Moose extension overview
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Extending::Recipe1 - Moose extension overview
+=pod
 
 =head1 DESCRIPTION
 
@@ -301,17 +303,4 @@ If you can write your extension as one or more metaclass and base
 object roles, please consider doing so. Make sure to read the docs for
 L<Moose::Exporter> and L<Moose::Util::MetaRole> as well.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index 64f0f05..03c3909 100644 (file)
@@ -1,3 +1,9 @@
+package Moose::Cookbook::Extending::Recipe2;
+
+# ABSTRACT: Providing a role for the base object class
+
+__END__
+
 
 =pod
 
@@ -9,10 +15,6 @@ use Test::Requires {
 
 =end testing-SETUP
 
-=head1 NAME
-
-Moose::Cookbook::Extending::Recipe2 - Providing a role for the base object class
-
 =head1 SYNOPSIS
 
   package MooseX::Debugging;
@@ -61,19 +63,6 @@ C<setup_import_methods> for us, since we passed the C<base_class_roles>
 parameter. The generated C<init_meta> will in turn call
 L<Moose::Util::MetaRole::apply_base_class_roles|Moose::Util::MetaRole/apply_base_class_roles>.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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.
-
 =begin testing
 
 {
index 1028a58..2c9885b 100644 (file)
@@ -1,3 +1,9 @@
+package Moose::Cookbook::Extending::Recipe3;
+
+# ABSTRACT: Providing an alternate base object class
+
+__END__
+
 
 =pod
 
@@ -9,10 +15,6 @@ use Test::Requires {
 
 =end testing-SETUP
 
-=head1 NAME
-
-Moose::Cookbook::Extending::Recipe3 - Providing an alternate base object class
-
 =head1 SYNOPSIS
 
   package MyApp::Base;
@@ -82,19 +84,6 @@ This is an awful lot of magic for a simple base class. You will often
 want to combine a metaclass trait with a base class extension, and
 that's when this technique is useful.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 {
index 9efb361..d7af9a1 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Extending::Recipe4;
 
-=pod
+# ABSTRACT: Acting like Moose.pm and providing sugar Moose-style
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Extending::Recipe4 - Acting like Moose.pm and providing sugar Moose-style
+=pod
 
 =head1 SYNOPSIS
 
@@ -78,19 +80,6 @@ when you C<use MyApp::Mooseish>.
 Providing sugar functions can make your extension look much more
 Moose-ish. See L<Fey::ORM> for a more extensive example.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 
index af2c1a6..f2e72a7 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Meta::Recipe1;
 
-=pod
+# ABSTRACT: Welcome to the meta world (Why Go Meta?)
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Meta::Recipe1 - Welcome to the meta world (Why Go Meta?)
+=pod
 
 =head1 SUMMARY
 
@@ -52,19 +54,6 @@ couple good examples include L<MooseX::Singleton> and
 L<MooseX::AttributeHelpers>. For a more complex example see
 L<Fey::ORM> or L<Reaction>.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.org<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
 
 
index 3f360c0..e7b0cec 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Meta::Recipe2;
 
-=pod
+# ABSTRACT: A meta-attribute, attributes with labels
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Meta::Recipe2 - A meta-attribute, attributes with labels
+=pod
 
 =head1 SYNOPSIS
 
@@ -260,21 +262,6 @@ of time:
 
 The sky's the limit!
 
-=head1 AUTHOR
-
-Shawn M Moore E<lt>sartak@gmail.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.org<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 my $app = MyApp::Website->new( url => "http://google.com", name => "Google" );
index ff612d2..985ce5f 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Meta::Recipe3;
 
-=pod
+# ABSTRACT: Labels implemented via attribute traits
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Meta::Recipe3 - Labels implemented via attribute traits
+=pod
 
 =head1 SYNOPSIS
 
@@ -184,21 +186,6 @@ extensions, either from CPAN or that you might write in the
 future. Moose makes it easy to create attribute metaclasses on the fly
 by providing a list of trait names to L<Moose/has>.
 
-=head1 AUTHOR
-
-Shawn M Moore E<lt>sartak@gmail.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.org<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 my $app2
index 1b58a17..3e5b3e3 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Meta::Recipe4;
 
-=pod
+# ABSTRACT: Adding a "table" attribute to the metaclass
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Meta::Recipe4 - Adding a "table" attribute to the metaclass
+=pod
 
 =head1 SYNOPSIS
 
@@ -62,17 +64,4 @@ as a metaclass trait
 L<Moose::Cookbook::Extending::Recipe2> - Acting like Moose.pm and
 providing sugar Moose-style
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =pod
index aef5a76..5075343 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Meta::Recipe5;
 
-=pod
+# ABSTRACT: The "table" attribute as a metaclass trait
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Meta::Recipe5 - The "table" attribute as a metaclass trait
+=pod
 
 =head1 SYNOPSIS
 
@@ -68,17 +70,4 @@ traits
 L<Moose::Cookbook::Meta::Recipe4> - Adding a "table" attribute to the
 metaclass
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =pod
index e26637a..548bb27 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Meta::Recipe6;
 
-=pod
+# ABSTRACT: A method metaclass for marking methods public or private
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Meta::Recipe6 - A method metaclass for marking methods public or private
+=pod
 
 =head1 SYNOPSIS
 
@@ -132,19 +134,6 @@ API we have for adding these methods is not very pretty.
 That can be improved with custom Moose-like sugar, or even by using a
 tool like L<Devel::Declare> to create full-blown new keywords in Perl.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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.
-
 =begin testing
 
 package main;
index 6ee9763..1034cd4 100644 (file)
@@ -1,3 +1,9 @@
+package Moose::Cookbook::Meta::Recipe7;
+
+# ABSTRACT: Creating a glob reference meta-instance class
+
+__END__
+
 
 =pod
 
 
 =end testing-SETUP
 
-=head1 NAME
-
-Moose::Cookbook::Meta::Recipe7 - Creating a glob reference meta-instance class
-
 =head1 SYNOPSIS
 
   package My::Meta::Instance;
@@ -190,19 +192,6 @@ use a handle as an object instance.
 
 =back
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 {
index 991b51d..2a3d44a 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Roles::Recipe1;
 
-=pod
+# ABSTRACT: The Moose::Role example
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Roles::Recipe1 - The Moose::Role example
+=pod
 
 =head1 SYNOPSIS
 
@@ -193,21 +195,6 @@ C<Executable> role, we're saying something about semantics.
 
 =back
 
-=head1 AUTHORS
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 ok( US::Currency->does('Comparable'), '... US::Currency does Comparable' );
index c13f0ad..096abfd 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Roles::Recipe2;
 
-=pod
+# ABSTRACT: Advanced Role Composition - method exclusion and aliasing
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Roles::Recipe2 - Advanced Role Composition - method exclusion and aliasing
+=pod
 
 =head1 SYNOPSIS
 
@@ -123,19 +125,6 @@ using method modifiers, but for the sake of this example, we don't.
 
 =back
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
 =begin testing
 
 {
index 33a7bb6..b81c9f4 100644 (file)
@@ -1,5 +1,11 @@
 package Moose::Cookbook::Roles::Recipe3;
 
+# ABSTRACT: Applying a role to an object instance
+
+__END__
+
+package Moose::Cookbook::Roles::Recipe3;
+
 =pod
 
 =begin testing-SETUP
@@ -25,10 +31,6 @@ package Moose::Cookbook::Roles::Recipe3;
 
 =end testing-SETUP
 
-=head1 NAME
-
-Moose::Cookbook::Roles::Recipe3 - Applying a role to an object instance
-
 =head1 SYNOPSIS
 
   package MyApp::Role::Job::Manager;
@@ -104,20 +106,6 @@ It can also be useful as a sort of controlled monkey-patching for
 existing code, particularly non-Moose code. For example, you could
 create a debugging role and apply it to an object at runtime.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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.
-
-
 =begin testing
 
 {
index a61e9fb..031a143 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Cookbook::Snack::Keywords;
+
+# ABSTRACT: Restricted "keywords" in Moose
 
-=head1 NAME
+__END__
 
-Moose::Cookbook::Snack::Keywords - Restricted "keywords" in Moose
+=pod
 
 =head1 DESCRIPTION
 
@@ -154,19 +156,4 @@ you must be careful not to remove C<meta> when doing so:
 
 =back
 
-=head1 AUTHOR
-
-John Goulah C<E<lt>jgoulah@cpan.org<gt>>
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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
index 2843817..5da470e 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Cookbook::Snack::Types;
 
-=pod
+# ABSTRACT: Snippets of code for using Types and Type Constraints
+
+__END__
 
-=head1 NAME
 
-Moose::Cookbook::Snack::Types - Snippets of code for using Types and Type Constraints
+=pod
 
 =head1 SYNOPSIS
 
@@ -61,17 +63,4 @@ to check a value directly.
 
 =back
 
-=head1 AUTHOR
-
-Jess Robinson <cpan@desert-island.me.uk>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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
index 35429ed..6721a26 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Cookbook::Style;
+
+# ABSTRACT: Expanded into Moose::Manual::BestPractices, so go read that
 
-=head1 NAME
+__END__
 
-Moose::Cookbook::Style - Expanded into Moose::Manual::BestPractices, so go read that
+=pod
 
 =head1 DESCRIPTION
 
index e705724..8d07d58 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Intro;
+
+# ABSTRACT: Expanded into Moose::Manual, so go read that
 
-=head1 NAME
+__END__
 
-Moose::Intro - Expanded into Moose::Manual, so go read that
+=pod
 
 =head1 DESCRIPTION
 
index 3195a5b..f50ca63 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual;
+
+# ABSTRACT: What is Moose, and how do I use it?
 
-=head1 NAME
+__END__
 
-Moose::Manual - What is Moose, and how do I use it?
+=pod
 
 =head1 WHAT IS MOOSE?
 
@@ -248,19 +250,4 @@ Nuff Said.
 
 =back
 
-=head1 AUTHORS
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2008-2010 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
index e870e1e..f809fd0 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Attributes;
+
+# ABSTRACT: Object attributes with Moose
 
-=head1 NAME
+__END__
 
-Moose::Manual::Attributes - Object attributes with Moose
+=pod
 
 =head1 INTRODUCTION
 
@@ -612,17 +614,4 @@ Moose provides an attribute option called C<initializer>. This is called when
 the attribute's value is being set in the constructor, and lets you change the
 value before it is set.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index 0a5b51b..5840910 100644 (file)
@@ -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
 
@@ -217,19 +219,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 E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index e06e0a3..812939f 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Classes;
+
+# ABSTRACT: Making your classes use Moose (and subclassing)
 
-=head1 NAME
+__END__
 
-Moose::Manual::Classes - Making your classes use Moose (and subclassing)
+=pod
 
 =head1 USING MOOSE
 
@@ -135,17 +137,4 @@ can also provide your own immutabilization method. Doing so requires
 extending the Moose metaclasses, and is well beyond the scope of this
 manual.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2008-2010 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
index 2e5b86c..e603e48 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Concepts;
+
+# ABSTRACT: Moose OO concepts
 
-=head1 NAME
+__END__
 
-Moose::Manual::Concepts - Moose OO concepts
+=pod
 
 =head1 MOOSE CONCEPTS (VS "OLD SCHOOL" Perl)
 
@@ -372,17 +374,4 @@ After that, check out the Role recipes. If you're really curious, go
 on and read the Meta and Extending recipes, but those are mostly there
 for people who want to be Moose wizards and extend Moose itself.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2008-2010 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
index 87d43c0..55266ec 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Construction;
+
+# ABSTRACT: Object construction (and destruction) with Moose
 
-=head1 NAME
+__END__
 
-Moose::Manual::Construction - Object construction (and destruction) with Moose
+=pod
 
 =head1 WHERE'S THE CONSTRUCTOR?
 
@@ -157,17 +159,4 @@ method and use that instead of the one provided by L<Moose::Object>. You can
 do this to preserve C<$@> I<and> capture any errors from object destruction by
 creating an error stack.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index d7f62c9..99ec372 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Contributing;
+
+# ABSTRACT: How to get involved in Moose
 
-=head1 NAME
+__END__
 
-Moose::Manual::Contributing - How to get involved in Moose
+=pod
 
 =head1 GETTING INVOLVED
 
@@ -382,23 +384,4 @@ All backwards incompatible changes B<must> be documented in
 L<Moose::Manual::Delta>. Make sure to document any useful tips or workarounds
 for the change in that document.
 
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-Chris (perigrin) Prather
-
-Yuval (nothingmuch) Kogman
-
-Jesse Luehrs E<lt>doy at tozt dot netE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index 99e0af2..f888400 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Delegation;
+
+# ABSTRACT: Attribute delegation
 
-=head1 NAME
+__END__
 
-Moose::Manual::Delegation - Attribute delegation
+=pod
 
 =head1 WHAT IS DELEGATION?
 
@@ -176,17 +178,4 @@ required or can be undefined. When a delegated method is called, Moose
 will throw a runtime error if the attribute does not contain an
 object.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index b7e75b0..3bb1bb1 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Delta;
+
+# ABSTRACT: Important Changes in Moose
 
-=head1 NAME
+__END__
 
-Moose::Manual::Delta - Important Changes in Moose
+=pod
 
 =head1 DESCRIPTION
 
@@ -814,17 +816,4 @@ crazy to not upgrade.
 Also, I am tired of going through the Changelog so I am stopping here,
 if anyone would like to continue this please feel free.
 
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index 0864fd4..029c92a 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Manual::FAQ;
 
-=pod
+# ABSTRACT: Frequently asked questions about Moose
+
+__END__
 
-=head1 NAME
 
-Moose::Manual::FAQ - Frequently asked questions about Moose
+=pod
 
 =head1 FREQUENTLY ASKED QUESTIONS
 
@@ -386,17 +388,4 @@ Moose attributes:
 
   sub foo : Bar(27) { ... }
 
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2006-2010 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
index 373471f..36258ec 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::MOP;
+
+# ABSTRACT: The Moose (and Class::MOP) meta API
 
-=head1 NAME
+__END__
 
-Moose::Manual::MOP - The Moose (and Class::MOP) meta API
+=pod
 
 =head1 INTRODUCTION
 
@@ -147,18 +149,4 @@ Finally, we welcome questions on the Moose mailing list and
 IRC. Information on the mailing list, IRC, and more references can be
 found in the L<Moose.pm docs|Moose/GETTING HELP>.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt> and Stevan Little
-E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index d05efd2..b982b0b 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::MethodModifiers;
+
+# ABSTRACT: Moose's method modifiers
 
-=head1 NAME
+__END__
 
-Moose::Manual::MethodModifiers - Moose's method modifiers
+=pod
 
 =head1 WHAT IS A METHOD MODIFIER?
 
@@ -295,17 +297,4 @@ semi-colon:
 
   after 'foo' => sub { };
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2008-2010 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
index d7f4374..c47d15f 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::MooseX;
+
+# ABSTRACT: Recommended Moose extensions
 
-=head1 NAME
+__END__
 
-Moose::Manual::MooseX - Recommended Moose extensions
+=pod
 
 =head1 MooseX?
 
@@ -257,17 +259,4 @@ setting up proper inheritance from Moose::Object and installing
 (and inlining, at make_immutable time) a constructor that makes sure things
 like BUILD methods are called.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index ce00b74..dcb29ba 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Roles;
+
+# ABSTRACT: Roles, an alternative to deep hierarchies and base classes
 
-=head1 NAME
+__END__
 
-Moose::Manual::Roles - Roles, an alternative to deep hierarchies and base classes
+=pod
 
 =head1 WHAT IS A ROLE?
 
@@ -324,17 +326,4 @@ normal Moose role combination system. We recommend using this function to
 apply roles to an object. This is what Moose uses internally when you call
 C<with>.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index 3cce8b7..6a18b72 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Types;
+
+# ABSTRACT: Moose's type system
 
-=head1 NAME
+__END__
 
-Moose::Manual::Types - Moose's type system
+=pod
 
 =head1 TYPES IN PERL?
 
@@ -422,17 +424,4 @@ In order to ameliorate this problem, we recommend defining I<all> of your
 custom types in one module, C<MyApp::Types>, and then loading this module in
 all of your other modules.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index 117cbcf..7e36fa8 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual::Unsweetened;
+
+# ABSTRACT: Moose idioms in plain old Perl 5 without the sugar
 
-=head1 NAME
+__END__
 
-Moose::Manual::Unsweetened - Moose idioms in plain old Perl 5 without the sugar
+=pod
 
 =head1 DESCRIPTION
 
@@ -319,17 +321,4 @@ Moose is a complete OO package in and of itself, and is part of a rich
 ecosystem of extensions. It also has an enthusiastic community of
 users, and is being actively maintained and developed.
 
-=head1 AUTHOR
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2009-2010 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
index ef4f590..2327440 100644 (file)
@@ -1,9 +1,11 @@
+package Moose::Spec::Role;
 
-=pod
+# ABSTRACT: Formal spec for Role behavior
+
+__END__
 
-=head1 NAME
 
-Moose::Spec::Role - Formal spec for Role behavior
+=pod
 
 =head1 DESCRIPTION
 
@@ -331,18 +333,5 @@ Which, of course, includes roles.
 
 =back
 
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2007-2010 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
 
index 0b06593..b67555e 100644 (file)
@@ -1,8 +1,10 @@
-=pod
+package Moose::Intro;
+
+# ABSTRACT: Moved to Moose::Manual::Unsweetened, so go read that
 
-=head1 NAME
+__END__
 
-Moose::Intro - Moved to Moose::Manual::Unsweetened, so go read that
+=pod
 
 =head1 DESCRIPTION