Re: Reference to Ted Harding's EQN document

[G. Branden Robinson]

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