groff-commit
[Top][All Lists]
Advanced

[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.
 .



reply via email to

[Prev in Thread] Current Thread [Next in Thread]