X-Loop: help-debbugs@HIDDEN
Subject: bug#79896: [coreutils] printf deficiencies
Resent-From: Bernhard Gabler <bernhard_gabler@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-coreutils@HIDDEN
Resent-Date: Tue, 25 Nov 2025 20:37:03 +0000
Resent-Message-ID: <handler.79896.B.176410298523413 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: report 79896
X-GNU-PR-Package: coreutils
X-GNU-PR-Keywords:
To: 79896 <at> debbugs.gnu.org
X-Debbugs-Original-To: bug-coreutils@HIDDEN
Received: via spool by submit <at> debbugs.gnu.org id=B.176410298523413
(code B ref -1); Tue, 25 Nov 2025 20:37:03 +0000
Received: (at submit) by debbugs.gnu.org; 25 Nov 2025 20:36:25 +0000
Received: from localhost ([127.0.0.1]:42698 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1vNzlw-00065N-5u
for submit <at> debbugs.gnu.org; Tue, 25 Nov 2025 15:36:25 -0500
Received: from lists.gnu.org ([2001:470:142::17]:58772)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <bernhard_gabler@HIDDEN>)
id 1vNbVN-0007HA-4U
for submit <at> debbugs.gnu.org; Mon, 24 Nov 2025 13:41:44 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10])
by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.90_1) (envelope-from <bernhard_gabler@HIDDEN>)
id 1vNbVE-0000TG-MM
for bug-coreutils@HIDDEN; Mon, 24 Nov 2025 13:41:32 -0500
Received: from mout.web.de ([212.227.15.3])
by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.90_1) (envelope-from <bernhard_gabler@HIDDEN>)
id 1vNbVC-0008Eq-A7
for bug-coreutils@HIDDEN; Mon, 24 Nov 2025 13:41:32 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=web.de;
s=s29768273; t=1764009686; x=1764614486; i=bernhard_gabler@HIDDEN;
bh=F9wVxuOdON25JC4fQSUsDMN89jc1SefmpZfGds73pZE=;
h=X-UI-Sender-Class:Content-Type:Message-ID:Date:MIME-Version:To:
From:Subject:cc:content-transfer-encoding:content-type:date:from:
message-id:mime-version:reply-to:subject:to;
b=N1Fw5rt0w4QGX7mH0u199mSEZlIajssmzzuZPFGMmgADysalCFH8ZsRkSYiCNBH+
iZNXpXRjotaru2dCddW1swRGpLQU44GiGLJfTsK3WqfIclgtfbpSxvenS79hQ4o+b
cqSEHMTk39TZJmyobVpj/yORokIjAKRrBXUV51cY8EvQYDFErqmSJEASqsLjJh5u7
BtRH8+NVRVPTBbemTUXBBstCO0cQ/9iow6Lf3Xlas90q0OGaucEyX2cv7lZ3a8IPi
/Uj96TtXEfsC3DiRQzA3z/7Hv2xRv9pdceT4LAgfJzWTMLf6oRRtCjlWmpbdHm39Y
xyYZzzir/uk5v4B/+Q==
X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6
Received: from [192.168.178.38] ([94.134.177.179]) by smtp.web.de (mrweb006
[213.165.67.108]) with ESMTPSA (Nemesis) id 1MNwjc-1vlteA3ELY-00Yra4 for
<bug-coreutils@HIDDEN>; Mon, 24 Nov 2025 19:41:26 +0100
Content-Type: multipart/alternative;
boundary="------------ZxX5BB2vTHX0H4LtWsepHuHu"
Message-ID: <6c35ea05-8c81-404e-8a2a-d9bc4fdc1cda@HIDDEN>
Date: Mon, 24 Nov 2025 19:41:26 +0100
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Content-Language: en-US, de-DE
From: Bernhard Gabler <bernhard_gabler@HIDDEN>
X-Provags-ID: V03:K1:YPqa8Ef/HMRNeYupV0MGSip8C8nOxqTiGUtDWlKrNgM/FVaf1KO
h6NjIT7SFL6QUQHV/sbCqs8Dfr7eMvQ5g05S9otKiqAa4/Wc8+ZJBvDOP0HfPpei0ulWK7p
JYtZlR3fOhmaJNsUAW/hRpB1+qmuFcqyL1siJIW4TfRG9B9EDfqkiNMrx6QO4eonJImUAQh
g4PmPMC5gs90CS7BdJd2g==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:PnvZueGQihc=;9OWa7dL1g0hLZLxCw5RxEMdyZPI
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
Received-SPF: pass client-ip=212.227.15.3; envelope-from=bernhard_gabler@HIDDEN;
helo=mout.web.de
X-Spam_score_int: -27
X-Spam_score: -2.8
X-Spam_bar: --
X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001,
HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001,
RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001,
RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001,
SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.0 (/)
X-Mailman-Approved-At: Tue, 25 Nov 2025 15:34:32 -0500
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)
This is a multi-part message in MIME format.
--------------ZxX5BB2vTHX0H4LtWsepHuHu
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: quoted-printable
Hello,
today I noticed the following deficiencies in implementation and=20
documentation of printf:
(1)
Built-in help (/usr/bin/printf --help)
=C2=A0 =C2=A0 entirely fails to mention the option --.
=C2=A0 =C2=A0 This is even more surprising, as an error message explicitl=
y points=20
to the built-in help when that option is used without any additional=20
parameters:
$/usr/bin/printf --
printf: missing operand
Try '/usr/bin/printf --help' for more information.
(2)
man page=C2=A0 (commonly: /usr/share/man/man1/printf.1.gz)
=C2=A0 =C2=A0 is missing any mention (lest description) of the option --.
(3)
Online-Documentation=20
(https://www.gnu.org/software/coreutils/manual/html_node/printf-invocation=
.html#printf-invocation)
=C2=A0 =C2=A0 is missing any mention (lest description) of the option --.
=C2=A0 =C2=A0 Though at the end of that documentation page, it says:
=C2=A0 =C2=A0 =C2=A0 =C2=A0 "The only options are a lone --help or --vers=
ion. See Common=20
options=20
<https://www.gnu.org/software/coreutils/manual/html_node/Common-options.ht=
ml>.=20
Options must precede operands."
=C2=A0 =C2=A0 Now seeing that only three "Common options" do exist, it do=
es not=20
seem to make sense that the printf page explicitly mentions only two of=20
them=C2=A0 ( --help=C2=A0, --version=C2=A0=C2=A0) but not the third=C2=A0(=
-- ).
Obviously, these deficiencies exist in all languages/translations.
Regards,
Bernhard
--------------ZxX5BB2vTHX0H4LtWsepHuHu
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
<!DOCTYPE html>
<html>
<head>
<meta http-equiv=3D"content-type" content=3D"text/html; charset=3DUTF-=
8">
</head>
<body>
<p>Hello,</p>
<p>today I noticed the following deficiencies in implementation and
documentation of printf:=C2=A0</p>
<p>(1)<br>
Built-in help (<span style=3D"font-family:monospace"><span
style=3D"color:#000000;background-color:#ffffff;">/usr/bin/print=
f
--help</span></span>)</p>
<p>=C2=A0 =C2=A0 entirely fails to mention the option=C2=A0<span
style=3D"font-family:monospace"><span
style=3D"color:#000000;background-color:#ffffff;">--</span></spa=
n>.=C2=A0<br>
=C2=A0 =C2=A0 This is even more surprising, as an error message expl=
icitly
points to the built-in help when that option is used without any
additional parameters:</p>
<p><span style=3D"font-family:monospace"><span
style=3D"font-weight:bold;color:#54ff54;background-color:#ffffff;">$</span=
><span
style=3D"color:#000000;background-color:#ffffff;">
/usr/bin/printf --</span><span
style=3D"color:#000000;background-color:#ffffff;">
</span><br>
<span style=3D"color:#000000;background-color:#ffffff;">printf:
missing operand</span><span
style=3D"color:#000000;background-color:#ffffff;">
</span><br>
<span style=3D"color:#000000;background-color:#ffffff;">Try
'/usr/bin/printf --help' for more information.</span><br>
</span>
<br>
</p>
<p>(2)<br>
man page=C2=A0 (commonly:=C2=A0=C2=A0
<span style=3D"font-family:monospace"><span
style=3D"color:#000000;background-color:#ffffff;">/usr/share</sp=
an><span
style=3D"color:#000000;background-color:#ffffff;">/man/man1/prin=
tf.1.gz</span></span>)</p>
<p>=C2=A0 =C2=A0 is missing any mention (lest description) of the opti=
on=C2=A0=C2=A0<span
style=3D"font-family:monospace"><span
style=3D"color:#000000;background-color:#ffffff;">--</span></spa=
n>.</p>
<p><br>
</p>
<p>(3)<br>
Online-Documentation (<span style=3D"font-family:monospace"><span
style=3D"color:#000000;background-color:#ffffff;"><a class=3D"mo=
z-txt-link-freetext" href=3D"https://www.gnu.org/software/coreutils/manual=
/html_node/printf-invocation.html#printf-invocation">https://www.gnu.org/s=
oftware/coreutils/manual/html_node/printf-invocation.html#printf-invocatio=
n</a></span></span>)</p>
<p>=C2=A0 =C2=A0 is missing any mention (lest description) of the opti=
on=C2=A0=C2=A0<span
style=3D"font-family:monospace"><span
style=3D"color:#000000;background-color:#ffffff;">--</span></spa=
n>.</p>
<p>=C2=A0 =C2=A0 Though at the end of that documentation page, it says=
:</p>
<p>=C2=A0 =C2=A0 =C2=A0 =C2=A0 "The only options are a lone <samp clas=
s=3D"option">--help</samp>
or
<samp class=3D"option">--version</samp>. See <a class=3D"xref"
href=3D"https://www.gnu.org/software/coreutils/manual/html_node/Common-opt=
ions.html">Common
options</a>.
Options must precede operands."</p>
<p>=C2=A0 =C2=A0 Now seeing that only three "Common options" do exist,=
it does
not seem to make sense that the printf page explicitly mentions
only two of them=C2=A0 ( <samp class=3D"option">--help</samp>=C2=A0,=
=C2=A0<samp
class=3D"option">--version</samp>=C2=A0=C2=A0) but not the third=
=C2=A0( <samp
class=3D"option">--</samp> ).</p>
<p><br>
</p>
<p>Obviously, these deficiencies exist in all
languages/translations.</p>
<p>Regards,<br>
Bernhard</p>
</body>
</html>
--------------ZxX5BB2vTHX0H4LtWsepHuHu--
Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) Content-Type: text/plain; charset=utf-8 X-Loop: help-debbugs@HIDDEN From: help-debbugs@HIDDEN (GNU bug Tracking System) To: Bernhard Gabler <bernhard_gabler@HIDDEN> Subject: bug#79896: Acknowledgement ([coreutils] printf deficiencies) Message-ID: <handler.79896.B.176410298523413.ack <at> debbugs.gnu.org> References: <6c35ea05-8c81-404e-8a2a-d9bc4fdc1cda@HIDDEN> X-Gnu-PR-Message: ack 79896 X-Gnu-PR-Package: coreutils Reply-To: 79896 <at> debbugs.gnu.org Date: Tue, 25 Nov 2025 20:37:03 +0000 Thank you for filing a new bug report with debbugs.gnu.org. This is an automatically generated reply to let you know your message has been received. Your message is being forwarded to the package maintainers and other interested parties for their attention; they will reply in due course. Your message has been sent to the package maintainer(s): bug-coreutils@HIDDEN If you wish to submit further information on this problem, please send it to 79896 <at> debbugs.gnu.org. Please do not send mail to help-debbugs@HIDDEN unless you wish to report a problem with the Bug-tracking system. --=20 79896: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D79896 GNU Bug Tracking System Contact help-debbugs@HIDDEN with problems
X-Loop: help-debbugs@HIDDEN
Subject: bug#79896: [coreutils] printf deficiencies
Resent-From: Collin Funk <collin.funk1@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-coreutils@HIDDEN
Resent-Date: Tue, 25 Nov 2025 20:58:01 +0000
Resent-Message-ID: <handler.79896.B.17641042698386 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 79896
X-GNU-PR-Package: coreutils
X-GNU-PR-Keywords:
To: 79896 <at> debbugs.gnu.org
Cc: bernhard_gabler@HIDDEN
X-Debbugs-Original-To: Bernhard Gabler via GNU coreutils Bug Reports <bug-coreutils@HIDDEN>
X-Debbugs-Original-Cc: Bernhard Gabler <bernhard_gabler@HIDDEN>, 79896 <at> debbugs.gnu.org
Received: via spool by submit <at> debbugs.gnu.org id=B.17641042698386
(code B ref -1); Tue, 25 Nov 2025 20:58:01 +0000
Received: (at submit) by debbugs.gnu.org; 25 Nov 2025 20:57:49 +0000
Received: from localhost ([127.0.0.1]:43239 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1vO06f-0002BB-6j
for submit <at> debbugs.gnu.org; Tue, 25 Nov 2025 15:57:49 -0500
Received: from lists.gnu.org ([2001:470:142::17]:51340)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <collin.funk1@HIDDEN>)
id 1vO06d-0002Ag-6Q
for submit <at> debbugs.gnu.org; Tue, 25 Nov 2025 15:57:47 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10])
by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.90_1) (envelope-from <collin.funk1@HIDDEN>)
id 1vO06A-0001wG-OK
for bug-coreutils@HIDDEN; Tue, 25 Nov 2025 15:57:20 -0500
Received: from mail-pg1-x52b.google.com ([2607:f8b0:4864:20::52b])
by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
(Exim 4.90_1) (envelope-from <collin.funk1@HIDDEN>)
id 1vO064-0004M5-VD
for bug-coreutils@HIDDEN; Tue, 25 Nov 2025 15:57:14 -0500
Received: by mail-pg1-x52b.google.com with SMTP id
41be03b00d2f7-b98983bae8eso4475983a12.0
for <bug-coreutils@HIDDEN>; Tue, 25 Nov 2025 12:57:11 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20230601; t=1764104230; x=1764709030; darn=gnu.org;
h=content-transfer-encoding:mime-version:user-agent:message-id:date
:references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date
:message-id:reply-to;
bh=nJomyib9mK66ZvrhvfZTgVg+pmzpl/wviYIsg6QSqsY=;
b=FaYneP6AjCh0OnwmX4mhxohDH7WFmX/U6dR0vViarzNSMN2bM5m2OxwNuHud+GQjWo
w0ko6XEJ3KacAFj11lBgDlTAIWWlQsRP992KRxYBtqlJulXMgAUNyghfatv/vBctVRun
4hXHdxTNuNqpUsIW40HebZm2HzbcyRYzZEGPbdx+nG4jvrX10Jt86SgrMPJ0blnU1D7p
6U8fXBn9sgkem7foDEbmyyknBwLrosqDVt0Tx3ac2Ksn8tSGunye0f9oQ0mTb+ZbQQVJ
hVVbY3adupZO0zb6TFcm/SuJuC/tDmjbFgXXzWXMPsvSz4IvpJ0OjItZbpYzIa40wYxh
kzKQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1764104230; x=1764709030;
h=content-transfer-encoding:mime-version:user-agent:message-id:date
:references:in-reply-to:subject:cc:to:from:x-gm-gg
:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to;
bh=nJomyib9mK66ZvrhvfZTgVg+pmzpl/wviYIsg6QSqsY=;
b=S2RY9buY6As+of8y5LAVwEuVnuK+8DReqW2at4sV4zawXBuenWUFc/dA6iS0NuliiJ
jLVDHtotXDI8WTWe6fTeLfT6zr4RUZ9qEWaQRwGyFuC0wgau7lQWWBSD6KLkOJlyxUS5
VsMIhW0MkwrZFzanV7YooX3Pwyd6KPrSIuphgjkEstY/ZlvWZF1Nt8ogyou+D8MRU37m
LWkGhCuU1hf4Yh5t2kAFlH5ZN2pMKNu5F++DUR9/nUNu85c/6FViQUmc79Y2zfC+En6e
+aieE5XyI3sV3R2Yit3DnyxUWO9PsLBOvYEujEV8hM04sPyiR30i8Qv0/HOiOUYS3aUL
XuHg==
X-Gm-Message-State: AOJu0Yydp8xTlmJZjCAL/4kLFrteGS4490pJaSh08Su+vE0WudStDEEw
d3D/huY2XAVpzEligv1FUgq1FwfX4zqCdRBH8xq4qVufSjuRe2WpbQzw
X-Gm-Gg: ASbGncvzCRviqrJDn42X8nJr70pxvb/g4jAs9GPk7bqzVFeS3llI+MZuv/6UVvsWM8t
CPBZ0FSl5te9Q7eOpc8MKqVpsZh1b2hT3F54Weu9KaloEk7mgW6Y8WEmLPervlafr6XhdkxPwlg
yMdFGzvddfrLMkk2qzyZxVNmTjkAuRQEGyFJy2sW7AoQ3lfh0WjgchgyH8TJc9afaVMaFScY+ab
N6n8J+ObNaJ1gTAQyyYftsISezNj0CYVXbFiikXxtg3poGj5Ism/gMhebQLzKIzBzyudYpAnHGK
cDTDrJo34lTUQM98Gmbg2K5rpijcDL5kFZIrsA0pf/hZZ/zrRDCA+iTQ+m74M3TzEXdWSoKZngT
3iyA/emLfcTDKqyBJ5Vo+dkKLmO1QVJlyJTI+zWu6Giy71wEKG1oWAkUj073Sjdci0iBB7X93/X
Fw9yV3W+Y+9eyUaWap9AOGT4vFbyi6Nvw7OZyKGgyeL78z+z+mJsE=
X-Google-Smtp-Source: AGHT+IEtS5BjBoEYM3zcDWVn2GM5nyJG+lzRQ129lhzHnbkzNorcGZyMXfzemLptEogEPW58Q0upxg==
X-Received: by 2002:a05:7300:8a1d:b0:2a4:3592:cf5e with SMTP id
5a478bee46e88-2a9415824d7mr2650371eec.2.1764104230370;
Tue, 25 Nov 2025 12:57:10 -0800 (PST)
Received: from fedora (c-73-93-224-2.hsd1.ca.comcast.net. [73.93.224.2])
by smtp.gmail.com with ESMTPSA id
5a478bee46e88-2a6fc3d0bb6sm93045551eec.2.2025.11.25.12.57.09
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Tue, 25 Nov 2025 12:57:10 -0800 (PST)
From: Collin Funk <collin.funk1@HIDDEN>
In-Reply-To: <6c35ea05-8c81-404e-8a2a-d9bc4fdc1cda@HIDDEN>
References: <6c35ea05-8c81-404e-8a2a-d9bc4fdc1cda@HIDDEN>
Date: Tue, 25 Nov 2025 12:57:08 -0800
Message-ID: <87see1n84b.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Received-SPF: pass client-ip=2607:f8b0:4864:20::52b;
envelope-from=collin.funk1@HIDDEN; helo=mail-pg1-x52b.google.com
X-Spam_score_int: -17
X-Spam_score: -1.8
X-Spam_bar: -
X-Spam_report: (-1.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001,
RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,
SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 1.2 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
has NOT identified this incoming email as spam. The original
message has been attached to this so you can view it or label
similar future email. If you have any questions, see
the administrator of that system for details.
Content preview: Hi Bernhard, Bernhard Gabler via GNU coreutils Bug Reports
writes: > Hello, > > today I noticed the following deficiencies in implementation
and > documentation of printf: > > (1) > Built-in help (/usr/bin/printf --help)
> > =?UTF-8?Q?=C2=A0_?= =?UTF-8?Q?=C2=A0?= entirely fails to mention the option [...]
Content analysis details: (1.2 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
1.0 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail)
0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail
provider (collin.funk1[at]gmail.com)
-0.0 SPF_HELO_PASS SPF: HELO matches SPF record
0.2 FREEMAIL_ENVFROM_END_DIGIT Envelope-from freemail username ends
in digit (collin.funk1[at]gmail.com)
-0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/,
no trust
[2001:470:142:0:0:0:0:17 listed in]
[list.dnswl.org]
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.2 (/)
Hi Bernhard,
Bernhard Gabler via GNU coreutils Bug Reports <bug-coreutils@HIDDEN>
writes:
> Hello,
>
> today I noticed the following deficiencies in implementation and
> documentation of printf:
>
> (1)
> Built-in help (/usr/bin/printf --help)
>
> =C2=A0 =C2=A0 entirely fails to mention the option --.
> =C2=A0 =C2=A0 This is even more surprising, as an error message explicitly
> points to the built-in help when that option is used without any
> additional parameters:
>
> $/usr/bin/printf --
> printf: missing operand
> Try '/usr/bin/printf --help' for more information.
>
> (2)
> man page=C2=A0 (commonly: /usr/share/man/man1/printf.1.gz)
>
> =C2=A0 =C2=A0 is missing any mention (lest description) of the option --.
>
>
> (3)
> Online-Documentation
> (https://www.gnu.org/software/coreutils/manual/html_node/printf-invocatio=
n.html#printf-invocation)
>
> =C2=A0 =C2=A0 is missing any mention (lest description) of the option --.
>
> =C2=A0 =C2=A0 Though at the end of that documentation page, it says:
>
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 "The only options are a lone --help or --vers=
ion. See Common
> options
> <https://www.gnu.org/software/coreutils/manual/html_node/Common-options.h=
tml>.
> Options must precede operands."
>
> =C2=A0 =C2=A0 Now seeing that only three "Common options" do exist, it do=
es not
> seem to make sense that the printf page explicitly mentions only two
> of them=C2=A0 ( --help=C2=A0, --version=C2=A0=C2=A0) but not the third=C2=
=A0( -- ).
>
>
> Obviously, these deficiencies exist in all languages/translations.
This is a POSIX requirement for programs. Copying their words here [1]:
Guideline 10:
The first -- argument that is not an option-argument should be
accepted as a delimiter indicating the end of options. Any
following arguments should be treated as operands, even if they
begin with the '-' character.
A common use of this is to delete file names that start with the "-"
character. We have an example like this in the manual under the 'rm'
command:
$ ls -- -f
-f
$ rm -f
$ ls -- -f
-f
$ rm -- -f
$ ls -- -f
ls: cannot access '-f': No such file or directory
Collin
[1] https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap12.htm=
l#tag_12_02
X-Loop: help-debbugs@HIDDEN
Subject: bug#79896: [coreutils] printf deficiencies
Resent-From: Collin Funk <collin.funk1@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-coreutils@HIDDEN
Resent-Date: Tue, 25 Nov 2025 20:58:02 +0000
Resent-Message-ID: <handler.79896.B79896.17641042398333 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 79896
X-GNU-PR-Package: coreutils
X-GNU-PR-Keywords:
To: 79896 <at> debbugs.gnu.org
Cc: bernhard_gabler@HIDDEN
X-Debbugs-Original-To: Bernhard Gabler via GNU coreutils Bug Reports <bug-coreutils@HIDDEN>
X-Debbugs-Original-Cc: Bernhard Gabler <bernhard_gabler@HIDDEN>, 79896 <at> debbugs.gnu.org
Received: via spool by 79896-submit <at> debbugs.gnu.org id=B79896.17641042398333
(code B ref 79896); Tue, 25 Nov 2025 20:58:02 +0000
Received: (at 79896) by debbugs.gnu.org; 25 Nov 2025 20:57:19 +0000
Received: from localhost ([127.0.0.1]:43236 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1vO06A-0002AL-Lw
for submit <at> debbugs.gnu.org; Tue, 25 Nov 2025 15:57:19 -0500
Received: from mail-pg1-x534.google.com ([2607:f8b0:4864:20::534]:59609)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
(Exim 4.84_2) (envelope-from <collin.funk1@HIDDEN>)
id 1vO068-0002A4-Ps
for 79896 <at> debbugs.gnu.org; Tue, 25 Nov 2025 15:57:17 -0500
Received: by mail-pg1-x534.google.com with SMTP id
41be03b00d2f7-bde0f62468cso1076585a12.2
for <79896 <at> debbugs.gnu.org>; Tue, 25 Nov 2025 12:57:16 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20230601; t=1764104230; x=1764709030; darn=debbugs.gnu.org;
h=content-transfer-encoding:mime-version:user-agent:message-id:date
:references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date
:message-id:reply-to;
bh=nJomyib9mK66ZvrhvfZTgVg+pmzpl/wviYIsg6QSqsY=;
b=MNm5UdjpqM1mlg8ExOLlR0YLqY5oBokyiR7eNVtKiTgXjWJt3382IuNOgiYMVynChm
4q7NWb0uJUVYYs4HfCYTrJrSoqjuJOT582TbMkpxPEcDWC69nw0fMy6NVtOPpk6T5UWi
A0HY3jl3BVxUc+rJMKhgBZUyfbDbl1tXiVLhdJlUm9e7f5TfKENuXCurAU5s7gq/gLNZ
vlHbIUq3VdaaoxBWlwnJ4qTQ+OMiYkj8s5qlFc/979lzZ4XcA6sTppWQgK4l48QUCpYc
R7Ye5pxq+7k5BtoM8LwRgaqGybMnUfLm2LP8fs9KuXOpU2IDcN0aGfsj/77HBIPjvUtQ
gnNg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1764104230; x=1764709030;
h=content-transfer-encoding:mime-version:user-agent:message-id:date
:references:in-reply-to:subject:cc:to:from:x-gm-gg
:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to;
bh=nJomyib9mK66ZvrhvfZTgVg+pmzpl/wviYIsg6QSqsY=;
b=F+fBmt1E4ut14X2kEY5JcifVBK/2WxwUOQBeATTPZLXQCgkJWJMxnvXnZvYK+xMe5+
cT+tYmmIFZ1lswEvtriQ2xzYHeB+aIrsc6Dn7U9Gv9fxymyW1by1zACLq9HJeGLN1Ykq
V1IWh7XnxaJx2/CpMBQJDg7AVEVFbrzX7JPxLEj8Y6DZA46UGRSooiTyJ6jgioq4vTgk
xJxt5IKbPOtO8MqkKjaLr6JOlvw5tl8z1st1ctNgibFhmf3/ye4WaO2Ech47eJhiSaQn
8O6B28C8HA9EVmyvCUR341BDlSNlBMZenkm0rTvfkG6tGh+MT3QWQ5WBKx5P6ByuV45a
eMlg==
X-Gm-Message-State: AOJu0YwQH0glOUG9rtuq5BTWHygwW0kLSlRHWwSqp8FnIEngEBvOaSRQ
n4awBkz6ApZxeRXOjAtPW9X/o8c95ZPU/OFQCLimJZEGrwZFcLqXMD7X
X-Gm-Gg: ASbGnctmHtjPuQRmUaxsy5hM+gk8w4H9AYWZMwBGmhxw950TuHDQs9f0pMHYBsPS7oI
fJnwYZjnvwHTlAhd/ApdKaZEJIcTAq8EDaMgzSqexr/YJH7uWSbcz+vh6IFuevp0QIg+rO35GJS
DKHUvLlORnGIII+/FymGNx5rFkISVX/zF9lbTIb+M6rvOxTDXhvlzfdgaNEj8y1cb83VilzX38A
0j4+ccMsRa2AWhZ9CC/Byn8ITLcLe4P81qCnhvShbIjnuKCplB7YxinT3h6vk6/0V8Ta/OPnklO
dTQ59ii7IBkp3ZrMWVLnrHERfW9HHWQUbwYEe0gkJxK8m+m537GRolsfaocWLaz6bKVYiscBqQw
OIAfc4TP7E6+qZrLrSOR1ibVqaIrJ6hicGJANWSbAL/b2Gbm7fGy/l5GYN+wO9wH9YBMomepARc
83YvCzWQVt19Rff7U9tJV88XjuoVY7W+yQBm4YgHj+E3epzgQp+74=
X-Google-Smtp-Source: AGHT+IEtS5BjBoEYM3zcDWVn2GM5nyJG+lzRQ129lhzHnbkzNorcGZyMXfzemLptEogEPW58Q0upxg==
X-Received: by 2002:a05:7300:8a1d:b0:2a4:3592:cf5e with SMTP id
5a478bee46e88-2a9415824d7mr2650371eec.2.1764104230370;
Tue, 25 Nov 2025 12:57:10 -0800 (PST)
Received: from fedora (c-73-93-224-2.hsd1.ca.comcast.net. [73.93.224.2])
by smtp.gmail.com with ESMTPSA id
5a478bee46e88-2a6fc3d0bb6sm93045551eec.2.2025.11.25.12.57.09
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Tue, 25 Nov 2025 12:57:10 -0800 (PST)
From: Collin Funk <collin.funk1@HIDDEN>
In-Reply-To: <6c35ea05-8c81-404e-8a2a-d9bc4fdc1cda@HIDDEN>
References: <6c35ea05-8c81-404e-8a2a-d9bc4fdc1cda@HIDDEN>
Date: Tue, 25 Nov 2025 12:57:08 -0800
Message-ID: <87see1n84b.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.3 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.7 (/)
Hi Bernhard,
Bernhard Gabler via GNU coreutils Bug Reports <bug-coreutils@HIDDEN>
writes:
> Hello,
>
> today I noticed the following deficiencies in implementation and
> documentation of printf:
>
> (1)
> Built-in help (/usr/bin/printf --help)
>
> =C2=A0 =C2=A0 entirely fails to mention the option --.
> =C2=A0 =C2=A0 This is even more surprising, as an error message explicitly
> points to the built-in help when that option is used without any
> additional parameters:
>
> $/usr/bin/printf --
> printf: missing operand
> Try '/usr/bin/printf --help' for more information.
>
> (2)
> man page=C2=A0 (commonly: /usr/share/man/man1/printf.1.gz)
>
> =C2=A0 =C2=A0 is missing any mention (lest description) of the option --.
>
>
> (3)
> Online-Documentation
> (https://www.gnu.org/software/coreutils/manual/html_node/printf-invocatio=
n.html#printf-invocation)
>
> =C2=A0 =C2=A0 is missing any mention (lest description) of the option --.
>
> =C2=A0 =C2=A0 Though at the end of that documentation page, it says:
>
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 "The only options are a lone --help or --vers=
ion. See Common
> options
> <https://www.gnu.org/software/coreutils/manual/html_node/Common-options.h=
tml>.
> Options must precede operands."
>
> =C2=A0 =C2=A0 Now seeing that only three "Common options" do exist, it do=
es not
> seem to make sense that the printf page explicitly mentions only two
> of them=C2=A0 ( --help=C2=A0, --version=C2=A0=C2=A0) but not the third=C2=
=A0( -- ).
>
>
> Obviously, these deficiencies exist in all languages/translations.
This is a POSIX requirement for programs. Copying their words here [1]:
Guideline 10:
The first -- argument that is not an option-argument should be
accepted as a delimiter indicating the end of options. Any
following arguments should be treated as operands, even if they
begin with the '-' character.
A common use of this is to delete file names that start with the "-"
character. We have an example like this in the manual under the 'rm'
command:
$ ls -- -f
-f
$ rm -f
$ ls -- -f
-f
$ rm -- -f
$ ls -- -f
ls: cannot access '-f': No such file or directory
Collin
[1] https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap12.htm=
l#tag_12_02
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.