[docs]: Regularize discussion of GROFF_FONT_PATH.

* src/devices/grodvi/grodvi.1.man (Environment):
* src/devices/grohtml/grohtml.1.man (Environment):
* src/devices/grolbp/grolbp.1.man (Environment):
* src/devices/grolj4/grolj4.1.man (Environment):
* src/devices/grops/grops.1.man (Environment):
* src/devices/grotty/grotty.1.man (Environment):
* src/devices/xditview/gxditview.1.man (Environment):
* src/roff/groff/groff.1.man (Environment): Use parallel language.

* doc/groff.texi (Environment): As above, but modify cross references.
  Add citations to man pages.

* src/devices/gropdf/gropdf.1.man (Environment): As above, but preserve
  note about absolute file names in download files.

* src/roff/troff/troff.1.man (Environment): As above, but preserve
  description of default font search path.  Break input line at comma.

11 files changed, 39 insertions, 53 deletions

diff --git a/doc/groff.texi b/doc/groff.texi
index c3e8539d2..a1adb6e7d 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -1374,9 +1374,12 @@ implies @code{groff}'s command-line option @option{-k} (that is,
 
 @item GROFF_FONT_PATH
 @tindex GROFF_FONT_PATH@r{, environment variable}
-A colon-separated list of directories in which to search for the
-@code{dev}@var{name} directory (before the default directories are
-tried).  @xref{Font Directories}.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.  GNU @code{troff}
+will search directories given as arguments to any specified @option{-F}
+options before these, and a built-in list of directories after them.
+@xref{Font Directories} and the @cite{troff@r{(1)}} or
+@cite{gtroff@r{(1)}} man pages.
 
 @item GROFF_TMAC_PATH
 @tindex GROFF_TMAC_PATH@r{, environment variable}
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index cb15e956b..9c92fd923 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -463,15 +463,13 @@ values.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.IR \%groff_font (@MAN5EXT@)
-for more details.
+.IR \%groff_font (@MAN5EXT@).
 .
 .
 .\" ====================================================================
diff --git a/src/devices/grohtml/grohtml.1.man b/src/devices/grohtml/grohtml.1.man
index feae0cc35..163401757 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -518,15 +518,13 @@ for details about where such files are created.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.IR groff_font (@MAN5EXT@)
-for more details.
+.IR \%groff_font (@MAN5EXT@).
 .
 .
 .TP
diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.1.man
index 176da058a..b13679686 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -408,15 +408,13 @@ is case sensitive.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.IR \%groff_font (@MAN5EXT@)
-for more details.
+.IR \%groff_font (@MAN5EXT@).
 .
 .
 .\" ====================================================================
diff --git a/src/devices/grolj4/grolj4.1.man b/src/devices/grolj4/grolj4.1.man
index 180d38043..ec49b0e30 100644
--- a/src/devices/grolj4/grolj4.1.man
+++ b/src/devices/grolj4/grolj4.1.man
@@ -188,15 +188,13 @@ must be in the range 0 to 65535; default is\~0.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.IR groff_font (@MAN5EXT@)
-for more details.
+.IR \%groff_font (@MAN5EXT@).
 .
 .
 .\" ====================================================================
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index ef1572da4..c0febb58f 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -1311,11 +1311,11 @@ field should be null for the default foundry.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
-If, in the
+If,
+in the
 .I download
 file,
 the font file has been specified with a full path,
@@ -1324,8 +1324,7 @@ no directories are searched.
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.IR groff_font (@MAN5EXT@)
-for more details.
+.IR groff_font (@MAN5EXT@).
 .
 .
 .TP
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 4f34548f1..3c5b5a820 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -1457,15 +1457,13 @@ or add the directory to groff's font path environment variable
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.IR groff_font (@MAN5EXT@)
-for more details.
+.IR \%groff_font (@MAN5EXT@).
 .
 .
 .TP
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index f7805e92d..ce197fb8a 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -480,15 +480,13 @@ isn't used.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.IR groff_font (@MAN5EXT@)
-for more details.
+.IR \%groff_font (@MAN5EXT@).
 .
 .
 .TP
diff --git a/src/devices/xditview/gxditview.1.man b/src/devices/xditview/gxditview.1.man
index d81bf758a..201f2d91e 100644
--- a/src/devices/xditview/gxditview.1.man
+++ b/src/devices/xditview/gxditview.1.man
@@ -568,15 +568,13 @@ This option specifies a resource string to be used.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.IR groff_font (@MAN5EXT@)
-for more details.
+.IR \%groff_font (@MAN5EXT@).
 .
 .
 .\" ====================================================================
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index cc9dc68a8..0a5b52dbb 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -1725,15 +1725,13 @@ for details.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
 .IR \%@g@troff (@MAN1EXT@)
 and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+.IR \%groff_font (@MAN5EXT@).
 .
 .
 .TP
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 94172133d..c549335ba 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -634,14 +634,14 @@ All warnings.
 .
 .TP
 .I GROFF_FONT_PATH
-A colon separated list of directories in which to search for the
-.IR dev name
-directory.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
 .I \%@g@troff
 will scan directories given in the
 .B \-F
-option before these, and in standard directories
+option before these,
+and in standard directories
 .RI ( @LOCALFONTDIR@ ,
 .IR @FONTDIR@ ,
 .IR @LEGACYFONTDIR@ )