groff-commit
[Top][All Lists]
Advanced

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

[groff] 31/35: [man pages]: Fix style nit.


From: G. Branden Robinson
Subject: [groff] 31/35: [man pages]: Fix style nit.
Date: Tue, 21 Jun 2022 14:26:31 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 696cb7d8ecc4d36869e46f32f081eb31db9f9c9c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jun 21 02:10:51 2022 -0500

    [man pages]: Fix style nit.
    
    Align and tighten descriptions of `-I` options.
---
 src/devices/gropdf/gropdf.1.man | 21 ++++++++++++---------
 src/devices/grops/grops.1.man   | 23 +++++++++++++----------
 src/preproc/soelim/soelim.1.man | 24 +++++++++++++-----------
 src/roff/troff/troff.1.man      | 27 ++++++++++++++-------------
 4 files changed, 52 insertions(+), 43 deletions(-)

diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index ee36eb3e..81a37c42 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -152,21 +152,24 @@ is the name of the device, usually
 .BR pdf .
 .
 .TP
-.BI \-I " dir"
-This option may be used to add a directory to the search path for
-files named in
+.BI \-I\~ dir
+Search the directory
+.I dir
+for files named in
 .B \[rs]X\[aq]pdf: pdfpic\[aq]
 escape sequences.
 .
-This option may be specified more than once;
-the directories are then searched in the order specified.
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
 .
-If you want to search the current directory before others,
+To search the current working directory before others,
 add
 .RB \[lq] "\-I .\&" \[rq]
-at the desired place.
-.
-The current working directory is otherwise searched last.
+at the desired place;
+it is otherwise searched last.
 .
 .
 .TP
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 329d8baf..f83de91b 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -280,22 +280,25 @@ U.S.\& letter and A4 paper formats without change.
 .
 .TP
 .BI \-I\~ dir
-This option may be used to add a directory to the search path for
-files on the command line and files named in
-.B \[rs]X\[aq]ps: \%import\[aq]
-and
+Search the directory
+.I dir
+for files named in
 .B \[rs]X\[aq]ps: file\[aq]
+and
+.B \[rs]X\[aq]ps: import\[aq]
 escape sequences.
 .
-This option may be specified more than once;
-the directories are then searched in the order specified.
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
 .
-If you want to search the current directory before others,
+To search the current working directory before others,
 add
 .RB \[lq] "\-I .\&" \[rq]
-at the desired place.
-.
-The current working directory is otherwise searched last.
+at the desired place;
+it is otherwise searched last.
 .
 .
 .TP
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index 93fcff01..b6af9d75 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -371,22 +371,24 @@ even when followed by a character other than space or 
newline.
 .
 .TP
 .BI \-I\~ dir
-Add the directory
+Search the directory
 .I dir
-to the search path for macro files
-(both those on the command line and those named in
-.B .so
-requests).
+path for
+.I input-
+and
+.I included-files.
 .
-This option may be specified more than once;
-the directories are searched in the order specified.
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
 .
-If you want to search the current directory before others,
+To search the current working directory before others,
 add
 .RB \[lq] "\-I .\&" \[rq]
-at the desired place.
-.
-The current working directory is otherwise searched last.
+at the desired place;
+it is otherwise searched last.
 .
 .
 .TP
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index f2830ac5..ff8cbbac 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -265,33 +265,34 @@ processed.
 .
 .TP
 .BI \-I\~ dir
-Search
+Search the directory
 .I dir
-for input files
-(those on the command line,
-those named in
+for files
+(those named on the command line;
+in
 .BR psbb ,
 .BR so ,
 and
 .B soquiet
-requests,
-and
-those named in
+requests;
+and in
 .RB \[lq] "\[rs]X\[aq]ps: import\[aq]" \[rq],
 .RB \[lq] "\[rs]X\[aq]ps: file\[aq]" \[rq],
 and
 .RB \[lq] "\[rs]X\[aq]pdf: pdfpic\[aq]" \[rq]
 device control escape sequences).
 .
-This option may be specified more than once;
-the directories are searched in the order specified.
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
 .
-If you want to search the current directory before others,
+To search the current working directory before others,
 add
 .RB \[lq] "\-I .\&" \[rq]
-at the desired place.
-.
-The current working directory is otherwise searched last.
+at the desired place;
+it is otherwise searched last.
 .
 .B \-I
 works similarly to,



reply via email to

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