[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 46/49: groff(1): Fix style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 46/49: groff(1): Fix style nits. |
Date: |
Wed, 16 Jun 2021 19:53:33 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit ab6b523d7365a2c7afbf58bf400236238c8ebc1e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jun 17 08:40:26 2021 +1000
groff(1): Fix style nits.
* src/roff/groff/groff.1.man: Fix style nits.
(Options): Use idiomatic English.
(Options/groff-specific options) <-l>: Tighten wording.
<-L>: Perform a Kemper notectomy.
(Options/Transparent options) <-c>: Say more about effect on terminal
output.
<-W>: Capitalize sentence.
(Environment) <GROFF_TMPDIR, GROFF_TYPESETTER>: Tighten wording. Set
program names in italics, not bold. Break input lines at commas.
(generally): Kill off superfluous "for more details" phrase.
---
src/roff/groff/groff.1.man | 74 ++++++++++++++++++++++++----------------------
1 file changed, 38 insertions(+), 36 deletions(-)
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 072b8a1..c9c5751 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -129,7 +129,7 @@ interprets differently.
At the same time,
not all valid
.I \%@g@troff
-options can be given into
+options can be given to
.IR groff .
.
.
@@ -231,16 +231,16 @@ Implies
.B \-l
Send the output to a spooler program for printing.
.
-The command that should be used for this is specified by the
-.B print
-command in the device description file;
+The
+.RB \[lq] print \[rq]
+directive in the device description file
+specifies the default command to be used;
see
.IR \%groff_font (@MAN5EXT@).
.
-If this command is not present,
-the output is piped into the
-.IR lpr (1)
-program by default.
+If no such directive is present for the output device,
+output is piped to
+.IR lpr (1).
.
See options
.B \-L
@@ -261,7 +261,6 @@ each should be passed with a separate
.B \-L
option each.
.
-Note that
.I groff
does not prepend
\[lq]\-\[rq]
@@ -347,11 +346,9 @@ No mechanism is provided for passing arguments to
because most
.I \%@g@refer
options have equivalent language elements that can be specified within
-the document.
-.
-See
-.IR \%@g@refer (@MAN1EXT@)
-for more details.
+the document;
+see
+.IR \%@g@refer (@MAN1EXT@).
.
.
.TP
@@ -651,13 +648,15 @@ Generate a plain text approximation of the typeset output.
.B \-b
Backtrace on error or warning.
.
+.
.TP
.B \-c
-Disable color output.
+Disable color output
+(to any device)
+and use legacy output format for terminal devices;
+see
+.IR \%grotty (@MAN1EXT@).
.
-Please consult the
-.IR \%grotty (@MAN1EXT@)
-man page for more details.
.
.TP
.B \-C
@@ -753,7 +752,7 @@ Texinfo manual for a list of names.
.
.TP
.BI \-W\~ name
-disable warning category
+Disable warning category
.IR name .
.
See
@@ -1741,36 +1740,37 @@ A list of directories in which to seek macro files.
See
.IR \%@g@troff (@MAN1EXT@)
and
-.IR \%groff_tmac (@MAN5EXT@)
-for more details.
+.IR \%groff_tmac (@MAN5EXT@).
.
.
.TP
.I GROFF_TMPDIR
The directory in which temporary files are created.
.
-If this is not set but the environment variable
+If not set,
+but the environment variable
.I \%TMPDIR
-instead, temporary files are created in the directory
-.IR \%TMPDIR .
+is set,
+temporary files are created there instead.
.
-On MS-DOS and Windows platforms, the environment variables
+On MS-DOS and Windows platforms,
+if neither of the foregoing are set,
+the environment variables
.I TMP
and
.I TEMP
-(in that order) are searched also, after
-.I \%GROFF_TMPDIR
-and
-.IR \%TMPDIR .
+(in that order)
+are checked also.
.
-Otherwise, temporary files are created in
+Otherwise,
+temporary files are created in
.IR /tmp .
.
The
-.BR \%@g@refer (@MAN1EXT@),
-.BR \%grohtml (@MAN1EXT@),
+.IR \%@g@refer (@MAN1EXT@),
+.IR \%grohtml (@MAN1EXT@),
and
-.BR grops (@MAN1EXT@)
+.IR grops (@MAN1EXT@)
commands use temporary files.
.
.
@@ -1778,12 +1778,14 @@ commands use temporary files.
.I GROFF_TYPESETTER
Preset the default device.
.
-If this is not set the
+If not set,
.B @DEVICE@
device is used as default.
.
-This device name is overwritten by the option
-.BR \-T .
+The
+.B \-T
+option overrides
+.IR GROFF_TYPESETTER .
.
.
.TP
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 46/49: groff(1): Fix style nits.,
G. Branden Robinson <=