[groff] 11/60: Migrate to device extension [command] terminology.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0cdb5aa785cadc06f768747253ac832fb8a09945
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Sep 8 05:25:35 2024 -0500

    Migrate to device extension [command] terminology.
    
    * src/devices/grodvi/grodvi.1.man:
    * src/devices/gropdf/gropdf.1.man:
    * src/devices/grops/grops.1.man:
    * src/devices/grotty/grotty.1.man: Do it.
    
    * tmac/tests/an_MR-works.sh: Update test output.
---
 ChangeLog                                             | 11 +++++++++++
 src/devices/grodvi/grodvi.1.man                       |  6 +++---
 src/devices/gropdf/gropdf.1.man                       | 19 ++++++++++---------
 src/devices/grops/grops.1.man                         |  6 +++---
 src/devices/grotty/grotty.1.man                       |  4 ++--
 src/devices/xditview/parse.c                          |  4 ++--
 src/libs/libdriver/input.cpp                          |  4 ++--
 .../device-control-escapes-express-basic-latin.sh     |  2 +-
 tmac/groff_man.7.man.in                               |  4 ++--
 tmac/pdf.tmac                                         |  2 +-
 tmac/tests/an_MR-works.sh                             |  4 ++--
 11 files changed, 39 insertions(+), 27 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 92ae61a34..59de709f5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2024-09-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       Migrate to "device extension [command]" terminology.
+
+       * src/devices/grodvi/grodvi.1.man:
+       * src/devices/gropdf/gropdf.1.man:
+       * src/devices/grops/grops.1.man:
+       * src/devices/grotty/grotty.1.man: Do it.
+
+       * tmac/tests/an_MR-works.sh: Update test output.
+
 2024-09-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [troff]: Trivially refactor and reform terminology.  Call `\X`
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index f0432de06..ae52f8f40 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -190,7 +190,7 @@ By design,
 the DVI format doesn't care about the physical dimensions of the output
 medium.
 .
-See subsection \[lq]Device control commands\[rq] below.
+See subsection \[lq]Device extension commands\[rq] below.
 .
 .
 .\" ====================================================================
@@ -348,7 +348,7 @@ does not set up automatic hyphenation codes.
 .
 .
 .\" ====================================================================
-. SS "Device control commands"
+. SS "Device extension commands"
 .\" ====================================================================
 .
 .I grodvi
@@ -367,7 +367,7 @@ special is output.
 .
 .P
 .I grodvi
-supports one device control function,
+supports one device extension,
 accessed with the
 .I groff
 request
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 5f3f39d15..3b4f09c1e 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -185,7 +185,7 @@ Search the directory
 .I dir
 for files named in
 .B \[rs]X\[aq]pdf: pdfpic\[aq]
-device control commands.
+device extension commands.
 .
 .B \-I
 may be specified more than once;
@@ -687,7 +687,7 @@ the \[lq]hand pointing left\[rq] glyph
 is available nevertheless,
 since it is defined using the
 .B \[rs]X\[aq]pdf: xrev\[aq]
-device control command
+device extension command
 (see below).
 .
 Most glyphs in these fonts are unnamed and must be accessed using
@@ -703,11 +703,11 @@ file.
 .
 .
 .\" ====================================================================
-. SS "Device control commands"
+. SS "Device extension commands"
 .\" ====================================================================
 .
 .I gropdf
-supports many device control functions,
+supports many device extensions,
 accessed with the
 .I groff
 request
@@ -719,7 +719,7 @@ escape sequence.
 .
 First,
 it
-understands many of the device control commands supported by
+understands many of the device extensions supported by
 .MR grops 1 .
 .
 .
@@ -891,7 +891,7 @@ tags are silently ignored.
 .
 .LP
 .I gropdf
-also recognizes a device control command used by the DVI driver.
+also recognizes a device extension used by the DVI driver.
 .
 .
 .TP
@@ -922,7 +922,7 @@ option.
 .
 .LP
 .I gropdf
-supports several more device control features using the
+supports several more device extensions using the
 .B pdf:
 tag.
 .
@@ -1032,7 +1032,7 @@ otherwise any text output by the trap will be marked as 
part of the hot
 spot.
 .
 To prevent this error,
-place these device control commands or their corresponding
+place these device extension escape sequences or their corresponding
 convenience macros
 .B \%.pdfmarksuspend
 and
@@ -1499,7 +1499,8 @@ support macros in
 .I pdf\.tmac
 define the convenience macros described above.
 .
-Some features have no direct device control command counterpart.
+Some features have no direct device extension escape sequence
+counterpart.
 .
 .
 .\" pdfhref
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 730d46700..dcd470156 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -888,11 +888,11 @@ file.
 .
 .
 .\" ====================================================================
-.SS "Device control commands"
+.SS "Device extension commands"
 .\" ====================================================================
 .
 .I grops
-recognizes device control commands produced by the
+recognizes device extension commands produced by the
 .B \[rs]X
 escape sequence,
 but interprets only those that begin with a
@@ -1222,7 +1222,7 @@ has been defined via a
 .RB \[lq] "ps: def" \[rq]
 or
 .RB \[lq] "ps: mdef" \[rq]
-device control command,
+device extension command,
 it is executed at the beginning of every page
 (before anything is drawn or written by
 .IR groff ).
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 332ed0659..8dca55c0d 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -286,11 +286,11 @@ There is therefore no need to filter its output through
 .
 .
 .\" ====================================================================
-.SS "Device control commands"
+.SS "Device extension commands"
 .\" ====================================================================
 .
 .I grotty
-supports a device control command accessed with the
+supports a device extension command accessed with the
 .RB \%\[lq] device \[rq]
 request or
 .B \[rs]X
diff --git a/src/devices/xditview/parse.c b/src/devices/xditview/parse.c
index 2c6b48e69..861a88b01 100644
--- a/src/devices/xditview/parse.c
+++ b/src/devices/xditview/parse.c
@@ -152,12 +152,12 @@ ParseInput(register DviWidget dw)
                        HorizontalGoto(dw, 0);
                        break;
                case 'F':       /* input files */
-               case '+':       /* continuation of X device control */
+               case '+':       /* continuation of X device extension */
                case 'm':       /* color */
                case '#':       /* comment */
                        GetLine(dw, NULL, 0);
                        break;
-               case 'x':       /* device control */
+               case 'x':       /* device extension */
                        ParseDeviceControl(dw);
                        break;
                case EOF:
diff --git a/src/libs/libdriver/input.cpp b/src/libs/libdriver/input.cpp
index 268469989..441e6817a 100644
--- a/src/libs/libdriver/input.cpp
+++ b/src/libs/libdriver/input.cpp
@@ -420,7 +420,7 @@ inline void unget_char(const Char);
 void parse_color_command(color *);
                                // color sub(sub)commands m and DF
 void parse_D_command(void);    // graphical subcommands
-bool parse_x_command(void);    // device controller subcommands
+bool parse_x_command(void);    // device control commands
 
 
 /**********************************************************************
@@ -1812,7 +1812,7 @@ do_file(const char *filename)
       break;
     case 'w':                  // w: inform about paddable space
       break;
-    case 'x':                  // device controlling commands
+    case 'x':                  // device control commands
       stopped = parse_x_command();
       break;
     default:
diff --git a/src/roff/groff/tests/device-control-escapes-express-basic-latin.sh 
b/src/roff/groff/tests/device-control-escapes-express-basic-latin.sh
index 387bdb6ad..83bc34d2f 100755
--- a/src/roff/groff/tests/device-control-escapes-express-basic-latin.sh
+++ b/src/roff/groff/tests/device-control-escapes-express-basic-latin.sh
@@ -22,7 +22,7 @@ groff="${abs_top_builddir:-.}/test-groff"
 fail=
 
 # Confirm translation of a groff special character escape sequence to a
-# basic Latin character when used in a device control escape sequence.
+# basic Latin character when used in a device extension escape sequence.
 #
 # $1 is the special character escape _without_ the leading backslash.
 # $2 is the expected output character _shell-quoted as necessary_.
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index f6c9795cb..16a822063 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1466,8 +1466,8 @@ and number signs in HTTP(S) URIs.
 _endif()dnl
 The formatter removes
 .B \e:
-escape sequences from hyperlinks when supplying device control commands
-to output drivers.
+escape sequences from hyperlinks when supplying device extension command
+arguments to output drivers.
 .
 .
 .TP
diff --git a/tmac/pdf.tmac b/tmac/pdf.tmac
index 74a0757eb..844bac1b7 100644
--- a/tmac/pdf.tmac
+++ b/tmac/pdf.tmac
@@ -698,7 +698,7 @@ am solely responsible for any bugs I may have introduced 
into this file.
 .\"
 .\" Does the user want to leave the mark hanging open (using the "-S"
 .\" flag)?  If so, it's their responsibility to close it by issuing the
-.\" "pdf: markend" device control command.
+.\" "pdf: markend" device extension command.
 .if \\n[pdf:href-S] \{\
 .  ie !'\\*[pdf:href-A]'' .pdf:error pdfhref flag '-S' cannot be used \
 with '-A' option
diff --git a/tmac/tests/an_MR-works.sh b/tmac/tests/an_MR-works.sh
index 924829669..77a8a9850 100755
--- a/tmac/tests/an_MR-works.sh
+++ b/tmac/tests/an_MR-works.sh
@@ -50,7 +50,7 @@ echo "$output"
 #   97  H912
 #   98  x X tty: link
 
-echo "checking for opening 'link' device control command" >&2
+echo "checking for opening 'link' device extension command" >&2
 echo "$output" | grep -Eq '91[[:space:]]+x X tty: link man:bar\(1\)$' \
     || wail
 
@@ -66,7 +66,7 @@ echo "$output" | grep -Eq '94[[:space:]]+f1' \
 echo "$output" | grep -Eq '95[[:space:]]+t\(1\)' \
     || wail
 
-echo "checking for closing 'link' device control command" >&2
+echo "checking for closing 'link' device extension command" >&2
 echo "$output" | grep -Eq '98[[:space:]]+x X tty: link$' \
     || wail