++

I'm also relying on perlmonks in order to find examples, which are commented, corrected,..
However, having these examples in the docs would be a big advantage, finally the docs should be there for not having the need of any further documentation sources.

I like the approach of some module authors, who create a examples subdir in their module distribution. (Although I always have to digg into my ~/.cpan/..)

That's how I try to get familiar with new modules (and also programming languages):

• Separate the problem to solve of the rest of the program
• Write a small script
• Try to get examples, copy them into the script, replace the names, extend the examples
• Play around with the script, until I've got a good feeling/the script does what it's supposed to do...

Although that's sort of copy and paste programming, I'm able to get familiar with new modules quite fast this way.
I'd think the important point is the playing with the script..

I should also remark that I've got some directories which contain such small scripts.
This way I'm able to remember and reuse solutions I already figured out.

---

---

Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!

Titles consisting of a single word are discouraged, and in most cases are disallowed outright.

Read Where should I post X? if you're not absolutely sure you're posting in the right place.

Please read these before you post! —

• How do I compose an effective node title?
• How do I post a question effectively?
• Markup in the Monastery

Posts may use any of the Perl Monks Approved HTML tags:

a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr

You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)

	For:		Use:
	&		&
	<		&lt;
	>		&gt;
	[		&#91;
	]		&#93;

Link using PerlMonks shortcuts! What shortcuts can I use for linking?

See Writeup Formatting Tips and other pages linked from there for more info.