[groff] 09/21: [docs]: Regularize discussion of GROFF_FONT_PATH.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit faa132538b48acbb2c3aed2797513e2788a25f82
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Jun 6 18:18:05 2021 +1000

    [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.
---
 doc/groff.texi                       |  9 ++++++---
 src/devices/grodvi/grodvi.1.man      |  8 +++-----
 src/devices/grohtml/grohtml.1.man    |  8 +++-----
 src/devices/grolbp/grolbp.1.man      |  8 +++-----
 src/devices/grolj4/grolj4.1.man      |  8 +++-----
 src/devices/gropdf/gropdf.1.man      | 11 +++++------
 src/devices/grops/grops.1.man        |  8 +++-----
 src/devices/grotty/grotty.1.man      |  8 +++-----
 src/devices/xditview/gxditview.1.man |  8 +++-----
 src/roff/groff/groff.1.man           |  8 +++-----
 src/roff/troff/troff.1.man           |  8 ++++----
 11 files changed, 39 insertions(+), 53 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index c3e8539..a1adb6e 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 cb15e95..9c92fd9 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 feae0cc..1634017 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 176da05..b136796 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 180d380..ec49b0e 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 ef1572d..c0febb5 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 4f34548..3c5b5a8 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 f7805e9..ce197fb 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 d81bf75..201f2d9 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 cc9dc68..0a5b52d 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 9417213..c549335 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@ )