gbranden pushed a commit to branch master
in repository groff.
commit 351840300aebe7f2ef9ef32e1fdc8a0c3eade064
Author: G. Branden Robinson <g.branden.robin...@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 <a...@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.
_______________________________________________
Groff-commit mailing list
Groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
