mdoc(7) police: formatting nits.

Approved by:	re

19 files changed, 94 insertions, 64 deletions

diff --git a/lib/libc/gen/fts.3 b/lib/libc/gen/fts.3
index 4526266..b50b316 100644
--- a/lib/libc/gen/fts.3
+++ b/lib/libc/gen/fts.3
@@ -64,7 +64,7 @@
 The
 .Nm
 functions are provided for traversing
-.Tn UNIX
+.Ux
 file hierarchies.
 A simple overview is that the
 .Fn fts_open
diff --git a/lib/libc/net/rcmd.3 b/lib/libc/net/rcmd.3
index 1193065..ba2cc55 100644
--- a/lib/libc/net/rcmd.3
+++ b/lib/libc/net/rcmd.3
@@ -117,7 +117,7 @@ in
 The control process will return diagnostic
 output from the command (unit 2) on this channel, and will also
 accept bytes on this channel as being
-.Tn UNIX
+.Ux
 signal numbers, to be
 forwarded to the process group of the command.
 If
diff --git a/lib/libc/stdio/fseek.3 b/lib/libc/stdio/fseek.3
index f2ca10f..6481fe6 100644
--- a/lib/libc/stdio/fseek.3
+++ b/lib/libc/stdio/fseek.3
@@ -166,7 +166,7 @@ object may be a complex object
 and these routines may be the only way to portably reposition a text stream.
 .Pp
 If the stream is a wide character stream (see
-.Xr fwide 3 Ns No ),
+.Xr fwide 3 ) ,
 the position specified by the combination of
 .Fa offset
 and
diff --git a/lib/libc/stdlib/atexit.3 b/lib/libc/stdlib/atexit.3
index cc434cc..9aae7af 100644
--- a/lib/libc/stdlib/atexit.3
+++ b/lib/libc/stdlib/atexit.3
@@ -66,7 +66,8 @@ These functions must not call
 if it should be necessary to terminate the process while in such a
 function, the
 .Xr _exit 2
-function should be used.  (Alternatively, the function may cause abnormal
+function should be used.
+(Alternatively, the function may cause abnormal
 process termination, for example by calling
 .Xr abort 3 . )
 .Pp
diff --git a/lib/libc/stdlib/qsort.3 b/lib/libc/stdlib/qsort.3
index 39d6e0c..a23301f 100644
--- a/lib/libc/stdlib/qsort.3
+++ b/lib/libc/stdlib/qsort.3
@@ -47,19 +47,34 @@
 .Sh SYNOPSIS
 .In stdlib.h
 .Ft void
-.Fn qsort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
+.Fo qsort
+.Fa "void *base"
+.Fa "size_t nmemb"
+.Fa "size_t size"
+.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
+.Fc
 .Ft void
 .Fo qsort_r
 .Fa "void *base"
 .Fa "size_t nmemb"
 .Fa "size_t size"
 .Fa "void *thunk"
-.Fa "int (*compar)(void *, const void *, const void *)"
+.Fa "int \*[lp]*compar\*[rp]\*[lp]void *, const void *, const void *\*[rp]"
 .Fc
 .Ft int
-.Fn heapsort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
+.Fo heapsort
+.Fa "void *base"
+.Fa "size_t nmemb"
+.Fa "size_t size"
+.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
+.Fc
 .Ft int
-.Fn mergesort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
+.Fo mergesort
+.Fa "void *base"
+.Fa "size_t nmemb"
+.Fa "size_t size"
+.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn qsort
@@ -111,7 +126,7 @@ except that it takes an additional argument,
 which is passed unchanged as the first argument to function pointed to
 .Fa compar .
 This allows the comparison function to access additional
-data without using global variables, and thus 
+data without using global variables, and thus
 .Fn qsort_r
 is suitable for use in functions which must be reentrant.
 .Pp
@@ -132,7 +147,9 @@ The
 .Fn qsort
 and
 .Fn qsort_r
-functions are an implementation of C.A.R. Hoare's ``quicksort'' algorithm,
+functions are an implementation of C.A.R. Hoare's
+.Dq quicksort
+algorithm,
 a variant of partition-exchange sorting; in particular, see D.E. Knuth's
 Algorithm Q.
 .Sy Quicksort
@@ -142,7 +159,9 @@ O N**2 worst-case behavior.
 .Pp
 The
 .Fn heapsort
-function is an implementation of J.W.J. William's ``heapsort'' algorithm,
+function is an implementation of J.W.J. William's
+.Dq heapsort
+algorithm,
 a variant of selection sorting; in particular, see D.E. Knuth's Algorithm H.
 .Sy Heapsort
 takes O N lg N worst-case time.
diff --git a/lib/libc/stdlib/strfmon.3 b/lib/libc/stdlib/strfmon.3
index 4c553de..7e5a9c0 100644
--- a/lib/libc/stdlib/strfmon.3
+++ b/lib/libc/stdlib/strfmon.3
@@ -49,7 +49,7 @@ bytes are placed into the array.
 .Pp
 The format string is composed of zero or more directives:
 ordinary characters (not
-.Cm % Ns ),
+.Cm % ) ,
 which are copied unchanged to the output stream; and conversion
 specifications, each of which results in fetching zero or more subsequent
 arguments.
@@ -75,9 +75,9 @@ Do not use grouping characters, regardless of the current locale default.
 Represent positive values by prefixing them with a positive sign,
 and negative values by prefixing them with a negative sign.
 This is the default.
-.It Cm (
+.It Cm \&(
 Enclose negative values in parentheses.
-.It Cm !
+.It Cm \&!
 Do not include a currency symbol in the output.
 .It Cm \-
 Left justify the result.
@@ -124,7 +124,7 @@ returns the number of bytes placed into the array pointed to by
 not including the terminating
 .Dv NULL
 byte.
-Otherwise, -1 is returned,
+Otherwise, \-1 is returned,
 the contents of the array are indeterminate,
 and
 .Va errno
diff --git a/lib/libc/string/strcpy.3 b/lib/libc/string/strcpy.3
index 01456d0..d52d0ed 100644
--- a/lib/libc/string/strcpy.3
+++ b/lib/libc/string/strcpy.3
@@ -99,7 +99,7 @@ return
 .Fa dst .
 The
 .Fn stpcpy
-function returns a pointer to the terminating 
+function returns a pointer to the terminating
 .Ql \e0
 character of
 .Fa dst .
diff --git a/lib/libc/string/strsep.3 b/lib/libc/string/strsep.3
index 12bd585..77c7b84 100644
--- a/lib/libc/string/strsep.3
+++ b/lib/libc/string/strsep.3
@@ -65,7 +65,9 @@ The original value of
 .Fa *stringp
 is returned.
 .Pp
-An ``empty'' field (i.e., a character in the string
+An
+.Dq empty
+field (i.e., a character in the string
 .Fa delim
 occurs as the first character of
 .Fa *stringp )
diff --git a/lib/libc/sys/intro.2 b/lib/libc/sys/intro.2
index c4804c1..2791452 100644
--- a/lib/libc/sys/intro.2
+++ b/lib/libc/sys/intro.2
@@ -456,7 +456,6 @@ The specified extended attribute does not exist.
 .It Er 88 EDOOFUS Em "Programming error" .
 A function or API is being abused in a way which could only be detected
 at run-time.
-
 .El
 .Sh DEFINITIONS
 .Bl -tag -width Ds
diff --git a/lib/libc/sys/kse.2 b/lib/libc/sys/kse.2
index 9146ca4..0497bc2 100644
--- a/lib/libc/sys/kse.2
+++ b/lib/libc/sys/kse.2
@@ -469,7 +469,7 @@ and
 .Va tm_sticks
 are time counters for user mode and kernel mode execution, respectively.
 These counters count ticks of the statistics clock (see
-.Xr clocks 7) .
+.Xr clocks 7 ) .
 While any thread is actively executing in the kernel, the corresponding
 .Va tm_sticks
 counter is incremented.
diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2
index 87ec6e4..fbf54cc 100644
--- a/lib/libc/sys/pathconf.2
+++ b/lib/libc/sys/pathconf.2
@@ -106,7 +106,7 @@ otherwise 0.
 Returns 1 if synchronised I/O is supported for this file, otherwise 0.
 .It Li _PC_ALLOC_SIZE_MIN
 Minimum number of bytes of storage allocated for any portion of a file.
-.Ar path .
+.Fa path .
 .It Li _PC_FILESIZEBITS
 Number of bits needed to represented the maximum file size.
 .It Li _PC_REC_INCR_XFER_SIZE
diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2
index cedc7a0..898de2b 100644
--- a/lib/libc/sys/sigaction.2
+++ b/lib/libc/sys/sigaction.2
@@ -56,8 +56,11 @@ struct  sigaction {
 #define	sa_sigaction	__sigaction_u.__sa_sigaction
 .Ed
 .Ft int
-.Fn sigaction "int sig" "const struct sigaction * restrict act" \
-    "struct sigaction * restrict oact"
+.Fo sigaction
+.Fa "int sig"
+.Fa "const struct sigaction * restrict act"
+.Fa "struct sigaction * restrict oact"
+.Fc
 .Sh DESCRIPTION
 The system defines a set of signals that may be delivered to a process.
 Signal delivery resembles the occurrence of a hardware interrupt:
diff --git a/lib/libc/sys/sigprocmask.2 b/lib/libc/sys/sigprocmask.2
index 7f271be..debb2a3 100644
--- a/lib/libc/sys/sigprocmask.2
+++ b/lib/libc/sys/sigprocmask.2
@@ -43,8 +43,11 @@
 .Sh SYNOPSIS
 .In signal.h
 .Ft int
-.Fn sigprocmask "int how" "const sigset_t * restrict set" \
-    "sigset_t * restrict oset"
+.Fo sigprocmask
+.Fa "int how"
+.Fa "const sigset_t * restrict set"
+.Fa "sigset_t * restrict oset"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn sigprocmask
diff --git a/lib/libc/sys/socketpair.2 b/lib/libc/sys/socketpair.2
index a1e6fb8..929b921 100644
--- a/lib/libc/sys/socketpair.2
+++ b/lib/libc/sys/socketpair.2
@@ -86,7 +86,7 @@ process address space.
 .Xr write 2
 .Sh BUGS
 This call is currently implemented only for the
-.Tn UNIX
+.Ux
 domain.
 .Sh HISTORY
 The
diff --git a/lib/libc/sys/uuidgen.2 b/lib/libc/sys/uuidgen.2
index 726039a..d2881cc 100644
--- a/lib/libc/sys/uuidgen.2
+++ b/lib/libc/sys/uuidgen.2
@@ -75,22 +75,21 @@ struct uuid {
 	uint8_t		node[_UUID_NODE_LEN];
 };
 .Ed
-.Pp
-.Bl -tag -width _clock_seq_hi_and_reserved_
-.It time_low
+.Bl -tag -width ".Va clock_seq_hi_and_reserved"
+.It Va time_low
 The least significant 32 bits of a 60-bit timestamp.
 This field is stored in the native byte-order.
-.It time_mid
+.It Va time_mid
 The least significant 16 bits of the most significant 28 bits of the 60-bit
 timestamp.
 This field is stored in the native byte-order.
-.It time_hi_and_reserved
+.It Va time_hi_and_reserved
 The most significant 12 bits of the 60-bit timestamp multiplexed with a 4-bit
 version number.
 The version number is stored in the most significant 4 bits of the 16-bit
 field.
 This field is stored in the native byte-order.
-.It clock_seq_hi_and_reserved
+.It Va clock_seq_hi_and_reserved
 The most significant 6 bits of a 14-bit sequence number multiplexed with a
 2-bit variant value.
 Note that the width of the variant value is determined by the variant itself.
@@ -98,9 +97,9 @@ Identifiers generated by the
 .Nm
 system call have variant value 10b.
 the variant value is stored in the most significant bits of the field.
-.It clock_seq_low
+.It Va clock_seq_low
 The least significant 8 bits of a 14-bit sequence number.
-.It node
+.It Va node
 The 6-byte IEEE 802 (MAC) address of one of the interfaces of the node.
 If no such interface exists, a random multi-cast address is used instead.
 .El
diff --git a/lib/libcompat/4.3/rexec.3 b/lib/libcompat/4.3/rexec.3
index 737c976..14ef11b 100644
--- a/lib/libcompat/4.3/rexec.3
+++ b/lib/libcompat/4.3/rexec.3
@@ -99,7 +99,7 @@ in
 The control process will return diagnostic
 output from the command (unit 2) on this channel, and will also
 accept bytes on this channel as being
-.Tn UNIX
+.Ux
 signal numbers, to be
 forwarded to the process group of the command.  The diagnostic
 information returned does not include remote authorization failure,
diff --git a/lib/libpam/modules/pam_radius/pam_radius.8 b/lib/libpam/modules/pam_radius/pam_radius.8
index 94a7d05..ea311dd4 100644
--- a/lib/libpam/modules/pam_radius/pam_radius.8
+++ b/lib/libpam/modules/pam_radius/pam_radius.8
@@ -77,7 +77,7 @@ prompts for one as usual.
 causes echoing to be left on if
 .Nm
 prompts for a password.
-.It Cm conf Ns No = Ns Ar pathname
+.It Cm conf Ns = Ns Ar pathname
 specifies a non-standard location for the RADIUS client configuration file
 (normally located in
 .Pa /etc/radius.conf ) .
diff --git a/lib/libpam/modules/pam_wheel/pam_wheel.8 b/lib/libpam/modules/pam_wheel/pam_wheel.8
index e564e6e..bf0e0e2 100644
--- a/lib/libpam/modules/pam_wheel/pam_wheel.8
+++ b/lib/libpam/modules/pam_wheel/pam_wheel.8
@@ -108,9 +108,12 @@ return
 .Dv PAM_IGNORE
 if the specified group (default group of
 .Dq Li wheel )
-is empty, providing traditional BSD
+is empty, providing traditional
+.Bx
 .Xr su 8
-semantics permitting any user to su if the wheel group is empty.
+semantics permitting any user to
+.Dq su
+if the wheel group is empty.
 .El
 .Sh SEE ALSO
 .Xr getlogin 2 ,
diff --git a/lib/libtacplus/libtacplus.3 b/lib/libtacplus/libtacplus.3
index bcaf609..9856163 100644
--- a/lib/libtacplus/libtacplus.3
+++ b/lib/libtacplus/libtacplus.3
@@ -114,7 +114,7 @@ in which case the standard configuration file
 .Pa /etc/tacplus.conf
 is used.
 .Fn tac_config
-returns 0 on success, or -1 if an error occurs.
+returns 0 on success, or \-1 if an error occurs.
 .Pp
 The library can also be configured programmatically by calls to
 .Fn tac_add_server .
@@ -148,7 +148,7 @@ confused if the client attempts to negotiate it.
 .El
 .Pp
 .Fn tac_add_server
-returns 0 on success, or -1 if an error occurs.
+returns 0 on success, or \-1 if an error occurs.
 .Pp
 .Fn tac_add_server
 may be called multiple times, and it may be used together with
@@ -168,7 +168,7 @@ and
 .Va service
 arguments must be set to appropriate values as defined in the
 TACACS+ protocol specification.  The
-.Aq taclib.h
+.Aq Pa taclib.h
 header file contains symbolic constants for these values.
 .Sh CREATING A TACACS+ AUTHORIZATION REQUEST
 To begin constructing a new authorization request, call
@@ -180,7 +180,7 @@ and
 .Va service
 arguments must be set to appropriate values as defined in the
 TACACS+ protocol specification.  The
-.Aq taclib.h
+.Aq Pa taclib.h
 header file contains symbolic constants for these values.
 .Sh SETTING OPTIONAL PARAMETERS ON A REQUEST
 After creating a request,
@@ -199,13 +199,13 @@ privilege level, which defaults to
 .Ql USER
 privilege.
 .Pp
-.Fn tac_set_av 
+.Fn tac_set_av
 only applies to the context of an authorization request.  The format
 for an attribute value pair is defined in the TACACS+ protocol
 specification.  The index specified can be any value between 0 and
 255 inclusive and indicates the position in the list to place the
-attribute value pair.  Calling 
-.Fn tac_set_av 
+attribute value pair.  Calling
+.Fn tac_set_av
 with same index twice effectively replaces the value at that position.
 Use
 .Fn tac_clear_avs
@@ -217,12 +217,12 @@ sent by means of
 This function connects to a server if not already connected, sends
 the request, and waits for a reply.  On failure,
 .Fn tac_send_authen
-returns -1.  Otherwise, it returns the TACACS+ status code and flags,
+returns \-1.  Otherwise, it returns the TACACS+ status code and flags,
 packed into an integer value.  The status can be extracted using the
 macro
 .Fn TAC_AUTHEN_STATUS .
 Possible status codes, defined in
-.Aq taclib.h ,
+.Aq Pa taclib.h ,
 include:
 .Pp
 .Bl -item -compact -offset indent
@@ -294,7 +294,7 @@ initial authentication request.
 .Pp
 When it receives the CONTINUE packet, the server may again request
 more information by returning
-.Dv TAC_AUTHEN_STATUS_GETDATA , 
+.Dv TAC_AUTHEN_STATUS_GETDATA ,
 .Dv TAC_AUTHEN_STATUS_GETUSER ,
 or
 .Dv TAC_AUTHEN_STATUS_GETPASS .
@@ -307,12 +307,12 @@ is sent by means of
 This function connects to a server if not already connected, sends
 the request, and waits for a reply.  On failure,
 .Fn tac_send_author
-returns -1.  Otherwise, it returns the TACACS+ status code and 
-number of attribute value (AV) pairs received packed into an 
+returns \-1.  Otherwise, it returns the TACACS+ status code and
+number of attribute value (AV) pairs received packed into an
 integer value.  The status can be extracted using the macro
 .Fn TAC_AUTHOR_STATUS .
 Possible status codes, defined in
-.Aq taclib.h ,
+.Aq Pa taclib.h ,
 include:
 .Pp
 .Bl -item -compact -offset indent
@@ -326,10 +326,10 @@ include:
 .Dv TAC_AUTHOR_STATUS_ERROR
 .El
 .Pp
-The number of AV pairs received is obtained using 
+The number of AV pairs received is obtained using
 .Fn TAC_AUTHEN_AV_COUNT .
 .Sh EXTRACTING INFORMATION FROM THE SERVER'S AUTHORIZATION RESPONSE
-Like an authentication response packet, an authorization 
+Like an authentication response packet, an authorization
 response packet from the
 server may contain a server message, a data string, or both.  Refer
 to EXTRACTING INFORMATION FROM THE SERVER'S AUTHENTICATION RESPONSE
@@ -341,16 +341,16 @@ attribute value (AV) pairs.  To extract these, use
 or
 .Fn tac_get_av_value .
 .Fn tac_get_av
-takes the index of the AV pair as it is positioned in the list.  
-The indexes start at 0 (use 
+takes the index of the AV pair as it is positioned in the list.
+The indexes start at 0 (use
 .Fn TAC_AUTHEN_AV_COUNT
-on the return value of 
-.Fn tac_send_author 
+on the return value of
+.Fn tac_send_author
 to get the total number of items in this list).
-Alternatively, 
-.Fn tac_get_av_value 
-can be used.  
-.Fn tac_get_av_value 
+Alternatively,
+.Fn tac_get_av_value
+can be used.
+.Fn tac_get_av_value
 takes the attribute name and returns the
 corresponding value only, not the AV pair.  These functions return
 dynamically-allocated copies of the information from the packet.
@@ -365,18 +365,18 @@ can be retrieved by calling
 .Fn tac_strerror .
 The message text is overwritten on each new error for the given
 .Va struct tac_handle * .
-Thus the message must be copied if it is to be preserved through 
+Thus the message must be copied if it is to be preserved through
 subsequent library calls using the same handle.
 .Sh CLEANUP
 To free the resources used by the TACACS+ library, call
 .Fn tac_close .
 .Sh RETURN VALUES
 The following functions return a non-negative value on success.  If
-they detect an error, they return -1 and record an error message
+they detect an error, they return \-1 and record an error message
 which can be retrieved using
 .Fn tac_strerror .
 .Pp
-.Bl -item -offset indent -compact 
+.Bl -item -offset indent -compact
 .It
 .Fn tac_add_server
 .It
@@ -446,8 +446,9 @@ without recording an error message.
 .%O draft-grant-tacacs-02.txt (Internet Draft)
 .Re
 .Sh AUTHORS
+.An -nosplit
 This software was written by
-.An John Polstra ,
+.An John Polstra
 and
 .An Paul Fraley ,
 and donated to the