Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-16 Thread Jason McIntyre
On Thu, Apr 30, 2020 at 07:13:16PM +0200, clematis wrote: > Hello, > > Following the previous thread about /etc/examples/doas.conf [1] , > I've noticed those example files aren't always listed in their > respective manpage or without a description. > This has been discussed here recently for

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-02 Thread Theo de Raadt
gwes wrote: > On 5/1/20 9:13 AM, 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

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-02 Thread gwes
On 5/1/20 9:13 AM, 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

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-01 Thread Theo de Raadt
Jason McIntyre 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

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-01 Thread Jason McIntyre
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

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-01 Thread Theo de Raadt
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

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-01 Thread Ingo Schwarze
Hi, clematis wrote on Fri, May 01, 2020 at 11:37:51AM +0200: > On Fri, May 01, 2020 at 06:52:27AM +0100, Jason McIntyre wrote: >> i don;t understand your reference to 28 out of 41 files. i cannot see >> where we added any expanded FILES entries. can you provide a summary of >> these

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-01 Thread clematis
On Fri, May 01, 2020 at 06:52:27AM +0100, Jason McIntyre wrote: > i don;t understand your reference to 28 out of 41 files. i cannot see > where we added any expanded FILES entries. can you provide a summary of > these inconsistencies, please? There's 41 example files in /etc/examples/. 28 of them

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-01 Thread Marc Espie
I do think newcomers will tend to miss examples, even if /etc/examples is somewhat documented elsewhere. Also, queries to mandocdb will probably benefit... say "what commands do have an example configuration file ?" kind of what you should be able to ask with advanced queries.

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-05-01 Thread Theo de Raadt
Jason McIntyre wrote: > > Just so this now applies to all /etc/examples/ files' manpages > > "consistently". > > > > Cheers, > > -- > > clematis (0xA2C87EDB507B4C53) > > > > ok, so i see from those threads that i was against expanding FILES, but > happy for entries for the corresponding

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-04-30 Thread Jason McIntyre
On Fri, May 01, 2020 at 12:22:26AM +0200, clematis wrote: > On Thu, Apr 30, 2020 at 07:20:04PM +0100, Jason McIntyre wrote: > > On Thu, Apr 30, 2020 at 07:13:16PM +0200, clematis wrote: > > > Hello, > > > > > > Following the previous thread about /etc/examples/doas.conf [1] , > > > I've noticed

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-04-30 Thread clematis
On Thu, Apr 30, 2020 at 07:20:04PM +0100, Jason McIntyre wrote: > On Thu, Apr 30, 2020 at 07:13:16PM +0200, clematis wrote: > > Hello, > > > > Following the previous thread about /etc/examples/doas.conf [1] , > > I've noticed those example files aren't always listed in their > > respective

Re: Mention /etc/examples/ in those config files manpages + FILES short description

2020-04-30 Thread Jason McIntyre
On Thu, Apr 30, 2020 at 07:13:16PM +0200, clematis wrote: > Hello, > > Following the previous thread about /etc/examples/doas.conf [1] , > I've noticed those example files aren't always listed in their > respective manpage or without a description. > This has been discussed here recently for