Even using Perl for freelance web development for the past ~3 years didn't help much with that. I guess I assumed that it's documentation is like any other.
And exception to that was perltoot - I stumbled upon it somewhere on Internet while I was searching for Perl OOP Tutorial.
Either way, recently I got some spare time and I gave a chance to Perl's documentation. Downloaded from Internet, in compiled HTML (chm) file type. Maybe reading JAVA built-in docs (needed something for University, and that was only thing about JAVA handy) added to it.
But honestly - I didn't realise so far that Perl's built in documentation is so good. Way better than Java's. Way better than any documentation that I saw before ...
Oh now I feel bad for not taking a look at it before!