[groff] 20/20: groff_man_style(7): Fix content and style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 351840300aebe7f2ef9ef32e1fdc8a0c3eade064
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Aug 2 11:12:45 2023 -0500

    groff_man_style(7): Fix content and style nits.
    
    * Explain why we put a space before an ellipsis in our example.
    * Also use active voice more.
    
    Reported-by: Alejandro Colomar <alx@kernel.org>
---
 tmac/groff_man.7.man.in | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 6af7a8244..e8e41691b 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1229,6 +1229,9 @@ brackets surround optional arguments,
 and an ellipsis indicates that the previous syntactical element may be
 repeated arbitrarily.
 .
+Where whitespace separates optional arguments,
+a space precedes the ellipsis.
+.
 .
 .IP \(bu
 The non-breaking adjustable space escape sequence
@@ -2591,13 +2594,14 @@ the end of a text line is treated like a space;
 .\" end-of-sentence detection is performed, and...
 an output line
 .I may
-be broken there
-(if not,
-an adjustable space is inserted);
+break there
+(if it does not,
+.I @g@troff
+inserts an adjustable space;
 if filling is disabled,
 the line
 .I will
-be broken there,
+break there,
 as in
 .BR .EX / .EE
 examples.