[groff] 01/01: groff_man(7): Clarify .SY pargraphing behavior.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit dde7d7207e60dd3574b811bc4e075e9b611775cd
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jul 24 08:07:49 2020 +1000

    groff_man(7): Clarify .SY pargraphing behavior.
    
    * Document fact that .SY works like a .PP macro (causing a break and
      vertical space) except when re-used "inside" a .SY/.YS region (where
      it causes only a break).
    * Remove unnecessary word "amount" from description of .YS.
    * Remove unnecessary .PP macro before .SY in page source.
    
    Thanks to Bjarni Ingi Gislason for pointing out this issue.
---
 tmac/groff_man.7.man | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index ad5ee0f..31e1342 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -814,6 +814,18 @@ installation.
 .BI .SY " command"
 Begin synopsis.
 .
+A new paragraph is begun at the left margin
+.\" BEGIN STYLE
+(like
+.B .PP
+and its aliases)
+.\" END STYLE
+unless
+.B .SY
+has already been called without a corresponding
+.BR .YS ,
+in which case only a break is performed.
+.
 Hyphenation is turned off.
 .
 The
@@ -852,7 +864,7 @@ Square brackets in roman surround both arguments.
 .B .YS
 End synopsis.
 .
-Restore previous indentation amount and initial hyphenation mode.
+Restore previous indentation and initial hyphenation mode.
 .
 .
 .PP
@@ -918,7 +930,6 @@ produces the following output.
 .
 .
 .RS
-.PP
 .SY groff
 .OP \-abcegiklpstzCEGNRSUVXZ
 .OP \-d cs