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