[src/trunk]: src/lib/libc/sys socket(2): Tidy up markup a bit.

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

details:   https://anonhg.NetBSD.org/src/rev/0f4a0838e872
branches:  trunk
changeset: 376256:0f4a0838e872
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Tue Jun 06 09:10:08 2023 +0000

description:
socket(2): Tidy up markup a bit.

Use a tag list, not a literal block with hand-formatted text, for
protocols and socket type flags.

diffstat:

 lib/libc/sys/socket.2 |  44 ++++++++++++++++++++++++++------------------
 1 files changed, 26 insertions(+), 18 deletions(-)

diffs (68 lines):

diff -r 81359cf75922 -r 0f4a0838e872 lib/libc/sys/socket.2
--- a/lib/libc/sys/socket.2     Tue Jun 06 08:27:44 2023 +0000
+++ b/lib/libc/sys/socket.2     Tue Jun 06 09:10:08 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: socket.2,v 1.43 2022/06/28 20:12:52 rillig Exp $
+.\"    $NetBSD: socket.2,v 1.44 2023/06/06 09:10:08 riastradh Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -54,33 +54,41 @@ These families are defined in the includ
 .Ao Pa sys/socket.h Ac .
 The currently understood formats are:
 .Pp
-.Bd -literal -offset indent -compact
-PF_LOCAL       local (previously UNIX) domain protocols
-PF_INET                ARPA Internet protocols
-PF_INET6       IPv6 (Internet Protocol version 6) protocols
-PF_NS          Xerox Network Systems protocols
-PF_APPLETALK   AppleTalk protocols
-PF_BLUETOOTH   Bluetooth protocols
-PF_CAN         CAN bus protocols
-.Ed
+.Bl -tag -offset indent -width 20n -compact
+.It Dv PF_LOCAL
+local (previously UNIX) domain protocols
+.It Dv PF_INET
+ARPA Internet protocols
+.It Dv PF_INET6
+IPv6 (Internet Protocol version 6) protocols
+.It Dv PF_NS
+Xerox Network Systems protocols
+.It Dv PF_APPLETALK
+AppleTalk protocols
+.It Dv PF_BLUETOOTH
+Bluetooth protocols
+.It Dv PF_CAN
+CAN bus protocols
+.El
 .Pp
 The socket has the indicated
 .Fa type ,
 which specifies the semantics of communication.
 Currently defined types are:
 .Pp
-.Bd -literal -offset indent -compact
-SOCK_STREAM
-SOCK_DGRAM
-SOCK_RAW
-SOCK_SEQPACKET
-SOCK_RDM
-.Ed
+.Bl -tag -offset indent -compact
+.It Dv SOCK_STREAM
+.It Dv SOCK_DGRAM
+.It Dv SOCK_RAW
+.It Dv SOCK_SEQPACKET
+.It Dv SOCK_RDM
+.El
 .Pp
 The following flags can be or'ed to the type to condition the returned
 file descriptor:
 The following flags are valid:
-.Bl -column SOCK_NONBLOCK -offset indent
+.Pp
+.Bl -tag -offset indent -width 20n -compact
 .It Dv SOCK_CLOEXEC
 Set the close on exec property.
 .It Dv SOCK_NONBLOCK