[src/trunk]: src/usr.sbin/services_mkdb services(5): consistently refer to th...

[uwe <uwe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/ea1a0824c16e
branches:  trunk
changeset: 373493:ea1a0824c16e
user:      uwe <uwe%NetBSD.org@localhost>
date:      Sun Feb 12 22:48:02 2023 +0000

description:
services(5): consistently refer to the cdb database

While here, fix a few markup nits.

diffstat:

 share/man/man5/services.5              |  23 ++++++++++-----------
 usr.sbin/services_mkdb/services_mkdb.8 |  35 +++++++++++++++++----------------
 2 files changed, 29 insertions(+), 29 deletions(-)

diffs (151 lines):

diff -r b5e68c437b05 -r ea1a0824c16e share/man/man5/services.5
--- a/share/man/man5/services.5 Sun Feb 12 20:43:21 2023 +0000
+++ b/share/man/man5/services.5 Sun Feb 12 22:48:02 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: services.5,v 1.10 2009/05/13 12:58:34 wiz Exp $
+.\"    $NetBSD: services.5,v 1.11 2023/02/12 22:48:02 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)services.5 8.1 (Berkeley) 6/5/93
 .\"
-.Dd June 19, 2007
+.Dd February 12, 2023
 .Dt SERVICES 5
 .Os
 .Sh NAME
@@ -56,11 +56,11 @@
 The port number and protocol name are considered a single
 .Em item ;
 a slash
-.Pq Dq /
-is used to separate the port and protocol (e.g.
-.Dq 512/tcp ) .
+.Pq Ql /
+is used to separate the port and protocol
+.Pq e.g. Ql 512/tcp .
 A hash
-.Pq Dq \&#
+.Pq Ql #
 indicates the beginning of
 a comment; subsequent characters up to the end of the line are
 not interpreted by the routines which search the file.
@@ -69,17 +69,16 @@
 field delimiter, newline, or comment character.
 .Pp
 The database in
-.Pa /var/db/services.db
+.Pa /var/db/services.cdb
 needs to be updated with
 .Xr services_mkdb 8
 after changes to the services file have been applied.
 .Sh FILES
-.Bl -tag -width /etc/services -compact
+.Bl -tag -width Pa -compact
 .It Pa /etc/services
-The
-.Nm services
-file resides in
-.Pa /etc .
+The current services file.
+.It Pa /var/db/services.cdb
+The current services database.
 .El
 .Sh SEE ALSO
 .Xr getservent 3 ,
diff -r b5e68c437b05 -r ea1a0824c16e usr.sbin/services_mkdb/services_mkdb.8
--- a/usr.sbin/services_mkdb/services_mkdb.8    Sun Feb 12 20:43:21 2023 +0000
+++ b/usr.sbin/services_mkdb/services_mkdb.8    Sun Feb 12 22:48:02 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: services_mkdb.8,v 1.12 2010/05/05 22:11:19 wiz Exp $
+.\"    $NetBSD: services_mkdb.8,v 1.13 2023/02/12 22:48:02 uwe Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 5, 2010
+.Dd February 12, 2023
 .Dt SERVICES_MKDB 8
 .Os
 .Sh NAME
@@ -45,7 +45,7 @@
 .Sh DESCRIPTION
 .Nm
 creates a
-.Xr db 3
+.Xr cdb 5
 database for the specified file.
 If no file is specified, then
 .Pa /etc/services
@@ -54,13 +54,13 @@
 .Pa /var/db/services.cdb
 for CDB format and into
 .Pa /var/db/services.db
-for DB format (see
+for legacy DB format (see
 .Fl V ) .
-The file must be in the correct format (see
-.Xr services 5 ) .
+The file must be in the correct format
+.Pq see Xr services 5 .
 .Pp
 The options are as follows:
-.Bl -tag -width indent
+.Bl -tag -width Fl
 .It Fl o Ar database
 Put the output databases in the named file.
 .It Fl q
@@ -68,13 +68,13 @@
 This is the default behavior.
 .It Fl u
 Print the services file to stdout, omitting duplicate entries and comments.
-.It Fl V
+.It Fl V Ar style
 Create a specific version of the database style.
 .Ar style
 can be
-.Li cdb
+.Cm cdb
 to request the CDB format (default) or
-.Li db
+.Cm db
 to request the DB format.
 The DB format is useful for compatibility with old statically
 linked binaries.
@@ -82,23 +82,24 @@
 Warn about duplicate services.
 .El
 .Pp
-The databases are used by the C library services routines (see
-.Xr getservent 3 ) .
+The databases are used by the C library services routines
+.Pq see Xr getservent 3 .
 .Pp
 .Nm
 exits zero on success, non-zero on failure.
 .Sh FILES
-.Bl -tag -width 24n -compact
-.It Pa /var/db/services.db
-The current services database.
-.It Pa /var/db/services.db.tmp
-A temporary file.
+.Bl -tag -width Pa -compact
 .It Pa /etc/services
 The current services file.
+.It Pa /var/db/services.cdb
+The current services database.
+.It Pa /var/db/services.cdb.tmp
+A temporary file.
 .El
 .Sh SEE ALSO
 .Xr db 3 ,
 .Xr getservent 3 ,
+.Xr cdb 5 ,
 .Xr services 5
 .Sh BUGS
 Because