From nobody Wed Feb 09 21:20:54 2022 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 29AE219B4F05; Wed, 9 Feb 2022 21:20:55 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4JvCTz0fp4z4l4D; Wed, 9 Feb 2022 21:20:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1644441655; 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=ki5p65dc3pt/tP3qxGtmXzbGjN3r28aqKRlja+wTHi0=; b=ZULqcbIIV0+5av9LfVUE9YUqTihO21x+mf1vTZFghxnO3gSImZC3GCe4D7NYgMIgGve4Fn F2OSZVh/lfR6+h7NSpEh8+DsOjEkSxB98GSs3seSbMYepJRTtR44UHPgNRlXCPuv1Oefd2 hMfxU6hX7Qcfeg1przUUQJsGTG2YY8O6CFJD7dNleT8g7V6HQ2BmHbVm7J6P4ye4UrKOEC m0K2+ol49wR5z44HueXK0K4WbidwLdcvsUlnEMuIPJBlq9sJKix2ZC5L8RiQ8otXOopwNc O1p9iE0YTSHqIM02jniRqWpxguidUR93x+GkA5dG2f0gcDkvAGZ0IruP5ZKJdQ== 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 EAE42144D8; Wed, 9 Feb 2022 21:20:54 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 219LKsIr037940; Wed, 9 Feb 2022 21:20:54 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 219LKsNr037939; Wed, 9 Feb 2022 21:20:54 GMT (envelope-from git) Date: Wed, 9 Feb 2022 21:20:54 GMT Message-Id: <202202092120.219LKsNr037939@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Ed Maste Subject: git: bf006787fed9 - stable/13 - sysctl.9: put negative sense sysctl note in own paragraph 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: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: src X-Git-Refname: refs/heads/stable/13 X-Git-Reftype: branch X-Git-Commit: bf006787fed90dbeb93d4af09a4e2ae747974a7f Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1644441655; 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=ki5p65dc3pt/tP3qxGtmXzbGjN3r28aqKRlja+wTHi0=; b=YnN2zurheYuM6DB6A+rgbMArPtZ3XORRKqwmwFTE6Abd1IWC+o0wt8epASxOnHST9UlkC+ eHKekpbkNXUNKAiPSGbJch3+nPmPIyiYMhwVwJ0xcM/FTBcnu9/kluVBBra6dICnmsE7Qa GdOaW5sAUqggIMDeT1E5xZAYuYnEh2fBxXeM64Rs+vdMnTKrMNBik9iFYSc65AxfMgTOIB eYblUXFZOBfwuCBWbXhYb6WQpFIPpoXLa7815zZI91QCuWEDZKRz/Zij+9kRzFg92S1FwX ztvjuCp56wxbtcTaW08qDsPwmOlW5ryCx1nFUvxqVI525EvIQAZ+fYheJSLzjA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1644441655; a=rsa-sha256; cv=none; b=MxqJqGj8azuiUD+pACRDwYK1Vmv8++TBn9RKc/QsRrSFXFF+YxJpD6/xBzPk4AY90xfkph Ampt3fW7W/xWSLc6p8bOcOqkDjnFV8B/D5F4xXT0qj7gL9YeGZg6RZ4/xQXPMFZ/eSrIcV bIqpzHdLj8k1U7H6Xkme7Kgs+Ui+Z0GnrpBiH/u3OChK0fg2NIECffTUMn8w8hVXglJgSK qvZX5kDtZADM0EGugw2k3Z2zEo98NeduFIOIMTaXCklECgTMsqADMI8y/O18u/kBxCPmlT OlkqWjuMOaqvnCAVGHWjASNIAHTOh2t5ljgDhCzpPIexIo29SmWp/J/a/62dOA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by emaste: URL: https://cgit.FreeBSD.org/src/commit/?id=bf006787fed90dbeb93d4af09a4e2ae747974a7f commit bf006787fed90dbeb93d4af09a4e2ae747974a7f Author: Ed Maste AuthorDate: 2021-08-17 15:58:03 +0000 Commit: Ed Maste CommitDate: 2022-02-09 21:20:41 +0000 sysctl.9: put negative sense sysctl note in own paragraph The sysctl man page cautions against negative-sense boolean sysctls (foobar_disable), but it gets lost at the end of a large paragraph. Move it to a separate paragraph in an attempt to make it more clear. This man page could use a more holistic review and edit pass. This change is simple and straightforward and I hope provides a small but immediate benefit. (cherry picked from commit dff1ba09f74725bb0a0b7b8c229ed4e6665b43e6) --- share/man/man9/sysctl.9 | 1 + 1 file changed, 1 insertion(+) diff --git a/share/man/man9/sysctl.9 b/share/man/man9/sysctl.9 index bae693489c73..f2b1159e71a8 100644 --- a/share/man/man9/sysctl.9 +++ b/share/man/man9/sysctl.9 @@ -1024,6 +1024,7 @@ underscore characters, as in Underscore characters may be omitted only if the name consists of not more than two words, each being not longer than four characters, as in .Va bootfile . +.Pp For boolean sysctls, negative logic should be totally avoided. That is, do not use names like .Va no_foobar