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) 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...
