[comp.sources.d] Mush man page

kyle@xanth.UUCP (10/02/87)

In article <42400003@uicsrd>, kai@uicsrd.csrd.uiuc.edu writes:
> What is shipped as a man page is over 40 printed pages long, and
> should be considered a User Guide.  A short man page should be
> created.

Maybe.

I've discovered that users in general do not like to be referred
somewhere else to get information on a command.  This is partially
laziness and partially because if they look, the referred to manuals
are nowhere to be found.

If the referred to manuals are on the system they are most like in
nroff/troff form, which means the user has to know how to set up a
tbl|nroff|col|more pipeline to finally get the manual onto his screen.
This is ridiculous considering all the user originally wanted to do
was learn how to use vi.