version 0.01

[gitmo/Moose-Policy.git] / lib / Moose / Policy / SingleInheritence.pm

diff --git a/lib/Moose/Policy/SingleInheritence.pm b/lib/Moose/Policy/SingleInheritence.pm
index 27c4d37..4addcf6 100644 (file)
--- a/lib/Moose/Policy/SingleInheritence.pm
+++ b/lib/Moose/Policy/SingleInheritence.pm
@@ -21,4 +21,55 @@ __END__
 
 =pod
 
+=head1 NAME 
+
+Moose::Policy::SingleInheritence - Why would you ever need more than one?
+
+=head1 SYNOPSIS
+
+  package Foo;
+  
+  use Moose::Policy 'Moose::Policy::SingleInheritence';
+  use Moose;
+  
+  package Bar;
+  
+  use Moose::Policy 'Moose::Policy::SingleInheritence';
+  use Moose;
+  
+  package Foo::Bar;
+  
+  use Moose::Policy 'Moose::Policy::SingleInheritence';
+  use Moose;
+  
+  extends 'Foo', 'Bar';  # BOOM!!!!
+
+=head1 DESCRIPTION
+
+This module restricts Moose's C<extends> keyword so that you can only assign 
+a single superclass. 
+
+This is mostly an example of how you can restrict behavior with meta-policies 
+in addition to extending and/or customising them. However, sometimes enforcing 
+a policy like this can be a good thing.
+
+=head1 BUGS
+
+All complex software has bugs lurking in it, and this module is no 
+exception. If you find a bug please either email me, or add the bug
+to cpan-RT.
+
+=head1 AUTHOR
+
+Stevan Little E<lt>stevan@iinteractive.comE<gt>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright 2006 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