At 2023-06-28T10:58:22+1000, Damian McGuckin wrote: > A reference is > > https://lists.gnu.org/archive/html/groff/2013-10/pdfTyBN2VWR1c.pdf > > It is too long for a reference list.
Did you try turning off filling (if necessary) and adding hyphenless
break points?
We have some advice about this sort of thing in 1.23.0.rc4's
groff_man_style(7).
The arguments to .MR, .MT, and .UR should be prepared for
typesetting since they can appear in the output. Use special
character escape sequences to encode Unicode basic Latin characters
where necessary, particularly the hyphen-minus. (See section
"Portability" below.) URIs can be lengthy; rendering them can
result in jarring adjustment or variations in line length, or troff
warnings when a hyperlink is longer than an output line. The
application of non-printing break point escape sequences \: after
each slash (or series thereof), and before each dot (or series
thereof) is recommended as a rule of thumb. The former practice
avoids forcing a trailing slash in a URI onto a separate output
line, and the latter helps the reader to avoid mistakenly
interpreting a dot at the end of a line as a period (or multiple
dots as an ellipsis). Thus,
.UR http://\:example\:.com/\:fb8afcfbaebc74e\:.cc
has several potential break points in the URI shown. Consider
adding break points before or after at signs in email addresses, and
question marks, ampersands, and number signs in HTTP(S) URIs. The
formatter removes \: escape sequences from hyperlinks when supplying
device control commands to output drivers.
Arguably, this advice should be (more or less) duplicated somewhere in
the formatter's documentation.
https://\:lists\:.gnu\:.org/\:archive/\:html/\:groff/\:2013\-10/\
\:pdfTyBN2VWR1c\:.pdf
(Note the escaped '-' as well.)
Regards,
Branden
signature.asc
Description: PGP signature
