Hi Alex, At 2024-06-11T00:21:59+0200, Alejandro Colomar wrote: > > troff: .tmp/man/man2/s390_sthyi.2:124: warning [p 2, 2.8i]: cannot adjust line > > make: *** [/home/jdamato/code/man-pages/share/mk/build/catman/troff.mk:63: .tmp/man/man2/s390_sthyi.2.cat.set] Error 1 > > Hmmm; can't reproduce it. My only difference (AFAICS) is I have > groff-1.23.0, while you'll have groff-1.22.4. 1.22.4 has many many > bugs, so I guess this is one of them. You can skip this specific > error with > > touch .tmp/man/man2/s390_sthyi.2.cat.set; 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. 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⟩. 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 Regards, Branden [1] https://lists.gnu.org/archive/html/groff/2023-07/msg00051.html [2] NEWS: o The an (man) and doc (mdoc) macro packages support a new `AD` string to put the default adjustment mode under user control at rendering time. The default is "b" (adjust lines to both margins) as has been the Unix man(7) default for typesetters since 1979.
Attachment:
signature.asc
Description: PGP signature
