gbranden pushed a commit to branch master
in repository groff.
commit 479779688a3d9f65dfafcbfea8c8292f62c1231f
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Jul 23 13:02:00 2025 -0500
doc/*,man/*: Continue terminological correction.
* Say "integral points", not "scaled points", when we mean the unit `p`
(or `z` in a context where only integral values are recognized).
* Say "typographical points", not "scaled points", when we mean the unit
`z`.
---
doc/groff.texi.in | 51 +++++++++++++++++++++++++++++++++++++--------------
man/groff_diff.7.man | 4 ++--
2 files changed, 39 insertions(+), 16 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index e7b56d71c..a97181f67 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12977,22 +12977,33 @@ It supports a variety of syntax forms.
@table @code
@item \s@var{n}
-Set the type size to @var{n}@tie{}scaled points. @var{n}@tie{}must be a
-single digit.@footnote{In compatibility mode only, a non-zero @var{n}
-must be in the range 4--39. @xref{Compatibility Mode}.}
-If @var{n}@tie{}is
+Set the type size to
+@var{n}@tie{}integral
+points.
+@var{n}@tie{}must
+be a single digit.@footnote{In compatibility mode only, a non-zero
+@var{n} must be in the range 4--39.
+@xref{Compatibility Mode}.}
+If
+@var{n}@tie{}is
@samp{0},
restore the previous size.
@item \s+@var{n}
@itemx \s-@var{n}
-Increase or decrease the type size by @var{n}@tie{}scaled points.
+Increase or decrease the type size by
+@var{n}@tie{}integral
+points.
@var{n}@tie{}must be exactly one digit.
@item \s(@var{nn}
-Set the type size to @var{nn}@tie{}scaled points. @var{nn} must be
-exactly two digits.
-If @var{n}@tie{}is
+Set the type size to
+@var{nn}
+integral points.
+@var{nn}
+must be exactly two digits.
+If
+@var{n}@tie{}is
@samp{00},
restore the previous size.
@@ -13000,11 +13011,17 @@ restore the previous size.
@itemx \s-(@var{nn}
@itemx \s(+@var{nn}
@itemx \s(-@var{nn}
-Alter the type size in scaled points by the two-digit value @var{nn}.
+Alter the type size in scaled points by the
+@var{nn}
+integral points.
+@var{nn}
+must be exactly two digits.
@end table
-@xref{Using Fractional Type Sizes}, for further syntactical forms of the
-@code{\s} escape sequence that additionally accept decimal fractions.
+@xref{Using Fractional Type Sizes},
+for further syntactical forms of the
+@code{\s}
+escape sequence that additionally accept decimal fractions.
@Example
snap, snap,
@@ -13319,8 +13336,12 @@ see @ref{Delimiters}.
@table @code
@item \s[@var{n}]
@itemx \s'@var{n}'
-Set the type size to @var{n}@tie{}scaled points; @var{n}@tie{}is a
-numeric expression with a default scaling unit of @samp{z}.
+Set the type size to
+@var{n}@tie{}typographical
+points;
+@var{n}@tie{}is
+a numeric expression with a default scaling unit of
+@samp{z}.
@item \s[+@var{n}]
@itemx \s[-@var{n}]
@@ -13330,7 +13351,9 @@ numeric expression with a default scaling unit of
@samp{z}.
@itemx \s'-@var{n}'
@itemx \s+'@var{n}'
@itemx \s-'@var{n}'
-Increase or decrease the type size by @var{n}@tie{}scaled points;
+Increase or decrease the type size by
+@var{n}@tie{}typographical
+points;
@var{n}@tie{}is
a numeric expression with a default scaling unit of
@samp{z}.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 4aba71d26..7d90d9813 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1124,8 +1124,8 @@ no operation if there is none.
.BI \[rs]s \[+-] \[aq] n \[aq]
Set the type size to,
or increment or decrement it by,
-.I n
-scaled points.
+.IR n \~typographical
+points.
.
.
.br
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
