some man pages have bugs, can't be grep'd

[Chris Murphy]

I've been seeing this since clean installing Fedora 30. I don't recall
ever seeing it before, including on a Fedora 29 -> Fedora 30 upgraded
system (is now the clean installed system).

[chris@flap ~]$ man rpm | grep -C 10 rpmverbosity
<standard input>:176: warning [p 3, 0.8i]: cannot adjust line
[chris@flap mantest]$ man rpm >rpm.stdout 2>rpm.stderr
[chris@flap mantest]$ ll
-rw-rw-r--. 1 chris chris    62 Jul 16 14:24 rpm.stderr
-rw-rw-r--. 1 chris chris 28498 Jul 16 14:24 rpm.stdout

Is this a bug that should be reported against rpm or something else?
I'm certain I've seen it in other man pages, but offhand I can't find
another example.

-- 
Chris Murphy

[Tom Hughes]

On 16/07/2019 21:30, Chris Murphy wrote:
>  I've been seeing this since clean installing Fedora 30. I
> don't recall
>  ever seeing it before, including on a Fedora 29 -> Fedora 30 upgraded
>  system (is now the clean installed system).
>  
>  [chris@flap ~]$ man rpm | grep -C 10 rpmverbosity
>  <standard input>:176: warning [p 3, 0.8i]: cannot adjust line
>  [chris@flap mantest]$ man rpm >rpm.stdout 2>rpm.stderr
>  [chris@flap mantest]$ ll
>  -rw-rw-r--. 1 chris chris    62 Jul 16 14:24 rpm.stderr
>  -rw-rw-r--. 1 chris chris 28498 Jul 16 14:24 rpm.stdout
>  
>  Is this a bug that should be reported against rpm or something else?
>  I'm certain I've seen it in other man pages, but offhand I can't find
>  another example. 
The grep seems to work to me - you get that warning but
the grep does work - that text doesn't exist but if you grep
something that does exist then it seems fine.

Tom

-- 
Tom Hughes (tom(a)compton.nu)
http://compton.nu/

[Chris Murphy]

On Tue, Jul 16, 2019 at 2:38 PM Tom Hughes <tom(a)compton.nu&gt; wrote:
>  On 16/07/2019 21:30, Chris Murphy wrote:
>  > I've been seeing this since clean installing Fedora 30. I don't recall
>  > ever seeing it before, including on a Fedora 29 -> Fedora 30 upgraded
>  > system (is now the clean installed system).
>  >
>  > [chris@flap ~]$ man rpm | grep -C 10 rpmverbosity
>  > <standard input>:176: warning [p 3, 0.8i]: cannot adjust line
>  > [chris@flap mantest]$ man rpm >rpm.stdout 2>rpm.stderr
>  > [chris@flap mantest]$ ll
>  > -rw-rw-r--. 1 chris chris    62 Jul 16 14:24 rpm.stderr
>  > -rw-rw-r--. 1 chris chris 28498 Jul 16 14:24 rpm.stdout
>  >
>  > Is this a bug that should be reported against rpm or something else?
>  > I'm certain I've seen it in other man pages, but offhand I can't find
>  > another example.
>
>  The grep seems to work to me - you get that warning but
>  the grep does work - that text doesn't exist but if you grep
>  something that does exist then it seems fine. 
So it is. That's even more unexpected.


-- 
Chris Murphy

[Nico Kadel-Garcia]

On Tue, Jul 16, 2019 at 5:13 PM Chris Murphy <lists(a)colorremedies.com&gt; wrote:
>  I've been seeing this since clean installing Fedora 30. I don't recall
>  ever seeing it before, including on a Fedora 29 -> Fedora 30 upgraded
>  system (is now the clean installed system).
>
>  [chris@flap ~]$ man rpm | grep -C 10 rpmverbosity
>  <standard input>:176: warning [p 3, 0.8i]: cannot adjust line
>  [chris@flap mantest]$ man rpm >rpm.stdout 2>rpm.stderr
>  [chris@flap mantest]$ ll
>  -rw-rw-r--. 1 chris chris    62 Jul 16 14:24 rpm.stderr
>  -rw-rw-r--. 1 chris chris 28498 Jul 16 14:24 rpm.stdout
>
>  Is this a bug that should be reported against rpm or something else?
>  I'm certain I've seen it in other man pages, but offhand I can't find
>  another example. 
The man output has formatting commands. Use "man -t rpm | grep -C 10
rpmverbosity" verbosity to avoid feeding those formatting characters
to the grep command.

[Tim Landscheidt]

Chris Murphy <lists(a)colorremedies.com&gt; wrote:

>  I've been seeing this since clean installing Fedora 30. I
> don't recall
>  ever seeing it before, including on a Fedora 29 -> Fedora 30 upgraded
>  system (is now the clean installed system). 
>  [chris@flap ~]$ man rpm | grep -C 10 rpmverbosity
>  <standard input>:176: warning [p 3, 0.8i]: cannot adjust line
>  [chris@flap mantest]$ man rpm >rpm.stdout 2>rpm.stderr
>  [chris@flap mantest]$ ll
>  -rw-rw-r--. 1 chris chris    62 Jul 16 14:24 rpm.stderr
>  -rw-rw-r--. 1 chris chris 28498 Jul 16 14:24 rpm.stdout 
>  Is this a bug that should be reported against rpm or something else?
>  I'm certain I've seen it in other man pages, but offhand I can't find
>  another example. 
(This also happens on Fedora 29, JFTR.)  The warning seems
to stem from this line in rpm.8:

| […]
|     175 The default \fIFILELIST\fR is
|     176
\fI/usr/\:lib/\:rpm/\:macros\fR:\:\fI/usr/\:lib/\:rpm/\:macros.d/\:macros.*\fR:\:\fI/usr/\:lib/\:rpm/\:platform/\:%{_target}/\:macros\fR:\:\fI/usr/\:lib/\:rpm/\
|     176
:fileattrs/\:*.attr\fR:\:\fI/usr/\:lib/\:rpm/\:redhat/\:macros\fR:\:\fI/etc/\:rpm/\:macros.*\fR:\:\fI/etc/\:rpm/\:macros\fR:\:\fI/etc/\:rpm/\:%{_target}/\:macro
|     176 s\fR:\:\fI~/.rpmmacros
|     177
| […]

This line is too long for the standard layout.  It already
has hints ("\:"; zero-width break points) where it should be
broken, but these seem to be ignored.  So prima facie RPM
has done everything right, and there is an error somewhere
in the groff/man ecosphere.

Tim

[Chris Murphy]

On Tue, Jul 16, 2019 at 8:12 PM Tim Landscheidt <tim(a)tim-landscheidt.de&gt; wrote:
>  Chris Murphy <lists(a)colorremedies.com&gt; wrote:
>
>  > I've been seeing this since clean installing Fedora 30. I don't recall
>  > ever seeing it before, including on a Fedora 29 -> Fedora 30 upgraded
>  > system (is now the clean installed system).
>
>  > [chris@flap ~]$ man rpm | grep -C 10 rpmverbosity
>  > <standard input>:176: warning [p 3, 0.8i]: cannot adjust line
>  > [chris@flap mantest]$ man rpm >rpm.stdout 2>rpm.stderr
>  > [chris@flap mantest]$ ll
>  > -rw-rw-r--. 1 chris chris    62 Jul 16 14:24 rpm.stderr
>  > -rw-rw-r--. 1 chris chris 28498 Jul 16 14:24 rpm.stdout
>
>  > Is this a bug that should be reported against rpm or something else?
>  > I'm certain I've seen it in other man pages, but offhand I can't find
>  > another example.
>
>  (This also happens on Fedora 29, JFTR.)  The warning seems
>  to stem from this line in rpm.8:
>
>  | […]
>  |     175 The default \fIFILELIST\fR is
>  |     176
> \fI/usr/\:lib/\:rpm/\:macros\fR:\:\fI/usr/\:lib/\:rpm/\:macros.d/\:macros.*\fR:\:\fI/usr/\:lib/\:rpm/\:platform/\:%{_target}/\:macros\fR:\:\fI/usr/\:lib/\:rpm/\
>  |     176
> :fileattrs/\:*.attr\fR:\:\fI/usr/\:lib/\:rpm/\:redhat/\:macros\fR:\:\fI/etc/\:rpm/\:macros.*\fR:\:\fI/etc/\:rpm/\:macros\fR:\:\fI/etc/\:rpm/\:%{_target}/\:macro
>  |     176 s\fR:\:\fI~/.rpmmacros
>  |     177
>  | […]
>
>  This line is too long for the standard layout.  It already
>  has hints ("\:"; zero-width break points) where it should be
>  broken, but these seem to be ignored.  So prima facie RPM
>  has done everything right, and there is an error somewhere
>  in the groff/man ecosphere. 

OK I filed this
https://bugzilla.redhat.com/show_bug.cgi?id=1730532

Obvious work around is to not search for things that don't exist!


-- 
Chris Murphy

[Tim Landscheidt]

I wrote a very long time ago:

> > I've been seeing this since clean installing Fedora 30. I
> don't recall
> > ever seeing it before, including on a Fedora 29 -> Fedora 30 upgraded
> > system (is now the clean installed system). 
> > [chris@flap ~]$ man rpm | grep -C 10 rpmverbosity
> > <standard input>:176: warning [p 3, 0.8i]: cannot adjust line
> > [chris@flap mantest]$ man rpm >rpm.stdout 2>rpm.stderr
> > [chris@flap mantest]$ ll
> > -rw-rw-r--. 1 chris chris    62 Jul 16 14:24 rpm.stderr
> > -rw-rw-r--. 1 chris chris 28498 Jul 16 14:24 rpm.stdout 
> > Is this a bug that should be reported against rpm or something
> else?
> > I'm certain I've seen it in other man pages, but offhand I can't find
> > another example. 
>  (This also happens on Fedora 29, JFTR.)  The warning seems
>  to stem from this line in rpm.8: 
>  | […]
>  |     175 The default \fIFILELIST\fR is
>  |     176
> \fI/usr/\:lib/\:rpm/\:macros\fR:\:\fI/usr/\:lib/\:rpm/\:macros.d/\:macros.*\fR:\:\fI/usr/\:lib/\:rpm/\:platform/\:%{_target}/\:macros\fR:\:\fI/usr/\:lib/\:rpm/\
>  |     176
> :fileattrs/\:*.attr\fR:\:\fI/usr/\:lib/\:rpm/\:redhat/\:macros\fR:\:\fI/etc/\:rpm/\:macros.*\fR:\:\fI/etc/\:rpm/\:macros\fR:\:\fI/etc/\:rpm/\:%{_target}/\:macro
>  |     176 s\fR:\:\fI~/.rpmmacros
>  |     177
>  | […] 
>  This line is too long for the standard layout.  It already
>  has hints ("\:"; zero-width break points) where it should be
>  broken, but these seem to be ignored.  So prima facie RPM
>  has done everything right, and there is an error somewhere
>  in the groff/man ecosphere. 
That analysis was wrong: "cannot adjust line" does not mean
that the line is too long, but rather that there are no spa-
ces that groff can expand to adjust (justify) the line.

For rpm(8) this was worked around by formatting the default
value as a code block, with line breaks after each colon,
thus not requiring the lines to be adjusted/justified.

Tim