gbranden pushed a commit to branch master
in repository groff.
commit f9b67f86afe8cc03bc5dd4de68e1e6a7aa389e57
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Wed Feb 26 18:46:08 2025 -0600
[doc,man]: Improve explanation of "special" fonts.
---
doc/groff.texi.in | 13 ++++++++++---
man/groff_font.5.man | 10 ++++++++--
2 files changed, 18 insertions(+), 5 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index a1a89eaa0..779b99300 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -19705,9 +19705,16 @@ must not extend over more than one line.
@item special
@cindex special fonts
@kindex special
-The font is @dfn{special}:@: when a glyph is requested that is not
-present in the formatter's currently selected font, the glyph is sought
-in any mounted fonts that bear this property.
+The font is @dfn{special}:@:
+when the document attempts to format a glyph
+that is not present in the formatter's currently selected font,
+the glyph is sought in any mounted fonts that bear this property.
+Often,
+such fonts are
+@dfn{unstyled},
+having no heavy (bold) or oblique
+(slanted or italic)
+variants.
@end table
Other directives in this section are ignored by GNU
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index de1f1a33e..37e27aa19 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -676,9 +676,15 @@ The list of ligatures must not extend over more than one
line.
.B special
The font is
.IR special :
-when a glyph is requested that is not present in the formatter's
-currently selected font,
+when the document attempts to format a glyph
+that is not present in the formatter's currently selected font,
the glyph is sought in any mounted fonts that bear this property.
+Often,
+such fonts are
+.IR unstyled ,
+having no heavy (bold) or oblique
+(slanted or italic)
+variants.
.
.
.P
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
