in reply to RE: Many many modules in thread Many many modules
...but in general, Perl modules lack good documentation...
I have to disagree, because IMHO, Perl Modules come with a rather good documentation, as you mentioned the perldoc. This is sufficient in most cases, if you just want to use the module. Of course, if you want to write and/or _understand_ a module, you have to look elsewhere.
RE: RE: RE: Many many modules (Perl documentation isn't bad in general)
by Corion (Patriarch) on Jul 26, 2000 at 18:10 UTC
|
Hmmm - after desperately searching for a module in the
standard distribution of Perl, I have to admit that I can't come up with an example of bad documentation. I only remember that the documentation for HTML::Parser was really bad, as they documented that one could "use either the version 2 compatible interface" (which was nowhere documented but maybe in the obsolete version of this module that was no more around) or the new (and completely different) version 3 interface, but the documentation completely lacked any example. Maybe that's because the documentation for this module is supposed to be in some book, I don't know.
But nonetheless, I have to admit, Perl module documentation is not bad in general, it was only my
perception of the documentation (you seldom notice good documentation :).
| [reply] |
|