gbranden pushed a commit to branch master
in repository groff.
commit e08c4b3f72ee2dda9f61ae0b9afea6e948cd1b69
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Apr 3 16:03:16 2026 -0500
[doc,man]: Revise and sync summary of registers.
---
doc/groff.texi.in | 17 +++++++++++++----
man/groff.7.man | 31 +++++++++++++++++--------------
2 files changed, 30 insertions(+), 18 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 804284632..39571b841 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -8927,13 +8927,22 @@ some of these are read-only.
You can also define your own.
Recall @ref{Identifiers},
regarding the construction of valid names for registers.
+The register name space is separate from that used for requests,
+macros,
+strings,
+and diversions.
@cindex format, register
@cindex register format
-Each register (except read-only ones) can be assigned a @dfn{format},
-causing its value to interpolate with leading zeroes, in Roman numerals,
-or alphabetically. Some read-only registers are string-valued, meaning
-that they interpolate text and lack a format.
+Each register
+(except read-only ones)
+can be assigned a
+@dfn{format},
+causing its value to interpolate with leading zeroes,
+in Roman numerals,
+or alphabetically.
+Some read-only registers are string-valued,
+meaning that they interpolate text and lack a format.
@menu
* Setting Registers::
diff --git a/man/groff.7.man b/man/groff.7.man
index 9ce3a4c90..124640fa2 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -7069,6 +7069,11 @@ You can also define your own.
See section \[lq]Identifiers\[rq] above
regarding the construction of valid names for registers.
.
+The register name space is separate from that used for requests,
+macros,
+strings,
+and diversions.
+.
.
.P
Each register
@@ -7110,29 +7115,27 @@ these features are called
.
(A negative auto-increment can be
considered an \[lq]auto-decrement\[rq].)
+.\" END Keep (roughly) parallel with groff.texi node "Registers".
.
.
.P
Many predefined registers are available.
.
-The following presentation uses
-register interpolation syntax
-.BI \[rs]n[ name ]
+A register synopsis in this document uses interpolation syntax
+.BI \[rs]n[ ident ]
to refer to a register
-.I name
-to clearly distinguish it from a string or request
-.IR name ;
+.I ident
+to distinguish it from a
+macro,
+string,
+diversion,
+or request
+.IR ident ;
the symbols
-.B \[rs]n[]
+.RB \[lq] \[rs]n[] \[rq]
are
.I not
-part of the register name.
-.
-The register name space is separate from that used for requests,
-macros,
-strings,
-and diversions.
-.\" END Keep (roughly) parallel with groff.texi node "Registers".
+part of the register's identifier.
.
.
.\" ====================================================================
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
