[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")



rhkramer@gmail.com wrote:
> My suggestion is you spend less time discussing it, and get started on
> writing a few bman pages...

Probably should be 'manng' (for 'next generation'), or perhaps mand (to
fit in with systemd) ;)

Anyway, isn't this where the differences between say "man something" and
"man 5 something" come into play?  Or rather, the implication that
section 1 (or whatever) may only hold a basic overview, and then section
5 (or whatever) will hold the full documentation.

TBH though, I kind of follow what everyone else has been saying -- the
manpages are more quick-reference type things ("how do I make tar use
bzip again?") rather than a 200-page treatise on how to set things up
from scratch.

-- 
|_|O|_| Registered Linux user #585947
|_|_|O| Github: https://github.com/dpurgert
|O|O|O| PGP: 05CA 9A50 3F2E 1335 4DC5  4AEE 8E11 DDF3 1279 A281


Reply to: