gbranden pushed a commit to branch master
in repository groff.
commit a40b0b67061c6beac4000cb8ab2a9ec302336c45
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Dec 10 16:26:30 2025 -0600
[doc,man]: Clarify a point.
(So to speak.)
GNU troff's support for sub-integer type size increments doesn't
categorically cause an incompatibility. It's troublesome only in the
scenario, hard to motivate and unobserved by me in the wild, of legacy
AT&T documents explicitly putting a "u" scaling unit on an argument to
the `ps` request. (Because, as explained here, AT&T troff ignored
scaling units in `ps`'s arguments, there was no benefit to doing so.)
---
doc/groff.texi.in | 9 ++++-----
man/groff_diff.7.man | 12 ++++--------
2 files changed, 8 insertions(+), 13 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 58fec6955..51fabbe94 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -20776,11 +20776,11 @@ using any valid identifiers for their names
@cindex type sizes, fractional
@cindex sizes, fractional
@cindex @code{ps} request, incompatibilities with @acronym{AT&T} @code{troff}
-Fractional type size support causes an incompatibility.
-In @acronym{AT&T}
-@command{troff}, @c AT&T
+As noted in @ref{Using Fractional Type Sizes},
+@acronym{AT&T}
+@command{troff}'s @c AT&T
@code{ps}
-ignores scaling units
+request ignores scaling units
and thus
@samp{.ps 10u}
sets the type size to 10@tie{}points,
@@ -20795,7 +20795,6 @@ possibly a much smaller measurement.
and
@samp{.ps 10z}
are portable.
-@xref{Using Fractional Type Sizes}.
@cindex @code{ab} request, incompatibilities with @acronym{AT&T} @code{troff}
The @code{ab} request differs from @acronym{AT&T} @code{troff}: GNU
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 91b440b5d..5e41bd45b 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6613,12 +6613,11 @@ using any valid identifiers for their names.
.
.
.P
-Fractional type size support causes an incompatibility.
-.
-In AT&T
-.IR troff , \" AT&T
+As noted above in \[lq]Fractional type sizes and new scaling units\[rq],
+AT&T
+.IR troff 's \" AT&T
.B ps
-ignores scaling units
+request ignores scaling units
and thus
.RB \[lq] .ps\~10u \[rq]
sets the type size to 10\~points,
@@ -6635,9 +6634,6 @@ and
.RB \[lq] .ps\~10z \[rq]
are portable.
.
-See subsection \[lq]Fractional type sizes and new scaling units\[rq]
-above.
-.
.
.P
The
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
