Path: utzoo!utgpu!jarvis.csri.toronto.edu!cs.utexas.edu!swrinde!zaphod.mps.ohio-state.edu!usc!apple!motcsd!hpda!hpcupt1!jamiller
From: jamiller@hpcupt1.HP.COM (Jim Miller)
Newsgroups: comp.lang.c
Subject: Re: Inappropiate "BUGS" Sections
Message-ID: <5940019@hpcupt1.HP.COM>
Date: 10 Mar 90 01:01:37 GMT
References: <27625@cup.portal.com>
Organization: Hewlett Packard, Cupertino
Lines: 14

>Not looking at documents from the customer perspective is one of 
>the marks of engineers.  We all need to improve in this area.

The Un*x man pages tend to be for programmers, especially the ones
under attack/consideration.  "WE" are the users for most the subjects under
definition.  The Manager is the buyer, not the user.  I will maintain that
the pages are more useful to the user (me) the way they are, even if not
as pretty to the buyer.  If the buyer asks his customers (the programmers)
which they prefer instead of telling him what he needs (and how long it
will take, and what exactly will be in it, and never mind the two are
not compatible ...)  the man pages as they exist will win out over
"professional" (suit, tie, and useless) ones.

    jim - i like them, i use them, i do not like the alternative - miller