[groff] 20/35: [man pages]: Fix content and style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 817196ba30ff45304a68f2b424d242d7c9d7e1c7
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Feb 21 01:13:59 2022 +1100

    [man pages]: Fix content and style nits.
    
    Content:
    * Stop referring to the recognition of `.R1` and `.R2` tokens as "new"
      features of GNU refer; they are thus only in a pedantic sense, having
      by now been around twice as long as troff itself had been when they
      were introduced.
    
    Style:
    * Set file names with mixed variable and literal content per our
      recommendation in groff_man_style(7).
    * Use "file" instead of "filename" as metasyntactic variable name, for
      consistency with our other pages.
---
 src/preproc/refer/refer.1.man   |  4 ++--
 src/utils/lkbib/lkbib.1.man     | 12 ++++++------
 src/utils/lookbib/lookbib.1.man | 10 +++++-----
 3 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 66428f8c..668e476b 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -181,7 +181,7 @@ The interpretation of lines between
 .B .R1
 and
 .B .R2
-as prepreocessor commands is a new feature of GNU
+as prepreocessor commands is a feature of GNU
 .IR \%refer . \" GNU
 .
 Documents making use of this feature can still be processed by AT&T
@@ -1089,7 +1089,7 @@ Search each bibliographic database
 For each
 .IR file ,
 if an index
-.IB file @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 created by
 .MR @g@indxbib @MAN1EXT@
 exists,
diff --git a/src/utils/lkbib/lkbib.1.man b/src/utils/lkbib/lkbib.1.man
index 62e58813..75849251 100644
--- a/src/utils/lkbib/lkbib.1.man
+++ b/src/utils/lkbib/lkbib.1.man
@@ -39,7 +39,7 @@ lkbib \- search bibliographic databases
 .RB [ \-i\~\c
 .IR fields ]
 .RB [ \-p\~\c
-.IR filename ]
+.IR file ]
 .RB [ \-t\~\c
 .IR n ]
 .I key
@@ -81,10 +81,10 @@ otherwise it is
 .IR @DEFAULT_INDEX@ .
 .
 For each database
-.I filename
+.I file
 to be searched,
 if an index
-.RI filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 created by
 .MR @g@indxbib @MAN1EXT@
 exists, then it will be searched instead;
@@ -113,9 +113,9 @@ ignore the contents of fields whose names are in
 .
 .
 .TP
-.BI \-p\~ filename
+.BI \-p\~ file
 Search
-.IR filename .
+.IR file .
 .
 Multiple
 .B \-p
@@ -154,7 +154,7 @@ environment variable is not set.
 .
 .
 .TP
-.RI filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 Index files.
 .
 .
diff --git a/src/utils/lookbib/lookbib.1.man b/src/utils/lookbib/lookbib.1.man
index 880ee685..58ef63ae 100644
--- a/src/utils/lookbib/lookbib.1.man
+++ b/src/utils/lookbib/lookbib.1.man
@@ -39,7 +39,7 @@
 .IR string ]
 .RB [ \-t\~\c
 .IR n ]
-.I filename
+.I file
 \&.\|.\|.\&
 .YS
 .
@@ -66,16 +66,16 @@ prints a prompt on the standard error (unless the standard 
input is not
 a terminal),
 reads from the standard input a line containing a set of keywords,
 searches the bibliographic databases
-.I filename
+.I file
 \&.\|.\|.\& for references containing those keywords,
 prints any references found on the standard output,
 and repeats this process until the end of input.
 .
 For each database
-.I filename
+.I file
 to be searched,
 if an index
-.RI filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 created by
 .MR @g@indxbib @MAN1EXT@
 exists, then it will be searched instead;
@@ -119,7 +119,7 @@ is\~6.
 .\" ====================================================================
 .
 .TP
-.RI filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 Index files.
 .
 .