gbranden pushed a commit to branch master
in repository groff.
commit 3b0fd8bbeb61a3bcad4bcd91d63776dc7f84f20c
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 24 14:25:39 2026 -0600
[doc,man]: Clarify utility of troff's `-R` option.
Also break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 14 +++++++++++---
src/roff/troff/troff.1.man | 5 +++--
2 files changed, 14 insertions(+), 5 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index e202712b1..0b755c0ce 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -1294,9 +1294,17 @@ elements that can be specified within the document.
@pindex troffrc
@pindex troffrc-end
-@command{@g@troff} also accepts a @option{-R} option, which is not
-accessible via @command{groff}. This option prevents the loading of the
-@file{troffrc} and @file{troffrc-end} files.
+@command{@g@troff}
+also accepts a
+@option{-R}
+option,
+which is not accessible via
+@command{groff}.
+This option facilitates troubleshooting
+by preventing the loading of the
+@file{troffrc}
+and
+@file{troffrc-end} files.
@item -s
Run @command{gsoelim} preprocessor.
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 6347e2fe5..5eec6e179 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -458,10 +458,11 @@ identifier.
.
.TP
.B \-R
-Don't load
+Prevent loading of
.I troffrc
and
-.IR troffrc\-end .
+.IR troffrc\-end ;
+this option can be useful for troubleshooting.
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
