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.

Reply via email to