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::. > > > > 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 > > >> 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/>
Attachment:
signature.asc
Description: PGP signature
