Re: man pages and GNOME docs [was Re: gtt suggestions]

[csmall scooter o i net]

Mark Galassi wrote:
> That's quite incorrect.  Some GNU programs have man pages by chance,
> and the GNU coding standards discourage spending time on maintaining
> them: take a look at the documentation part of the GNU coding
> standards -- it's quite explicit.  And in practice most GNU programs
> don't have man pages, especially the recent ones.  Do you find man
> pages for automake or gettext?
No, and that is a 100% pain.  It's ok for me, I know that there is probably
an info file for it.

I cannot believe that's a standard, I thought that at the very least they
would have a pointer to the real source of information. A "it's not here
but 'info foo' will tell you what you need to know" man page is not going
to take up much of anyone's time.  The alternative, having no man pages,
is just plain user unfriendly; we're trying to help users, not hide the
documentation from them.

Now we all know that info pages exist, but some people don't.  At least 
some Unix newbies should know man.

Now how/where the real information is kept, well that's another story.

  - Craig

-- 
Craig Small VK2XLZ, PGP: AD 8D D8 63 6E BF C3 C7  47 41 B1 A2 1F 46 EC 90
|@work: csmall@scooter.o.i.net,            @play: vk2xlz@vk2xlz.ampr.org|
|@home: csmall@small.dropbear.id.au,           @debian:csmall@debian.org|
Finger csmall@triode.net.au for PGP key, http://www.triode.net.au/~csmall