gbranden pushed a commit to branch master
in repository groff.
commit 16dccefdf32751d828f841c9bafac51d2dddb70b
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 3 08:27:34 2026 -0600
groff_man_style(7): Amplify advice.
Generalize proscription against blank input lines, and expand rationale.
---
tmac/groff_man.7.man.in | 20 ++++++++++++--------
1 file changed, 12 insertions(+), 8 deletions(-)
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index bf87b67bd..b20a910dd 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1305,13 +1305,8 @@ Several features of the above example are of note.
The empty request (.),
which does nothing,
vertically spaces the input file for readability by the document
-maintainer.
-.
-Do not put blank (empty) lines in a man page source document.
-.
-Some
-.MR man 1
-programs \[lq]squeeze\[rq] multiple blank output lines into one.
+maintainer;
+see subsection \[lq]Portability\[rq] below regarding blank lines.
.
.
.IP \[bu]
@@ -2576,7 +2571,6 @@ that employs special character escape sequences
to access other glyphs.
.
.
-.
.P
AT&T
.IR troff 's \" AT&T
@@ -2643,6 +2637,16 @@ or omitted entirely.
.
.
.P
+Do not put blank (empty) lines in a man page source document.
+.
+They can produce excessive space in the output,
+or less than is attempted;
+some
+.MR man 1
+programs \[lq]squeeze\[rq] multiple blank output lines into one.
+.
+.
+.P
The wise
.I man
author
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
