gbranden pushed a commit to branch master
in repository groff.
commit 1b9a32f3070ed90762cd72b987a91a3e9e5838d6
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jul 24 11:11:23 2025 -0500
doc/*,man/*: Continue clarifying type size stuff.
Also annotate inconsistency in *roff language grammar to future
document maintainers, to forestall overgeneralizations.
---
doc/groff.texi.in | 5 ++++-
man/groff_diff.7.man | 5 ++++-
2 files changed, 8 insertions(+), 2 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 203036fa8..3cbf60635 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -13196,7 +13196,10 @@ and otherwise defaults
to@tie{}1.@footnote{@xref{Device and Font
Description Files}.}
Requests and escape sequences in GNU
@command{troff}
-interpret arguments that represent a type size in typographical points,
+interpret arguments that accept a numerical expression
+indicating a type size defaulting to units of typographical points,
+@c Legacy forms of the `\s` escape sequence don't accept numerical
+@c expressions--only integers.
which the formatter multiplies by
@var{sizescale}
and converts to an integer.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index c345bb195..f11e37acc 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -394,7 +394,10 @@ see
.
Requests and escape sequences in GNU
.I troff \" GNU
-interpret arguments that represent a type size in typographical points,
+interpret arguments that accept a numerical expression
+indicating a type size defaulting to units of typographical points,
+.\" Legacy forms of the `\s` escape sequence don't accept numerical
+.\" expressions--only integers.
which the formatter multiplies by
.I sizescale
and converts to an integer.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
