Follow-up Comment #2, bug #60332 (project groff): I did some further work on this, prompted by Peter's follow-up on the mailing list.
https://lists.gnu.org/archive/html/groff/2021-04/msg00017.html commit 064d169b242d514418c371be5693a96370c5a985 Author: G. Branden Robinson <[email protected]> Date: Tue Apr 6 14:50:08 2021 +1000 [docs]: Revise hyphenation discussion. * doc/groff.texi (Manipulating Hyphenation): - Recast introductory paragraph to better distinguish between the automatic breaking of words and placement of hyphens at user-specified hyphenation points (done with the \% escape) and automatic determination of hyphenation points within words (what the pattern files and most of the hyphenation mode parameters are for). Clarify that what our manual calls "automatic hyphenation" pertains only to the latter. - Tweak narrative motivating manual hyphenation. - <hw> Correct over-general claim; hyphenation exceptions defined with the .hw request _do_ honor .hy value 2 (don't break a word at the bottom of a page), but none of the others. - <\:> Clarify that escape is an input word boundary. - <shc> Reorganize discussion of soft hyphen glyph-setting request. Recast; "hyphenation" as defined in this manual always implies a break. Clarify that the soft hyphen glyph is applied to manual as well as automatically-determined hyphenation points. (This further distinguishes such points from "explicit" hyphens, as in "mother-in-law".) Change more uses of soft hyphen "character" to "glyph". Tighten wording. - Move concept index entry for "automatic hyphenation" to first discussion of the concept instead of immediately prior to the .hy request entry. - Add concept index entries for "automatic hyphenation parameters", "explicit hyphenation", "manual hyphenation", and altenate orderings of these words. - <hy> Recharacterize as setting the _automatic_ hyphenation mode. Tighten wording in footnote regarding vertical location traps. Note that restrictions apart from value 2 are not applied to words with manually-assigned hyphenation points. * man/groff_diff.7.man (Language/Escape sequences) <\:>: Drop example. * man/groff.7.man (Hyphenation): Mention .hw request and its purpose in introductory paragraph. Contrast with default of automatic determination of hyphenation points. * man/groff_diff.7.man (Language/New requests) <shc>: * man/groff.7.man (Hyphenation): Resync with our Texinfo manual. Continues addressing <https://savannah.gnu.org/bugs/?60332>. _______________________________________________________ Reply to this item at: <https://savannah.gnu.org/bugs/?60332> _______________________________________________ Message sent via Savannah https://savannah.gnu.org/
