[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal")





On Thu, Dec 29, 2016 at 12:59 PM, Xen <list@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.

Reply to: