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.

23 files changed, 83 insertions, 116 deletions

diff --git a/lib/libalias/libalias.3 b/lib/libalias/libalias.3
index e8bdefd..aa804db 100644
--- a/lib/libalias/libalias.3
+++ b/lib/libalias/libalias.3
@@ -170,12 +170,10 @@ Mainly useful for debugging when the log file is viewed continuously with
 .It Dv PKT_ALIAS_DENY_INCOMING
 If this mode bit is set, all incoming packets associated with new TCP
 connections or new UDP transactions will be marked for being ignored
-.Po
-.Fn PacketAliasIn
+.Fn ( PacketAliasIn
 returns
 .Dv PKT_ALIAS_IGNORED
-code
-.Pc
+code)
 by the calling program.
 Response packets to connections or transactions initiated from the packet
 aliasing host or local network will be unaffected.
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
diff --git a/lib/libcompat/4.4/cuserid.3 b/lib/libcompat/4.4/cuserid.3
index 5ac7e34..5141c03 100644
--- a/lib/libcompat/4.4/cuserid.3
+++ b/lib/libcompat/4.4/cuserid.3
@@ -73,11 +73,9 @@ returns the address of an array in which the name has been stored.
 .Pp
 If the name associated with the effective UID of the current process
 could not be found, either a null pointer will be returned, or
-.Po
-if
+(if
 .Fa s
-is non-NULL
-.Pc
+is non-NULL)
 the buffer
 .Fa s
 will be filled with a null string.
diff --git a/lib/libedit/editline.3 b/lib/libedit/editline.3
index 5034163..8108026 100644
--- a/lib/libedit/editline.3
+++ b/lib/libedit/editline.3
@@ -207,9 +207,7 @@ The colon between
 and the command,
 .Ar command ,
 will be replaced with a NUL
-.Po
-.Dq \e0
-.Pc .
+.Pq Dq \e0 .
 .It Fn el_set
 Set
 .Nm
diff --git a/lib/libedit/editrc.5 b/lib/libedit/editrc.5
index 2d8c3e4..816ccf3 100644
--- a/lib/libedit/editrc.5
+++ b/lib/libedit/editrc.5
@@ -156,10 +156,8 @@ can contain control characters of the form
 .Sm off
 .Sq No ^ Ar character
 .Sm on
-.Po
-e.g.
-.Sq ^A
-.Pc ,
+(e.g.
+.Sq ^A ) ,
 and the following backslashed escape sequences:
 .Pp
 .Bl -tag -compact -offset indent -width 4n
@@ -261,13 +259,9 @@ set of tty modes respectively; defaulting to
 Without other arguments,
 .Ic setty
 lists the modes in the chosen set which are fixed on
-.Po
-.Sq +mode
-.Pc
+.Pq Sq +mode
 or off
-.Po
-.Sq -mode
-.Pc .
+.Pq Sq -mode .
 .Fl a
 lists all tty modes in the chosen set regardless of the setting.
 With
diff --git a/lib/libipsec/ipsec_set_policy.3 b/lib/libipsec/ipsec_set_policy.3
index f841df2..0b293ff 100644
--- a/lib/libipsec/ipsec_set_policy.3
+++ b/lib/libipsec/ipsec_set_policy.3
@@ -110,7 +110,7 @@ means to consult to SPD defined by
 .It Ar direction Li bypass
 .Li bypass
 means to be bypassed the IPsec processing.
-.Pq packet will be transmitted in clear .
+(packet will be transmitted in clear).
 This is for privileged socket.
 .It Xo
 .Ar direction
@@ -167,7 +167,7 @@ is this node
 and
 .Ar src
 is the other node
-.Pq peer .
+(peer).
 If
 .Ar mode
 is
@@ -196,9 +196,9 @@ regarding the system default.
 means that a relevant SA can be used when available,
 since the kernel may perform IPsec operation against packets when possible.
 In this case, packets can be transmitted in clear
-.Pq when SA is not available ,
+(when SA is not available),
 or encrypted
-.Pq when SA is available .
+(when SA is available).
 .Li require
 means that a relevant SA is required,
 since the kernel must perform IPsec operation against packets.
@@ -241,7 +241,7 @@ Refer to
 for detail.
 .Pp
 Here are several examples
-.Pq long lines are wrapped for readability :
+(long lines are wrapped for readability):
 .Bd -literal -offset indent
 in discard
 out ipsec esp/transport//require
@@ -255,7 +255,7 @@ in ipsec ipcomp/transport//use
 returns a pointer to the allocated buffer of policy specification if successful; otherwise a NULL pointer is returned.
 .Fn ipsec_get_policylen
 returns with positive value
-.Pq meaning the buffer size
+(meaning the buffer size)
 on success, and negative value on errors.
 .Fn ipsec_dump_policy
 returns a pointer to dynamically allocated region on success,
diff --git a/lib/libmd/sha.3 b/lib/libmd/sha.3
index 1f69450..9151857 100644
--- a/lib/libmd/sha.3
+++ b/lib/libmd/sha.3
@@ -74,7 +74,8 @@ a ``fingerprint'' of the input-data, which doesn't disclose the actual
 input.
 .Pp
 .Tn SHA
-.Pq \&or Tn SHA-0
+(or
+.Tn SHA-0 )
 is the original Secure Hash Algorithm specified in
 .Tn FIPS
 160.  It was quickly proven insecure, and has been superseded by