gbranden pushed a commit to branch master
in repository groff.
commit 1c56bcaa1dcabe0952d4a73480254552508e714f
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Mar 28 14:15:00 2026 -0500
[doc,man]: Update discussion of `.fp` register.
Also reward students who paid attention to analysis of algorithms with a
footnote/parenthetical.
---
doc/groff.texi.in | 34 +++++++++++++++++++++++++++-------
man/groff_diff.7.man | 37 +++++++++++++++++++++++++++----------
2 files changed, 54 insertions(+), 17 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 08b0fc011..376bc0dd7 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12671,14 +12671,34 @@ use.
@endExample
@cindex next free font position register (@code{.fp})
-The index of the next (non-zero) free font position is available in the
-read-only register @samp{.fp}.
+The index of the next (non-zero) free font position
+is available in the read-only register
+@samp{.fp}.
@cindex @file{DESC} file, and font mounting
-Fonts not listed in the @file{DESC} file are automatically mounted at
-position @samp{\n[.fp]} when selected with the @code{ft} request or
-@code{\f} escape sequence. When mounting a font at a position
-explicitly with the @code{fp} request, this same practice should be
-followed, although GNU @code{troff} does not enforce this strictly.
+When using the
+@code{ft}
+request or
+@code{\f}
+escape sequence
+to select a font by name that is not listed in the device's
+@file{DESC}
+file,
+GNU
+@command{troff} @c GNU
+automatically mounts it
+at position
+@samp{\n[.fp]}.
+If you mount a font at a position explicitly
+with the
+@code{fp}
+request,
+you should follow the same practice,
+though the program
+does not strictly enforce adherence.@footnote{GNU
+@command{troff} @c GNU
+looks up fonts by name with a search that is
+O(@var{n})
+in the length of the dynamically sized mounting position list.}
@endDefreq
@c ---------------------------------------------------------------------
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index bb42b1638..ffe2647a0 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -5608,20 +5608,37 @@ to behave in ways difficult to predict.
.SS Miscellaneous
.\" ====================================================================
.
-A font not listed in the output device's
+The index of the next (non-zero) free font position
+is available in the read-only register
+.BR .fp .
+.
+When using the
+.B ft
+request or
+.B \[rs]f
+escape sequence
+to select a font by name that is not listed in the device's
.I DESC
-file's
-.B fonts
-directive is automatically mounted at the next available font position
-when it is selected.
+file,
+GNU
+.I troff \" GNU
+automatically mounts it
+at position
+.RB \[lq] \[rs]n[.fp] \[rq].
.
-If you mount a font explicitly with the
+If you mount a font at a position explicitly
+with the
.B fp
request,
-you should do so on the first unused position,
-which can be found in the
-.B .fp
-register.
+you should follow the same practice,
+though the program
+does not strictly enforce adherence.
+.
+(GNU
+.I troff \" GNU
+looks up fonts by name with a search that is
+.RI O( n )
+in the length of the dynamically sized mounting position list.)
.
.
.P
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
