view release on metacpan or  search on metacpan

MakeMethods.pm  view on Meta::CPAN

=head1 SEE ALSO

=head2 Package Documentation

A collection of sample uses is available in
L<Class::MakeMethods::Docs::Examples>.

See the documentation for each family of subclasses:

=over 4

=item *

L<Class::MakeMethods::Basic>

=item *

L<Class::MakeMethods::Standard>

=item *

L<Class::MakeMethods::Composite>

=item *

L<Class::MakeMethods::Template>

=back

A listing of available method types from each of the different
subclasses is provided in L<Class::MakeMethods::Docs::Catalog>.

=head2 Related Modules

For a brief survey of the numerous modules on CPAN which offer some
type of method generation, see L<Class::MakeMethods::Docs::RelatedModules>.

If you have used Class::MethodMaker, you will note numerous
similarities.  Class::MakeMethods is based on Class::MethodMaker,
but has been substantially revised in order to provide a range of
new features.  Backward compatibility and conversion documentation
is provded in L<Class::MakeMethods::Emulator::MethodMaker>.

In several cases, Class::MakeMethods provides functionality closely
equivalent to that of an existing module, and emulator modules are
provided to map the existing module's interface to that of
Class::MakeMethods.  See L<Class::MakeMethods::Emulator> for more
information.

=head2 Perl Docs

See L<perlboot> for a quick introduction to objects for beginners.
For an extensive discussion of various approaches to class
construction, see L<perltoot> and L<perltootc> (called L<perltootc>
in the most recent versions of Perl).

See L<perlref/"Making References">, point 4 for more information
on closures. (FWIW, I think there's a big opportunity for a "perlfunt"
podfile bundled with Perl in the tradition of "perlboot" and
"perltoot", exploring the utility of function references, callbacks,
closures, and continuations... There are a bunch of useful references
available, but not a good overview of how they all interact in a
Perlish way.)


=head1 BUGS AND SUPPORT

=head2 Release Status

This module has been used in a variety of production systems and
has been available on CPAN for over two years, with several other
distributions dependant on it, so it would be fair to say that it
is fully released. 

However, while some portions are well tested, others are less so,
and new bug reports do trickle in occasionally. If you do encounter
any problems, please inform the author and I'll endeavor to patch
them promptly. 

Additional features have been outlined for future development, but
the intent is support these by adding more options to the declaration
interface, while maintaining backward compatibility.

=head2 Known Problems

It does not appear to be possible to assign subroutine names to
closures within Perl. As a result, debugging output from Carp and
similar sources will show all generated methods as "ANON()" rather
than "YourClass::methodname()".

See L<Class::MakeMethods::Docs::ToDo> for other outstanding issues
and development plans.

=head2 Support

If you have questions or feedback about this module, please feel
free to contact the author at the below address. Although there is
no formal support program, I do attempt to answer email promptly. 

I would be particularly interested in any suggestions towards
improving the documentation, correcting any Perl-version or platform
dependencies, as well as general feedback and suggested additions.

Bug reports that contain a failing test case are greatly appreciated,
and suggested patches will be promptly considered for inclusion in
future releases.

To report bugs via the CPAN web tracking system, go to 
C<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Class-MakeMethods> or send mail 
to C<Dist=Class-MakeMethods#rt.cpan.org>, replacing C<#> with C<@>.

=head2 Community

If you've found this module useful or have feedback about your
experience with it, consider sharing your opinion with other Perl
users by posting your comment to CPAN's ratings system:

=over 2

=item *