[groff] 11/41: [docs]: Clarify a couple of hyphenation points.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 72642417a7501923f68803f837378b902178b063
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Mar 4 09:31:11 2022 +1100

    [docs]: Clarify a couple of hyphenation points.
    
    * Emphasize that _explicitly_ hyphenated words are _always_ eligible for
      breaking (if breaking is even happening) at their hyphens.
      Hyphenation mode value 2 doesn't suppress this.
    * When explaining the mechanics of that mode say what it is that a page
      location trap vs. next text baseline is "closer to"--the vertical
      drawing position.
---
 doc/groff.texi  | 21 +++++++++++----------
 man/groff.7.man |  9 ++++-----
 2 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 18ba5979..0080ac0b 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -7661,9 +7661,9 @@ hyphenation points can be set manually.
 @cindex explicit hyphenation
 @cindex hyphenation, manual
 @cindex manual hyphenation
-Explicitly hyphenated words such as ``mother-in-law'' are eligible for
-breaking after each of their hyphens.  Relatively few words in a
-language offer such obvious break points, however, and automatic
+Explicitly hyphenated words such as ``mother-in-law'' are always
+eligible for breaking after each of their hyphens.  Relatively few words
+in a language offer such obvious break points, however, and automatic
 hyphenation is not perfect, particularly for unusual words found in
 technical literature.  We may wish to instruct GNU @code{troff} how to
 hyphenate specific words if the need arises.
@@ -7847,13 +7847,14 @@ restrictions relative to that basis.
 @table @code
 @item 2
 disables hyphenation of the last word on a page,@footnote{Hyphenation is
-prevented if the next page location trap is closer than the next text
-baseline would be.  GNU @code{troff} automatically inserts an implicit
-vertical position trap at the end of each page to cause a page
-transition.  Users or macro packages can set such traps explicitly to
-prevent hyphenation of the last word in a column in multi-column page
-layouts or before floating figures or tables.  @xref{Page Location
-Traps}.} even for manually hyphenated words.
+prevented if the next page location trap is closer to the vertical
+drawing position than the next text baseline would be.  GNU @code{troff}
+automatically inserts an implicit vertical position trap at the end of
+each page to cause a page transition.  Users or macro packages can set
+such traps explicitly to prevent hyphenation of the last word in a
+column in multi-column page layouts or before floating figures or
+tables.  @xref{Page Location Traps}.} even for manually hyphenated
+words.
 
 @item 4
 disables hyphenation before the last two characters of a word.
diff --git a/man/groff.7.man b/man/groff.7.man
index 31871517..d2d774d7 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5159,8 +5159,8 @@ When filling,
 hyphenates words as needed at user-specified and automatically
 determined hyphenation points.
 .
-Explicitly hyphenated words such as \[lq]mother-in-law\[rq] are eligible
-for breaking after each of their hyphens.
+Explicitly hyphenated words such as \[lq]mother-in-law\[rq] are always
+eligible for breaking after each of their hyphens.
 .
 The hyphenation
 .RB character\~ \[rs]%
@@ -5228,9 +5228,8 @@ and then apply or lift restrictions relative to that 
basis.
 .B 2
 disables hyphenation of the last word on a page.
 .
-(Technically,
-hyphenation is prevented if the next page location trap is closer than
-the next line of text would be.
+(Hyphenation is prevented if the next page location trap is closer to
+the vertical drawing position than the next text baseline would be.
 .
 .I groff
 automatically inserts an implicit page location trap at the end of each