develooper Front page | perl.perl5.porters | Postings from November 2003

Re: Poor State of the Man Pages

Rafael Garcia-Suarez
November 29, 2003 08:49
Re: Poor State of the Man Pages
Message ID:
H.Merijn Brand wrote:
> If you regard 'info' files as documentation, I fully disagree. One has to be
> an emacs user to be able to read that, and even then, finding the info you
> need takes too much time. man or pod, all info is ready for immediate
> trashcanning and can IMHO *never* be marked good documentation. If you ask me,
> it cannot be marked documentation at all.

I wholeheartedly agree with this intolerant statement.

Also, I've often remarked that it's very hard to find specific info in
the GNU docs : changes and history ? no. Deviations from the standard ?
nope. Portability issues ? none. Edge cases ? surely you jest. The perl
docs aren't so bad after all. Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About