[groff] 18/26: doc/groff.texi: Fix content, style, markup nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 8367785a19d19f9608b4bae57b240448bdc1a039
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Nov 13 07:05:12 2021 +1100

    doc/groff.texi: Fix content, style, markup nits.
    
    Content:
    * Rename node "Escape Index" to "Escape Sequence Index".
    * Revise introduction to that index: an "escape sequence...not in the
      list below" is not an escape sequence, but merely an input token.
      Further, the two items \\ and \. are not escape sequences either, but
      _do_ receive special handling, so they warrant placement here.
    
    Style:
    * Use Texinfo @xref command instead of "See @ref"; that's what it's for.
    
    Markup:
    * Set "(unary)" in roman in the index when applied to operators.
---
 doc/groff.texi | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index f20a892..8ac1702 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -452,7 +452,7 @@ developing GNU and promoting software freedom.''
 * Installation::
 * Copying This Manual::
 * Request Index::
-* Escape Index::
+* Escape Sequence Index::
 * Operator Index::
 * Register Index::
 * Macro Index::
@@ -5695,8 +5695,8 @@ be expected.
 @cindex @code{-}, and page motion
 @cindex motion operators
 @cindex operators, motion
-@opindex + (unary)
-@opindex - (unary)
+@opindex + @r{(unary)}
+@opindex - @r{(unary)}
 For many requests that cause a motion on the page, the unary operators
 @samp{+} and @samp{-} work differently if leading an expression.  They
 then indicate a motion relative to the current position (down or up,
@@ -7207,7 +7207,7 @@ the @code{fi} request.
 Enable filling of output lines; a pending output line is broken.  The
 read-only register @code{.u} is set to@tie{}1.  The filling enablement
 status, sometimes called @dfn{fill mode}, is associated with the
-environment (@pxref{Environments}).  See @ref{Line Continuation}, for
+environment (@pxref{Environments}).  @xref{Line Continuation}, for
 interaction with the @code{\c} escape.
 @endDefreq
 
@@ -18430,7 +18430,7 @@ for@tie{}@var{n}.
 @codequotebacktick on
 @codequoteundirected on
 
-@node Request Index, Escape Index, Copying This Manual, Top
+@node Request Index, Escape Sequence Index, Copying This Manual, Top
 @appendix Request Index
 
 Requests appear without the leading control character (normally either
@@ -18443,11 +18443,11 @@ Requests appear without the leading control character 
(normally either
 @c =====================================================================
 @c =====================================================================
 
-@node Escape Index, Operator Index, Request Index, Top
-@appendix Escape Index
+@node Escape Sequence Index, Operator Index, Request Index, Top
+@appendix Escape Sequence Index
 
-Any escape sequence @code{\@var{X}} with @var{X} not in the list below
-emits a warning, printing glyph @var{X}.
+Any token @code{\@var{X}} with @var{X} not in the list below emits a
+warning and interpolates glyph @var{X}.
 
 @printindex es
 
@@ -18456,7 +18456,7 @@ emits a warning, printing glyph @var{X}.
 @c =====================================================================
 @c =====================================================================
 
-@node Operator Index, Register Index, Escape Index, Top
+@node Operator Index, Register Index, Escape Sequence Index, Top
 @appendix Operator Index
 
 @printindex op