From nobody Fri Jun 9 19:57:57 2023
X-Original-To: dev-commits-src-branches@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 4QdBhP71q2z4cKSM;
Fri, 9 Jun 2023 19:57:57 +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 4QdBhP6T7Tz4Hkq;
Fri, 9 Jun 2023 19:57:57 +0000 (UTC)
(envelope-from git@FreeBSD.org)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim;
t=1686340677;
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=5lGZDiEfOhrljWSVN6IxnzfQDxPtduWeuvH5bbju1+4=;
b=hUzwdFfVRwfmUUtEYdfaH8sjh9u/WilmS+jRfbmYxIvL9nc6sV4BksvJfPNKPnt6KA4/51
2LlEP6qY4v3c5muPcdzdkK5FbLfROz2fsbp82TroJzGeLx5yV+CanjLxREYWxcneTULBtb
raly2AU2bTmWTO2vPf4cj9S5g6gWefUT2MYeB5VPYYRD46SbU9f6OVGj+ORq76pnlA3p6D
2KU1r2W2XL8ptESjyS65uIR2TEH4dyXPj7P423A5xwIC4r+NiilJnWkEcOpv/lepwujKYq
DqUqukY4l1qXfaIM5DCKzLJTdyvHU+Zl3eJSwowL/RHawQLAceRcHc1Bz6nRdA==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org;
s=dkim; t=1686340677;
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=5lGZDiEfOhrljWSVN6IxnzfQDxPtduWeuvH5bbju1+4=;
b=OqHclqlCdyK+7cC1uK0vHZ9Nml6kIov0KIjPY92SPLdlMbmKilGbvwROnDsUOrkml34EwU
IJoaseONxp+L+r2P68MHnKDxHlZdFSw+6brP8tVeIUIr2dUGdqn8adPvyiQfy/Ka9LR9lh
99pbaoeQoC0bqdW3Knk3Fn5uWaIz0DHT0xv+GpBQDdpuS2nAkdbjgQEjM7DU3Ar3kHZf8z
6mKe5ONc0lEU3zZ5BOienCr49CLdPPmuX9HnFJhGxz/tGONKfpO1e1ftKQ+xcQ67+gW0LY
sLmTrWGkdcQKe6uNybj7JnNxn23R7j6CIIwPPorvPQf6WQFGXaKl1jQEIA5XuA==
ARC-Authentication-Results: i=1;
mx1.freebsd.org;
none
ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1686340677; a=rsa-sha256; cv=none;
b=XEg9GgRGpj29EBHgItvqYU9cpxk6/KhO/Zuwe+Cy5ZESX43IiS6JLq8DxufR8YCz3KkFMy
NX4WTW282Qi9Uz5F08Np7RDkOKa2t/vIG7JQQ+gmwwJJo03shpZABudl2BQbW/qVoH7suk
oqGG67XRjdsn9lcHWtsflRZToiPqQdC5EqM2YF/6kTbAfQEA9dzdLbRalTMjlFwoV6Fb1W
+H8rF6pwvCgkjDmicwgYPIeqZBiu/90XDPoqGml8Llq1U6ZDW9es6VuPSDZzVY5r2EpYZr
5mSSsubzZu3dXMqeuugK64GHHBzJSNK2hjrYB+mJQSVwjr7DDPtmm0UQPZRVyQ==
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 4QdBhP5RSGzndw;
Fri, 9 Jun 2023 19:57:57 +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 359Jvvjq071952;
Fri, 9 Jun 2023 19:57:57 GMT
(envelope-from git@gitrepo.freebsd.org)
Received: (from git@localhost)
by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 359JvvWJ071951;
Fri, 9 Jun 2023 19:57:57 GMT
(envelope-from git)
Date: Fri, 9 Jun 2023 19:57:57 GMT
Message-Id: <202306091957.359JvvWJ071951@gitrepo.freebsd.org>
To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org,
dev-commits-src-branches@FreeBSD.org
From: Mitchell Horne <mhorne@FreeBSD.org>
Subject: git: fd9ce8745f64 - stable/13 - printf(9): clarify the description of %b
List-Id: Commits to the stable branches of the FreeBSD src repository <dev-commits-src-branches.freebsd.org>
List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches
List-Help: <mailto:dev-commits-src-branches+help@freebsd.org>
List-Post: <mailto:dev-commits-src-branches@freebsd.org>
List-Subscribe: <mailto:dev-commits-src-branches+subscribe@freebsd.org>
List-Unsubscribe: <mailto:dev-commits-src-branches+unsubscribe@freebsd.org>
Sender: owner-dev-commits-src-branches@freebsd.org
X-BeenThere: dev-commits-src-branches@freebsd.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Git-Committer: mhorne
X-Git-Repository: src
X-Git-Refname: refs/heads/stable/13
X-Git-Reftype: branch
X-Git-Commit: fd9ce8745f643e718014ca301e63c07bad1595d9
Auto-Submitted: auto-generated
X-ThisMailContainsUnwantedMimeParts: N
The branch stable/13 has been updated by mhorne:
URL: https://cgit.FreeBSD.org/src/commit/?id=fd9ce8745f643e718014ca301e63c07bad1595d9
commit fd9ce8745f643e718014ca301e63c07bad1595d9
Author: Mitchell Horne <mhorne@FreeBSD.org>
AuthorDate: 2023-04-25 20:26:36 +0000
Commit: Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2023-06-09 18:14:58 +0000
printf(9): clarify the description of %b
The bit values are numbers given in octal representation, not decimal,
as one might assume from the description. Same goes for the base,
although this has an example.
Reviewed by: emaste
MFC after: 3 days
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D39815
(cherry picked from commit 82bc33d5ad2e00179ea7026c496a35b00550da15)
---
share/man/man9/printf.9 | 10 ++++++----
1 file changed, 6 insertions(+), 4 deletions(-)
diff --git a/share/man/man9/printf.9 b/share/man/man9/printf.9
index 33347fb135ca..631701e455cf 100644
--- a/share/man/man9/printf.9
+++ b/share/man/man9/printf.9
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd April 14, 2023
+.Dd April 25, 2023
.Dt PRINTF 9
.Os
.Sh NAME
@@ -94,11 +94,13 @@ and a
These are used as a register value and a print mask for decoding bitmasks.
The print mask is made up of two parts: the base and the
arguments.
-The base value is the output base expressed as an integer value;
+The base value is the output base (radix) expressed as an octal value;
for example, \e10 gives octal and \e20 gives hexadecimal.
The arguments are made up of a sequence of bit identifiers.
-Each bit identifier begins with an integer value which is the number of the
-bit (starting from 1) this identifier describes.
+Each bit identifier begins with an
+.Em octal
+value which is the number of the bit (starting from 1) this identifier
+describes.
The rest of the identifier is a string of characters containing the name of
the bit.
The string is terminated by either the bit number at the start of the next