gbranden pushed a commit to branch master
in repository groff.
commit 001f5a242cce49aea3e0a72f539a5fc24809339d
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Apr 10 03:11:44 2026 -0500
doc/groff.texi.in: Fix style and markup nits.
* Favor footnotes over inlining for forward references.
* Favor "recall" over "see" for for backward references.
* Break input lines in a roff-friendly way.
---
doc/groff.texi.in | 30 +++++++++++++++++++++---------
1 file changed, 21 insertions(+), 9 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index a5b6b4e6a..3d3e9313f 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -8981,7 +8981,7 @@ In the
@code{\R}
escape sequence,
the delimiter need not be a neutral apostrophe;
-see @ref{Delimiters}.
+recall @ref{Delimiters}.
@Example
.nr a (((17 + (3 * 4))) % 4)
@@ -8991,9 +8991,14 @@ see @ref{Delimiters}.
@result{} 1 1
@endExample
-(Later, we will discuss additional forms of @code{nr} and @code{\R} that
-can change a register's value after it is dereferenced but before it is
-interpolated. @xref{Auto-increment}.)
+Later,
+we will discuss additional forms of
+@code{nr}
+and
+@code{\R}
+that can change a register's value
+after it is dereferenced
+but before it is interpolated.@footnote{@xref{Auto-increment}.}
@cindex @code{\R} escape sequence, untokenized on input
@cindex untokenized escape sequence, @code{\R}
@@ -9003,8 +9008,8 @@ does not tokenize
@code{\R}
when reading it;
the escape sequence updates only the formatter's register dictionary
-and does not contribute (directly) to output.
-@xref{GNU @command{troff} Internals}.
+and does not contribute (directly)
+to output.@footnote{@xref{GNU @command{troff} Internals}.}
Further surprise can occur if you use registers like
@code{.k},@footnote{@xref{Page Motions}.} whose values are not
@@ -9050,9 +9055,16 @@ increment or decrement a register.
@DefreqItem {nr, ident @t{-}@Var{value}}
@DefescItemx {\\R, @code{'}, ident @t{+}value, @code{'}}
@DefescListEnd {\\R, @code{'}, ident @t{-}value, @code{'}}
-Increment (decrement) register @var{ident} by @var{value}. In the
-@code{\R} escape sequence, the delimiter need not be a neutral
-apostrophe; see @ref{Delimiters}.
+Increment (decrement) register
+@var{ident}
+by
+@var{value}.
+In the
+@code{\R}
+escape sequence,
+the delimiter need not be a neutral apostrophe;
+recall
+@ref{Delimiters}.
@Example
.nr a 1
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
