[groff] 14/17: [docs]: Continue terminological reform.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit fe5b849fa9a1be454864522332ad6679174e533a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Jun 7 16:53:51 2023 -0500

    [docs]: Continue terminological reform.
    
    ...from "real font name" to "resolved font name", and qualification of
    "style" with "abstract" when it is treated independently of the font
    family.
---
 NEWS                 |  4 ++--
 doc/groff.texi       |  6 +++---
 man/groff_diff.7.man | 23 +++++++++++------------
 3 files changed, 16 insertions(+), 17 deletions(-)

diff --git a/NEWS b/NEWS
index fb1388a11..740828e00 100644
--- a/NEWS
+++ b/NEWS
@@ -1924,8 +1924,8 @@ o It is now possible to have whitespace between the first 
and second dot
     .  !
     ..
 
-o `.fn' is a new string-valued register which returns the (internal)
-  real font name; styles and families are properly concatenated.
+o `.fn' is a new string-valued register that returns the resolved font
+  font name; a font family and abstract style are catenated.
 
 o Three new read/write registers `seconds', `minutes', and `hours'
   contain the current time, set at start-up of troff.  Use the `af'
diff --git a/doc/groff.texi b/doc/groff.texi
index fb8e7bea4..1d0202303 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -10294,7 +10294,6 @@ Font translations cannot be chained.
 @endExample
 @endDefreq
 
-@c TODO: Move `fzoom` to "Artificial Fonts"?
 @DefreqList {fzoom, f [@Var{zoom}]}
 @DefregListEndx {.zoom}
 @cindex magnification of a font (@code{fzoom})
@@ -10319,8 +10318,9 @@ Palatino and \f[CR]Courier\f[]
 @endExample
 
 A missing or zero value of @var{zoom} is the same as a value of 1000,
-which means no magnification.  @var{f}@tie{}must be a real font name,
-not a style.
+which means no magnification.  @var{f}@tie{}must be a resolved font
+name, not an abstract style.
+@c XXX: What about a mounting position?  It's not rejected...
 
 The magnification of a font is completely transparent to GNU
 @code{troff}; a change of the zoom factor doesn't cause any effect
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index e2aac847a..c10e42755 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -700,12 +700,13 @@ argument).
 .
 .
 .TP
-.BI \[rs]f[ xxx ]
-Select font
-.IR xxx ,
-which may be a font name,
-mounting position,
-or abstract style to select the typeface.
+.BI \[rs]f[ font ]
+Select
+.IR font ,
+which may be a mounting position,
+abstract style,
+or font name,
+to select the typeface.
 .
 .B \[rs]f[]
 is a synonym of
@@ -2503,7 +2504,9 @@ must a non-negative integer multiple of 1/1000th.
 If it is missing or is equal to zero, it means the same as 1000, namely
 no magnification.
 .IR f \~\c
-must be a real font name, not a style.
+must be a resolved font name,
+not an abstract style.
+.\" XXX: What about a mounting position?  It's not rejected...
 .
 .
 .TP
@@ -4102,14 +4105,10 @@ This is a string-valued register.
 .
 .TP
 .B \[rs]n[.fn]
-The current (internal) real font name.
+The resolved font name.
 .
 This is a string-valued register.
 .
-If the current font is a style, the value of
-.B \[rs]n[.fn]
-is the proper concatenation of family and style name.
-.
 .TP
 .B \[rs]n[.fp]
 The number of the next free font position.