On Sun, Feb 09, 2020 at 01:37:33PM +0000, Jason McIntyre wrote: > On Sun, Feb 09, 2020 at 02:27:23PM +0100, Marc Espie wrote: > > On Sun, Feb 09, 2020 at 12:41:43AM +0100, Sebastian Benoit wrote: > > > Ingo Schwarze([email protected]) on 2020.02.09 00:33:06 +0100: > > > > Hi, > > > > > > > > Jason McIntyre wrote on Sat, Feb 08, 2020 at 10:15:08PM +0000: > > > > > > > > > - i'm ok with adding the path to these files to a FILES section > > > > > > > > So, here is a specific patch for bgpf.conf(5) and bgpd(8) such > > > > that we can agree on a general direction for one case where > > > > the example file is particularly important. > > > > > > > > Once the direction is agreed, applying it to the relatively > > > > small number of other cases is likely not difficult. > > > > > > > > OK? > > > > Ingo > > > > > > I'm not against this as it only adds to the manpage, but an > > > alternative could be to just tell users (in afterboot(8)?) that there is > > > /etc/examples for them to look at and see whats there? > > > > > > Otherwise ok. > > > > I still think it's a good idea to put it in afterboot(8). > > That was the patch I sent to a few people that obviously triggered Ingo. > > > > As for /etc/examples, I still think that directory has merits. > > It's WAY easier to copy an example file and uncomment/tweak the parts you > > need while skimming through the manpage than creating one from scratch. > > > > Also, cut&paste from an EXAMPLE in the manpage is distasteful. > > > > Yeah, it's more info that has to be kept in synch. So what ? It's still > > useful, so it should stay. > > > > Here's an updated version, taking Theo's remarks into account. > > > > hi. i'm fine with your text, but it would be better placed in the > section "Daemons" (yes i'm aware not all the files are for daemons) > or a new section in "FURTHER CHANGES". > > jmc
Sorry, I saw your message a bit late. I don't think it's a good idea. Specifically, that text should come in as early as possible. "FURTHER CHANGES" sound like a section near the end. "Daemons" also comes very late in the game (after ntpd, after sysctl.conf, which do have /etc/examples scripts) also, you should update, as your email setup is broken. any direct email to you have come back with <forwarder address redacted>: 553 ORCPT address syntax error which according to Stuart, has been fixed in recent snaps.
