gbranden pushed a commit to branch master
in repository groff.
commit ef86d30030ba4e6bc0d49f2f96773146d38f55ed
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun May 4 09:04:34 2025 -0500
man/*: Tidy up special font/character discussions.
* Clarify.
* Favor active voice over passive.
* Sync text between groff_diff(7) and groff(7).
---
man/groff.7.man | 57 +++++++++++++++++++++++++++++++++-------------------
man/groff_diff.7.man | 39 ++++++++++++++++++++---------------
2 files changed, 59 insertions(+), 37 deletions(-)
diff --git a/man/groff.7.man b/man/groff.7.man
index 605f81914..c40e2df38 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3413,11 +3413,13 @@ as
.
As
.request .char ,
-but a character defined by
+but GNU
+.I troff \" GNU
+locates a character defined by
.B fschar
-is located after the list of fonts declared with
+after any fonts named as arguments to the
.B \%fspecial
-is searched and before those declared with the
+are searched and before those named as arguments to the
.RB \%\[lq] special \[rq]
request.
.
@@ -3428,15 +3430,25 @@ Empty the list of fonts treated as special when
is selected.
.
.TPx
-.REQ .fspecial "font s1 s2 \fR\&.\|.\|.\&\fP"
+.REQ .fspecial "fnt sfnt \fR\&.\|.\|.\&\fP"
When
-.I font
+.RI font\~ fnt
is selected,
-treat the fonts
-.IR s1 ,
-.IR s2 ,
-\&.\|.\|.\&
-as special.
+treat each font
+.I sfnt
+as
+.I special;
+that is,
+search it for any glyph not found in
+.IR f .
+.
+GNU
+.I troff \" GNU
+searches fonts specified as arguments to the
+.RB \%\[lq] special \[rq]
+request after those given as arguments to the
+.B fspecial
+request.
.
.TPx
.REQ .ft
@@ -4507,11 +4519,13 @@ as
.IR contents .
.
As
-.request .char ,
-but a character defined with
+.BR char ,
+but GNU
+.I troff \" GNU
+locates a character defined with
.B schar
-is located after the list of fonts declared with the
-.request \%.special
+after any fonts named as arguments to the
+.RB \%\[lq] special \[rq]
request and before any mounted special fonts.
.
.TPx
@@ -4604,15 +4618,16 @@ is ignored inside a diversion.
.
.TPx
.REQ .special
-Reset global list of fallback special fonts to be empty.
+Empty the list of special fonts designated by this request
+when given arguments.
.
.TPx
-.REQ .special "s1 s2 \fR\&.\|.\|.\&\fR"
-Fonts
-.IR s1 ,
-.IR s2 ,
-etc.\& are special and are searched for glyphs not in the
-current font.
+.REQ .special "s \fR\&.\|.\|.\&\fP"
+Declare each font
+.I s
+as
+.I special,
+searching it for glyphs not found in the selected font.
.
.TPx
.REQ .spreadwarn
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 8fc96c0b5..02f2dc216 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2714,40 +2714,44 @@ as
.
As
.BR char ,
-but a character defined by
+but GNU
+.I troff \" GNU
+locates a character defined by
.B fschar
-is located after the list of fonts declared with
+after any fonts named as arguments to the
.B \%fspecial
-is searched and before those declared with the
+are searched and before those named as arguments to the
.RB \%\[lq] special \[rq]
request.
.
.TP
-.BI .fspecial\~ f\~\c
-.RI [ s\~ .\|.\|.]
+.BI .fspecial\~ fnt\~\c
+.RI [ sfnt\~ .\|.\|.]
When
-.RI font\~ f
+.RI font\~ fnt
is selected,
treat each font
-.I s
-as special;
+.I sfnt
+as
+.I special;
that is,
search it for any glyph not found in
.IR f .
.
-Fonts specified by the
+GNU
+.I troff \" GNU
+searches fonts specified as arguments to the
.RB \%\[lq] special \[rq]
-request are searched after those
-listed in the
+request after those given as arguments to the
.B fspecial
request.
.
Without
-.I s
+.I sfnt
arguments,
.B \%fspecial
empties the list of fonts treated as special when
-.I f
+.RI font\~ fnt
is selected.
.
.
@@ -3731,9 +3735,11 @@ as
.
As
.BR char ,
-but a character defined with
+but GNU
+.I troff \" GNU
+locates a character defined with
.B schar
-is located after the list of fonts declared with the
+after any fonts named as arguments to the
.RB \%\[lq] special \[rq]
request and before any mounted special fonts.
.
@@ -3825,7 +3831,8 @@ does not exist.
.IR s\~ .\|.\|.]
Declare each font
.I s
-as special,
+as
+.I special,
searching it for glyphs not found in the selected font.
.
Without arguments,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
