gbranden pushed a commit to branch master
in repository groff.
commit 2ff1b6d4fbce27028aaab5857b1821bb7cf6f439
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Apr 3 02:59:32 2026 -0500
[doc,man]: Update and sync `.br` register stuff.
---
doc/groff.texi.in | 23 +++++++++++++++--------
man/groff_diff.7.man | 20 ++++++++++++++------
2 files changed, 29 insertions(+), 14 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index feb3aa9dc..001b27266 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -8040,17 +8040,23 @@ When writing a macro, you might wish to know which
control character was
used to call it.
@Defreg {.br}
-This read-only register interpolates@tie{}1 if the currently executing
-macro was called using the normal control character and@tie{}0
-otherwise. If a macro is interpolated as a string, the @code{.br}
-register's value is inherited from the context of the string
-interpolation. @xref{Strings}.
+This read-only register interpolates@tie{}1
+if the currently executing macro was called
+using the normal control character
+and@tie{}0 otherwise.
+If a macro is interpolated as a string,
+the
+@code{.br}
+register inherits its value
+from the context of the string interpolation.@footnote{@xref{Strings}.}
@cindex intercepting requests
@cindex requests, intercepting
@cindex modifying requests
@cindex requests, modifying
-Use this register to reliably intercept requests that imply breaks.
+Use the
+@code{.br}
+register to reliably wrap or intercept requests that imply breaks.
@Example
.als bp*orig bp
@@ -8060,8 +8066,9 @@ Use this register to reliably intercept requests that
imply breaks.
..
@endExample
-Testing the @code{.br} register outside of a macro definition makes no
-sense.
+Testing the
+@code{.br}
+register outside of a macro definition makes no sense.
@endDefreg
@c ---------------------------------------------------------------------
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index e506cf70c..33138ce7c 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4938,15 +4938,23 @@ Their names often correspond to the requests that
affect them.
.
.TP 14n \" "\n[.hydefault]" + 2n
.B \[rs]n[.br]
-Within a macro definition,
-interpolate\~1
-if the macro is called with the \[lq]normal\[rq] control character
-(\[lq].\[rq] by default),
+Interpolate\~1
+if the currently executing macro was called
+using the normal control character
and\~0 otherwise.
.
-This facility allows requests to be reliably wrapped by a macro.
+If a macro is interpolated as a string,
+the
+.B .br
+register inherits its value
+from the context of the string interpolation.
+.\" @footnote{@xref{Strings}.}
+.
+Use the
+.B .br
+register to reliably wrap or intercept requests that imply breaks.
.
-Interpolating the
+Testing the
.B .br
register outside of a macro definition makes no sense.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
