groff-commit
[Top][All Lists]
Advanced

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

[groff] 12/21: [man pages]: Tighten descriptions.


From: G. Branden Robinson
Subject: [groff] 12/21: [man pages]: Tighten descriptions.
Date: Sat, 16 Sep 2023 18:39:38 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 518a777eeec7851e068ee763cebfeea76edacfcf
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Sep 15 17:21:21 2023 -0500

    [man pages]: Tighten descriptions.
    
    * Detautologize.  You can't give a command an "operand" _except_ on the
      command line.
    * Use active voice more in indxbib(1) and troff(1).
---
 src/preproc/eqn/eqn.1.man         | 2 +-
 src/preproc/pic/pic.1.man         | 2 +-
 src/preproc/preconv/preconv.1.man | 2 +-
 src/preproc/refer/refer.1.man     | 2 +-
 src/preproc/tbl/tbl.1.man         | 2 +-
 src/roff/troff/troff.1.man        | 5 +++--
 src/utils/indxbib/indxbib.1.man   | 7 +++----
 7 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 8594808be..f6f0fbb2a 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -147,7 +147,7 @@ must be used.
 .
 If no
 .I file
-operands are given on the command line,
+operands are present,
 or if
 .I file
 is
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 687d037ca..1ea9eba10 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -146,7 +146,7 @@ option to
 .
 If no
 .I file
-operands are given on the command line,
+operands are present,
 or if
 .I file
 is
diff --git a/src/preproc/preconv/preconv.1.man 
b/src/preproc/preconv/preconv.1.man
index 5fe409779..2034f301d 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -131,7 +131,7 @@ options of
 .
 If no
 .I file
-operands are given on the command line,
+operands are present,
 or if
 .I file
 is
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 08566b1f0..d7f510424 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -146,7 +146,7 @@ option to
 .
 If no
 .I file
-operands are given on the command line,
+operands are present,
 or if
 .I file
 is
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index f00ff1329..3160a6813 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -123,7 +123,7 @@ option to
 .
 If no
 .I file
-operands are given on the command line,
+operands are present,
 or if
 .I file
 is
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 1044a1fed..a12e251e6 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -114,12 +114,13 @@ document formatting system.
 .
 If no
 .I file
-operands are given on the command line,
+operands are present,
 or if
 .I file
 is
 .RB \[lq] \- \[rq],
-the standard input stream is read.
+.I @g@troff
+reads the standard input stream.
 .
 .
 .P
diff --git a/src/utils/indxbib/indxbib.1.man b/src/utils/indxbib/indxbib.1.man
index 14b3ad161..3f3c022fc 100644
--- a/src/utils/indxbib/indxbib.1.man
+++ b/src/utils/indxbib/indxbib.1.man
@@ -107,13 +107,12 @@ writing is done to a temporary file which is then renamed 
to this.
 .
 If no
 .I file
-operands are given on the command line because the
-.B \-f
-option has been used,
+operands are present
 and no
 .B \-o
 option is given,
-the index will be named
+.I @g@refer
+names the index
 .IR \%@DEFAULT_INDEX_NAME@@INDEX_SUFFIX@ .
 .
 .



reply via email to

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