Catherine Gramze schreef op 29-12-2016 19:31:
On Thu, Dec 29, 2016 at 12:59 PM, Xen <l...@xenhideout.nl> wrote:
But if you are going to say the purpose of a man page is to be a
complete reference guide unto its options, then you will write dirt
poor man pages. That is all I can say here
.
But that is precisely the original function of the man pages, to
serve as a complete reference, not as any sort of tutorial. That is
what those other /usr/share/doc documents were supposed to be, for
people who found the man pages too difficult to use. Trying to wish
the man pages into something they were never designed to be is likely
to be unsuccessful.
More importantly the man system or man format does not preclude such
documents being written as tutorials so basically it is being done all
around.
So your assertion here does not really have a basis in reality I must
say: the system does not preclude this from being done. People can do it
all they want, and they do it.
It is the people that insist on not doing it, that write poor man pages.
