gbranden pushed a commit to branch master
in repository groff.
commit 8a6b787b852d2db3577200813bc49f625fa07281
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Mar 3 06:22:20 2026 -0600
[doc,man]: Tweak documentation.
* Speak of "the formatter", not GNU troff, when describing generally
applicable *roff behavior.
* Tag the word "troff" with Texinfo's "@command", not "@code", to
satisfy semantic markup scruples and to ensure it gets set in a
consistent face.
* Break Texinfo input lines in a roff-friendly way.
* Bump document date.
---
doc/groff.texi.in | 28 ++++++++++++++++++++--------
man/groff.7.man | 8 +++++---
2 files changed, 25 insertions(+), 11 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index e4642a351..f9908d7e9 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -467,7 +467,7 @@ Documentation License''.
@title groff
@subtitle The GNU implementation of @code{troff}
@subtitle version @VERSION@
-@subtitle February 2026
+@subtitle March 2026
@author Trent@tie{}A.@: Fisher
@author Werner Lemberg
@author G.@tie{}Branden Robinson
@@ -7962,10 +7962,13 @@ only at the beginning of an input line,
or at the beginning of a branch of a control structure request;
see @ref{Conditionals and Loops}.
-A few requests cause a break implicitly; use the no-break control
-character to prevent the break. Break suppression is its sole
-behavioral distinction. Employing the no-break control character to
-invoke requests that don't cause breaks is harmless but poor style.
+A few requests cause a break implicitly;
+invoke them with the no-break control character
+to prevent the break.
+Break suppression is its sole behavioral distinction.
+Employing the no-break control character
+to invoke requests that don't cause breaks
+is harmless but poor style.
@xref{Manipulating Filling and Adjustment}.
@cindex control character, changing (@code{cc})
@@ -8868,9 +8871,18 @@ the @code{\R} escape sequence.
@DefreqList {nr, ident value}
@DefescListEndx {\\R, @code{'}, ident value, @code{'}}
-Set register @var{ident} to @var{value}. If @var{ident} doesn't exist,
-GNU @code{troff} creates it. In the @code{\R} escape sequence, the
-delimiter need not be a neutral apostrophe; see @ref{Delimiters}.
+Set register
+@var{ident}
+to
+@var{value}.
+If
+@var{ident} doesn't exist,
+the formatter creates it.
+In the
+@code{\R}
+escape sequence,
+the delimiter need not be a neutral apostrophe;
+see @ref{Delimiters}.
@Example
.nr a (((17 + (3 * 4))) % 4)
diff --git a/man/groff.7.man b/man/groff.7.man
index d3133bec2..6008f11a4 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1541,12 +1541,14 @@ see section \[lq]Control structures\[rq] below.
.
.P
A few requests cause a break implicitly;
-use the no-break control character to prevent the break.
+invoke them with the no-break control character
+to prevent the break.
.
Break suppression is its sole behavioral distinction.
.
-Employing the no-break control character to invoke requests that don't
-cause breaks is harmless but poor style.
+Employing the no-break control character
+to invoke requests that don't cause breaks
+is harmless but poor style.
.
.
.P
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
