gbranden pushed a commit to branch master
in repository groff.
commit e2cb860282dd645942d85330bc700c2e2144f5a5
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Jun 2 03:58:13 2025 -0500
doc/*,man/*: Recast "Measurements" discussion.
* Clarify.
* Favor active voice over passive.
* Parallelize input line breaks between Texinfo and man(7) documents.
---
doc/groff.texi.in | 36 +++++++++++++++++++++++++-----------
man/groff.7.man | 25 +++++++++++++++----------
2 files changed, 40 insertions(+), 21 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 9ffa82048..06f8fc368 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6150,23 +6150,37 @@ one vee.
@cindex indicator, scaling
@cindex units of measurement
-The formatter sometimes requires the input of numeric parameters to
-specify measurements. These are specified as integers or decimal
-fractions with an optional @dfn{scaling unit} suffixed. A scaling unit
-is a letter that immediately follows the last digit of a number. Digits
-after the decimal point are optional. Examples of measurements include
-@samp{10.5p}, @samp{11i}, and @samp{3.c}.
+A @code{roff} document sometimes
+requires the input of numeric parameters to specify measurements.
+These are expressed as integers
+or decimal fractions
+with an optional
+@dfn{scaling unit}
+suffixed.
+A scaling unit is a letter
+that immediately follows the last digit of a number.
+Digits after the decimal point are optional.
+Examples of measurements include
+@samp{10.5p},
+@samp{11i},
+and @samp{3.c}.
@cindex basic units, conversion to
@cindex units, basic, conversion to
@cindex conversion to basic units
-Measurements are scaled by the scaling unit and stored internally (with
-any fractional part discarded) in basic units.
+The formatter scales measurements by the specified scaling unit,
+storing them internally
+(with any fractional part discarded)
+in basic units.
@cindex device resolution, obtaining in the formatter
@cindex resolution, device, obtaining in the formatter
-The device resolution can therefore be obtained by storing a value of
-@samp{1i} to a register. The only constraint on the basic unit is that
-it is at least as small as any other unit.
+The device resolution can therefore be obtained
+by storing a value of
+@samp{1i}
+to a register,
+then reading the register.
+The only constraint on the basic unit
+is that it is at least as small as any other unit.
@c That's a fib. A device resolution of around 2^31 would surely also
@c cause problems. But nobody does that.
diff --git a/man/groff.7.man b/man/groff.7.man
index 54d863481..85d9fda95 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -844,28 +844,33 @@ now withdrawn.)
.\" ====================================================================
.
.\" BEGIN Keep (roughly) parallel with groff.texi node "Measurements".
-Numeric parameters that specify measurements are expressed as
-integers or decimal fractions with an optional
-.I scaling unit
+Express numeric parameters that specify measurements
+as integers
+or decimal fractions
+with an optional
+.I "scaling unit"
suffixed.
.
-A scaling unit is a letter that immediately follows the last digit of a
-number.
+A scaling unit is a letter
+that immediately follows the last digit of a number.
.
Digits after the decimal point are optional.
.
.
.P
-Measurements are scaled by the scaling unit and stored internally
+The formatter scales measurements by the specified scaling unit,
+storing them internally
(with any fractional part discarded)
in basic units.
.
-The device resolution can therefore be obtained by storing a value of
+The device resolution can therefore be obtained
+by storing a value of
.RB \[lq] 1i \[rq]
-to a register.
+to a register,
+then reading the register.
.
-The only constraint on the basic unit is that it is at least as small as
-any other unit.
+The only constraint on the basic unit
+is that it is at least as small as any other unit.
.\" That's a fib. A device resolution of around 2^31 would surely also
.\" cause problems. But nobody does that.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
