Jason McIntyre <j...@kerhand.co.uk> wrote: > On Fri, May 01, 2020 at 07:13:53AM -0600, Theo de Raadt wrote: > > I think there's a bit of drama going on here. > > > > Once a person uses one example in the examples directory, they > > will become aware of the directory and see it has other files. > > And possibly use them in the future. > > > > It is not clear to me that example discovery has to come via > > each and every manual page. > > > > yes, that's perfectly true. but it's also a bit about consistency - why > would we add entries to some pages and not others? i suppose we do it or > not.
Well there is one reason to not add it to every page: trying to control verbosity, and avoiding pages all becoming the same without individual personal touches.