[groff] 01/01: doc/groff.texi: Fix error in .rfschar description.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit ae31b006c81b5ccced7bec6acf74525c4ad93179
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jul 16 20:44:44 2020 +1000

    doc/groff.texi: Fix error in .rfschar description.
    
    ...which should refer to "font f" rather than "glyph f".  Thanks to Dave
    Kemper for the report and the patch.
    
    Fixes <https://savannah.gnu.org/bugs/index.php?58767>.
    
    And make some style tweaks in the neighborhood.
    
    * doc/groff.texi (Using Symbols): As above.  Also, recast to stop ending
      a sentence with an ellipsis, which I dislike.  Describe space among cn
      arguments as "optional", which is more idiomatic than saying that
      whitespace is "possible".
    
    * man/groff.7.man (.rfschar):
    * man/groff_diff.7.man (.rfschar): More closely parallelize with our
      Texinfo manual.
    
    * man/groff.7.man (.rfschar): And set ellipsis in roman, not italics.
      God, I hate that.  It's like the Ludovico Treatment.
    
    * tmac/groff_man.7.man: Add comments explaining deviation from
      non-quotation of escape sequences.
---
 ChangeLog            |  8 ++++++++
 doc/groff.texi       |  8 ++++----
 man/groff.7.man      |  7 +++----
 man/groff_diff.7.man | 16 +++++++++++-----
 tmac/groff_man.7.man |  4 ++++
 5 files changed, 30 insertions(+), 13 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 18ce4eb..1689026 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2020-07-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * doc/groff.texi (Using Symbols): Fix error in .rfschar
+       description, which should refer to "font f" rather than "glyph
+       f".  Thanks to Dave Kemper for the report and the patch.
+
+       Fixes <https://savannah.gnu.org/bugs/index.php?58767>.
+
 2020-07-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * tmac/groff_man.7.man (.EE, .YS): Fix error; refer to "initial
diff --git a/doc/groff.texi b/doc/groff.texi
index cb803df..5112c0a 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -9491,14 +9491,14 @@ request, but before the already mounted special fonts.
 @cindex removing glyph definition (@code{rchar}, @code{rfschar})
 @cindex glyph, removing definition (@code{rchar}, @code{rfschar})
 @cindex fallback glyph, removing definition (@code{rchar}, @code{rfschar})
-Remove the definitions of glyphs @var{c1}, @var{c2},@tie{}@enddots{}
-This undoes the effect of a @code{char}, @code{fchar}, or @code{schar}
+Remove the definitions of glyphs @var{c1}, @var{c2},@tie{}@dots{},
+undoing the effect of a @code{char}, @code{fchar}, or @code{schar}
 request.
 
-It is possible to omit the whitespace between arguments.
+Whitespace is optional between @var{cn}@tie{}arguments.
 
 The request @code{rfschar} removes glyph definitions defined with
-@code{fschar} for glyph@tie{}f.
+@code{fschar} for font@tie{}@var{f}.
 @endDefreq
 
 @xref{Special Characters}.
diff --git a/man/groff.7.man b/man/groff.7.man
index 61e5399..48c644b 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2357,12 +2357,11 @@ macro one level higher.
 .
 .TPx
 .REQ .rfschar "f c1 c2 \fR\&.\|.\|.\&\fP"
-Remove the definitions of entities
+Remove the font-specific definitions of glyphs
 .IR c1 ,
 .IR c2 ,
-\&.\|.\|.\&
-for font
-.IR f .
+\&.\|.\|.\& for
+.RB font\~ f .
 .
 .TPx
 .REQ .rj "n"
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 8f9c167..30d9e5d 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2578,14 +2578,20 @@ and from the macro one level higher.
 No effect otherwise.
 .
 .TP
-.BI .rfschar\~ "c1 c2 \*[ellipsis]"
+.BI .rfschar\~ "f c1 c2 "\c
+\*[ellipsis]
 Remove the font-specific definitions of glyphs
 .IR c1 ,
 .IR c2 ,
-.I \*[ellipsis]\~\"Add a sentence space
-This undoes the effect of an
-.B fschar
-request.
+\*[ellipsis] for
+.RB font\~ f .
+.
+Whitespace is optional between
+.IR cn \~arguments.
+.
+See
+.BR .fschar .
+.
 .
 .TP
 .B .rj
diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 75ae5f8..4b1dfd0 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -2123,6 +2123,8 @@ or
 .B .RI
 macros,
 you will need to manually add an italic correction escape
+.\" Normally we don't quote escapes, but these use potentially-confusing
+.\" prose punctuation.
 .RB \(lq \e/ \(rq,
 a GNU extension,
 before the
@@ -2213,6 +2215,8 @@ Style escapes may be more portable than
 .
 As shown above,
 it is up to you to account for italic corrections with
+.\" Normally we don't quote escapes, but these use potentially-confusing
+.\" prose punctuation.
 .RB \(lq \e/ \(rq
 and
 .RB \(lq \e, \(rq,