ok benno@
Jason McIntyre(j...@kerhand.co.uk) on 2018.06.17 21:23:50 +0100: > hi. > > diff below removes the section header SECTIONS for conf files, > preventing a one line DESCRIPTION. it also stops numbering the amount of > sections because a) it is unimportant and b) every time we add or remove > a section the doc goes out of date. > > ok? > jmc > > Index: usr.sbin/bgpd/bgpd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/bgpd/bgpd.conf.5,v > retrieving revision 1.168 > diff -u -r1.168 bgpd.conf.5 > --- usr.sbin/bgpd/bgpd.conf.5 13 Jun 2018 10:43:03 -0000 1.168 > +++ usr.sbin/bgpd/bgpd.conf.5 17 Jun 2018 20:19:25 -0000 > @@ -27,10 +27,10 @@ > .Xr bgpd 8 > daemon implements the Border Gateway Protocol version 4 as described > in RFC 4271. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into five main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/dvmrpd/dvmrpd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/dvmrpd/dvmrpd.conf.5,v > retrieving revision 1.8 > diff -u -r1.8 dvmrpd.conf.5 > --- usr.sbin/dvmrpd/dvmrpd.conf.5 24 Apr 2012 14:56:09 -0000 1.8 > +++ usr.sbin/dvmrpd/dvmrpd.conf.5 17 Jun 2018 20:19:25 -0000 > @@ -28,10 +28,10 @@ > .Xr dvmrpd 8 > daemon implements the Distance Vector Multicast Routing Protocol as described > in draft-ietf-idmr-dvmrp-v3-11 DVMRP Version 3. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into three main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/eigrpd/eigrpd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/eigrpd/eigrpd.conf.5,v > retrieving revision 1.6 > diff -u -r1.6 eigrpd.conf.5 > --- usr.sbin/eigrpd/eigrpd.conf.5 24 Dec 2015 05:42:54 -0000 1.6 > +++ usr.sbin/eigrpd/eigrpd.conf.5 17 Jun 2018 20:19:25 -0000 > @@ -28,10 +28,10 @@ > The > .Xr eigrpd 8 > daemon implements the Enhanced Interior Gateway Routing Protocol. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into four main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/hostapd/hostapd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/hostapd/hostapd.conf.5,v > retrieving revision 1.45 > diff -u -r1.45 hostapd.conf.5 > --- usr.sbin/hostapd/hostapd.conf.5 26 Mar 2015 20:34:54 -0000 1.45 > +++ usr.sbin/hostapd/hostapd.conf.5 17 Jun 2018 20:19:25 -0000 > @@ -25,10 +25,10 @@ > is the configuration file for the > .Xr hostapd 8 > daemon. > -.Sh SECTIONS > +.Pp > The > .Nm > -file is divided into four main sections. > +file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/httpd/httpd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/httpd/httpd.conf.5,v > retrieving revision 1.99 > diff -u -r1.99 httpd.conf.5 > --- usr.sbin/httpd/httpd.conf.5 15 Jun 2018 17:17:40 -0000 1.99 > +++ usr.sbin/httpd/httpd.conf.5 17 Jun 2018 20:19:26 -0000 > @@ -24,9 +24,9 @@ > .Nm > is the configuration file for the HTTP daemon, > .Xr httpd 8 . > -.Sh SECTIONS > +.Pp > .Nm > -is divided into four main sections: > +is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/ifstated/ifstated.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/ifstated/ifstated.conf.5,v > retrieving revision 1.12 > diff -u -r1.12 ifstated.conf.5 > --- usr.sbin/ifstated/ifstated.conf.5 6 Mar 2018 15:18:27 -0000 1.12 > +++ usr.sbin/ifstated/ifstated.conf.5 17 Jun 2018 20:19:26 -0000 > @@ -28,10 +28,10 @@ > determines by monitoring interface link state or running external tests. > .Nm > is the configuration file for this daemon. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into three main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Global Configuration > Global settings for > Index: usr.sbin/switchd/switchd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/switchd/switchd.conf.5,v > retrieving revision 1.6 > diff -u -r1.6 switchd.conf.5 > --- usr.sbin/switchd/switchd.conf.5 8 Mar 2017 09:41:40 -0000 1.6 > +++ usr.sbin/switchd/switchd.conf.5 17 Jun 2018 20:19:26 -0000 > @@ -27,9 +27,9 @@ > .Nm > is the configuration file for the switch daemon, > .Xr switchd 8 . > -.Sh SECTIONS > +.Pp > .Nm > -files is divided into two main sections: > +files is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and user later, simplifying the > Index: usr.sbin/iscsictl/iscsi.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/iscsictl/iscsi.conf.5,v > retrieving revision 1.2 > diff -u -r1.2 iscsi.conf.5 > --- usr.sbin/iscsictl/iscsi.conf.5 21 Apr 2014 17:33:20 -0000 1.2 > +++ usr.sbin/iscsictl/iscsi.conf.5 17 Jun 2018 20:19:26 -0000 > @@ -27,10 +27,10 @@ > .Xr iscsid 8 > daemon implements the Internet Small Computer Systems Interface as described > in RFC 3720. > -.Sh SECTIONS > +.Pp > The > .Nm > -configuration file is divided into three main sections: > +configuration file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/ldpd/ldpd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/ldpd/ldpd.conf.5,v > retrieving revision 1.34 > diff -u -r1.34 ldpd.conf.5 > --- usr.sbin/ldpd/ldpd.conf.5 3 Mar 2017 23:36:06 -0000 1.34 > +++ usr.sbin/ldpd/ldpd.conf.5 17 Jun 2018 20:19:26 -0000 > @@ -29,10 +29,10 @@ > The > .Xr ldpd 8 > daemon implements the Label Distribution Protocol as described in RFC 5036. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into seven main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/npppd/npppd/npppd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/npppd/npppd/npppd.conf.5,v > retrieving revision 1.21 > diff -u -r1.21 npppd.conf.5 > --- usr.sbin/npppd/npppd/npppd.conf.5 12 Aug 2017 11:20:34 -0000 1.21 > +++ usr.sbin/npppd/npppd/npppd.conf.5 17 Jun 2018 20:19:26 -0000 > @@ -24,9 +24,9 @@ > .Nm > is the configuration file for the PPP daemon > .Xr npppd 8 . > -.Sh SECTIONS > +.Pp > .Nm > -is divided into six sections: > +is divided into the following main sections: > .Pp > .Bl -tag -width "AuthenticationXXX" -offset indent -compact > .It Sy Global > Index: usr.sbin/ospf6d/ospf6d.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/ospf6d/ospf6d.conf.5,v > retrieving revision 1.13 > diff -u -r1.13 ospf6d.conf.5 > --- usr.sbin/ospf6d/ospf6d.conf.5 12 Jun 2018 20:12:36 -0000 1.13 > +++ usr.sbin/ospf6d/ospf6d.conf.5 17 Jun 2018 20:19:26 -0000 > @@ -28,10 +28,10 @@ > .Xr ospf6d 8 > daemon implements the Open Shortest Path First protocol version 3 as > described > in RFC 5340. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into three main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/ospfd/ospfd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/ospfd/ospfd.conf.5,v > retrieving revision 1.51 > diff -u -r1.51 ospfd.conf.5 > --- usr.sbin/ospfd/ospfd.conf.5 5 Feb 2018 12:43:29 -0000 1.51 > +++ usr.sbin/ospfd/ospfd.conf.5 17 Jun 2018 20:19:26 -0000 > @@ -28,10 +28,10 @@ > .Xr ospfd 8 > daemon implements the Open Shortest Path First protocol version 2 as > described > in RFC 2328. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into three main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/relayd/relayd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/relayd/relayd.conf.5,v > retrieving revision 1.184 > diff -u -r1.184 relayd.conf.5 > --- usr.sbin/relayd/relayd.conf.5 20 Apr 2018 16:21:32 -0000 1.184 > +++ usr.sbin/relayd/relayd.conf.5 17 Jun 2018 20:19:28 -0000 > @@ -25,9 +25,9 @@ > .Nm > is the configuration file for the relay daemon, > .Xr relayd 8 . > -.Sh SECTIONS > +.Pp > .Nm > -is divided into seven main sections: > +is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/ripd/ripd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/ripd/ripd.conf.5,v > retrieving revision 1.14 > diff -u -r1.14 ripd.conf.5 > --- usr.sbin/ripd/ripd.conf.5 24 Apr 2012 14:56:09 -0000 1.14 > +++ usr.sbin/ripd/ripd.conf.5 17 Jun 2018 20:19:28 -0000 > @@ -29,10 +29,10 @@ > .Xr ripd 8 > daemon implements the Routing Information Protocol version 2 as described > in RFC 2453. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into three main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/snmpd/snmpd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/snmpd/snmpd.conf.5,v > retrieving revision 1.37 > diff -u -r1.37 snmpd.conf.5 > --- usr.sbin/snmpd/snmpd.conf.5 15 May 2018 15:54:51 -0000 1.37 > +++ usr.sbin/snmpd/snmpd.conf.5 17 Jun 2018 20:19:28 -0000 > @@ -25,10 +25,10 @@ > is the configuration file for the > .Xr snmpd 8 > daemon. > -.Sh SECTIONS > +.Pp > The > .Nm > -file is divided into four main sections: > +file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/vmd/vm.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/vmd/vm.conf.5,v > retrieving revision 1.28 > diff -u -r1.28 vm.conf.5 > --- usr.sbin/vmd/vm.conf.5 13 May 2018 22:48:11 -0000 1.28 > +++ usr.sbin/vmd/vm.conf.5 17 Jun 2018 20:19:29 -0000 > @@ -29,9 +29,9 @@ > .Ar host . > The VMM subsystem is responsible for creating, destroying, and > executing VMs. > -.Sh SECTIONS > +.Pp > .Nm > -is divided into four main sections: > +is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the > Index: usr.sbin/ypldap/ypldap.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/ypldap/ypldap.conf.5,v > retrieving revision 1.21 > diff -u -r1.21 ypldap.conf.5 > --- usr.sbin/ypldap/ypldap.conf.5 30 May 2017 12:17:17 -0000 1.21 > +++ usr.sbin/ypldap/ypldap.conf.5 17 Jun 2018 20:19:29 -0000 > @@ -24,10 +24,10 @@ > The > .Xr ypldap 8 > daemon provides YP maps using LDAP as a backend. > -.Sh SECTIONS > +.Pp > The > .Nm > -config file is divided into three main sections. > +config file is divided into the following main sections: > .Bl -tag -width xxxx > .It Sy Macros > User-defined variables may be defined and used later, simplifying the >