From cf999c6e103dff5af8e1c6d655dfc47635fdbc23 Mon Sep 17 00:00:00 2001 From: gbe Date: Fri, 9 Oct 2020 19:12:44 +0000 Subject: [PATCH] Fix a few mandoc issues - skipping paragraph macro: Pp after Sh - sections out of conventional order: Sh EXAMPLES - whitespace at end of input line - normalizing date format --- lib/libc/capability/cap_rights_init.3 | 2 +- lib/libc/sys/cpuset_getaffinity.2 | 2 +- lib/libc/sys/cpuset_getdomain.2 | 5 +-- lib/libc/sys/fhlink.2 | 2 +- lib/libc/sys/getitimer.2 | 2 +- lib/libc/sys/getsockopt.2 | 5 +-- lib/libgssapi/gss_accept_sec_context.3 | 22 +++++++------ lib/libmd/mdX.3 | 2 +- lib/libmd/ripemd.3 | 2 +- lib/libmd/sha.3 | 2 +- lib/libmd/sha256.3 | 2 +- lib/libmd/sha512.3 | 2 +- lib/libmd/skein.3 | 10 +++--- lib/libmt/mt.3 | 22 ++++++------- lib/libpathconv/abs2rel.3 | 4 +-- lib/libpmc/pmc.sandybridge.3 | 2 +- lib/libpmc/pmc.sandybridgeuc.3 | 2 +- lib/libradius/libradius.3 | 9 +++--- lib/librpcsec_gss/rpc_gss_set_callback.3 | 3 +- lib/libsysdecode/sysdecode_mask.3 | 6 ++-- lib/libusb/libusb20.3 | 35 +++++++++++---------- lib/libutil/login_ok.3 | 2 +- lib/msun/man/sincos.3 | 20 ++++++------ share/man/man4/fdt_pinctrl.4 | 3 +- share/man/man4/ig4.4 | 2 +- share/man/man4/man4.i386/ce.4 | 2 +- share/man/man4/mlx5io.4 | 2 +- share/man/man4/mrsas.4 | 2 +- share/man/man4/ng_pppoe.4 | 4 +-- share/man/man4/qlxgbe.4 | 2 +- share/man/man4/rtwn.4 | 6 ++-- share/man/man4/sa.4 | 12 +++---- share/man/man4/smartpqi.4 | 2 +- share/man/man4/spigen.4 | 4 +-- share/man/man4/syscons.4 | 2 +- share/man/man4/udbp.4 | 8 ++--- share/man/man9/OF_finddevice.9 | 25 +++++++-------- share/man/man9/backlight.9 | 2 +- share/man/man9/vnet.9 | 1 - usr.bin/dpv/dpv.1 | 3 +- usr.bin/indent/indent.1 | 3 +- usr.bin/localedef/localedef.1 | 6 ++-- usr.bin/mkimg/mkimg.1 | 4 +-- usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 | 3 +- usr.sbin/camdd/camdd.8 | 26 +++++++-------- usr.sbin/mlx5tool/mlx5tool.8 | 2 +- usr.sbin/nfsd/pnfsserver.4 | 2 +- usr.sbin/zonectl/zonectl.8 | 18 +++++------ 48 files changed, 160 insertions(+), 151 deletions(-) diff --git a/lib/libc/capability/cap_rights_init.3 b/lib/libc/capability/cap_rights_init.3 index 95c62dc1636c..9695a188e317 100644 --- a/lib/libc/capability/cap_rights_init.3 +++ b/lib/libc/capability/cap_rights_init.3 @@ -239,7 +239,7 @@ The functions .Fn cap_rights_is_set , .Fn cap_rights_is_valid , .Fn cap_rights_merge , -.Fn cap_rights_remove +.Fn cap_rights_remove and .Fn cap_rights_contains first appeared in diff --git a/lib/libc/sys/cpuset_getaffinity.2 b/lib/libc/sys/cpuset_getaffinity.2 index ebc72e391ed2..49a7d466d331 100644 --- a/lib/libc/sys/cpuset_getaffinity.2 +++ b/lib/libc/sys/cpuset_getaffinity.2 @@ -149,7 +149,7 @@ was either preposterously large or smaller than the kernel set size. The calling process did not have the credentials required to complete the operation. .It Bq Er ECAPMODE -The calling process attempted to act on a process other than itself, while +The calling process attempted to act on a process other than itself, while in capability mode. See .Xr capsicum 4 . diff --git a/lib/libc/sys/cpuset_getdomain.2 b/lib/libc/sys/cpuset_getdomain.2 index 399b4bed93b2..919b79ada684 100644 --- a/lib/libc/sys/cpuset_getdomain.2 +++ b/lib/libc/sys/cpuset_getdomain.2 @@ -119,7 +119,8 @@ Memory is allocated on a round-robin basis by cycling through each domain in .Fa mask . .It Dv DOMAINSET_POLICY_FIRSTTOUCH Memory is allocated on the domain local to the CPU the requesting thread is -running on. Failure to allocate from this domain will fallback to round-robin. +running on. +Failure to allocate from this domain will fallback to round-robin. .It Dv DOMAINSET_POLICY_PREFER Memory is allocated preferentially from the single domain specified in the mask. If memory is unavailable the domains listed in the parent cpuset will be @@ -167,7 +168,7 @@ was either preposterously large or smaller than the kernel set size. The calling process did not have the credentials required to complete the operation. .It Bq Er ECAPMODE -The calling process attempted to act on a process other than itself, while +The calling process attempted to act on a process other than itself, while in capability mode. See .Xr capsicum 4 . diff --git a/lib/libc/sys/fhlink.2 b/lib/libc/sys/fhlink.2 index 1fcb7365fc0c..0cf00de84b4b 100644 --- a/lib/libc/sys/fhlink.2 +++ b/lib/libc/sys/fhlink.2 @@ -178,7 +178,7 @@ The link count of the file pointed at by .Fa fhp would exceed 32767. .It Bq Er EACCES -A component of +A component of .Fa to prefix denies search permission. .It Bq Er EACCES diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index 9f8df6dbf7c0..1cb3d5e6a6b2 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -28,7 +28,7 @@ .\" @(#)getitimer.2 8.3 (Berkeley) 5/16/95 .\" $FreeBSD$ .\" -.Dd May 1, 2020 +.Dd May 1, 2020 .Dt GETITIMER 2 .Os .Sh NAME diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index dcd39e07efb8..1e4ed6827170 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -28,7 +28,7 @@ .\" @(#)getsockopt.2 8.4 (Berkeley) 5/2/95 .\" $FreeBSD$ .\" -.Dd June 03, 2020 +.Dd June 3, 2020 .Dt GETSOCKOPT 2 .Os .Sh NAME @@ -219,7 +219,8 @@ if they all set before binding the port. Incoming TCP and UDP connections are distributed among the sharing processes based on a hash function of local port number, foreign IP -address and port number. A maximum of 256 processes can share one socket. +address and port number. +A maximum of 256 processes can share one socket. .Pp .Dv SO_KEEPALIVE enables the diff --git a/lib/libgssapi/gss_accept_sec_context.3 b/lib/libgssapi/gss_accept_sec_context.3 index cc368876e390..5d132eff1de4 100644 --- a/lib/libgssapi/gss_accept_sec_context.3 +++ b/lib/libgssapi/gss_accept_sec_context.3 @@ -52,8 +52,9 @@ .Fa "gss_cred_id_t *delegated_cred_handle" .Fc .Sh DESCRIPTION -Allows a remotely initiated security context between the application -and a remote peer to be established. The routine may return a +Allows a remotely initiated security context between the application and a remote +peer to be established. +The routine may return a .Fa output_token which should be transferred to the peer application, where the peer application will present it to @@ -78,7 +79,8 @@ parameters. .Pp Portable applications should be constructed to use the token length and return status to determine whether a token needs to be sent or -waited for. Thus a typical portable caller should always invoke +waited for. +Thus a typical portable caller should always invoke .Fn gss_accept_sec_context within a loop: .Bd -literal @@ -166,10 +168,9 @@ returned to a caller (i.e. when accompanied by a .Dv GSS_S_COMPLETE status code), applications -should not rely on this behavior as the flag was not defined in -Version 1 of the GSS-API. Instead, applications should be prepared to -use per-message services after a successful context establishment, -according to the +should not rely on this behavior as the flag was not defined in Version 1 of the GSS-API. +Instead, applications should be prepared to use per-message services after a +successful context establishment, according to the .Dv GSS_C_INTEG_FLAG and .Dv GSS_C_CONF_FLAG values. @@ -190,9 +191,10 @@ fails, the implementation should not create a context object, and should leave the value of the context_handle parameter set to .Dv GSS_C_NO_CONTEXT to -indicate this. In the event of a failure on a subsequent call, the -implementation is permitted to delete the "half-built" security -context (in which case it should set the +indicate this. +In the event of a failure on a subsequent call, the implementation is +permitted to delete the "half-built" security context (in which case it +should set the .Fa context_handle parameter to .Dv GSS_C_NO_CONTEXT ), but the preferred behavior is to leave the diff --git a/lib/libmd/mdX.3 b/lib/libmd/mdX.3 index b5f4fc07c9b7..30e6f367c662 100644 --- a/lib/libmd/mdX.3 +++ b/lib/libmd/mdX.3 @@ -157,7 +157,7 @@ The .Fn MDXFile and .Fn MDXFileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/ripemd.3 b/lib/libmd/ripemd.3 index 54cdf73ecc8d..d868ae12827b 100644 --- a/lib/libmd/ripemd.3 +++ b/lib/libmd/ripemd.3 @@ -137,7 +137,7 @@ The .Fn RIPEMD160_File and .Fn RIPEMD160_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/sha.3 b/lib/libmd/sha.3 index ac8e3ae02511..20a1e5639dde 100644 --- a/lib/libmd/sha.3 +++ b/lib/libmd/sha.3 @@ -168,7 +168,7 @@ The .Fn SHA1_File and .Fn SHA1_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/sha256.3 b/lib/libmd/sha256.3 index a6829a5ed2ea..d11f2f783557 100644 --- a/lib/libmd/sha256.3 +++ b/lib/libmd/sha256.3 @@ -159,7 +159,7 @@ The .Fn SHA256_File and .Fn SHA256_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/sha512.3 b/lib/libmd/sha512.3 index 64981e64310c..6a5ed6f887d9 100644 --- a/lib/libmd/sha512.3 +++ b/lib/libmd/sha512.3 @@ -203,7 +203,7 @@ The .Fn SHA512_File and .Fn SHA512_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/skein.3 b/lib/libmd/skein.3 index b0278028b1bc..325a1ab4874b 100644 --- a/lib/libmd/skein.3 +++ b/lib/libmd/skein.3 @@ -201,7 +201,7 @@ The .Fn SKEIN256_File and .Fn SKEIN256_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , @@ -220,15 +220,15 @@ These functions appeared in .Fx 11.0 . .Sh AUTHORS .An -nosplit -The core hash routines were imported from version 1.3 of the optimized +The core hash routines were imported from version 1.3 of the optimized Skein reference implementation written by .An Doug Whiting as submitted to the NSA SHA-3 contest. The algorithms were developed by -.An Niels Ferguson , +.An Niels Ferguson , .An Stefan Lucks , -.An Bruce Schneier , -.An Doug Whiting , +.An Bruce Schneier , +.An Doug Whiting , .An Mihir Bellare , .An Tadayoshi Kohno , .An Jon Callas, diff --git a/lib/libmt/mt.3 b/lib/libmt/mt.3 index 39a4d658a590..cadb1689a8d4 100644 --- a/lib/libmt/mt.3 +++ b/lib/libmt/mt.3 @@ -1,7 +1,7 @@ -.\" +.\" .\" Copyright (c) 2013, 2015 Spectra Logic Corporation .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -13,7 +13,7 @@ .\" ("Disclaimer") and any redistribution must be conditioned upon .\" including a substantially similar Disclaimer requirement for further .\" binary redistribution. -.\" +.\" .\" NO WARRANTY .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT @@ -26,9 +26,9 @@ .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGES. -.\" +.\" .\" Authors: Ken Merry (Spectra Logic Corporation) -.\" +.\" .\" $FreeBSD$ .\" .Dd February 13, 2015 @@ -177,7 +177,7 @@ driver returns some status data as XML-formatted strings, and the primary purpose of this library is to make it easier for the software developer to parse those strings and extract the status values. .Pp -The +The .Fn mt_start_element , .Fn mt_end_element , and @@ -310,7 +310,7 @@ except that it prints the results to standard output instead of an sbuf. .Pp .Fn mt_param_entry_sbuf prints the -.Ar entry +.Ar entry to the given sbuf .Ar sb . The argument @@ -361,7 +361,7 @@ See below for notes on the return values. Returns the bits per inch or bits per mm values for a given density entry specified by the .Ar density_num . -If the +If the .Ar bpi argument is non-zero, the bits per inch value is returned. Otherwise, the bits per mm value is returned. @@ -375,8 +375,8 @@ to the supplied density name. gets the current XML status / parameter string from the sa(4) driver instance referenced by the open file descriptor .Ar mtfd . -The -.Xr mtio 4 +The +.Xr mtio 4 .Xr ioctl 2 to be used is supplied as the .Ar cmd @@ -425,7 +425,7 @@ If the density is not known, will return "UNKNOWN". .Pp .Fn mt_density_bp -returns the bits per inch value for the given density (if the +returns the bits per inch value for the given density (if the .Ar bpi field is non-zero), the bits per mm value otherwise, or 0 if the supplied .Ar density_num diff --git a/lib/libpathconv/abs2rel.3 b/lib/libpathconv/abs2rel.3 index 4d46d8a79b26..984b2530e1b0 100644 --- a/lib/libpathconv/abs2rel.3 +++ b/lib/libpathconv/abs2rel.3 @@ -119,8 +119,8 @@ yields: path == "../../../sys/kern" /* It's correct but ... */ -That is correct, but a little redundant. If you wish get the simple -answer 'kern', do the following. +That is correct, but a little redundant. +If you wish get the simple answer 'kern', do the following. path = abs2rel(realpath("/sys/kern", r1), realpath("/sys", r2), result, MAXPATHLEN); diff --git a/lib/libpmc/pmc.sandybridge.3 b/lib/libpmc/pmc.sandybridge.3 index 0e219ae3aeaa..a0bd457e2147 100644 --- a/lib/libpmc/pmc.sandybridge.3 +++ b/lib/libpmc/pmc.sandybridge.3 @@ -1,4 +1,4 @@ -.\" Copyright (c) 2012 Davide Italiano +.\" Copyright (c) 2012 Davide Italiano .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libpmc/pmc.sandybridgeuc.3 b/lib/libpmc/pmc.sandybridgeuc.3 index 0215c36a45d7..f78ff10de4fe 100644 --- a/lib/libpmc/pmc.sandybridgeuc.3 +++ b/lib/libpmc/pmc.sandybridgeuc.3 @@ -1,4 +1,4 @@ -.\" Copyright (c) 2012 Davide Italiano +.\" Copyright (c) 2012 Davide Italiano .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libradius/libradius.3 b/lib/libradius/libradius.3 index f3ff70058d44..27612b73a1e3 100644 --- a/lib/libradius/libradius.3 +++ b/lib/libradius/libradius.3 @@ -485,7 +485,8 @@ To free the resources used by the RADIUS library, call .Fn rad_close . .Ss Server operation Server mode operates much alike to client mode, except packet send and receive -steps are swapped. To operate as server you should obtain server context with +steps are swapped. +To operate as server you should obtain server context with .Fn rad_server_open function, passing opened and bound UDP socket file descriptor as argument. You should define allowed clients and their secrets using @@ -493,9 +494,9 @@ You should define allowed clients and their secrets using function. port, timeout and max_tries arguments are ignored in server mode. You should call .Fn rad_receive_request -function to receive request from client. If you do not want to block on socket -read, you are free to use any poll(), select() or non-blocking sockets for -the socket. +function to receive request from client. +If you do not want to block on socket read, you are free to use any +poll(), select() or non-blocking sockets for the socket. Received request can be parsed with same parsing functions as for client. To respond to the request you should call .Fn rad_create_response diff --git a/lib/librpcsec_gss/rpc_gss_set_callback.3 b/lib/librpcsec_gss/rpc_gss_set_callback.3 index 54f3f517680d..a988e300c5bf 100644 --- a/lib/librpcsec_gss/rpc_gss_set_callback.3 +++ b/lib/librpcsec_gss/rpc_gss_set_callback.3 @@ -74,7 +74,8 @@ GSS-API delegated credentials (if any) .It gss_context The GSS-API context .It lock -A structure used to enforce a particular QOP and service. Set +A structure used to enforce a particular QOP and service. +Set .Fa lock->locked to .Dv TRUE diff --git a/lib/libsysdecode/sysdecode_mask.3 b/lib/libsysdecode/sysdecode_mask.3 index d7e22dca9d63..54e182db31d7 100644 --- a/lib/libsysdecode/sysdecode_mask.3 +++ b/lib/libsysdecode/sysdecode_mask.3 @@ -194,17 +194,17 @@ and .Xr fcntl 2 commands. .It Fn sysdecode_sctp_nxt_flags -The +The .Fa nxt_flags member of a .Vt struct sctp_nxtinfo . .It Fn sysdecode_sctp_rcv_flags -The +The .Fa rcv_flags member of a .Vt struct sctp_rcvinfo . .It Fn sysdecode_sctp_snd_flags -The +The .Fa snd_flags member of a .Vt struct sctp_sndinfo . diff --git a/lib/libusb/libusb20.3 b/lib/libusb/libusb20.3 index eef79bd4658d..66d868cfea37 100644 --- a/lib/libusb/libusb20.3 +++ b/lib/libusb/libusb20.3 @@ -314,15 +314,16 @@ This function returns NULL in case of failure. . .Fn libusb20_tr_get_time_complete will return the completion time of an USB transfer in -millisecond units. This function is most useful for isochronous USB -transfers when doing echo cancelling. +millisecond units. +This function is most useful for isochronous USB transfers when doing echo +cancelling. . .Pp . .Fn libusb20_tr_get_actual_frames will return the actual number of USB frames after an USB -transfer completed. A value of zero means that no data was transferred. -. +transfer completed. +A value of zero means that no data was transferred. .Pp . .Fn libusb20_tr_get_actual_length @@ -691,9 +692,11 @@ Before this call will succeed the USB device must be opened. .Fa setup is a pointer to a decoded and host endian SETUP packet. .Fa data -is a pointer to a data transfer buffer associated with the control transaction. This argument can be NULL. +is a pointer to a data transfer buffer associated with the control transaction. +This argument can be NULL. .Fa pactlen -is a pointer to a variable that will hold the actual transfer length after the control transaction is complete. +is a pointer to a variable that will hold the actual transfer length after the +control transaction is complete. .Fa timeout is the transaction timeout given in milliseconds. A timeout of zero means no timeout. @@ -792,10 +795,11 @@ The USB device need not be opened when calling this function. .Pp . .Fn libusb20_dev_alloc_config -will read out and decode the USB config descriptor for -the given USB device and config index. This function returns a pointer -to the decoded configuration which must eventually be passed to -free(). NULL is returned in case of failure. +will read out and decode the USB config descriptor for the given USB device +and config index. +This function returns a pointer to the decoded configuration which must eventually +be passed to free(). +NULL is returned in case of failure. . .Pp . @@ -902,8 +906,8 @@ will set the global USB device side mode template to The new template is not activated until after the next USB enumeration. The template number decides how the USB device will present itself to -the USB Host, like Mass Storage Device, USB Ethernet Device. Also see -the +the USB Host, like Mass Storage Device, USB Ethernet Device. +Also see the .Xr usb2_template 4 module. This function returns zero on success else a LIBUSB20_ERROR value is @@ -966,10 +970,9 @@ returned. .Fn libusb20_be_alloc_default .Fn libusb20_be_alloc_freebsd .Fn libusb20_be_alloc_linux -These functions are used to allocate a specific USB backend or the -operating system default USB backend. Allocating a backend is a way to -scan for currently present USB devices. -. +These functions are used to allocate a specific USB backend or the operating system +default USB backend. +Allocating a backend is a way to scan for currently present USB devices. .Pp . .Fn libusb20_be_device_foreach diff --git a/lib/libutil/login_ok.3 b/lib/libutil/login_ok.3 index b43906e1f471..c18e94ed680e 100644 --- a/lib/libutil/login_ok.3 +++ b/lib/libutil/login_ok.3 @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd May 10, 2020 +.Dd May 10, 2020 .Dt LOGIN_OK 3 .Os .Sh NAME diff --git a/lib/msun/man/sincos.3 b/lib/msun/man/sincos.3 index 9c42a9605710..7d44bea931b1 100644 --- a/lib/msun/man/sincos.3 +++ b/lib/msun/man/sincos.3 @@ -50,33 +50,33 @@ and functions compute the sine and cosine of .Fa x . Using these functions allows argument reduction to occur only -once instead of twice with individual invocations of +once instead of twice with individual invocations of .Fn sin -and +and .Fn cos . -Like +Like .Fn sin -and +and .Fn cos , a large magnitude argument may yield a result with little or no significance. .Sh RETURN VALUES -Upon returning from +Upon returning from .Fn sincos , .Fn sincosf , and .Fn sincosl , -the memory pointed to by -.Ar "*s" +the memory pointed to by +.Ar "*s" and -.Ar "*c" +.Ar "*c" are assigned the values of sine and cosine, respectively. .Sh SEE ALSO .Xr cos 3 , .Xr sin 3 , .Sh HISTORY -These functions were added to +These functions were added to .Fx 9.0 -to aid in writing various complex function contained in +to aid in writing various complex function contained in .St -isoC-99 . diff --git a/share/man/man4/fdt_pinctrl.4 b/share/man/man4/fdt_pinctrl.4 index aefd477cdf72..7c387ded9069 100644 --- a/share/man/man4/fdt_pinctrl.4 +++ b/share/man/man4/fdt_pinctrl.4 @@ -33,10 +33,9 @@ .Sh SYNOPSIS .Cd "device fdt_pinctrl" .Sh DESCRIPTION -.Pp Pin multiplexing is a technology used to re-purpose a single physical connection (depending on chip packaging it may be -pin, ball, or pad) by routing its signal to any one of several +pin, ball, or pad) by routing its signal to any one of several different SoC internal devices. For example, based on the actual device design, a single SoC chip pin might perform any of these roles: SPI clock, I2C diff --git a/share/man/man4/ig4.4 b/share/man/man4/ig4.4 index da76ae526f59..8220c0da0ffb 100644 --- a/share/man/man4/ig4.4 +++ b/share/man/man4/ig4.4 @@ -71,7 +71,7 @@ device with the same unit number. .An -nosplit The .Nm -driver was written for +driver was written for .Dx by .An Matthew Dillon diff --git a/share/man/man4/man4.i386/ce.4 b/share/man/man4/man4.i386/ce.4 index fec2dabcb8d7..531904fd539c 100644 --- a/share/man/man4/man4.i386/ce.4 +++ b/share/man/man4/man4.i386/ce.4 @@ -9,7 +9,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE diff --git a/share/man/man4/mlx5io.4 b/share/man/man4/mlx5io.4 index 5057ee356204..495cd6608f47 100644 --- a/share/man/man4/mlx5io.4 +++ b/share/man/man4/mlx5io.4 @@ -10,7 +10,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE diff --git a/share/man/man4/mrsas.4 b/share/man/man4/mrsas.4 index ad1dec46c637..fb2288d91f80 100644 --- a/share/man/man4/mrsas.4 +++ b/share/man/man4/mrsas.4 @@ -34,7 +34,7 @@ .\" .\" $FreeBSD$ .\" -.Dd Mar 13, 2019 +.Dd March 13, 2019 .Dt MRSAS 4 .Os .Sh NAME diff --git a/share/man/man4/ng_pppoe.4 b/share/man/man4/ng_pppoe.4 index 7b0aee78a6cf..d4ca53e68714 100644 --- a/share/man/man4/ng_pppoe.4 +++ b/share/man/man4/ng_pppoe.4 @@ -110,9 +110,9 @@ using the .Qq Li [AC-Name\\][Host-Uniq|]Service-Name syntax. To set a binary Host-Uniq, it must be encoded as a hexadecimal lowercase -string and prefixed with +string and prefixed with .Qq Li 0x , -for example +for example .Qq Li 0x6d792d746167 is equivalent to .Qq Li my-tag . diff --git a/share/man/man4/qlxgbe.4 b/share/man/man4/qlxgbe.4 index f7934dbea3bd..5082829e1dc3 100644 --- a/share/man/man4/qlxgbe.4 +++ b/share/man/man4/qlxgbe.4 @@ -53,7 +53,7 @@ TCP and UDP checksum offload for both IPv4 and IPv6, Large Segment Offload for both IPv4 and IPv6, Jumbo frames, VLAN Tag, and Receive Side scaling, ability to select either HW or Software LRO, -when LRO is enabled (default HW LRO). +when LRO is enabled (default HW LRO). For further hardware information, see .Pa http://www.qlogic.com/ . .Sh HARDWARE diff --git a/share/man/man4/rtwn.4 b/share/man/man4/rtwn.4 index 82b4766d7f63..1ffafc6dfcf9 100644 --- a/share/man/man4/rtwn.4 +++ b/share/man/man4/rtwn.4 @@ -150,9 +150,9 @@ prompt before booting the kernel or stored in .It Va dev.rtwn.%d.hwcrypto This tunable controls how key slots are assigned: .br -0 - disable h/w crypto support. Features that require access -to frame contents (e.g., TCP/UDP/IP Rx checksum validation) -will not work; +0 - disable h/w crypto support. +Features that require access to frame contents (e.g., TCP/UDP/IP Rx +checksum validation) will not work; .br 1 - use h/w crypto support for pairwise keys only; .br diff --git a/share/man/man4/sa.4 b/share/man/man4/sa.4 index c7336748d432..bb0ee3f4d743 100644 --- a/share/man/man4/sa.4 +++ b/share/man/man4/sa.4 @@ -251,7 +251,7 @@ The user can query parameters using (which uses the .Dv MTIOCPARAMGET ioctl) and the user can set parameters using -.Dq mt param -s +.Dq mt param -s (which uses the .Dv MTIOCPARAMSET ioctl). @@ -281,13 +281,13 @@ driver reports entering Programmable Early Warning, Early Warning and End of Media conditions by returning a write with 0 bytes written, and .Dv errno set to 0. -If +If .Va eot_warn is set to 1, the .Nm driver will set .Dv errno -to +to .Dv ENOSPC when it enters any of the out of space conditions. .It protection.protection_supported @@ -353,10 +353,10 @@ In addition, when EOM is injected, the tape position status will be updated to temporarily show Beyond of the Programmable Early Warning (BPEW) status. To see BPEW status, use the .Dv MTIOCEXTGET -ioctl, which is used by the -.Dq mt status +ioctl, which is used by the +.Dq mt status command. -To inject an EOM notification, set the +To inject an EOM notification, set the .Pp .Va kern.cam.sa.%d.inject_eom .Pp diff --git a/share/man/man4/smartpqi.4 b/share/man/man4/smartpqi.4 index ca3fad07a9de..d1df4514f2d8 100644 --- a/share/man/man4/smartpqi.4 +++ b/share/man/man4/smartpqi.4 @@ -71,7 +71,7 @@ driver include: .It HPE Gen10 Smart Array Controller Family .It -OEM Controllers based on the Microsemi Chipset +OEM Controllers based on the Microsemi Chipset .El .Sh FILES .Bl -tag -width /boot/kernel/aac.ko -compact diff --git a/share/man/man4/spigen.4 b/share/man/man4/spigen.4 index f79bb85dcfaf..e586b0baa82a 100644 --- a/share/man/man4/spigen.4 +++ b/share/man/man4/spigen.4 @@ -58,7 +58,7 @@ line on the bus, and all I/O performed through that instance is done with that chip-select line asserted. .Pp SPI data transfers are inherently bi-directional; there are not separate -read and write operations. +read and write operations. When commands and data are sent to a device, data also comes back from the device, although in some cases the data may not be useful (or even documented or predictable for some devices). @@ -129,7 +129,7 @@ The setting remains in effect for subsequent transfers; it is not necessary to reset this before each transfer. .El .Sh HINTS CONFIGURATION -On a +On a .Xr device.hints 5 based system, such as .Li MIPS , diff --git a/share/man/man4/syscons.4 b/share/man/man4/syscons.4 index 8fa34eefb67d..c2f8cd56e0ee 100644 --- a/share/man/man4/syscons.4 +++ b/share/man/man4/syscons.4 @@ -422,7 +422,7 @@ These options remove the .Qq dumb , .Qq sc , and -.Qq scteken +.Qq scteken terminal emulators, respectively. .El .Ss Driver Flags diff --git a/share/man/man4/udbp.4 b/share/man/man4/udbp.4 index 3ac8b3fa470c..eaa9283d8050 100644 --- a/share/man/man4/udbp.4 +++ b/share/man/man4/udbp.4 @@ -118,7 +118,7 @@ has been expressly designed to follow its specification. .Xr ngctl 8 .\" .Rs -.%B Universal Serial Bus: Communications Class Subclass Specification for Ethernet Emulation Model Devices +.%B Universal Serial Bus: Communications Class Subclass Specification for Ethernet Emulation Model Devices .%N Revision 1.0 .%D February 2, 2005 .%I USB Implementers Forum, Inc. @@ -136,8 +136,8 @@ makes them unsuitable as a "drop-in" replacement for an Ethernet LAN; for a USB 3.0 SuperSpeed cable, latency is comparable to 100BaseTX Ethernet (but often worse), with throughput comparable to 2.5GBASE-T. .Pp -However, their energy efficiency makes them attractive for embedded -applications. A Plugable PL27A1 cable claims 24mA of USB3 bus power, +However, their energy efficiency makes them attractive for embedded applications. +A Plugable PL27A1 cable claims 24mA of USB3 bus power, as compared to 150mA for a typical USB 3.0 to Gigabit Ethernet interface. .Sh HISTORY The @@ -160,6 +160,6 @@ and .An Nick Hibma Aq Mt n_hibma@FreeBSD.org . .Pp This manual page was written by -.An Nick Hibma Aq Mt n_hibma@FreeBSD.org +.An Nick Hibma Aq Mt n_hibma@FreeBSD.org and updated by .An Bruce Simpson Aq Mt bms@FreeBSD.org . diff --git a/share/man/man9/OF_finddevice.9 b/share/man/man9/OF_finddevice.9 index a2fb69a82de1..30341e779bf2 100644 --- a/share/man/man9/OF_finddevice.9 +++ b/share/man/man9/OF_finddevice.9 @@ -37,23 +37,10 @@ .Ft phandle_t .Fn OF_finddevice "const char *path" .Sh DESCRIPTION -.Pp .Fn OF_finddevice returns the phandle for the node specified by the .Fa path . Returns -1 if the path cannot be found in the tree. -.Sh CAVEATS -The return value should only be checked with equality -operators (equal to, not equal to) and not relational comparison -(less than, greater than ). -There is a discrepancy between IEEE 1275 standard and -.Fx Ns 's -internal representation of a phandle: IEEE 1275 -requires the return value of this function to be -1 if the path -is not found. -But phandle_t is an unsigned type, so it cannot -be relationally compared with -1 or 0, this comparison -is always true or always false. .Sh EXAMPLES .Bd -literal phandle_t root, i2c; @@ -72,3 +59,15 @@ is always true or always false. .An -nosplit This manual page was written by .An Oleksandr Tymoshenko Aq Mt gonzo@FreeBSD.org . +.Sh CAVEATS +The return value should only be checked with equality +operators (equal to, not equal to) and not relational comparison +(less than, greater than ). +There is a discrepancy between IEEE 1275 standard and +.Fx Ns 's +internal representation of a phandle: IEEE 1275 +requires the return value of this function to be -1 if the path +is not found. +But phandle_t is an unsigned type, so it cannot +be relationally compared with -1 or 0, this comparison +is always true or always false. diff --git a/share/man/man9/backlight.9 b/share/man/man9/backlight.9 index e8b5de581cd0..5151ab1e91da 100644 --- a/share/man/man9/backlight.9 +++ b/share/man/man9/backlight.9 @@ -22,7 +22,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 02, 2020 +.Dd October 2, 2020 .Dt BACKLIGHT 9 .Os .Sh NAME diff --git a/share/man/man9/vnet.9 b/share/man/man9/vnet.9 index a4e979078249..4848023e4cc9 100644 --- a/share/man/man9/vnet.9 +++ b/share/man/man9/vnet.9 @@ -39,7 +39,6 @@ .Cd "options VNET_DEBUG" .Pp .In sys/vnet.h -.Pp .\"------------------------------------------------------------ .Ss "Constants and Global Variables" .\" diff --git a/usr.bin/dpv/dpv.1 b/usr.bin/dpv/dpv.1 index 992251c88ab9..8c0dce79d2d1 100644 --- a/usr.bin/dpv/dpv.1 +++ b/usr.bin/dpv/dpv.1 @@ -144,7 +144,8 @@ Prevent visually distracting initialization/exit routines for scripts running .Xr dialog 1 several times. .It Fl l -Line mode. Read lines from input instead of bytes. +Line mode. +Read lines from input instead of bytes. .It Fl L Ar size Label size. If negative, shrink to longest label width. diff --git a/usr.bin/indent/indent.1 b/usr.bin/indent/indent.1 index 9e220ff11eeb..04e8ad355e28 100644 --- a/usr.bin/indent/indent.1 +++ b/usr.bin/indent/indent.1 @@ -122,7 +122,8 @@ is named .Sq Pa /blah/blah/file , the backup file is named .Sq Pa file.BAK -by default. The extension used for the backup file may be overridden using the +by default. +The extension used for the backup file may be overridden using the .Ev SIMPLE_BACKUP_SUFFIX environment variable. .Pp diff --git a/usr.bin/localedef/localedef.1 b/usr.bin/localedef/localedef.1 index 41f030684b04..126193caebb3 100644 --- a/usr.bin/localedef/localedef.1 +++ b/usr.bin/localedef/localedef.1 @@ -124,9 +124,9 @@ See .Sx NOTES . .It Fl U Ignore the presence of character symbols that have no matching character -definition. This facilitates the use of a common locale definition file -to be used across multiple encodings, even when some symbols are not -present in a given encoding. +definition. +This facilitates the use of a common locale definition file to be used across multiple +encodings, even when some symbols are not present in a given encoding. .It Fl v Emit verbose debugging output on standard output. .It Fl w Ar widthfile diff --git a/usr.bin/mkimg/mkimg.1 b/usr.bin/mkimg/mkimg.1 index 129269ca4fb8..69af5ef0fe0a 100644 --- a/usr.bin/mkimg/mkimg.1 +++ b/usr.bin/mkimg/mkimg.1 @@ -223,8 +223,8 @@ The preferred file extension is ".qcow" and ".qcow2" for QCOW and QCOW2 (resp.), but ".qcow" is sometimes used for version 2 files as well. .Ss RAW file format This file format is a sector by sector representation of an actual disk. -There is no extra information that describes or relates to the format -itself. The size of the file is the size of the (virtual) disk. +There is no extra information that describes or relates to the format itself. +The size of the file is the size of the (virtual) disk. This file format is suitable for being copyied onto a disk with utilities like .Nm dd . diff --git a/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 b/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 index a2a118679f40..95abc87a5720 100644 --- a/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 +++ b/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 @@ -148,7 +148,8 @@ Information (SMIv2). The context to query with SNMPv3 PDUs. .Bl -tag -width \& .It Cm context=name -The context name. Default is "" (empty). +The context name. +Default is "" (empty). .It Cm context-engine=engine-id The SNMP Engine ID of the context to query with SNMPv3 PDUs, represented as binary octet string. diff --git a/usr.sbin/camdd/camdd.8 b/usr.sbin/camdd/camdd.8 index af556bb7bd2e..1f116b1426ee 100644 --- a/usr.sbin/camdd/camdd.8 +++ b/usr.sbin/camdd/camdd.8 @@ -1,7 +1,7 @@ -.\" +.\" .\" Copyright (c) 2015 Spectra Logic Corporation .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -13,7 +13,7 @@ .\" ("Disclaimer") and any redistribution must be conditioned upon .\" including a substantially similar Disclaimer requirement for further .\" binary redistribution. -.\" +.\" .\" NO WARRANTY .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT @@ -26,11 +26,11 @@ .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGES. -.\" -.\" Authors: Ken Merry (Spectra Logic Corporation) -.\" -.\" $FreeBSD$ .\" +.\" Authors: Ken Merry (Spectra Logic Corporation) +.\" +.\" $FreeBSD$ +.\ .Dd November 11, 2015 .Dt CAMDD 8 .Os @@ -70,7 +70,7 @@ The following options are available: .Bl -tag -width 12n .It Fl i | o Ar args Specify the input and output device or file. -Both +Both .Fl i and .Fl o @@ -96,7 +96,7 @@ name and unit number, for instance or a regular peripheral driver name and unit number, for instance .Dq da5 . It can also be the path of a -.Xr pass 4 +.Xr pass 4 or other disk device, like .Dq /dev/da5 . It may also be a bus:target:lun, for example: @@ -127,7 +127,7 @@ It does support probing disk sector size and capacity information, and tape blocksize and maximum transfer size information. The file interface supports standard files, disks, tape drives, special devices, pipes and standard input and output. -If the file is specified as a +If the file is specified as a .Dq - , standard input or standard output are used. For tape devices, the specified blocksize will be the size that @@ -138,7 +138,7 @@ size. So, that means .Nm will not write anything smaller than the sector size. -At the end of a transfer, if there isn't sufficient data from the reader +At the end of a transfer, if there isn't sufficient data from the reader to yield a full block, .Nm will add zeros on the end of the data from the reader to make up a full @@ -171,7 +171,7 @@ Specify a desired queue depth for the input or output path. will attempt to keep the requested number of requests of the specified blocksize queued to the input or output device. Queue depths greater than 1 are only supported for the asynchronous -.Xr pass 4 +.Xr pass 4 output method. The queue depth is maintained on a best effort basis, and may not be possible to maintain for especially fast devices. @@ -261,7 +261,7 @@ Stop the transfer after 100MB has been written. Copy disk da8 using a 1MB blocksize and desired queue depth of 3 to the file disk.img. .Pp -.Dl camdd -i file=/etc/rc -o file=- +.Dl camdd -i file=/etc/rc -o file=- .Pp Read the file /etc/rc and write it to standard output. .Pp diff --git a/usr.sbin/mlx5tool/mlx5tool.8 b/usr.sbin/mlx5tool/mlx5tool.8 index 3d9435037fab..6e0eee0eac4f 100644 --- a/usr.sbin/mlx5tool/mlx5tool.8 +++ b/usr.sbin/mlx5tool/mlx5tool.8 @@ -10,7 +10,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE diff --git a/usr.sbin/nfsd/pnfsserver.4 b/usr.sbin/nfsd/pnfsserver.4 index cb71448dde6e..6cdaf61c29c2 100644 --- a/usr.sbin/nfsd/pnfsserver.4 +++ b/usr.sbin/nfsd/pnfsserver.4 @@ -266,7 +266,7 @@ Note that the must be the exact mounted-on path string used when the DS was mounted on the MDS. .Pp Once the mirrored DS has been disabled, the pNFS service should continue to -function, but file updates will only happen on the DS(s) +function, but file updates will only happen on the DS(s) that have not been disabled. Assuming two way mirroring, that implies the one DS of the pair stored in the .Dq pnfsd.dsfile diff --git a/usr.sbin/zonectl/zonectl.8 b/usr.sbin/zonectl/zonectl.8 index 5e2f313603c7..d50fc2a6c2c0 100644 --- a/usr.sbin/zonectl/zonectl.8 +++ b/usr.sbin/zonectl/zonectl.8 @@ -1,7 +1,7 @@ -.\" +.\" .\" Copyright (c) 2015 Spectra Logic Corporation .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -13,7 +13,7 @@ .\" ("Disclaimer") and any redistribution must be conditioned upon .\" including a substantially similar Disclaimer requirement for further .\" binary redistribution. -.\" +.\" .\" NO WARRANTY .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT @@ -26,11 +26,11 @@ .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGES. -.\" -.\" Authors: Ken Merry (Spectra Logic Corporation) -.\" -.\" $FreeBSD$ .\" +.\" Authors: Ken Merry (Spectra Logic Corporation) +.\" +.\" $FreeBSD$ +.\ .Dd May 18, 2016 .Dt ZONECTL 8 .Os @@ -188,8 +188,8 @@ The summary and column headings are printed, fields are separated by spaces and the fields themselves may contain spaces. .It summary Just print the summary: the number of zones, the maximum LBA (LBA of the -last logical block on the drive), and the value of the -.Dq same +last logical block on the drive), and the value of the +.Dq same field. The .Dq same