Assorted mdoc(7) fixes.

Approved by:	re (blanket)

lib/libc/gen/arc4random.3

@@ -57,7 +57,8 @@ The S-Boxes
 can be in about
 .if t 2\u\s71700\s10\d
 .if n (2**1700)
-states. The
+states.
+The
 .Fn arc4random
 function returns pseudo-random numbers in the range of 0 to
 .if t 2\u\s731\s10\d\(mi1,
@@ -87,7 +88,7 @@ and
 functions using
 .Fn arc4random :
 .Pp
-.Dl #define foo4random() (arc4random()  % ((unsigned)RAND_MAX + 1))
+.Dl "#define foo4random() (arc4random() % ((unsigned)RAND_MAX + 1))"
 .Sh SEE ALSO
 .Xr rand 3 ,
 .Xr random 3 ,

lib/libc/gen/getfsent.3

@@ -46,11 +46,11 @@
 .Lb libc
 .Sh SYNOPSIS
 .In fstab.h
-.Ft struct fstab *
+.Ft "struct fstab *"
 .Fn getfsent void
-.Ft struct fstab *
+.Ft "struct fstab *"
 .Fn getfsspec "const char *spec"
-.Ft struct fstab *
+.Ft "struct fstab *"
 .Fn getfsfile "const char *file"
 .Ft int
 .Fn setfsent void
@@ -58,7 +58,7 @@
 .Fn endfsent void
 .Ft void
 .Fn setfstab "const char *file"
-.Ft const char *
+.Ft "const char *"
 .Fn getfstab void
 .Sh DESCRIPTION
 The
@@ -103,11 +103,11 @@ function sets the file to be used by subsequent operations.
 The value set by
 .Fn setfstab
 does not persist across calls to
-.Fn endfsent
+.Fn endfsent .
 .Pp
 The
 .Fn getfstab
-function returns the name of the file that that will be used.
+function returns the name of the file that will be used.
 .Pp
 The
 .Fn getfsspec
@@ -145,17 +145,17 @@ The
 function
 returns nothing.
 .Sh ENVIRONMENT
-.Bl -tag -width PATH_FSTAB
+.Bl -tag -width ".Ev PATH_FSTAB"
-.It Pa PATH_FSTAB
+.It Ev PATH_FSTAB
 If the environment variable
-.Pa PATH_FSTAB
+.Ev PATH_FSTAB
-is set all operations are performed against the specified file.
+is set, all operations are performed against the specified file.
-.Pa PATH_FSTAB
+.Ev PATH_FSTAB
 will not be honored if the process environment or memory address space is
 considred
 .Dq tainted .
 (See
-.Fn issetugid
+.Xr issetugid 2
 for more information.)
 .El
 .Sh FILES

lib/libc/gen/getpwent.3

@@ -194,7 +194,8 @@ The functions
 and
 .Fn getpwuid_r
 return 0 if no error occurred, or an error number to indicate failure.
-It is not an error if a matching entry is not found.  (Thus, if
+It is not an error if a matching entry is not found.
+(Thus, if
 .Fa result
 is
 .Dv NULL

lib/libc/i386/sys/i386_vm86.2

@@ -75,13 +75,14 @@ The
 .Fa int_map
 argument
 is a bitmap which determines whether vm86 interrupts should be handled
-in vm86 mode, or reflected back to the process.  If the
+in vm86 mode, or reflected back to the process.
+If the
 .Em Nth
 bit is set, the interrupt will be reflected to the process, otherwise
 it will be dispatched by the vm86 interrupt table.
 .It Dv VM86_INTCALL
-This allows calls to be made to vm86 interrupt handlers by the process. It
+This allows calls to be made to vm86 interrupt handlers by the process.
-effectively simulates an INT instruction.
+It effectively simulates an INT instruction.
 .Fa data
 should point to the following structure:
 .Bd -literal
@@ -92,8 +93,8 @@ struct vm86_intcall_args {
 .Ed
 .Pp
 .Fa intnum
-specifies the operand of INT for the simulated call. A value of 0x10, for
+specifies the operand of INT for the simulated call.
-example, would often be used to call into the VGA BIOS.
+A value of 0x10, for example, would often be used to call into the VGA BIOS.
 .Fa vmf
 is used to initialize CPU registers according to the calling convention for
 the interrupt handler.
@@ -117,7 +118,8 @@ vm86 mode is entered by calling
 .Xr sigreturn 2
 with the correct machine context for vm86, and with the
 .Dv PSL_VM
-bit set.  Control returns to the process upon delivery of a signal.
+bit set.
+Control returns to the process upon delivery of a signal.
 .Sh RETURN VALUES
 .Rv -std i386_vm86
 .Sh ERRORS
@@ -132,6 +134,7 @@ The kernel does not have vm86 support, or an invalid function was specified.
 There is not enough memory to initialize the kernel data structures.
 .El
 .Sh AUTHORS
+.An -nosplit
 This man page was written by
 .An Jonathan Lemon ,
 and updated by

lib/libc/locale/setlocale.3

@@ -177,7 +177,7 @@ The individual fields have the following meanings:
 .Bl -tag -width mon_decimal_point
 .It Fa decimal_point
 The decimal point character, except for currency values,
-can't be the empty string.
+cannot be an empty string.
 .It Fa thousands_sep
 The separator between groups of digits
 before the decimal point, except for currency values.

lib/libc/locale/wcstod.3

@@ -31,14 +31,17 @@
 .Nm wcstof ,
 .Nm wcstod ,
 .Nm wcstold
-.Nd "convert string to float, double or long double"
+.Nd convert string to
+.Vt float , double
+or
+.Vt "long double"
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In wchar.h
 .Ft float
 .Fn wcstof "const wchar_t * restrict nptr" "wchar_t ** restrict endptr"
-.Ft long double
+.Ft "long double"
 .Fn wcstold "const wchar_t * restrict nptr" "wchar_t ** restrict endptr"
 .Ft double
 .Fn wcstod "const wchar_t * restrict nptr" "wchar_t ** restrict endptr"
@@ -53,13 +56,13 @@ functions are the wide-character versions of the
 .Fn strtod
 and
 .Fn strtold
-functios.
+functions.
 Refer to
 .Xr strtod 3
 for details.
 .Sh SEE ALSO
 .Xr strtod 3 ,
-.Xr wcstol 3 ,
+.Xr wcstol 3
 .Sh STANDARDS
 The
 .Fn wcstof ,

lib/libc/net/nsdispatch.3

@@ -74,7 +74,8 @@ the caller of
 .Pp
 Each method has the function signature described by the typedef:
 .Pp
-.Ft typedef "int \*(lp*nss_method\*(rp\*(lpvoid *retval, void *mdata, va_list *ap\*(rp" ;
+.Ft typedef int
+.Fn \*(lp*nss_method\*(rp "void *retval" "void *mdata" "va_list *ap" ;
 .Pp
 .Va dtab
 is an array of
@@ -175,12 +176,12 @@ as a variable argument list of the type
 .Ss Valid source types
 While there is support for arbitrary sources, the following
 #defines for commonly implemented sources are available:
-.Bl -column NS_COMPAT COMPAT -offset indent
+.Bl -column NSSRC_COMPAT compat -offset indent
 .It Sy "#define	value"
-.It "NSSRC_FILES	""files"""
+.It Dv NSSRC_FILES Ta """files""
-.It "NSSRC_DNS	""dns"""
+.It Dv NSSRC_DNS Ta """dns""
-.It "NSSRC_NIS	""nis"""
+.It Dv NSSRC_NIS Ta """nis""
-.It "NSSRC_COMPAT	""compat"""
+.It Dv NSSRC_COMPAT Ta """compat""
 .El
 .Pp
 Refer to
@@ -192,13 +193,13 @@ The
 .Vt nss_method
 functions must return one of the following values depending upon status
 of the lookup:
-.Bl -column "RETURN VALUE" "STATUS CODE"
+.Bl -column "Return value" "Status code"
 .It Sy "Return value	Status code"
-.It "NS_SUCCESS	success"
+.It Dv NS_SUCCESS Ta success
-.It "NS_NOTFOUND	notfound"
+.It Dv NS_NOTFOUND Ta notfound
-.It "NS_UNAVAIL	unavail"
+.It Dv NS_UNAVAIL Ta unavail
-.It "NS_TRYAGAIN	tryagain"
+.It Dv NS_TRYAGAIN Ta tryagain
-.It "NS_RETURN	-none-"
+.It Dv NS_RETURN Ta -none-
 .El
 .Pp
 Refer to
@@ -208,12 +209,14 @@ for a complete description of each status code.
 The
 .Fn nsdispatch
 function returns the value of the method that caused the dispatcher to
-terminate, or NS_NOTFOUND otherwise.
+terminate, or
+.Dv NS_NOTFOUND
+otherwise.
 .Sh SEE ALSO
 .Xr hesiod 3 ,
 .Xr stdarg 3 ,
-.Xr yp 8 ,
+.Xr nsswitch.conf 5 ,
-.Xr nsswitch.conf 5
+.Xr yp 8
 .Sh HISTORY
 The
 .Fn nsdispatch
@@ -232,10 +235,10 @@ Luke Mewburn
 wrote this freely-distributable name-service switch implementation,
 using ideas from the
 .Tn ULTRIX
-"svc.conf\*(lp5\*(rp"
+svc.conf(5)
 and
 .Tn Solaris
-"nsswitch.conf\*(lp4\*(rp"
+nsswitch.conf(4)
 manual pages.
 The
 .Fx

lib/libc/posix1e/mac.3

@@ -35,7 +35,7 @@
 .Os
 .Sh NAME
 .Nm mac
-.Nd Introduction to the MAC security API
+.Nd introduction to the MAC security API
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS

lib/libc/stdio/fputws.3

@@ -63,10 +63,10 @@ The
 function
 returns 0 on success and \-1 on error.
 .Sh ERRORS
-.Bl -tag -width Er
 The
 .Fn fputws
 function will fail if:
+.Bl -tag -width Er
 .It Bq Er EBADF
 The
 .Fa fp

lib/libc/stdlib/strtod.3

@@ -52,7 +52,7 @@ string to floating point
 .Fn strtod "const char * restrict nptr" "char ** restrict endptr"
 .Ft float
 .Fn strtof "const char * restrict nptr" "char ** restrict endptr"
-.Ft long double
+.Ft "long double"
 .Fn strtold "const char * restrict nptr" "char ** restrict endptr"
 .Sh DESCRIPTION
 These conversion
@@ -63,7 +63,7 @@ to
 .Vt double ,
 .Vt float ,
 and
-.Vt long double
+.Vt "long double"
 representation, respectively.
 .Pp
 The expected form of the string is an optional plus (``+'') or minus
@@ -160,10 +160,10 @@ These routines do not recognize the C99 ``NaN(...)'' syntax.
 The author of this software is
 .An David M. Gay .
 .Pp
+.Bd -literal
 Copyright (c) 1998 by Lucent Technologies
-.br
 All Rights Reserved
-.Pp
+
 Permission to use, copy, modify, and distribute this software and
 its documentation for any purpose and without fee is hereby
 granted, provided that the above copyright notice appear in all
@@ -173,7 +173,7 @@ documentation, and that the name of Lucent or any of its entities
 not be used in advertising or publicity pertaining to
 distribution of the software without specific, written prior
 permission.
-.Pp
+
 LUCENT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
 IN NO EVENT SHALL LUCENT OR ANY OF ITS ENTITIES BE LIABLE FOR ANY
@@ -182,3 +182,4 @@ WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
 IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
 ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
 THIS SOFTWARE.
+.Ed

lib/libc/sys/jail.2

@@ -12,7 +12,7 @@
 .Dt JAIL 2
 .Os
 .Sh NAME
-.Nm jail
+.Nm jail , jail_attach
 .Nd imprison current process and future decendants
 .Sh LIBRARY
 .Lb libc
@@ -59,21 +59,16 @@ The
 .Fn jail_attach
 system call attaches the current process to an existing jail,
 identified by
-.Va jid .
+.Fa jid .
 .Sh RETURN VALUES
 If successful,
 .Fn jail
 returns a non-negative integer, termed the jail identifier (JID).
-It returns -1 on failure, and sets
+It returns \-1 on failure, and sets
 .Va errno
 to indicate the error.
 .Pp
-If successful,
+.Rv -std jail_attach
-.Fn jail_attach
-returns 0.
-It returns -1 on failure, and sets
-.Va errno
-to indicate the error.
 .Sh PRISON?
 Once a process has been put in a prison, it and its decendants cannot escape
 the prison.

lib/libc/sys/sendfile.2

@@ -107,22 +107,22 @@ implementation of
 .Fn sendfile
 is "zero-copy", meaning that it has been optimized so that copying of the file data is avoided.
 .Sh TUNING
-Internally this system call uses a special
+Internally, this system call uses a special
 .Xr sendfile 2
 buffer
-.Pq Fa "struct sf_buf"
+.Pq Vt "struct sf_buf"
 to handle sending file data to the client.
 If the sending socket is
-blocking and there are not enough sendfile buffers available,
+blocking, and there are not enough sendfile buffers available,
 .Xr sendfile 2
 will block and report a state of
-.Dq sfbufa .
+.Dq Li sfbufa .
 If the sending socket is non-blocking and there are not enough
 sendfile buffers available, the call will block and wait for the
 necessary buffers to become available before finishing the call.
 .Pp
 The number of
-.Fa sf_buf Ns 's
+.Vt sf_buf Ns 's
 allocated should be proportional to the number of nmbclusters used to
 send data to a client via
 .Xr sendfile 2 .
@@ -130,19 +130,21 @@ Tune accordingly to avoid blocking!
 Busy installations that make extensive use of
 .Xr sendfile 2
 may want to increase these values to be inline with their
-.Ar kern.ipc.nmbclusters
+.Va kern.ipc.nmbclusters
-.Pq see Xr tuning 7 for details .
+(see
+.Xr tuning 7
+for details).
 .Pp
 The number of
 .Xr sendfile 2
 buffers in use is determined at boot time by either the
-.Em kern.ipc.nsfbufs
+.Va kern.ipc.nsfbufs
 .Xr loader.conf 5
 variable or the
-.Em NSFBUFS
+.Dv NSFBUFS
 kernel configuration tunable.
 The number of sendfile buffers scales with
-.Em kern.maxusers .
+.Va kern.maxusers .
 .Sh RETURN VALUES
 .Rv -std sendfile
 .Sh ERRORS
@@ -198,8 +200,8 @@ If specified, the number of bytes successfully sent will be returned in
 .Xr open 2 ,
 .Xr send 2 ,
 .Xr socket 2 ,
-.Xr tuning 7 ,
+.Xr writev 2 ,
-.Xr writev 2
+.Xr tuning 7
 .Sh HISTORY
 The
 .Fn sendfile

lib/libc/sys/stat.2

@@ -90,8 +90,8 @@ and into which information is placed concerning the file.
 The time-related fields of
 .Fa struct stat
 are as follows:
-.Bl -tag -width XXXst_mtime
+.Bl -tag -width ".Va st_birthtime"
-.It st_atime
+.It Va st_atime
 Time when file data last accessed.
 Changed by the
 .Xr mknod 2 ,
@@ -99,7 +99,7 @@ Changed by the
 and
 .Xr read 2
 system calls.
-.It st_mtime
+.It Va st_mtime
 Time when file data last modified.
 Changed by the
 .Xr mknod 2 ,
@@ -107,7 +107,7 @@ Changed by the
 and
 .Xr write 2
 system calls.
-.It st_ctime
+.It Va st_ctime
 Time when file status was last changed (inode data modification).
 Changed by the
 .Xr chmod 2 ,
@@ -120,7 +120,7 @@ Changed by the
 and
 .Xr write 2
 system calls.
-.It st_birthtime
+.It Va st_birthtime
 Time when the inode was created.
 .El
 .Pp

lib/libdevstat/devstat.3

@@ -40,7 +40,7 @@
 .Nm devstat_selectdevs ,
 .Nm devstat_buildmatch ,
 .Nm devstat_compute_statistics ,
-.Nm devstat_compute_etime ,
+.Nm devstat_compute_etime
 .Nd device statistics utility library
 .Sh LIBRARY
 .Lb libdevstat
@@ -553,7 +553,7 @@ and
 .It DSM_MB_PER_SECOND_FREE
 type: long double *
 .Pp
-The average number of megabytesper second in the specified type of
+The average number of megabytes per second in the specified type of
 transaction between the acquisition of
 .Va previous
 and
@@ -600,7 +600,7 @@ acquisition of
 and
 .Va current .
 .It DSM_BUSY_PCT
-type long double *
+type: long double *
 .Pp
 The percentage of time the device had one or more transactions outstanding
 between the acquisition of

lib/libfetch/fetch.3

@@ -444,7 +444,7 @@ Invalid URL
 The accompanying error message includes a protocol-specific error code
 and message, e.g. "File is not available (404 Not Found)"
 .Sh ENVIRONMENT
-.Bl -tag -width FETCH_BIND_ADDRESS
+.Bl -tag -width ".Ev FETCH_BIND_ADDRESS"
 .It Ev FETCH_BIND_ADDRESS
 Specifies a hostname or IP address to which sockets used for outgoing
 connections will be bound.

lib/libusbhid/usbhid.3

@@ -65,13 +65,13 @@
 .Fn hid_report_size "report_desc_t d" "hid_kind_t k" "int id"
 .Ft int
 .Fn hid_locate "report_desc_t d" "u_int usage" "hid_kind_t k" "hid_item_t *h" "int id"
-.Ft char *
+.Ft "char *"
 .Fn hid_usage_page "int i"
-.Ft char *
+.Ft "char *"
 .Fn hid_usage_in_page "u_int u"
 .Ft int
 .Fn hid_parse_usage_page "const char *"
-.Ft char *
+.Ft "char *"
 .Fn hid_parse_usage_in_page "const char *"
 .Ft void
 .Fn hid_init "char *file"
@@ -83,7 +83,7 @@
 The
 .Nm
 library provides routines to extract data from USB Human Interface Devices.
-.Ss INTRODUCTION
+.Ss Introduction
 USB HID devices send and receive data layed out in a device dependent way.
 The
 .Nm
@@ -94,7 +94,7 @@ which contains the data layout information and then use this information.
 The routines can be divided into four parts: extraction of the descriptor,
 parsing of the descriptor, translating to/from symbolic names, and
 data manipulation.
-.Ss DESCRIPTOR FUNCTIONS
+.Ss Descriptor Functions
 A report descriptor can be obtained by calling
 .Fn hid_get_report_desc
 with a file descriptor obtained by opening a
@@ -114,7 +114,7 @@ If
 .Fn hid_dispose_report_desc
 fails it will return
 .Dv NULL .
-.Ss DESCRIPTOR PARSING FUNCTIONS
+.Ss Descriptor Parsing Functions
 To parse the report descriptor the
 .Fn hid_start_parse
 function should be called with a report descriptor and a set that
@@ -125,7 +125,7 @@ where
 .Fa k
 is an item of type
 .Vt hid_kind_t .
-The report id (if present) is given by
+The report ID (if present) is given by
 .Fa id .
 The function returns
 .Dv NULL
@@ -164,7 +164,7 @@ function can be used.
 It should be given the usage code of
 the item and its kind and it will fill the item and return
 non-zero if the item was found.
-.Ss Name TRANSLATION FUNCTIONS
+.Ss Name Translation Functions
 The function
 .Fn hid_usage_page
 will return the symbolic name of a usage page, and the function
@@ -190,7 +190,7 @@ with the name of the table.
 Passing
 .Dv NULL
 to this function will cause it to use the default table.
-.Ss Data EXTRACTION FUNCTIONS
+.Ss Data Extraction Functions
 Given the data obtained from a HID device and an item in the
 report descriptor the
 .Fn hid_get_data