Re: [PATCH 5/9] doc/bash.1: Stop manipulating adjustment.

[G. Branden Robinson]

I need to correct a point in my own explanation.  No revision to the
patch itself is necessary.

At 2024-12-16T11:48:15-0600, G. Branden Robinson wrote:
> Since AT&T troff also lacks a feature for hyphenless discretionary
> breaks (groff's `\%`),

I of course meant `\:` here.  If you knew your man page was going to be
rendered only by modern tools, like groff, Heirloom Doctools troff, or
mandoc(1), you could say the following, using Bash's page-local "QN"
macro for hyphenless quotation...

The default command search path is
.QN /usr/local/bin:/usr/local/sbin:\:/usr/bin:/usr/sbin:/bin:/sbin .

...and rest easy that the line would not overrun, and if it broke across
lines, a hyphen wouldn't be stuck into it.

Unfortunately, most descendants of Unix troff, like those of DWB,
Solaris 10, Illumos,[1] and (I think) Plan 9, don't support `\:`.

Hence the alternative technique I used in my patch.  (Also, that was a
displayed example, so filling was disabled, which in *roff means that
automatic breaking [and therefore hyphenation] is too.)

Regards,
Branden

[1] Solaris 11 uses groff, albeit an old one (1.22.2, I think), as its
    troff.

signature.asc
Description: PGP signature