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.
It is very successful. You can see it all around, there are very many
such successful man pages.
Trying to turn /usr/share/doc into something useful when it is not, is
not going to work however.
