-=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?
A role encapsulates some piece of behavior or state that can be shared between
-classes. Is something that classes I<do>. It is important to understand that
+classes. It is something that classes I<do>. It is important to understand that
I<roles are not classes>. You cannot inherit from a role, and a role cannot be
instantiated. We sometimes say that roles are I<consumed>, either by classes
or other roles.
isa => 'Marrow',
);
-See also L<Moose::Cookbook::Roles::Recipe1> for an example.
+See also L<Moose::Cookbook::Roles::Comparable_CodeReuse> for an example.
=head1 REQUIRED METHODS
In some use cases we might alias and exclude methods from roles, but
then provide a method of the same name in the class itself.
-Also see L<Moose::Cookbook::Roles::Recipe2> for an example.
+Also see L<Moose::Cookbook::Roles::Restartable_AdvancedComposition> for an example.
=head1 ROLE EXCLUSION
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