Ingo Schwarze(schwa...@usta.de) 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. > Index: bgpd.8 > =================================================================== > RCS file: /cvs/src/usr.sbin/bgpd/bgpd.8,v > retrieving revision 1.62 > diff -u -p -r1.62 bgpd.8 > --- bgpd.8 10 Nov 2019 20:51:53 -0000 1.62 > +++ bgpd.8 8 Feb 2020 23:24:28 -0000 > @@ -205,11 +205,13 @@ Only check the configuration file for va > Produce more verbose output. > .El > .Sh FILES > -.Bl -tag -width "/var/run/bgpd.sockXXX" -compact > +.Bl -tag -width "/etc/examples/bgpd.conf" -compact > .It Pa /etc/bgpd.conf > default > .Nm > configuration file > +.It Pa /etc/examples/bgpd.conf > +example file, do not edit > .It Pa /var/run/bgpd.sock > default > .Nm > Index: bgpd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/bgpd/bgpd.conf.5,v > retrieving revision 1.199 > diff -u -p -r1.199 bgpd.conf.5 > --- bgpd.conf.5 25 Jan 2020 12:07:28 -0000 1.199 > +++ bgpd.conf.5 8 Feb 2020 23:24:28 -0000 > @@ -1883,10 +1883,12 @@ For prefixes with equally long paths, th > is selected. > .El > .Sh FILES > -.Bl -tag -width "/etc/bgpd.conf" -compact > +.Bl -tag -width "/etc/examples/bgpd.conf" -compact > .It Pa /etc/bgpd.conf > .Xr bgpd 8 > configuration file > +.It Pa /etc/examples/bgpd.conf > +example file, do not edit > .El > .Sh SEE ALSO > .Xr strftime 3 , >