Trying to learn a new language that at first sight is very poorly documented (no -- votes for this please... i have been using perl for a few months before finding this site, and learning how to use the docs properly)

I'll refrain from downvoting you, but let me ask this: What makes it "poorly documented"? Did you not install the documentation that comes with it? Could you not figure out how to use it? And a more useful question, what would have improved your perception of the documentation?

People always go on and on about php's wonderful documentation, and I just don't understand it. They don't even have a command line tool for access documentation do they? So what could be improved about perl's documentation? Surely not the quantity. Perhaps the quality? Or is it just too hard to use? Maybe it needs a better website?

---

---

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.