From owner-dev-commits-src-all@freebsd.org Tue Aug 17 16:11:02 2021 Return-Path: Delivered-To: dev-commits-src-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C974A666D5C; Tue, 17 Aug 2021 16:11:02 +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 4Gpwxf4L7cz3H9M; Tue, 17 Aug 2021 16:11:02 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 7D2BE20925; Tue, 17 Aug 2021 16:11:02 +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 17HGB2EL069729; Tue, 17 Aug 2021 16:11:02 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 17HGB2P9069728; Tue, 17 Aug 2021 16:11:02 GMT (envelope-from git) Date: Tue, 17 Aug 2021 16:11:02 GMT Message-Id: <202108171611.17HGB2P9069728@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Ed Maste Subject: git: dff1ba09f747 - main - sysctl.9: put negative sense sysctl note in own paragraph 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/main X-Git-Reftype: branch X-Git-Commit: dff1ba09f74725bb0a0b7b8c229ed4e6665b43e6 Auto-Submitted: auto-generated X-BeenThere: dev-commits-src-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the src repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Aug 2021 16:11:02 -0000 The branch main has been updated by emaste: URL: https://cgit.FreeBSD.org/src/commit/?id=dff1ba09f74725bb0a0b7b8c229ed4e6665b43e6 commit dff1ba09f74725bb0a0b7b8c229ed4e6665b43e6 Author: Ed Maste AuthorDate: 2021-08-17 15:58:03 +0000 Commit: Ed Maste CommitDate: 2021-08-17 16:10:44 +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. --- 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