bug#46808: closed (Man page of "tail")

[GNU bug Tracking System]

Your message dated Wed, 23 Feb 2022 14:36:34 -0800
with message-id <8dacd258-78ba-56b0-68df-bee93b253843@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@gnu.org.)


-- 
46808: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=46808
GNU Bug Tracking System
Contact help-debbugs@gnu.org with problems
> --- Begin Message ---
>
>
>
> 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
>
>
> --- End Message ---
> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: bug#46808: Man page of "tail"
>
>
>
>
> Date: 
>
> Wed, 23 Feb 2022 14:36:34 -0800
>
>
>
>
> User-agent: 
>
> Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.5.0
>
>
>
>
> 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@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
>
>
> --- End Message ---