[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: doc/groff.texi: Fix error in .rfschar description.
From: |
G. Branden Robinson |
Subject: |
[groff] 01/01: doc/groff.texi: Fix error in .rfschar description. |
Date: |
Thu, 16 Jul 2020 06:52:16 -0400 (EDT) |
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,
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: doc/groff.texi: Fix error in .rfschar description.,
G. Branden Robinson <=