Die Doku bei Perl-Modulen ist auch bei verbreiteten Modulen nicht immer sonderlich gut. Selbst technisch bewanderte Leute haben bei manchen Modulen von CPAN Schwierigkeiten bei der Doku, wenn ich das so an Erfahrungen bei IO::Socket::SSL oder Crypt::SSLeay denke, krieg ich immer noch Zustände und das Haare raufen.

Perl hat den Ruf unlesbar zu sein, ja, aber unlesbare Dokumentation macht dessen Module unverbreitbar und nur für Gurus lesbar. Wenn nur die Programmierer da gut durchblicken, können andere die Dokumentation auch nicht mit verbessern.