[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 03/09: doc/groff.texi: Improve Texinfo command usage.
From: |
G. Branden Robinson |
Subject: |
[groff] 03/09: doc/groff.texi: Improve Texinfo command usage. |
Date: |
Wed, 2 Sep 2020 09:25:07 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit d59b5e71c3e00d5dcca5c0d0ead2fe61b45d290d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Sep 2 04:39:10 2020 +1000
doc/groff.texi: Improve Texinfo command usage.
Use @command where applicable; it is more meaningful than @code.
Note that dvips and dvipdf can be used with grodvi output.
Add program index entries for grodvi, dvips, and dvipdf.
Add concept index entry for "DVI output driver".
---
doc/groff.texi | 43 +++++++++++++++++++++++++------------------
1 file changed, 25 insertions(+), 18 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index c134c9a..fca5e30 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -1379,12 +1379,13 @@ by @code{groff}.
@tindex GROFF_COMMAND_PREFIX@r{, environment variable}
@cindex command prefix
@cindex prefix, for commands
-If this is set to@tie{}@var{X}, then @code{groff} runs
-@code{@var{X}troff} instead of @code{gtroff}. This also applies to
-@code{tbl}, @code{pic}, @code{eqn}, @code{grn}, @code{chem},
-@code{refer}, and @code{soelim}. It does not apply to @code{grops},
-@code{grodvi}, @code{grotty}, @code{pre-grohtml}, @code{post-grohtml},
-@code{preconv}, @code{grolj4}, @code{gropdf}, and @code{gxditview}.
+If this is set to@tie{}@var{X}, then @command{groff} runs
+@command{@var{X}troff} instead of @command{gtroff}. This also applies
+to @command{tbl}, @command{pic}, @command{eqn}, @command{grn},
+@command{chem}, @command{refer}, and @command{soelim}. It does not
+apply to @command{grops}, @command{grodvi}, @command{grotty},
+@command{pre-grohtml}, @command{post-grohtml}, @command{preconv},
+@command{grolj4}, @command{gropdf}, and @command{gxditview}.
The default command prefix is determined during the installation
process. If a non-GNU troff system is found, prefix @samp{g} is used,
@@ -1532,7 +1533,7 @@ All font files are kept in the @dfn{font directories},
which constitute
the @dfn{font path}. The file search functions always append the
directory @code{dev}@var{name}, where @var{name} is the name of the
output device. Assuming, say, DVI output, and @file{/foo/bar} as a font
-directory, the font files for @code{grodvi} must be in
+directory, the font files for @command{grodvi} must be in
@file{/foo/bar/devdvi}.
The elements of the search path for font files are (in that order):
@@ -15353,13 +15354,19 @@ specified as zero then the width is scaled in
proportion to the height.
@c =====================================================================
@node grodvi, grolj4, gropdf, Output Devices
-@section @code{grodvi}
-@cindex @code{grodvi}, the program
+@section @command{grodvi}
+@pindex grodvi
+@pindex dvips
+@pindex dvipdf
+@cindex @command{grodvi}, the program
+@cindex DVI output driver
The postprocessor @command{grodvi} translates the output from GNU
-@command{troff} into the @strong{DVI} output format compatible with
-the @strong{@TeX{}} document preparation system. It is fully
-documented on its manual page, @cite{grodvi(1)}.
+@code{troff} into the DVI format produced by the @TeX{} document
+preparation system. This enables the use of programs that process the
+DVI format, like @command{dvips} and @command{dvipdf}, with GNU
+@code{troff} output. @command{grodvi} is fully documented in its
+manual page, @cite{grodvi(1)}.
@menu
* Invoking grodvi::
@@ -15368,11 +15375,11 @@ documented on its manual page, @cite{grodvi(1)}.
@c ---------------------------------------------------------------------
@node Invoking grodvi, , grodvi, grodvi
-@subsection Invoking @code{grodvi}
-@cindex invoking @code{grodvi}
-@cindex @code{grodvi}, invoking
+@subsection Invoking @command{grodvi}
+@cindex invoking @command{grodvi}
+@cindex @command{grodvi}, invoking
-The postprocessor @code{grodvi} accepts the following command-line
+The postprocessor @command{grodvi} accepts the following command-line
options:
@table @option
@@ -16720,8 +16727,8 @@ postpro grodvi
@endExample
@noindent
-in the file @file{devdvi/DESC} makes @code{groff} call @code{grodvi} if
-option @option{-Tdvi} is given (and @option{-Z} isn't used).
+in the file @file{devdvi/DESC} makes @code{groff} call @command{grodvi}
+if option @option{-Tdvi} is given (and @option{-Z} isn't used).
@item prepro @var{program}
@kindex prepro
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 03/09: doc/groff.texi: Improve Texinfo command usage.,
G. Branden Robinson <=