[groff] 05/16: [docs]: Sync descriptions of $GROFF_TYPESETTER.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 189fbf692a124a41c48916c5777251caf6034b67
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Aug 21 13:18:19 2021 +1000

    [docs]: Sync descriptions of $GROFF_TYPESETTER.
    
    Clarify that an empty $GROFF_TYPESETTER value is equivalent to it being
    unset.
---
 doc/groff.texi             |  4 +++-
 src/roff/groff/groff.1.man |  8 ++++----
 src/roff/troff/troff.1.man | 11 ++++++++++-
 3 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 6429533..55ac9ef 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -1405,7 +1405,9 @@ default directory (on Unix and GNU/Linux systems, this is 
usually
 
 @item GROFF_TYPESETTER
 @tindex GROFF_TYPESETTER@r{, environment variable}
-The default output device.
+Sets the default output device.  If empty or not set, a build-time
+default (often @code{ps}) is used.  The @option{-T@var{dev}} option
+overrides @env{GROFF_TYPESETTER}.
 
 @item SOURCE_DATE_EPOCH
 @tindex SOURCE_DATE_EPOCH@r{, environment variable}
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 632cfb6..0bc876a 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -1757,11 +1757,11 @@ commands use temporary files.
 .
 .TP
 .I GROFF_TYPESETTER
-Preset the default device.
+Set the default output device.
 .
-If not set,
-.B @DEVICE@
-device is used as default.
+If empty or not set,
+.RB \[lq] @DEVICE@ \[rq]
+is used.
 .
 The
 .B \-T
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 0024f4a..46b4832 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -797,7 +797,16 @@ after them.
 .
 .TP
 .I GROFF_TYPESETTER
-Default output device.
+Set the default output device.
+.
+If empty or not set,
+.RB \[lq] @DEVICE@ \[rq]
+is used.
+.
+The
+.B \-T
+option overrides
+.IR GROFF_TYPESETTER .
 .
 .
 .TP