groff-commit
[Top][All Lists]
Advanced

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

[groff] 11/38: pic(1): Fix style nits.


From: G. Branden Robinson
Subject: [groff] 11/38: pic(1): Fix style nits.
Date: Fri, 2 Sep 2022 19:56:30 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 3befb0c6aeeb7edb06af8e296d13ec9989272471
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Aug 28 17:19:46 2022 -0500

    pic(1): Fix style nits.
    
    * Use independent clause in imperative mood when characterizing options.
    * Add comma after phrase used as restrictive modifier.
    * End sentence with period, not colon.  The word "following" does not
      excuse you from the rules of English grammar (in formal writing).
    * Say "GNU pic" explicitly when distinguishing this implementation's
      behavior from others.
    
    Also fix markup nit: migrate from `LP` to `P` macro.
---
 src/preproc/pic/pic.1.man | 29 +++++++++++++++++------------
 1 file changed, 17 insertions(+), 12 deletions(-)

diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 18cff26fe..c8e4be540 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -257,10 +257,10 @@ mode.
 .
 .TP
 .B \-S
-Safer mode;
-do not execute
+Operate in
+.I safer mode;
 .B sh
-commands.
+commands are ignored.
 .
 This option,
 enabled by default,
@@ -274,29 +274,33 @@ can be useful when operating on untrustworthy input.
 .
 .TP
 .B \-U
-Unsafe mode;
-revert the default option
-.BR \-S .
+Operate in
+.I unsafe mode;
+.B sh
+commands are interpreted.
 .
 .
 .TP
 .B \-z
-In \*[tx] mode draw dots using zero-length lines.
+In \*[tx] mode,
+draw dots using zero-length lines.
 .
 .
-.LP
+.P
 The following options supported by other versions of
 .I pic \" generic
-are ignored:
+are ignored.
+.
 .
 .TP
 .B \-D
 Draw all lines using the \[rs]D escape sequence.
-.I @g@pic
+GNU
+.I pic \" GNU
 always does this.
 .
 .TP
-.BI \-T \ dev
+.BI \-T\~ dev
 Generate output for the
 .I troff \" generic
 device
@@ -305,7 +309,8 @@ device
 This is unnecessary because the
 .I troff \" generic
 output generated by
-.I @g@pic
+GNU
+.I pic \" GNU
 is device-independent.
 .
 .



reply via email to

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