gbranden pushed a commit to branch master
in repository groff.
commit d046a3cc173c30a0ab9f19c09d752d228b8cb477
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon May 25 13:50:26 2026 -0500
[doc,man]: Revise description of `\N` escape seq.
---
doc/groff.texi.in | 35 ++++++++++++++++++++---------------
man/groff.7.man | 14 +++++++++++++-
2 files changed, 33 insertions(+), 16 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 1ad3b1e57..544968d7d 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -13927,23 +13927,31 @@ request.@footnote{@xref{Debugging}.}
@cindex numbered glyph, accessing (@code{\N})
@cindex glyph, numbered, accessing (@code{\N})
@cindex @code{char} request, used with @code{\N}
-@cindex Unicode
-Format indexed character numbered
+The
+@code{\N}
+@dfn{indexed character}
+escape sequence formats the glyph indexed
@var{n}
-in the current font
-(@code{n}@tie{}is
-@emph{not}
-the input character code).
+in the current font.
@var{n}@tie{}can
be any non-negative decimal integer.
-Most devices number glyphs with codes between 0 and@tie{}255 only;
+If the current font lacks a glyph with that index,
+the formatter does
+@emph{not}
+search special fonts.
+The formatter does not apply kerning to glyphs accessed with
+@code{\N}.
+The delimiter need not be a neutral apostrophe;
+recall @ref{Delimiters}.
+@var{n}@tie{}is
+not necessarily the input character code;
+use the Unicode form of special character escape sequence shown above
+to access glyphs by their character encoding.
+Most devices number glyphs with indices between 0 and@tie{}255 only;
the
@code{utf8}
-output device uses codes in the range 0--65535.
-If the current font does not contain a glyph with that code,
-special fonts are
-@emph{not}
-searched.
+output device uses indices in the range 0--65535.
+
The
@code{\N}
escape sequence can be conveniently used in conjunction with the
@@ -13962,9 +13970,6 @@ The code of each glyph is given in the fourth column in
the font
description file after the @code{charset} command. It is possible to
include unnamed glyphs in the font description file by using a name of
@samp{---}; the @code{\N} escape sequence is the only way to use these.
-
-No kerning is applied to glyphs accessed with @code{\N}. The delimiter
-need not be a neutral apostrophe; see @ref{Delimiters}.
@endDefesc
A few escape sequences are also special characters.
diff --git a/man/groff.7.man b/man/groff.7.man
index 21a1384b8..c59cf739a 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6493,10 +6493,22 @@ Interpolate value of register with arbitrarily long
.
.TP
.ESCq N n
-Format indexed character numbered
+Format the glyph indexed
.I n
in the current font.
.
+.IR n \~can
+be any non-negative decimal integer.
+.
+If the current font lacks a glyph with that index,
+the formatter does
+.I not
+search special fonts.
+.
+The formatter does not apply kerning to glyphs accessed with
+.BR \[rs]N .
+.
+.
.TP
.ESCq o abc\f[R].\|.\|.\f[]
Overstrike centered glyphs of characters
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
