gbranden pushed a commit to branch master
in repository groff.
commit b2d4010486fc733d21a41327ed40e384baa31a75
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri May 1 02:09:20 2026 -0500
[doc,man]: Tweak `.$` register description.
---
doc/groff.texi.in | 12 ++++++++++--
man/groff.7.man | 16 +++++++++-------
2 files changed, 19 insertions(+), 9 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index be6fa0ed4..b28b64b47 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -17191,8 +17191,16 @@ shall motivate and explain below (@pxref{Copy Mode}).
@Defreg {.$}
@cindex parameter count register (@code{.$})
-The count of parameters available to a macro or string is kept in this
-read-only register. The @code{shift} request can change its value.
+The read-only register
+@code{.$}
+makes the count of a macro or interpolation's parameters
+available to its definition.
+The
+@code{shift}
+request dequeues parameters,
+and thus updates
+@code{.$}'s
+value.
@endDefreg
Any individual parameter can be accessed by its position in the list of
diff --git a/man/groff.7.man b/man/groff.7.man
index ab80e0943..58f37df18 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -8947,14 +8947,16 @@ Macro call and string interpolation parameters can be
accessed using
escape sequences starting with
.RB \[lq] \|\[rs]$ \[rq].
.
-The
+The read-only register
.B \[rs]n[.$]
-read-only register stores the count of parameters available to a macro
-or string;
-change its value with the
-.B .shift
-request,
-which dequeues parameters from the current list.
+makes the count of a macro or interpolation's parameters
+available to its definition.
+The
+.RB \[lq] shift \[rq]
+request dequeues parameters,
+and thus updates
+.BR \[rs]n[.$] 's
+value.
.
The
.B \[rs]$0
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
