[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 09/16: groff_man*(7): Fix content and style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 09/16: groff_man*(7): Fix content and style nits. |
Date: |
Sat, 16 Mar 2024 01:48:52 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit f378721fdec399cd01d55810ec5125dc08b2b2f3
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Mar 15 23:19:31 2024 -0500
groff_man*(7): Fix content and style nits.
Content:
* Note that DWB troff doesn't support \[xxx] escape sequence syntax.
Style:
* Favor active voice over passive.
---
tmac/groff_man.7.man.in | 22 +++++++++++-----------
1 file changed, 11 insertions(+), 11 deletions(-)
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 3320ad383..f43481161 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1203,8 +1203,8 @@ Several features of the above example are of note.
.IP \(bu 3n
The empty request (.),
which does nothing,
-is used to vertically space the input file for readability by the
-document maintainer.
+vertically spaces the input file for readability by the document
+maintainer.
.
Do not put blank (empty) lines in a man page source document.
.
@@ -1245,8 +1245,7 @@ a space precedes the ellipsis.
.IP \(bu
The non-breaking adjustable space escape sequence
.B \e\(ti
-is used to prevent the output line from breaking within the option
-brackets;
+prevents the output line from breaking within the option brackets;
see subsection \(lqPortability\(rq below.
.
.
@@ -2854,8 +2853,10 @@ Heirloom Doctools
.IR troff , \" Heirloom Doctools
and
.IR neatroff ,
-but not Plan\~9 or Solaris
-.I troff. \" Plan 9, Solaris
+but not Documenter's Workbench,
+Plan\~9,
+or Solaris
+.I troff. \" DWB, Plan 9, Solaris
.
.
.TP
@@ -4229,14 +4230,13 @@ that precedes it.
.
.
.IP
-After calls to the
+Calling the
.B .SH
-and
+or
.B .SS
-sectioning macros,
-all relative insets are cleared and calls to
+sectioning macros clears all relative insets and
.B .RE
-have no effect until
+calls have no effect until
.B .RS
is used again.
.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 09/16: groff_man*(7): Fix content and style nits.,
G. Branden Robinson <=