gbranden pushed a commit to branch master
in repository groff.
commit 61e593a5478a76cd9e626cc953b4b0cee0b3de5d
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Apr 27 01:28:15 2026 -0500
[doc,man]: Update description of `fzoom` request.
Also favor footnotes over inlining for forward references.
---
doc/groff.texi.in | 26 +++++++++++++++++++-------
man/groff.7.man | 42 +++++++++++++++++++++++++++++++-----------
man/groff_diff.7.man | 12 +++++++-----
3 files changed, 57 insertions(+), 23 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 093133415..a90f22095 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12736,12 +12736,24 @@ request.@footnote{@xref{Debugging}.}
@cindex optical size of a font, setting the (@code{fzoom})
@cindex font, optical size, setting (@code{fzoom})
@cindex size, optical, of a font, setting (@code{fzoom})
-Set magnification of mounted @var{font} to factor @var{zoom}, a
-multiplier applied to the type size in thousandths. @var{zoom} must be
-non-negative. @code{fzoom} applies to glyphs when they are formatted,
-altering a font's apparent size in relation to others. A missing or
-zero @var{zoom} is treated as @samp{1000}---no magnification.
-@var{font} must be a resolved font name, not an abstract style.
+Set magnification of
+@var{font}
+to factor
+@var{zoom},
+a multiplier applied to the type size in thousandths.
+@var{zoom}
+must be non-negative.
+@code{fzoom}
+applies to glyphs when they are formatted,
+altering a font's apparent size in relation to others.
+If
+@var{zoom}
+is missing or equal to zero or 1000,
+@var{font}
+is not magnified.
+@var{font}
+must be a resolved font name,
+not an abstract style or a mounting position.
Font magnification is transparent to some aspects of GNU @code{troff}.
A change of the zoom factor affects scaling of glyph sizes, inter-word
@@ -12752,7 +12764,7 @@ supplemental inter-sentence space sizes. It @emph{is}
reflected in
measurements of formatted output:@: the horizontal drawing position
register @code{hp}, interpolation of the @code{\w} escape sequence, and
the registers updated by that escape sequence or the formatting of a
-glyph in the environment. @xref{Environments}.
+glyph in the environment.@footnote{@xref{Environments}.}
@code{fzoom} can harmonize the apparent cap-heights of fonts from
different families when formatted on the same baseline at the same type
diff --git a/man/groff.7.man b/man/groff.7.man
index 9b042784b..093376a59 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3929,19 +3929,39 @@ to
.IR font2 .
.
.TPx
-.REQ .fzoom font\~\f[B]0\f[]
-Stop magnifying font
-.IR font .
+.REQ .fzoom f
+.TQ
+.REQ .fzoom f\~\f[B]0\f[]
+.TQ
+.REQ .fzoom f\~\f[B]1000\f[]
+Stop magnifying
+.RI font\~ f .
+.
+.IR f \~must
+be a resolved font name,
+not an abstract style or mounting position.
.
.TPx
-.REQ .fzoom "font zoom"
-Set magnification of mounted
-.I font
-to
-.IR zoom ,
-a multiplier of the current type size in thousandths
-(default:
-1000).
+.REQ .fzoom "f zoom"
+Set zoom factor
+.I zoom
+for
+.RI font\~ f .
+.
+.I zoom
+must be a non-negative integer;
+it scales the magnification by thousandths with 1000 as a default.
+.
+.I zoom
+must be non-negative.
+.
+.B fzoom
+applies to glyphs when they are formatted,
+altering a font's apparent size in relation to others.
+.
+.IR f \~must
+be a resolved font name,
+not an abstract style or a mounting position.
.
.TPx
.REQ .gcolor
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index fa4a218be..ae05b8948 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3302,19 +3302,21 @@ is not translated.
.RI [ zoom ]
Set zoom factor
.I zoom
-for font\~\c
+for
+.RI font\~ f .
.IR f .
.I zoom
must be a non-negative integer;
-it scales the magnification by thousandths with 1000 as a basis.
+it scales the magnification by thousandths with 1000 as a default.
+.
If
.I zoom
is missing or equal to zero or 1000,
-.RI font\~ f
+.I f
is not magnified.
.
-.IR f \~\c
-must be a resolved font name,
+.IR f \~must
+be a resolved font name,
not an abstract style or mounting position.
.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
