groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 21/29: groff_man*(7): Fix style nits.


From: G. Branden Robinson
Subject: [groff] 21/29: groff_man*(7): Fix style nits.
Date: Tue, 26 Apr 2022 06:40:18 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit dca2874b6f9157530903b73064cc10ad7bef2df6
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Apr 18 17:15:46 2022 +1000

    groff_man*(7): Fix style nits.
    
    * Drop misleading reference to "strings".  Macro arguments are not best
      thought of as string objects in the roff language.  (You don't
      interpolate them with `\*`, for instance, but with the bespoke `\$`.)
    * Clarify mention of "two major syntactical categories".  Ordinary text
      is a syntactical category, too.
    * Tighten wording.
---
 tmac/groff_man.7.man.in | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 5084d899..c38349c2 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -284,7 +284,7 @@ See section \(lqNotes\(rq below for examples of cases where 
better
 alternatives to empty arguments in macro calls are available.
 _endif()dnl
 .
-Most macro arguments are strings that will be output as text;
+Most macro arguments wll be formatted as text in the output;
 exceptions are noted.
 .
 .
@@ -915,9 +915,8 @@ Begin synopsis.
 .
 A new paragraph is begun at the left margin
 _ifstyle()dnl
-(like
-.B .P
-and its aliases)
+(as with
+.BR .P )
 _endif()dnl
 unless
 .B .SY
@@ -2215,7 +2214,7 @@ and font style alternation macros.
 .
 .
 .P
-The two major syntactical categories of the
+The two major syntactical categories for formatting control in the
 .I roff
 language are requests and escape sequences.
 .



reply via email to

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