in reply to Struggling with Modules

If I understand you right, you're finding existing modules hard to understand how to use (rather than having problems writing your own).

It's true that few CPAN modules come with their own separate tutorials, but you can usually get clues from the include POD documentation. In most cases, the sample code in the SYNOPSIS portion actually works by itself, or would work inside a trivial program.

There are a few problems that I've seen with people using my CPAN modules. One is that they don't read the documentation in detail. A characteristic of much CPAN module documentation is that it doesn't repeat itself. The answer is probably in there, once, but you may have to look carefully. This is a different tack than most books take; it's typical in books to see the same information presented multiple times in different contexts. Not so in most CPAN modules. Another information source is example programs that might be included with the module. Also look at the test programs; these at least work.

To make your life easier with OO modules, also make sure you understand references and Perl's object model. As has been suggested, read and understand perlmod, perlmodlib, perltoot, and perlbot. Not that you have to understand these to use modules; it's just that you'll have an easier time with them if you do.