NAME

Pod::Weaver::Section::ClassMopper - Use Class::MOP introspection to make a couple sections.

OVERVIEW

This section plugin is able to generate two sections for you, ATTRIBUTES and METHODS. By default, both sections are generated.

Your results will look something like:

=head1 ATTRIBUTES

=head2 someattribute

Reader: someattribute

Type: Str

This attribute is required.

It should be noted that should an attribute make use of the Moose 'documentation' option, its value will be included here as well.

=head1 METHODS

=head2 somemethod
 
Method originates in Some::Parent::Class

This documentation was automatically generated.

=head2 another_method 

OPTIONS

All options are checked under the mopper part of the input..

$weaver->weave_document({ 
  ...
  mopper => { 
     include_private => 0,
     skip_attributes => 0,
     skip_methods => 0,
     no_tagline => 0,
     skip_method_list => { 
        [qw(DOES AUTOLOAD can)] # .. see below
     }
  },
  ...
});

Additionally, options passed via weaver.ini, by the same name, should also be accepted.

[ClassMopper]
no_tagline = 1
skip_method_list = DOES AUTOLOAD can  
etc.

include_private

By default, all methods and attributes matching C</^_/> are excluded.  Toggle this
bit on if you want to see the gory details.

skip_attributes and skip_methods

Set these to something Perl thinks is true and it'll skip over the appropriate section.

no_tagline

Turn the "This documentation was automatically generated" bit off. It's on by default.

skip_method_list

By default, there are several methods (see below) that will be skipped when generating your list. Most of them are from UNIVERSAL or Moose::Object. If you'd like to adjust this list, provide the complete list (that is, include the things below, and then some) here, as an arrayref.

The default list of methods skipped is:

BUILDARGS
BUILDALL
DEMOLISHALL
does
DOES
dump
can
VERSION
DESTROY

AUTHOR

Dave Houston, dhouston@cpan.org, 2010.

LICENSE

This library is free software; you may redistribute and/or modify it under the same terms as Perl itself.