[groff] 13/14: [nroff]: Support groff's -R flag to run refer(1).

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit ddcd2afb9b0d37d4c3e5597e47721306d1895c19
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Oct 20 11:25:32 2021 +1100

    [nroff]: Support groff's -R flag to run refer(1).
    
    There's no reason not to support calling `refer` with nroff-mode
    documents; typographically, it's less demanding than tbl(1).  GNU
    troff(1) supports an incompatible `-R` flag to suppress the reading of
    troffrc{,-end} files, but this is likely not the `-R` that users will
    want--it is most useful for troubleshooting troff, and nroff already
    unconditionally loads a macro file (tty-char.tmac).
    
    * src/roff/nroff/nroff.sh: Do it.
    
    * src/roff/nroff/nroff.1.man:
    * NEWS: Document it.
---
 ChangeLog                  | 17 +++++++++++++++++
 NEWS                       |  2 +-
 src/roff/nroff/nroff.1.man |  3 ++-
 src/roff/nroff/nroff.sh    |  4 ++--
 4 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index d817cbe..8d1e6b7 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,22 @@
 2021-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       [nroff]: Support groff's -R flag to run refer(1).
+
+       There's no reason not to support calling `refer` with nroff-mode
+       documents; typographically, it's less demanding than tbl(1).
+       GNU troff(1) supports an incompatible `-R` flag to suppress the
+       reading of troffrc{,-end} files, but this is likely not the `-R`
+       that users will want--it is most useful for troubleshooting
+       troff, and nroff already unconditionally loads a macro file
+       {tty-char.tmac}.
+
+       * src/roff/nroff/nroff.sh: Do it.
+
+       * src/roff/nroff/nroff.1.man:
+       * NEWS: Document it.
+
+2021-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        * tmac/tmac.am (tmac/groff_man.7.man,
        tmac/groff_man_style.7.man): Be quieter by default; use
        $(AM_V_GEN) more consistently with the rest of the build.
diff --git a/NEWS b/NEWS
index e18186c..645c032 100644
--- a/NEWS
+++ b/NEWS
@@ -87,7 +87,7 @@ o The new option -V emits the constructed groff command that 
nroff would
   this is a historical deficiency of the Bourne shell family not yet
   corrected by the POSIX standard.
 
-o nroff now recognizes the -b, -E, -k, -K, and -z options and passes
+o nroff now recognizes the -b, -E, -k, -K, -R, and -z options and passes
   them through to groff.
 
 o nroff now supports whitespace between option flag letters and option
diff --git a/src/roff/nroff/nroff.1.man b/src/roff/nroff/nroff.1.man
index 327c978..637ba6f 100644
--- a/src/roff/nroff/nroff.1.man
+++ b/src/roff/nroff/nroff.1.man
@@ -35,7 +35,7 @@
 .\" ====================================================================
 .
 .SY @g@nroff
-.RB [ \-bcCEhikpStUVz ]
+.RB [ \-bcCEhikpRStUVz ]
 .RB [ \-d\~\c
 .IR cs ]
 .RB [ \-d\~\c
@@ -185,6 +185,7 @@ The options
 .BR \-K ,
 .BR \-p ,
 .BR \-P ,
+.BR \-R ,
 .BR \-t ,
 and
 .B \-S
diff --git a/src/roff/nroff/nroff.sh b/src/roff/nroff/nroff.sh
index a1d752e..231292d 100644
--- a/src/roff/nroff/nroff.sh
+++ b/src/roff/nroff/nroff.sh
@@ -49,7 +49,7 @@ do
     -[dKmMnoPrTwW])
       is_option_argument_pending=yes
       opts="$opts $arg" ;;
-    -[bCEikpStUz] | -[dKMmrnoPwW]*)
+    -[bCEikpRStUz] | -[dKMmrnoPwW]*)
       opts="$opts $arg" ;;
     -T*)
       Topt=$arg ;;
@@ -68,7 +68,7 @@ do
       opts="$opts $arg" ;;
     --help)
       cat <<EOF
-usage: $prog [-bcCEhikpStUVz] [-dCS] [-dNAME=STRING] [-Karg] [-mNAME]\
+usage: $prog [-bcCEhikpRStUVz] [-dCS] [-dNAME=STRING] [-Karg] [-mNAME]\
  [-Mdir] [-nNUM] [-oLIST] [-Parg] [-rCN] [-rREG=EXPR] [-Tdev] [-wNAME]\
  [-Wname] [FILE ...]
 usage: $prog {--help | -v | --version}