[groff] 10/41: [docs]: Tweak descriptions of \[`'-_] escapes.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 6b16274a7bce0617b030e7210d887370ef8bc926
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Mar 4 09:18:17 2022 +1100

    [docs]: Tweak descriptions of \[`'-_] escapes.
    
    Emphasize their synonymy with more regularly spelled special character
    escape sequences.  Shift name of \[ul] from "underline" to "underrule",
    (like "baseline rule" and "box rule") emphasizing its drawn, non-glyph
    nature on typesetter devices.
---
 doc/groff.texi  | 15 +++++++++------
 man/groff.7.man | 10 +++++-----
 2 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index dd372ff7..18ba5979 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -10287,23 +10287,26 @@ No kerning is applied to glyphs accessed with 
@code{\N}.
 Some escape sequences directly map onto special glyphs.
 
 @Defesc {\@code{'}, , , }
-This is a backslash followed by the apostrophe character,
+A backslash followed by the apostrophe character,
 @acronym{ASCII} character @code{0x27} (@acronym{EBCDIC} character
-@code{0x7D}).  The same as @code{\[aa]}, the acute accent.
+@code{0x7D}), is a synonym for @code{\[aa]}, the acute accent.
 @endDefesc
 
 @Defesc {\@code{`}, , , }
-This is a backslash followed by @acronym{ASCII} character @code{0x60}
-(@acronym{EBCDIC} character @code{0x79} usually).  The same as
+A backslash followed by @acronym{ASCII} character @code{0x60}
+(@acronym{EBCDIC} character @code{0x79} [usually]), is a synonym for
 @code{\[ga]}, the grave accent.
 @endDefesc
 
 @Defesc {\\-, , , }
-This is the same as @code{\[-]}, the minus sign in the current font.
+A backslash followed by a dash is a synonym for @code{\[-]}, the minus
+sign.
 @endDefesc
 
 @Defesc {\\_, , , }
-This is the same as @code{\[ul]}, the underline character.
+A backslash followed by an underscore is a synonym for @code{\[ul]}, the
+underrule.  On @code{troff}-mode (typesetter) devices it may be
+font-invariant and drawn lower than the underscore glyph @samp{_}.
 @endDefesc
 
 @Defreq {cflags, n c1 c2 @dots{}}
diff --git a/man/groff.7.man b/man/groff.7.man
index 2d92dc92..31871517 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3486,30 +3486,30 @@ request.
 .
 .TP
 .ESC \[aq]
-Translates to
+is a synonym for
 .esc [aa] ,
 the acute accent special character.
 .
 .
 .TP
 .ESC \[ga]
-Translates to
+is a synonym for
 .esc [ga] ,
 the grave accent special character.
 .
 .
 .TP
 .ESC \-
-Translates to
+is a synonym for
 .esc [\-] ,
 the minus sign special character.
 .
 .
 .TP
 .ESC _
-Translates to
+is a synonym for
 .esc [ul] ,
-the underline special character.
+the underrule special character.
 .
 .
 .TP