gbranden pushed a commit to branch master
in repository groff.
commit 765b7ed5645c8fcb2b000a4e44b77adccfb3385f
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Tue Jun 3 05:44:41 2025 -0500
doc/*,man/*: Recast font selection material.
---
doc/groff.texi.in | 42 +++++++++++++++++++++++++++++++---------
man/groff.7.man | 58 ++++++++++++++++++++++++++++++++++++++-----------------
2 files changed, 73 insertions(+), 27 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 421fde3ee..8ce57e42a 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -10812,7 +10812,6 @@ typeface: by its mounting position (@samp{3}), by its
identifier
(@samp{TB}), or by an abstract style (@samp{B}) to be combined with the
default family.
-@c TODO: Add requests `pft`, `rft`?
@DefreqList {ft, [@Var{font}]}
@DefescItemx {\\f, , f, }
@DefescItem {\\f, (, fn, }
@@ -10829,19 +10828,43 @@ default family.
@cindex selecting the previous font (@code{ft})
@cindex previous font, selecting (@code{ft})
@cindex font, previous, selecting (@code{ft})
-The @code{ft} request selects the typeface @var{font}.
+The
+@code{ft}
+request selects the typeface
+@var{font}.
If the argument is absent or
@samp{P},
it selects the previously used typeface;
if there is none,
the formatter ignores the request.
-If @var{font} is a non-negative
-integer, it is interpreted as a mounting position; the font mounted
-there is selected. If that position refers to an abstract style, it is
-combined with the default family (see @code{fam} and @code{\F} below) to
-make a resolved font name. If the mounting position is not a style and
-no font is mounted there, GNU @code{troff} emits a warning in category
-@samp{font} and ignores the request.
+If
+@var{font}
+is an integer,
+the formatter interprets it as a mounting position;
+the font mounted there is selected.
+If that position refers to an abstract style,
+GNU
+@command{troff} @c GNU
+combines it with the default family
+(see
+@code{fam}
+and
+@code{\F}
+below)
+to make a resolved font name.
+If
+@var{font}
+is
+@samp{DESC},
+if the mounting position is not an abstract style
+and no font is mounted there,
+or the mounting position is negative,
+GNU
+@command{troff} @c GNU
+ignores the request.@footnote{It also
+emits a warning in category @samp{font} or @samp{range},
+as appropriate.
+@xref{Warnings}.}
If @var{font} matches a style name, it is combined with the default
family to make a resolved font name. If not, @var{font} is assumed
@@ -11115,6 +11138,7 @@ it is selected; GNU @code{troff} will search
@env{GROFF_FONT_PATH} for
it by name and mount it at the first free position on demand.
@need 500
+@c TODO: Add request `rfp` to unmount a font?
@DefreqList {fp, pos id [@Var{font-description-file-name}]}
@DefregItemx {.f}
@DefregListEndx {.fp}
diff --git a/man/groff.7.man b/man/groff.7.man
index d9801859a..df8ed8840 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3506,27 +3506,49 @@ request.
.REQ .ft
.TQ
.REQ ".ft P"
-Select previous font mounting position
-(abstract style or font);
-same as
-.esc f[]
-or
-.esc fP .
+Select the typeface
+.I font.
.
-.TPx
-.REQ .ft font
-Select typeface
-.I font,
-a mounting position,
-abstract style,
-or font name;
-same as
-.esc[] f font
-escape sequence.
+If
+.I font
+is an integer,
+the formatter interprets it as a mounting position;
+the font mounted there is selected.
+.
+If that position refers to an abstract style,
+GNU
+.I troff \" GNU
+combines it with the default family
+(see
+.B fam
+above and
+.B \[rs]F
+below)
+to make a resolved font name.
.
+If
.I font
-cannot be
-.BR P .
+is
+.RB \[lq] DESC \[rq],
+if the mounting position is not an abstract style
+and no font is mounted there,
+or the mounting position is negative,
+GNU
+.I troff \" GNU
+ignores the request.
+.
+(It also
+emits a warning in category
+.RB \[lq] font \[rq],
+or
+.RB \[lq] range \[rq],
+as appropriate.
+.
+See section \[lq]Warnings\[rq] in
+.MR @g@troff @MAN1EXT@ .)
+.
+Also see
+.B \[rs]f .
.
.TPx
.REQ .ftr f
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
