From nobody Fri Dec 27 17:06:24 2024 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4YKX2n070vz5j38k; Fri, 27 Dec 2024 17:06:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YKX2m2f9Xz4vfb; Fri, 27 Dec 2024 17:06:24 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1735319184; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=FqYn6WqhV+ZuEeh46yvkbTACpMuR2dsMimOZRrCM7Bs=; b=HVTKW72aihqtfnYQenMqtcFSNIYmDjx2jnWENcfLXl7UQ2ATdRCd9/UXcFRwH8v/pyxBaS pd2dyOM8h49ZiRf6NCBWbDLOYiP4/PUIGzDEDVHB2X9tJF1HIE8H0p47DXIcwg0iMliiSA gblKAWsR6gQXJCLYvDu7a5jRQI3w/odHjfQBcMo+nCLJ7VEOWzJMuDIT7uQ3ORTYXbzcJs 1XX5lkj9pi2bS1jXtli5CeYQifsvM9JUkmhrwRWAvskI1YjefmVVSXJuzXbODv7zFZUgtm rcQCUOc2/hAR3eSNhKoasbbCZWHJD7AsI9Yy/q2Om739XuA1zPC6uyeupgfk2A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1735319184; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=FqYn6WqhV+ZuEeh46yvkbTACpMuR2dsMimOZRrCM7Bs=; b=c/NXtbO53esEzVP5FU/gqMqHkTnyCFcr325bPYeqHWvB2UqBRF5bg+1mUN57mCfQ0W2uWj 4xcTQDk9sJMY/6ksF/Ubp+u6ePC0CoJ019cpjZa6C7/xEuGg7KEpUYe3lzcrIyFPBYoGEA L0KeGj8oXdKQByHXv9Cca/iFHkslHkHOvnWrmAm5mvDTns3x9FEREMfgCNXrGVskBlxiAW dkTNrjcvfMV1QoXHcni38+xdJx9KVU0hIqXf5zcIhJfg2RkqbyGs8jP3fdUPjfjXnEQ/Gl B+VoOeDw/4uCM2rLJD1VXZk/MbeWsv9QGQvkJ3wcLd1LaUPv6vRm7Ce/aAnmlw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1735319184; a=rsa-sha256; cv=none; b=DRvDjUXj9ZDXjlCw47/Ck1KNQueE3YJuM9ArK8HGcdWH8E6lfDQJNaagNG7bSVcUz9Pwg7 Dvxhb3hCS8pTR30+HDv27UIsgPhVcQVhjD4A/wUCC7rWD9zgWgvcdzXtzpLBFpTwgzT8fP M+nHONaQr1onhIduLmUulTfWfEHGotaUI9RcpVFV8pNjynkju9b+4aBs+Fwrdxt/IzaJhL 5u4SB7kLFK4DkO28P8riEPM9O/QW0KwzrYghCsAFHi9Sv3kXKdf7m4zoI2EGk2yJJ7Jcrd GyDl1zuiQ8dSTssLkt9nkeR23Vqp6y6wCohRAowiV/cstjataYc+JENXg62P6w== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4YKX2m18HCznm7; Fri, 27 Dec 2024 17:06:24 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4BRH6OmW037357; Fri, 27 Dec 2024 17:06:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4BRH6OvU037354; Fri, 27 Dec 2024 17:06:24 GMT (envelope-from git) Date: Fri, 27 Dec 2024 17:06:24 GMT Message-Id: <202412271706.4BRH6OvU037354@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: John Baldwin Subject: git: 9a15a1fef95e - stable/14 - manuals: Misc macro typos List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: jhb X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 9a15a1fef95e96ce2434adc76835c862a9e336ce Auto-Submitted: auto-generated The branch stable/14 has been updated by jhb: URL: https://cgit.FreeBSD.org/src/commit/?id=9a15a1fef95e96ce2434adc76835c862a9e336ce commit 9a15a1fef95e96ce2434adc76835c862a9e336ce Author: Graham Percival AuthorDate: 2024-09-12 16:36:42 +0000 Commit: John Baldwin CommitDate: 2024-12-27 15:40:05 +0000 manuals: Misc macro typos These were reported by `mandoc -T lint` as ERROR: skipping unknown macro When these pages were rendered with `man`, the "unknown macro" meant that the entire line was omitted from the output. Obvious typos in: lib/libsys/swapon.2 lib/libsys/procctl.2 share/man/man9/firmware.9 lib/libcasper/services/cap_net/cap_net.3: 'mode' describes a function argument. lib/libsys/statfs.2: there's no .Tm command ("trademark?"), and .Tn ("tradename") is deprecated, so remove the macro entirely. usr.sbin/mfiutil/mfiutil.8: man was interpreting '/dev/' as a macro (which it didn't recognize). share/man/man4/qat.4: same issue as above, but with '0'. In this case, given the context of the previous line, rewriting as "Value '0'" seemed more appropriate. usr.sbin/mlx5tool/mlx5tool.8: typo in .Xr Signed-off-by: Graham Percival Sponsored by: Tarsnap Backup Inc. Reviewed by: concussious, imp Pull Request: https://github.com/freebsd/freebsd-src/pull/1417 (cherry picked from commit 2878d99dfcfbdd7a415a7f31cf95fbd53fc8e581) --- lib/libc/sys/procctl.2 | 2 +- lib/libc/sys/statfs.2 | 4 +--- lib/libc/sys/swapon.2 | 2 +- lib/libcasper/services/cap_net/cap_net.3 | 2 +- share/man/man4/qat.4 | 2 +- usr.sbin/mfiutil/mfiutil.8 | 3 ++- usr.sbin/mlx5tool/mlx5tool.8 | 2 +- 7 files changed, 8 insertions(+), 9 deletions(-) diff --git a/lib/libc/sys/procctl.2 b/lib/libc/sys/procctl.2 index b040116a8e60..2d9833ab4710 100644 --- a/lib/libc/sys/procctl.2 +++ b/lib/libc/sys/procctl.2 @@ -75,7 +75,7 @@ All status changing requests .Dv *_CTL require the caller to have the right to debug the target. All status query requests -.DV *_STATUS +.Dv *_STATUS require the caller to have the right to observe the target. .Pp The following commands are supported: diff --git a/lib/libc/sys/statfs.2 b/lib/libc/sys/statfs.2 index 6111b127b8e3..7e41537b359c 100644 --- a/lib/libc/sys/statfs.2 +++ b/lib/libc/sys/statfs.2 @@ -233,9 +233,7 @@ Corrupted data was detected while reading from the file system. The fields in the .Vt statfs structure have been defined to provide the parameters relevant for -traditional -.Tm UNIX -file systems. +traditional UNIX file systems. For some other file systems, values that have similar, but not identical, semantics to those described above may be returned. An example is msdosfs, which in case of FAT12 or FAT16 file systems diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2 index 8cfac8ce1f64..b5adda8df2fd 100644 --- a/lib/libc/sys/swapon.2 +++ b/lib/libc/sys/swapon.2 @@ -69,7 +69,7 @@ is made available for other purposes. The .Fa special argument points to the name of the device or file used for swapping. -.The +The .Va flags argument takes the following flags: .Bl -tag -width SWAPOFF_FORCE diff --git a/lib/libcasper/services/cap_net/cap_net.3 b/lib/libcasper/services/cap_net/cap_net.3 index 6e525508d3c4..e322222e866f 100644 --- a/lib/libcasper/services/cap_net/cap_net.3 +++ b/lib/libcasper/services/cap_net/cap_net.3 @@ -121,7 +121,7 @@ The .Fn cap_net_limit_init returns an opaque limit handle used to store a list of capabilities. The -.Fv mode +.Fa mode restricts the functionality of the service. Modes are encoded using the following flags: .Pp diff --git a/share/man/man4/qat.4 b/share/man/man4/qat.4 index 03d1e6e956e7..3d8c0cd32664 100644 --- a/share/man/man4/qat.4 +++ b/share/man/man4/qat.4 @@ -148,7 +148,7 @@ QAT firmware revision number. Summary of device specific configuration. .It Va heartbeat QAT device heartbeat status. Value '1' indicates that the device is operational. -'0' value means that the device is not responsive. Device requires restart. +Value '0' means that the device is not responsive. Device requires restart. .It Va heartbeat_failed Number of QAT heartbeat failures received. .It Va heartbeat_sent diff --git a/usr.sbin/mfiutil/mfiutil.8 b/usr.sbin/mfiutil/mfiutil.8 index 86dc6b6ee122..9f8cacf7f16d 100644 --- a/usr.sbin/mfiutil/mfiutil.8 +++ b/usr.sbin/mfiutil/mfiutil.8 @@ -271,7 +271,8 @@ Currently three global options are supported: .It Fl D Ar device .Ar device specifies the device node of the controller to use. -'/dev/' will be added to the device node if needed. +.Pa /dev/ +will be added to the device node if needed. If no device node is specified, then device will be made of the type and device. .It Fl t Ar type diff --git a/usr.sbin/mlx5tool/mlx5tool.8 b/usr.sbin/mlx5tool/mlx5tool.8 index 17f0fd515a50..5f4157c4d49c 100644 --- a/usr.sbin/mlx5tool/mlx5tool.8 +++ b/usr.sbin/mlx5tool/mlx5tool.8 @@ -60,7 +60,7 @@ The utility executes commands on specific adapter, which is addressed using .Em device:bus:slot:function conventions of the PCIe buses. You can match adapters ethernet name and addresses using the -.X pciconf 8 +.Xr pciconf 8 utility. The address is passed as an argument of the .Fl d