[groff] 06/18: [docs]: Adopt a terminological reform.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9bf77f6fd0b5d6a4effcf2871bb0139dccb58d1e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Aug 17 06:47:19 2021 +1000

    [docs]: Adopt a terminological reform.
    
    "input level" -> "interpolation depth"
    
    Leave behind "input level" only in ChangeLog entries and concept index
    items in our Texinfo manual.
---
 NEWS                 |  2 +-
 doc/groff.texi       | 15 +++++++++------
 man/groff_diff.7.man | 20 ++++++++++----------
 src/roff/troff/TODO  |  5 +++--
 4 files changed, 23 insertions(+), 19 deletions(-)

diff --git a/NEWS b/NEWS
index 9dbb039..2b29d2d 100644
--- a/NEWS
+++ b/NEWS
@@ -2788,7 +2788,7 @@ Troff
 -----
 
 In long escape names the closing ] is now required to be at the same
-input level as the opening [.
+interpolation depth as the opening [.
 
 The \A'S' escape sequence returns 1 or 0 according as S is or is not
 suitable for use as a name.
diff --git a/doc/groff.texi b/doc/groff.texi
index fb999dd..6bdbc9d 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -6067,8 +6067,10 @@ yy: `A' `test with "quotes"' `.'
 @noindent
 @cindex input level
 @cindex level, input
-since GNU @code{troff} preserves the @dfn{input level}; that is, the
-nesting depth of interpolations.
+@cindex interpolation depth
+@cindex depth, interpolation
+since GNU @code{troff} tracks the nesting depth of
+interpolations.
 
 @item
 Use the double-quote glyph @code{\(dq}.  This works with and without
@@ -12412,8 +12414,8 @@ example, to pass the arguments along to another macro). 
 The @code{\$*}
 escape concatenates all the arguments separated by spaces.  A similar
 escape is @code{\$@@}, which concatenates all the arguments with each
 surrounded by double quotes, and separated by spaces.  If not in
-compatibility mode, the input level of double quotes is preserved
-(@pxref{Request and Macro Arguments}).
+compatibility mode, the interpolation depth of double quotes is
+preserved (@pxref{Request and Macro Arguments}).
 @endDefesc
 
 @Defesc {\\$^, , , }
@@ -15764,9 +15766,10 @@ may exist, using any valid identifiers for their names
 (@pxref{Identifiers}.)
 
 @cindex input level in delimited arguments
+@cindex interpolation depth in delimited arguments
 @cindex delimited arguments, incompatibilities with @acronym{AT&T} @code{troff}
-Normally, GNU @code{troff} preserves the input level in delimited
-arguments, but not in compatibility mode.
+Normally, GNU @code{troff} preserves the interpolation depth in
+delimited arguments, but not in compatibility mode.
 
 @Example
 .ds xx '
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 7b3e5af..0d5e365 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4181,7 +4181,7 @@ between them.
 .
 .P
 In a string comparison in a condition,
-characters that appear at different input levels from the first
+characters that appear at different interpolation depths from the first
 delimiter character are not recognized as the second or third
 delimiters.
 .
@@ -4192,8 +4192,8 @@ request.
 In a
 .B \[rs]w
 escape sequence,
-a character that appears at a different input level from the starting
-delimiter character is not recognized as the closing delimiter
+a character that appears at a different interpolation depth from the
+starting delimiter character is not recognized as the closing delimiter
 character.
 .
 The same is true for
@@ -4210,24 +4210,24 @@ and
 .
 When decoding a macro or string argument that is delimited by double
 quotes,
-a character that appears at a different input level from the starting
-delimiter character is not recognized as the closing delimiter
+a character that appears at a different interpolation depth from the
+starting delimiter character is not recognized as the closing delimiter
 character.
 .
 The implementation of
 .B \[rs]$@
 ensures that the double quotes surrounding an argument appear at the
-same input level,
-which is differs from the input level of the argument itself.
+same interpolation depth,
+which is differs from the depth of the argument itself.
 .
 In a long escape name
 .B ]
 is not recognized as a closing delimiter except when it occurs at
-the same input level as the
+the same interpolation depth as the
 .RB opening\~ [ .
 .
 In compatibility mode,
-no attention is paid to the input level.
+no attention is paid to the interpolation depth.
 .
 .
 .P
@@ -4924,7 +4924,7 @@ using any valid identifiers for their names.
 .P
 Normally,
 .I groff
-preserves the input level in delimited arguments,
+preserves the interpolation depth in delimited arguments,
 but not in compatibility mode.
 .
 For example,
diff --git a/src/roff/troff/TODO b/src/roff/troff/TODO
index 630113f..60fe79c 100644
--- a/src/roff/troff/TODO
+++ b/src/roff/troff/TODO
@@ -40,7 +40,8 @@ and has a non-zero hyphen-type. Then we ought to be able to 
hyphenate,
 but we won't be able to because we will look for the hyphen only in
 font S and not in font R.
 
-Perhaps the current input level should be accessible in a number register.
+Perhaps the current interpolation depth should be accessible in a number
+register.
 
 Should \w deal with a newline like \X?
 
@@ -107,7 +108,7 @@ to the environment from the environment table, environment 
dictionary
 or environment stack.)
 
 Perhaps in the nr request a leading '-' should only be recognized as a
-decrement when it's at the same input level as the request.
+decrement when it's at the same interpolation depth as the request.
 
 Don't ever change a charinfo.  Create new variants instead and chain
 them together.