[bug #60332] Document behaviour of soft hyphens in hyphenation mode 0

[G. Branden Robinson]

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 <g.branden.robinson@gmail.com>
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/