[groff] 11/11: groff_man*(7): Fix content nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1beb12abee6b669da7bfbdc9c2224a3c6520a224
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Apr 6 09:55:57 2022 +1000

    groff_man*(7): Fix content nits.
    
    * Alter descriptions of ordinary paragraphing macros in initial summary
      list.  Stop suggesting mnemonic for "LP".  Say "Begin paragraph"
      instead of "Paragraphing" so that an action is implied.
    * <SY> Clarify that it is _automatic_ hyphenation that is disabled.
      Drop reiteration that filling is unchanged.
    * <YS> Use passive voice to describe operations that the macro
      definition performs (after the active voice and imperative mood used
      to characterize the issue of the macro call itself); this is symmetric
      with other descriptions in this page (and in meref.me, which I
      recently thoroughly revised).
---
 tmac/groff_man.7.man.in | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index a50c9f5a..1afdd796 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -152,12 +152,12 @@ _
 \&.IB  Italic, bold alternating        Font style macros
 \&.IP  Indented paragraph      Paragraphing macros
 \&.IR  Italic, roman alternating       Font style macros
-\&.LP  (Left) paragraph        Paragraphing macros
+\&.LP  Begin paragraph Paragraphing macros
 \&.ME  Mail-to end     Hyperlink macros
 \&.MR  Man page cross reference        Hyperlink macros
 \&.MT  Mail-to start   Hyperlink macros
-\&.P   Paragraphing    Paragraphing macros
-\&.PP  Paragraphing    Paragraphing macros
+\&.P   Begin paragraph Paragraphing macros
+\&.PP  Begin paragraph Paragraphing macros
 \&.RB  Roman, bold alternating Font style macros
 \&.RE  Relative inset end      Document structure macros
 \&.RI  Roman, italic alternating       Font style macros
@@ -922,15 +922,13 @@ has already been called without a corresponding
 .BR .YS ,
 in which case only a break is performed.
 .
-Hyphenation is turned off.
+Automatic hyphenation is disabled.
 .
-The
 .I command
-argument is set in bold.
+is set in bold.
 .
-The output line is filled as normal,
-but if a break is required,
-subsequent output lines are indented by the width of
+If a break is required,
+lines after the first are indented by the width of
 .I command
 plus a space.
 .
@@ -939,7 +937,8 @@ plus a space.
 .B .YS
 End synopsis.
 .
-Restore previous indentation and initial hyphenation mode.
+The previous indentation amount and initial hyphenation mode are
+restored.
 _ifstyle()dnl
 .
 .