GNU logs - #43282, boring messages

Message sent to bug-coreutils@HIDDEN:

Subject: bug#43282: tail -c +N / --bytes +N manpage wrong (off by 1)
Resent-From: "Martin Taibr" <Taibr@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-coreutils@HIDDEN
Resent-Date: Tue, 08 Sep 2020 15:55:03 +0000
Resent-Message-ID: <handler.43282.B.159958049316447 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 43282 <at> debbugs.gnu.org
From: "Martin Taibr" <Taibr@HIDDEN>
Date: Tue, 08 Sep 2020 17:50:50 +0200 (CEST)
Message-Id: <T9.tuNS.2WK8x07EZ5e.1VLwXQ@HIDDEN>
Mime-Version: 1.0 (szn-mime-2.1.6)
Content-Type: multipart/alternative;
 boundary="=_6c0a86266f79d79475ff734e=3d2284d5-62f0-5727-a332-bad047134a30_="
Received-SPF: pass client-ip=2a02:598:a::78:89; envelope-from=Taibr@HIDDEN;
 helo=mxb1.seznam.cz
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, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.4 (/)
X-Mailman-Approved-At: Tue, 08 Sep 2020 11:54:48 -0400
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: -2.6 (--)

--=_6c0a86266f79d79475ff734e=3d2284d5-62f0-5727-a332-bad047134a30_=
Content-Type: text/plain;
	charset=utf-8
Content-Transfer-Encoding: quoted-printable


Currently the manpage says:





-c, --bytes=3D[+]NUM

=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=
=C2=A0 output the last NUM bytes; or use -c +NUM to output starting 
with byte NUM of each file




Most (all?) hex editors number bytes from 0 so it's natural to assume tail=
 -
c +0 will print the entire file, tail -c +1 will cut off the first byte an=
d 
so on. That's not the case, tail seems to "index" bytes from 1, not 0, so =
+0
and +1 both print the entire file.




I'd suggest

1) the manpage should mention counting starts from 1 (so you need to add 1=
 
when copy pasting offsets from most other programs)


2) +0 should print a warning since its usage indicates the user likely 
thinks tail counts from 0

3) -n / --lines docs should be changed to match (though counting lines fro=
m 
1 is more common)

--=_6c0a86266f79d79475ff734e=3d2284d5-62f0-5727-a332-bad047134a30_=
Content-Type: text/html;
	charset=utf-8
Content-Transfer-Encoding: quoted-printable

<html><body><div>Currently the manpage says:<br></div><div><br></div><div>=
-c, --bytes=3D[+]NUM</div><div>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&=
nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; output the last NUM bytes; or use -c +=
NUM to output starting with byte NUM of each file</div><div><br></div><div=
>Most (all?) hex editors number bytes from 0 so it's natural to assume tai=
l -c +0 will print the entire file, tail -c +1 will cut off the first byte=
 and so on. That's not the case, tail seems to "index" bytes from 1, not 0=
, so +0 and +1 both print the entire file.</div><div><br></div><div>I'd su=
ggest</div><div>1) the manpage should mention counting starts from 1 (so y=
ou need to add 1 when copy pasting offsets from most other programs)<br></=
div><div>2) +0 should print a warning since its usage indicates the user l=
ikely thinks tail counts from 0</div><div>3) -n / --lines docs should be c=
hanged to match (though counting lines from 1 is more common)<br></div></b=
ody></html>
--=_6c0a86266f79d79475ff734e=3d2284d5-62f0-5727-a332-bad047134a30_=--

Message sent:

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: "Martin Taibr" <Taibr@HIDDEN>
Subject: bug#43282: Acknowledgement (tail -c +N / --bytes +N manpage wrong
 (off by 1))
Message-ID: <handler.43282.B.159958049316447.ack <at> debbugs.gnu.org>
References: <T9.tuNS.2WK8x07EZ5e.1VLwXQ@HIDDEN>
X-Gnu-PR-Message: ack 43282
X-Gnu-PR-Package: coreutils
Reply-To: 43282 <at> debbugs.gnu.org
Date: Tue, 08 Sep 2020 15:55: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 43282 <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
43282: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D43282
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Last modified: Tue, 8 Sep 2020 16:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.