gbranden pushed a commit to branch master
in repository groff.
commit 6d928aad7957b7a10b289822ce445e617a978c1b
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jun 19 11:16:33 2025 -0500
doc/*,man/*: Document `char` limitations.
Thanks to Dave Kemper for pointing out that user-defined characters
don't participate (at their boundaries) in kerning adjustments or italic
corrections.
Also align wording and input breaks between our Texinfo manual and
groff_diff(7).
See <https://savannah.gnu.org/bugs/?59932>.
---
doc/groff.texi.in | 38 ++++++++++++++++++++++++++++++--------
man/groff_diff.7.man | 8 ++++++++
2 files changed, 38 insertions(+), 8 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 292e55af4..0f31f62ac 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -11814,14 +11814,36 @@ glyphs in @var{contents}.
@c TODO: Document Peter Schaffter's diversion-as-character trick.
@c https://lists.gnu.org/archive/html/groff/2024-12/msg00085.html
-A character defined by these requests can be used just like a glyph
-provided by the output device. In particular, other characters can be
-translated to it with the @code{tr} or @code{trin} requests; it can be
-made the tab or leader fill character with the @code{tc} and @code{lc}
-requests, respectively; repeated patterns can be drawn with it using the
-@code{\l} and @code{\L} escape sequences; and words
-containing@tie{}@var{c} can be hyphenated correctly if the @code{hcode}
-request is used to give the object a hyphenation code.
+A character defined by these requests
+can be used just like a glyph provided by the output device.
+In particular,
+other characters can be translated to it with the
+@code{tr}
+and
+@code{trin} requests;
+it can be made the tab or leader fill character with the
+@code{tc}
+and
+@code{lc}
+requests,
+respectively;
+sequences of it can be drawn with the
+@code{\l}
+and
+@code{\L}
+escape sequences;
+and,
+if the
+@code{hcode}
+request is used on
+@var{c},
+it is subject to automatic hyphenation.
+
+However,
+a user-defined character
+@var{c}
+does not participate at its boundaries
+in kerning adjustments or italic corrections.
There is a special anti-recursion feature: use of the object within its
own definition is handled like a normal character (not
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index fa4eebccd..a9c73a51f 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2203,6 +2203,14 @@ it is subject to automatic hyphenation.
.
.
.IP
+However,
+a user-defined character
+.I c
+does not participate at its boundaries
+in kerning adjustments or italic corrections.
+.
+.
+.IP
To prevent infinite recursion,
occurrences of
.I c
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
