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

Re: Poor State of the Man Pages

Alan Burlison
November 27, 2003 02:14
Re: Poor State of the Man Pages
Message ID:
Shlomi Fish wrote:

> Are you with me? I volunteer to take the initial effort and get this
> effort going. One thing that has to be understood is that the man pages
> should be clear, explanatory, and organized. We cannot leave
> "transliterate" as such because it's a piece of UNIX jargon and not plain
> English. (for example).

Looks like English to me:

I'm all in favour of improving documentation, but I would not like to see 
the documents 'dumbed down'.  The online manpages are meant primarily as a 
reference for people who already know some perl, not as an introductory text 
- as you have already said there are plenty of good introductory books that 
already cover this ground.

Alan Burlison
-- Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About