[groff] 11/48: groff_man_style(7): Clarify behavior of `\%`.

[G. Branden Robinson]

gbranden pushed a commit to branch branden-2023-03-31
in repository groff.

commit f0b9f96977e5d57e6fa9a28e798a49d6e9ea9ff6
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Mar 24 05:54:07 2023 -0500

    groff_man_style(7): Clarify behavior of `\%`.
    
    Also clarify effects of `SY` and `YS` macros on adjustment.
    
    Prompted by Alex Colomar in
    <https://lists.gnu.org/archive/html/groff/2023-03/msg00079.html>.
---
 tmac/groff_man.7.man.in | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 8416825cf..5338a715c 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1018,7 +1018,7 @@ has already been called without a corresponding
 .BR .YS ,
 in which case only a break is performed.
 .
-Automatic hyphenation is disabled.
+Adjustment and automatic hyphenation are disabled.
 .
 .I command
 is set in bold.
@@ -1033,8 +1033,10 @@ plus a space.
 .B .YS
 End synopsis.
 .
-The previous indentation amount and initial hyphenation mode are
-restored.
+Indentation,
+adjustment,
+and hyphenation
+are restored to their previous states.
 _ifstyle()dnl
 .
 .
@@ -2466,10 +2468,10 @@ supplementing
 automatic hyphenation patterns.
 .
 At the beginning of a word,
-it suppresses any automatic hyphenation points within;
-any specified with
-.B \e%
-are still honored.
+it suppresses any hyphenation breaks within
+.I except
+those specified with
+.BR \e% .
 .
 .
 .TP