On Tue, Jun 11, 2024 at 07:39:50AM GMT, G. Branden Robinson wrote:

Hi Alex,

Hi Branden,

groff 1.22.4 did have, by my count, over 400 bugs in it that groff
1.23.0 fixed.[1]  However this is not one of them.  groff 1.23.0 still
complains.

Hummm.

Let us recall what "adjustment" is in typography.

5.1.5 Adjustment
----------------

After GNU 'troff' performs an automatic break, it may then "adjust" the
line, widening inter-word spaces until the text reaches the right
margin.  Extra spaces between words are preserved.  Leading and trailing
spaces are handled as noted above.  Text can be aligned to the left or
right margin only, or centered; see *note Manipulating Filling and
Adjustment::.

quoted

quoted

troff: .tmp/man/man2/s390_sthyi.2:124: warning [p 2, 2.8i]: cannot adjust line

What is at line 124 of this document?

$ cat -n ./man2/s390_sthyi.2 | sed -n '120,125p'
   120  .SH NOTES
   121  For details of the STHYI instruction, see
   122  .UR https://www.ibm.com\:/support\:/knowledgecenter\:/SSB27U_6.3.0\:/com.ibm.zvm.v630.hcpb4\:/hcpb4sth.htm
   123  the documentation page
   124  .UE .
   125  .P

quoted

quoted

cannot adjust line

This is a legitimate diagnostic arising from a ridiculously long URL
colliding with the formatter's frustrated attempt to adjust the output
line.  Here's how that renders.

NOTES
       For  details  of  the  STHYI  instruction,  see  the documentation page
       ⟨https://www.ibm.com/support/knowledgecenter/SSB27U_6.3.0
       /com.ibm.zvm.v630.hcpb4/hcpb4sth.htm⟩.

I see:

NOTES
     For details of the STHYI instruction, see the documentation page.

In xfce4-terminal(1), that's an underdotted hyperlink.  In xterm(1), I
see the same, but it's not underdotted, and seems not clickable.

Why am I unable to see the explicit URI?  That seems the reason why
I can't reproduce the warning.

Not much the formatter can do about this monstrosity.  People with
crazily wide terminal windows, or with adjustment of man pages disabled
(a groff 1.23.0 feature)[2] won't experience the warning.

You _could_ make it less obnoxious in the source document with input
line continuation.

.UR https://www.ibm.com\:/support\:/knowledgecenter\:/SSB27U_6.3.0\:/\
com.ibm.zvm.v630.hcpb4\:/hcpb4sth.htm

I don't like breaking URIs.  I'll accept the warning and add it as an
XFAIL.  However, I'd like to be able to reproduce it.  :|

Have a lovely day!
Alex

-- 
<https://www.alejandro-colomar.es/>