gbranden pushed a commit to branch master
in repository groff.
commit 74d1e81873274734a8d54314a6eb080329778164
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jan 4 03:36:16 2026 -0600
[doc,man]: Migrate `\w` to "input" term.
Expand description of escape sequence in groff(7), pulling material from
our Texinfo manul.
Also break input lines consistently between Texinfo and man pages.
Continues the long process of fixing Savannah #65976.
---
doc/groff.texi.in | 35 ++++++++++++++++++++++++++---------
man/groff.7.man | 20 ++++++++++++++++----
2 files changed, 42 insertions(+), 13 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index d16205f76..05a173357 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -16430,7 +16430,7 @@ Move right by the width of a numeral in the current
font.
Horizontal motions are not discarded at the end of an output line as
word spaces are. @xref{Breaking}.
-@DefescList {\\w, @code{'}, anything, @code{'}}
+@DefescList {\\w, @code{'}, input, @code{'}}
@DefregItemx {st}
@DefregItemx {sb}
@DefregItemx {rst}
@@ -16439,8 +16439,12 @@ word spaces are. @xref{Breaking}.
@DefregItemx {ssc}
@DefregListEndx {skw}
@cindex width computation escape sequence (@code{\w})
-Interpolate the width of @var{anything} in basic units. This escape
-sequence allows several properties of formatted output to be measured
+Interpolate the width of
+@var{input},
+as interpreted,
+in basic units.
+This escape sequence
+allows several properties of formatted output to be measured
without writing it out.
@Example
@@ -16451,7 +16455,7 @@ The length of the string 'abc' is \w'abc'u.
@cindex dummy environment, used by @code{\w} escape sequence
@cindex environment, dummy, used by @code{\w} escape sequence
The formatter processes
-@var{anything}
+@var{input}
in a dummy environment:@:
this means that font and type size changes,
for example,
@@ -16475,13 +16479,26 @@ to @code{\w}] relative to the baseline''.
@item rst
@itemx rsb
-Like @code{st} and @code{sb}, but taking account of the heights and
-depths of glyphs. In other words, these registers store the highest and
-lowest vertical positions attained by @var{anything}, doing what
-@acronym{AT&T} @code{troff} documented @code{st} and @code{sb} as doing.
+Like
+@code{st}
+and
+@code{sb},
+but taking account of the heights and depths of glyphs.
+In other words,
+these registers store
+the highest and lowest vertical positions attained by
+@var{input},
+doing what
+@acronym{AT&T}
+@code{troff} @c AT&T
+documented
+@code{st}
+and
+@code{sb} as doing.
@item ct
-Characterizes the geometry of glyphs occurring in @var{anything}.
+Characterizes the geometry of glyphs occurring in
+@var{input}.
@table @asis
@item 0
diff --git a/man/groff.7.man b/man/groff.7.man
index 7b014498c..9ad6ed254 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6387,10 +6387,22 @@ as returned by
.
.
.TP
-.ESCq w anything
-Interpolate width of
-.IR anything ,
-formatted in a dummy environment.
+.ESCq w input
+Interpolate the width of
+.IR input ,
+as interpreted,
+in basic units.
+.
+This escape sequence
+allows several properties of formatted output to be measured
+without writing it out.
+.
+The formatter processes
+.I input
+in a dummy environment:
+this means that font and type size changes,
+for example,
+may occur within it without affecting subsequent output.
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
