The package into which to install the subroutine. If this argument is omitted,
it will inspect $self to determine the package. Class::Accessor::*
accessor generators are typically used like this:
Therefore install_accessor() can determine the right package into which to install the subroutine.
The name or names to use for the subroutine. You can either pass a single
string or a reference to an array of strings. Each string is interpreted as a
subroutine name inside the given package, and the code reference is installed
into the appropriate typeglob.
Why would you want to install a subroutine in more than one place inside your package? For example, Class::Accessor::Complex often creates aliases so the user can choose the version of the name that reads more naturally.
An example of this usage would be:
|code||This is the code reference that should be installed.|
Now the subroutine will be named both in a stack trace and inside the debugger.
Adds documentation for an accessor - not necessarily one that has been generated with install_accessor(). See Sub::Documentation for details.
Takes as arguments a named hash. The following keys are recognized:
You can pass additional arbitrary key/value pairs; they will be stored as well. It depends on your documentation tool which keys are useful. For example, Class::Accessor::Complex generates and Pod::Weaver::Section::CollectWithAutoDoc supports a belongs_to key that shows which generated helper method belongs to which main accessor.
package Like the package argument of install_accessor(). name The name of the accessor being documented. This can be a string or a reference to an array of strings, if the same documentation applies to more than one method. This can occur, for example, when there are aliases for a method such as clear_foo() and foo_clear(). purpose A string describing the generated method. examples An array reference containing one or more examples of using the method. These will also be used in the generated documentation.
See perlmodinstall for information and options on installing Perl modules.
No bugs have been reported.
The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN site near you, or see <http://search.cpan.org/dist/Class-Accessor-Installer/>.
The development version lives at <http://github.com/hanekomu/Class-Accessor-Installer/>. Instead of sending patches, please fork this project using the standard git and github infrastructure.
Marcel Gruenauer <firstname.lastname@example.org> Florian Helmberger <email@example.com>
This software is copyright (c) 2007 by Marcel Gruenauer.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
|perl v5.20.3||CLASS::ACCESSOR::INSTALLER (3)||2010-03-29|