GNU bug report logs - #46808
Man page of "tail"

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Paul Eggert <eggert <at> cs.ucla.edu>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#46808: closed (Man page of "tail")
Date: Wed, 23 Feb 2022 22:37:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Wed, 23 Feb 2022 14:36:34 -0800
with message-id <8dacd258-78ba-56b0-68df-bee93b253843 <at> cs.ucla.edu>
and subject line Re: bug#46808: Man page of "tail"
has caused the debbugs.gnu.org bug report #46808,
regarding Man page of "tail"
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
46808: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=46808
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Reuti <reuti <at> staff.uni-marburg.de>
To: bug-coreutils <at> gnu.org
Subject: Man page of "tail"
Date: Sat, 27 Feb 2021 08:32:22 +0100

Hi,

I noticed some formatting issues in the man page of `tail`, and I wonder whether they are intentional as they occur at some places. They happen up to version 8.32:

line: "-c, --bytes=[+]NUM" the "[" is in italic: \fB\-c\fR, \fB\-\-bytes\fR=\fI\,[\/\fR+]NUM
line: "-f, --follow[={name|descriptor}]" the "[=" is in bold: \fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}]
line: "-n, --lines=[+]NUM" the "[" is "[" is in italic: \fB\-n\fR, \fB\-\-lines\fR=\fI\,[\/\fR+]NUM

I'm not a `groff` expert, but the sequence "\,some-text\/" appears a couple of times. What effect does it have for the formatting as the "," and "/" are not output?

-- Reuti

[Message part 3 (message/rfc822, inline)]

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: Reuti <reuti <at> staff.uni-marburg.de>
Cc: 46808-done <at> debbugs.gnu.org, bug-help2man <at> gnu.org
Subject: Re: bug#46808: Man page of "tail"
Date: Wed, 23 Feb 2022 14:36:34 -0800

On 2/26/21 23:32, Reuti wrote:

> I noticed some formatting issues in the man page of `tail`, and I wonder whether they are intentional as they occur at some places. They happen up to version 8.32:
> 
> line: "-c, --bytes=[+]NUM" the "[" is in italic: \fB\-c\fR, \fB\-\-bytes\fR=\fI\,[\/\fR+]NUM
> line: "-f, --follow[={name|descriptor}]" the "[=" is in bold: \fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}]
> line: "-n, --lines=[+]NUM" the "[" is "[" is in italic: \fB\-n\fR, \fB\-\-lines\fR=\fI\,[\/\fR+]NUM
> 
> I'm not a `groff` expert, but the sequence "\,some-text\/" appears a couple of times. What effect does it have for the formatting as the "," and "/" are not output?

Thanks for the bug report. Those lines are automatically generated by 
help2man, so I'm cc'ing this to bug-help2man <at> gnu.org and will close the 
coreutils bug report.

The problem is that "tail --help" outputs this:

  -c, --bytes=[+]NUM       output the last NUM bytes; or use -c +NUM to
                             output starting with byte NUM of each file
  -f, --follow[={name|descriptor}]
                           output appended data as the file grows;
                             an absent option argument means 'descriptor'
  -F                       same as --follow=name --retry
  -n, --lines=[+]NUM       output the last NUM lines, instead of the 
last 10;
                             or use -n +NUM to output starting with 
line NUM


and help2man transforms that into:

.TP
\fB\-c\fR, \fB\-\-bytes\fR=\fI\,[\/\fR+]NUM
output the last NUM bytes; or use \fB\-c\fR +NUM to
output starting with byte NUM of each file
.TP
\fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}]
output appended data as the file grows;
.IP
an absent option argument means 'descriptor'
.TP
\fB\-F\fR
same as \fB\-\-follow\fR=\fI\,name\/\fR \fB\-\-retry\fR
.TP
\fB\-n\fR, \fB\-\-lines\fR=\fI\,[\/\fR+]NUM
output the last NUM lines, instead of the last 10;
or use \fB\-n\fR +NUM to output starting with line NUM

Previous Next

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