gbranden pushed a commit to branch master
in repository groff.
commit 61b1423689583668299ac8592f192f78b25b9a29
Author: Dave Kemper <[email protected]>
AuthorDate: Wed Apr 29 18:57:57 2026 +0000
[doc,man]: Fix Savannah #60233.
* doc/groff.texi.in (Ligatures and Kerning):
* man/groff.7.man (Request short reference):
* man/groff_diff.7.man (New requests): Clarify behavior of `tkf`
request.
[Also annotate a point I remain confused by. --GBR]
---
ChangeLog | 7 ++++++
doc/groff.texi.in | 61 +++++++++++++++++++++++++++++++++++++++-------------
man/groff.7.man | 25 +++++++++++++++++++--
man/groff_diff.7.man | 54 +++++++++++++++++++++++++++++++++++-----------
4 files changed, 117 insertions(+), 30 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 298bf1adc..84a3a072a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2026-04-29 Dave Kemper <[email protected]>
+
+ * doc/groff.texi.in (Ligatures and Kerning):
+ * man/groff.7.man (Request short reference):
+ * man/groff_diff.7.man (New requests): Clarify behavior of `tkf`
+ request.
+
2026-04-30 G. Branden Robinson <[email protected]>
[man]: Alter extension macro testing technique. What we had
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 9b6384341..3d355f989 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -14738,21 +14738,52 @@ the reader notices the effect.
@Defreq {tkf, f s1 n1 s2 n2}
@cindex activating track kerning (@code{tkf})
@cindex track kerning, activating (@code{tkf})
-Enable track kerning for font@tie{}@var{f}. If the current font
-is@tie{}@var{f} the width of every glyph is increased by an amount
-between @var{n1} and @var{n2} (@var{n1}, @var{n2} can be negative); if
-the current type size is less than or equal to @var{s1} the width is
-increased by @var{n1}; if it is greater than or equal to @var{s2} the
-width is increased by @var{n2}; if the type size is greater than or
-equal to @var{s1} and less than or equal to @var{s2} the increase in
-width is a linear function of the type size.
-
-The default scaling unit is @samp{z} for @var{s1} and @var{s2}, @samp{p}
-for @var{n1} and @var{n2}.
-
-The track kerning amount is added even to the rightmost glyph in a line;
-for large values it is thus recommended to increase the line length by
-the same amount to compensate.
+Enable track kerning for
+font@tie{}@var{f}.
+If the selected font
+is@tie{}@var{f},
+increase the advance width by an amount between
+@var{n1}
+and
+@var{n2}
+(each can be negative):@:
+if the type size is less than or equal to
+@var{s1},
+or if
+@var{s2}
+is less than or equal to
+@var{s1},
+the width increases by
+@var{n1};
+if the type size is greater than or equal to
+@var{s2},
+the width increases by
+@var{n2};
+otherwise,
+the advance width increase is a linear function of the type size.
+
+The default scaling unit is
+@samp{z}
+for
+@var{s1}
+and
+@var{s2},
+and
+@samp{p}
+for
+@var{n1}
+and
+@var{n2}.
+GNU
+@command{troff} @c GNU
+adds the track kerning amount even to the rightmost glyph in a line;
+for large
+@var{n1}
+and/or
+@var{n2},
+we thus recommend increasing the line length to compensate.
+@c XXX: Doesn't this depend on how many glyphs on the output line are
+@c affected, and the type sizes of each?
@endDefreq
@c ---------------------------------------------------------------------
diff --git a/man/groff.7.man b/man/groff.7.man
index 452d741ed..f6385d2ae 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5416,8 +5416,29 @@ Temporarily indent next output line
.
.TPx
.REQ .tkf "font s1 n1 s2 n2"
-Enable track kerning for
-.IR font .
+Enable track kerning for font
+.I font.
+If the selected font is
+.I font,
+increase the advance width by an amount between
+.I n1
+and
+.I n2
+(each can be negative):
+if the type size is less than or equal to
+.IR s1 ,
+or if
+.I s2
+is less than or equal to
+.IR s1 ,
+the width increases by
+.IR n1 ;
+if the type size is greater than or equal to
+.IR s2 ,
+the width increases by
+.IR n2 ;
+otherwise,
+the advance width increase is a linear function of the type size.
.
.TPx
.REQ .tl \f[B]\[aq]\f[]left\f[B]\[aq]\f[]center\f[B]\[aq]\f[]right\
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index f15888992..c771bcf5f 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4624,27 +4624,55 @@ request.
.
.TP
.BI .tkf\~ f\~s1\~n1\~s2\~n2
-Enable track kerning for font\~\c
-.IR f .
-When the current font is\~\c
-.IR f ,
-the width of every glyph is increased by an amount between
+Enable track kerning for
+.RI font\~ f.
+If the selected font
+.RI is\~ f,
+increase the advance width by an amount between
.I n1
and
-.IR n2 ;
-when the current type size is less than or equal to
+.I n2
+(each can be negative):
+if the type size is less than or equal to
+.IR s1 ,
+or if
+.I s2
+is less than or equal to
.IR s1 ,
-the width is increased by
+the width increases by
.IR n1 ;
-when it is greater than or equal to
+if the type size is greater than or equal to
.IR s2 ,
-the width is increased by
+the width increases by
.IR n2 ;
-when the type size is greater than or equal to
+otherwise,
+the advance width increase is a linear function of the type size.
+.
+.
+.IP
+The default scaling unit is
+.B z
+for
.I s1
-and less than or equal to
+and
.IR s2 ,
-the increase in width is a linear function of the type size.
+and
+.B p
+for
+.I n1
+and
+.IR n2 .
+.
+GNU
+.I troff \" GNU
+adds the track kerning amount even to the rightmost glyph in a line;
+for large
+.I n1
+and/or
+.IR n2 ,
+we thus recommend increasing the line length to compensate.
+.\" XXX: Doesn't this depend on how many glyphs on the output line are
+.\" affected, and the type sizes of each?
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
