On Sat, Feb 08, 2020 at 03:33:37PM -0700, Theo de Raadt wrote: > Jason McIntyre <[email protected]> wrote: > > > without getting into a discussion about /etc/examples, in this case i > > personally see neither the point of the example config file (so trivial > > as to be questionable) nor the addition to the man page (if the example > > is worthwhile, add it to mixerctl, not the conf page). > > there is additional pieces of "documentation" that occurs here > > - this is a filename, which if placed one directory above., would > perform a function > - the comment format of the file is demonstrated > - the basic format of the file is demonstrated (is it simply a series > of name=value, or have we created a richer DSL)
- points out common use case > you can argue that is in the manual page. It is. After you read a > lot more. There is a pace-of-learning going on here. Noone ever > demanded that learning must come from a man page, additional sources > of transient information are not prohibited, but I'm picking up a > disdain for information learned any other way... I agree with that, personally I find /etc/examples/ helpful.
