mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

17 files changed, 66 insertions, 88 deletions

diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3
index 5aa6b07..062f60d 100644
--- a/lib/libc/gen/sysctl.3
+++ b/lib/libc/gen/sysctl.3
@@ -544,7 +544,7 @@ The fifth and sixth level names are as follows:
 .El
 .It Li PF_INET
 Get or set various global information about the IPv4
-.Pq Internet Protocol version 4 .
+(Internet Protocol version 4).
 The third level name is the protocol.
 The fourth level name is the variable name.
 The currently defined protocols and names are:
@@ -585,7 +585,7 @@ For variables net.inet.*.ipsec, please refer to
 .El
 .It Li PF_INET6
 Get or set various global information about the IPv6
-.Pq Internet Protocol version 6 .
+(Internet Protocol version 6).
 The third level name is the protocol.
 The fourth level name is the variable name.
 .Pp
diff --git a/lib/libc/gen/time.3 b/lib/libc/gen/time.3
index 1293e02..570a88d 100644
--- a/lib/libc/gen/time.3
+++ b/lib/libc/gen/time.3
@@ -66,9 +66,7 @@ Upon successful completion,
 .Fn time
 returns the value of time.
 Otherwise a value of
-.Po
-.Po Fa time_t Pc \-1
-.Pc
+.Pq Po Vt time_t Pc \-1
 is returned and the global variable
 .Va errno
 is set to indicate the error.
diff --git a/lib/libc/locale/multibyte.3 b/lib/libc/locale/multibyte.3
index 52ee84e..e909dce 100644
--- a/lib/libc/locale/multibyte.3
+++ b/lib/libc/locale/multibyte.3
@@ -77,7 +77,8 @@ Multibyte characters are used for input and output
 and code each basic element as a sequence of C
 .Va char Ns s .
 Individual basic elements may map into one or more
-.Pq up to Dv MB_CHAR_MAX
+(up to
+.Dv MB_CHAR_MAX )
 bytes in a multibyte character.
 .Pp
 The current locale
@@ -128,10 +129,10 @@ categories.
 .Pp
 For convenience in processing,
 the wide character with value 0
-.Pq the null wide character
+(the null wide character)
 is recognized as the wide character string terminator,
 and the character with value 0
-.Pq the null byte
+(the null byte)
 is recognized as the multibyte character string terminator.
 Null bytes are not permitted within multibyte characters.
 .Pp
diff --git a/lib/libc/net/addr2ascii.3 b/lib/libc/net/addr2ascii.3
index b9f6fa9..4003a83 100644
--- a/lib/libc/net/addr2ascii.3
+++ b/lib/libc/net/addr2ascii.3
@@ -105,13 +105,16 @@ addresses in the specified family:
 .Bl -tag -width AF_INETxxxx -compact
 .It Dv AF_INET
 .Li struct in_addr
-.Pq in Aq Pa netinet/in.h
+(in
+.Aq Pa netinet/in.h )
 .It Dv AF_LINK
 .Li struct sockaddr_dl
-.Pq in Aq Pa net/if_dl.h
+(in
+.Aq Pa net/if_dl.h )
 .\" .It Dv AF_INET6
 .\" .Li struct in6_addr
-.\" .Pq in Aq Pa netinet6/in6.h
+.\" (in
+.\" .Aq Pa netinet6/in6.h )
 .El
 .Sh RETURN VALUES
 The
diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3
index 7dd98a1..cd73f28 100644
--- a/lib/libc/net/getaddrinfo.3
+++ b/lib/libc/net/getaddrinfo.3
@@ -107,9 +107,7 @@ A
 .Pf non Dv -NULL
 .Fa nodename
 string can be either a node name or a numeric host address string
-.Po
-i.e., a dotted-decimal IPv4 address or an IPv6 hex address
-.Pc .
+(i.e., a dotted-decimal IPv4 address or an IPv6 hex address).
 A
 .Pf non Dv -NULL
 .Fa servname
@@ -226,13 +224,13 @@ member of the
 structure, then the returned socket address structure will be ready for a
 call to
 .Fn connect
-.Pq for a connection-oriented protocol
+(for a connection-oriented protocol)
 or either
 .Fn connect ,
 .Fn sendto ,
 or
 .Fn sendmsg
-.Pq for a connectionless protocol .
+(for a connectionless protocol).
 In this case, if the
 .Fa nodename
 argument is a
@@ -379,10 +377,8 @@ and allows cut-and-paste input of scoped addresses.
 At the moment the code supports only link-local addresses in this format.
 The scope identifier is hardcoded to name of hardware interface associated
 with the link,
-.Po
-such as
-.Li ne0
-.Pc .
+(such as
+.Li ne0 ) .
 For example,
 .Dq Li fe80::1%ne0 ,
 which means
@@ -615,7 +611,7 @@ function is defined in
 .St -p1003.1g-2000 ,
 and documented in
 .Dq Basic Socket Interface Extensions for IPv6
-.Pq RFC2553 .
+(RFC2553).
 .\"
 .Sh BUGS
 The current implementation is not thread-safe.
diff --git a/lib/libc/net/getifaddrs.3 b/lib/libc/net/getifaddrs.3
index a83e397..b1da0bc 100644
--- a/lib/libc/net/getifaddrs.3
+++ b/lib/libc/net/getifaddrs.3
@@ -114,11 +114,13 @@ field references address family specific data.  For
 .Dv AF_LINK
 addresses it contains a pointer to the
 .Fa struct if_data
-.Pq as defined in include file Aq Pa net/if.h
+(as defined in include file
+.Aq Pa net/if.h )
 which contains various interface attributes and statistics.
 For all other address families, it contains a pointer to the
 .Fa struct ifa_data
-.Pq as defined in include file Aq Pa net/if.h
+(as defined in include file
+.Aq Pa net/if.h )
 which contains per-address interface statistics.
 .Pp
 The data returned by
diff --git a/lib/libc/net/getipnodebyname.3 b/lib/libc/net/getipnodebyname.3
index b31fe33..f960957 100644
--- a/lib/libc/net/getipnodebyname.3
+++ b/lib/libc/net/getipnodebyname.3
@@ -75,12 +75,10 @@ and
 for specifying address family and operation mode.
 The additional arguments allow programmer to get address for a nodename,
 for specific address family
-.Po
-such as
+(such as
 .Dv AF_INET
 or
-.Dv AF_INET6
-.Pc .
+.Dv AF_INET6 ) .
 The functions also require an additional pointer argument,
 .Ar error_num
 to return the appropriate error code,
@@ -97,9 +95,7 @@ the
 .Ar name
 argument can be either a node name or a numeric address
 string
-.Po
-i.e., a dotted-decimal IPv4 address or an IPv6 hex address
-.Pc .
+(i.e., a dotted-decimal IPv4 address or an IPv6 hex address).
 The
 .Ar af
 argument specifies the address family, either
@@ -112,7 +108,7 @@ argument specifies the types of addresses that are searched for,
 and the types of addresses that are returned.
 We note that a special flags value of
 .Dv AI_DEFAULT
-.Pq defined below
+(defined below)
 should handle most applications.
 That is, porting simple applications to use IPv6 replaces the call
 .Bd -literal -offset
@@ -192,10 +188,8 @@ That is, if no
 records are found then a query is made for
 .Li A
 records and any found are returned as IPv4-mapped IPv6 addresses
-.Po
-.Li h_length
-will be 16
-.Pc .
+.Li ( h_length
+will be 16).
 The
 .Dv AI_V4MAPPED
 flag is ignored unless
@@ -284,9 +278,7 @@ We noted that the
 function must allow the
 .Ar name
 argument to be either a node name or a literal address string
-.Po
-i.e., a dotted-decimal IPv4 address or an IPv6 hex address
-.Pc .
+(i.e., a dotted-decimal IPv4 address or an IPv6 hex address).
 This saves applications from having to call
 .Xr inet_pton 3
 to handle literal address strings.
@@ -329,15 +321,11 @@ is a copy of the
 argument,
 .Li h_length
 is either 4
-.Po
-for
-.Dv AF_INET
-.Pc
+(for
+.Dv AF_INET )
 or 16
-.Po
-for
-.Dv AF_INET6
-.Pc ,
+(for
+.Dv AF_INET6 ) ,
 .Li h_addr_list[0]
 is a pointer to the 4-byte or 16-byte binary address,
 and
@@ -453,7 +441,7 @@ and
 .Fn getipnodebyaddr
 are documented in
 .Dq Basic Socket Interface Extensions for IPv6
-.Pq RFC2553 .
+(RFC2553).
 .\"
 .Sh BUGS
 .Fn getipnodebyname
diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3
index 6b4f02d..8dc026c 100644
--- a/lib/libc/net/getnameinfo.3
+++ b/lib/libc/net/getnameinfo.3
@@ -122,9 +122,7 @@ The first value is actually defined as the constant
 in recent versions of BIND's
 .Aq Pa arpa/nameser.h
 header
-.Po
-older versions of BIND define this constant to be 256
-.Pc
+(older versions of BIND define this constant to be 256)
 and the second is a guess based on the services listed in the current
 Assigned Numbers RFC.
 .Pp
@@ -143,12 +141,10 @@ bit
 .Dv NI_NUMERICHOST
 is set, or if the host's name cannot be located in the DNS,
 the numeric form of the host's address is returned instead of its name
-.Po
-e.g., by calling
+(e.g., by calling
 .Fn inet_ntop
 instead of
-.Fn getnodebyaddr
-.Pc .
+.Fn getnodebyaddr ) .
 If the
 .Fa flag
 bit
@@ -158,7 +154,7 @@ is set, an error is returned if the host's name cannot be located in the DNS.
 If the flag bit
 .Dv NI_NUMERICSERV
 is set, the numeric form of the service address is returned
-.Pq e.g., its port number
+(e.g., its port number)
 instead of its name.
 The two
 .Dv NI_NUMERICxxx
@@ -302,7 +298,7 @@ function is defined in
 .St -p1003.1g-2000 ,
 and documented in
 .Dq Basic Socket Interface Extensions for IPv6
-.Pq RFC2553 .
+(RFC2553).
 .\"
 .Sh BUGS
 The current implementation is not thread-safe.
diff --git a/lib/libc/net/if_indextoname.3 b/lib/libc/net/if_indextoname.3
index adf82cb..29ae464 100644
--- a/lib/libc/net/if_indextoname.3
+++ b/lib/libc/net/if_indextoname.3
@@ -139,4 +139,4 @@ R. Gilligan, S.  Thomson, J. Bound, and W. Stevens,
 The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
 .Sh STANDARDS
 These functions are defined in ``Basic Socket Interface Extensions for IPv6''
-.Pq RFC2533 .
+(RFC2533).
diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3
index c2338fc..726a41c 100644
--- a/lib/libc/net/inet6_option_space.3
+++ b/lib/libc/net/inet6_option_space.3
@@ -102,7 +102,7 @@ is the number of options to be stored in the object.
 This is of little consequence, since it is assumed that most
 Hop-by-Hop option headers and Destination option headers carry only
 one option
-.Pq appendix B of [RFC-2460] .
+(appendix B of [RFC-2460]).
 .\"
 .Ss inet6_option_init
 .Fn inet6_option_init
@@ -171,7 +171,7 @@ field is immediately followed by the 8-bit option data length field,
 which is then followed immediately by the option data.
 The caller
 initializes these three fields
-.Pq the type-length-value, or TLV
+(the type-length-value, or TLV)
 before calling this function.
 .Pp
 The option type must have a value from
@@ -439,7 +439,7 @@ The implementation first appeared in KAME advanced networking kit.
 The functions
 are documented in
 .Dq Advanced Sockets API for IPv6
-.Pq RFC2292 .
+(RFC2292).
 .\"
 .Sh BUGS
 The text was shamelessly copied from RFC2292.
diff --git a/lib/libc/net/inet6_rthdr_space.3 b/lib/libc/net/inet6_rthdr_space.3
index 2c3fd9c..d09bba6 100644
--- a/lib/libc/net/inet6_rthdr_space.3
+++ b/lib/libc/net/inet6_rthdr_space.3
@@ -106,7 +106,7 @@ header of the specified
 .Fa type
 containing the specified number of
 .Fa segments
-.Pq addresses .
+(addresses).
 For an IPv6 Type 0 Routing header, the number
 of segments must be between 1 and 23, inclusive.  The return value
 includes the size of the cmsghdr structure that precedes the Routing
@@ -218,14 +218,14 @@ and writes a new Routing
 header that sends datagrams along the reverse of that route.
 Both
 arguments are allowed to point to the same buffer
-.Pq that is, the reversal can occur in place .
+(that is, the reversal can occur in place).
 .Pp
 The return value of the function is 0 on success, or -1 upon an
 error.
 .\"
 .Ss inet6_rthdr_segments
 This function returns the number of segments
-.Pq addresses
+(addresses)
 contained in
 the Routing header described by
 .Fa cmsg .
@@ -314,7 +314,7 @@ The implementation first appeared in KAME advanced networking kit.
 The functions
 are documented in
 .Dq Advanced Sockets API for IPv6
-.Pq RFC2292 .
+(RFC2292).
 .\"
 .Sh BUGS
 The text was shamelessly copied from RFC2292.
diff --git a/lib/libc/regex/regex.3 b/lib/libc/regex/regex.3
index 9d91f20..fc9b1b3 100644
--- a/lib/libc/regex/regex.3
+++ b/lib/libc/regex/regex.3
@@ -533,12 +533,10 @@ The endpoint of one range cannot begin another.
 the limit on repetition counts in bounded repetitions, is 255.
 .Pp
 A repetition operator
-.Po
-.Ql ?\& ,
+.Ql ( ?\& ,
 .Ql *\& ,
 .Ql +\& ,
-or bounds
-.Pc
+or bounds)
 cannot follow another
 repetition operator.
 A repetition operator cannot begin an expression or subexpression
diff --git a/lib/libc/stdio/ungetc.3 b/lib/libc/stdio/ungetc.3
index f3de89d..83483be 100644
--- a/lib/libc/stdio/ungetc.3
+++ b/lib/libc/stdio/ungetc.3
@@ -61,12 +61,10 @@ stream (in reverse order).
 A successful intervening call,
 using the same stream,
 to one of the file positioning functions
-.Po
-.Xr fseek 3 ,
+.Xr ( fseek 3 ,
 .Xr fsetpos 3 ,
 or
-.Xr rewind 3
-.Pc
+.Xr rewind 3 )
 will discard the pushed back characters.
 .Pp
 One character of push-back is guaranteed,
diff --git a/lib/libc/stdtime/strptime.3 b/lib/libc/stdtime/strptime.3
index b69cbee..78ffd77 100644
--- a/lib/libc/stdtime/strptime.3
+++ b/lib/libc/stdtime/strptime.3
@@ -115,10 +115,10 @@ without
 .Fa %p
 will produce undefined results.
 Note that 12AM
-.Pq ante meridiem
+(ante meridiem)
 is taken as midnight
 and 12PM
-.Pq post meridiem
+(post meridiem)
 is taken as noon.
 .Pp
 The
diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2
index f0b9654..23bacb0 100644
--- a/lib/libc/sys/kill.2
+++ b/lib/libc/sys/kill.2
@@ -87,9 +87,12 @@ this is a variant of
 If the user has super-user privileges,
 the signal is sent to all processes excluding
 system processes
-.Pq with Dv P_SYSTEM flag set ,
+(with
+.Dv P_SYSTEM
+flag set),
 process with ID 1
-.Pq usually Xr init 8 ,
+(usually
+.Xr init 8 ) ,
 and the process sending the signal.
 If the user is not the super user, the signal is sent to all processes
 with the same uid as the user excluding the process sending the signal.
diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2
index a223b80..177d88b 100644
--- a/lib/libc/sys/ptrace.2
+++ b/lib/libc/sys/ptrace.2
@@ -23,10 +23,8 @@ process) to control another (the
 .Em traced
 process).  Most of the time, the traced process runs normally, but when
 it receives a signal
-.Po
-see
-.Xr sigaction 2
-.Pc ,
+(see
+.Xr sigaction 2 ) ,
 it stops.  The tracing process is expected to notice this via
 .Xr wait 2
 or the delivery of a
@@ -58,10 +56,8 @@ traced process stops, it cannot be made to continue except via
 When a process has used this request and calls
 .Xr execve 2
 or any of the routines built on it
-.Po
-such as
-.Xr execv 3
-.Pc ,
+(such as
+.Xr execv 3 ) ,
 it will stop before executing the first instruction of the new image.
 Also, any setuid or setgid bits on the executable being executed will
 be ignored.
@@ -136,9 +132,7 @@ The traced process continues execution.
 .Fa addr
 is an address specifying the place where execution is to be resumed (a
 new value for the program counter), or
-.Po
-.Vt caddr_t
-.Pc Ns 1
+.Po Vt caddr_t Pc Ns 1
 to indicate that execution is to pick up where it left off.
 .Fa data
 provides a signal number to be delivered to the traced process as it
diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2
index 6929ff1..9044679 100644
--- a/lib/libc/sys/send.2
+++ b/lib/libc/sys/send.2
@@ -186,7 +186,8 @@ doesn't necessarily block until the data has been transferred, it
 is possible to transfer an open file descriptor across an
 .Dv AF_UNIX
 domain socket
-.Pq see Xr recv 2 ,
+(see
+.Xr recv 2 ) ,
 then
 .Fn close
 it before it has actually been sent, the result being that the receiver