gbranden pushed a commit to branch master
in repository groff.
commit 4f4433938fe411224f7f394f4789602f2b48af66
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Jun 2 01:55:35 2025 -0500
doc/*,man/*: Update `warnscale` req description.
Document new nroff-mode behavior and parallelize wording.
---
doc/groff.texi.in | 20 +++++++++++++++-----
man/groff.7.man | 8 +++++---
man/groff_diff.7.man | 24 ++++++++++++++----------
3 files changed, 34 insertions(+), 18 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 73e38b6a8..06ce29fb0 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -18284,12 +18284,22 @@ there is no limit: recursion can continue until
program memory is
exhausted. The default is 1,000.
@endDefreg
-@Defreq {warnscale, su}
+@Defreq {warnscale, scaling-unit}
Set the scaling unit used in certain warnings @c `output_warning()`
-to @var{su}, which can take the values @samp{u}, @samp{i}, @samp{c},
-@samp{p}, and @samp{P}. The default is @samp{i}. Ignored on
-@code{nroff}-mode output devices, for which these diagnostics report the
-vertical page location in lines.
+(one of
+@samp{u},
+@samp{i},
+@samp{c},
+@samp{p},
+and
+@samp{P};
+default:
+@samp{i}).
+Ignored on
+@code{nroff}-mode
+output devices,
+for which these diagnostics report the vertical page location in lines,
+and the horizontal page location in ens.
@endDefreq
@Defreq {spreadwarn, [@Var{limit}]}
diff --git a/man/groff.7.man b/man/groff.7.man
index 826bf4650..d12d8fc11 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5031,9 +5031,11 @@ or
default:
.BR i ).
.
-Ignored in
-.B nroff
-mode.
+Ignored on
+.IR nroff -mode
+output devices,
+for which these diagnostics report the vertical page location in lines,
+and the horizontal page location in ens.
.
.TPx
.REQ .wh vertical-position
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 082baf6d1..6a7eeef66 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4124,19 +4124,23 @@ all warning categories are enabled.
.
.
.TP
-.BI .warnscale\~ si
-Set the scaling unit used in warnings to
-.IR si .
-.
-Valid values for
-.I si
-are
+.BI .warnscale\~ scaling-unit
+Select scaling unit used in certain warnings \" `output_warning()`
+(one of
.BR u ,
-.B i
-(the default),
+.BR i ,
.BR c ,
.BR p ,
-.RB and\~ P .
+or
+.BR P ;
+default:
+.BR i ).
+.
+Ignored on
+.IR nroff -mode
+output devices,
+for which these diagnostics report the vertical page location in lines,
+and the horizontal page location in ens.
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
