[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 05/05: doc/meref.me: Fix content nit.
From: |
G. Branden Robinson |
Subject: |
[groff] 05/05: doc/meref.me: Fix content nit. |
Date: |
Thu, 28 Oct 2021 22:38:21 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 342dabb0becc2fdb8688d4a1e5d961833126c061
Author: Dave Kemper <saint.snit@gmail.com>
AuthorDate: Sat Oct 9 07:40:51 2021 +0000
doc/meref.me: Fix content nit.
The -me Reference Manual is fairly scrupulous about documenting the
default values of its registers, but $v and $V are two exceptions.
[This commit] documents the default values for these (both 120).
$ groff -me <<<'.tm \n($v \n($V'
120 120
There is also what I feel is an oddity in the nearby wording: "The line
spacing as a percentage of the point size expressed in units is stored
in \n($v." I'm not sure what the phrase "expressed in units" is
supposed to communicate; it's not clear whether it modifies "line
spacing" or "point size," and neither really makes sense, even mentally
adding the presumably intended "basic" before "units."
$v is a percentage; if it meaningfully has a unit at all, that unit
is %.
In what units the point size is expressed or stored is irrelevant to
a percentage: 120% of the point size is not dependent on the units
expressing that point size.
Thus this patch removes the phrase entirely. If someone has a better
idea what that phrase is trying to say, it could instead be reworded to
say it more clearly.
Fixes <https://savannah.gnu.org/bugs/index.php?61314>.
[It would be nice to say "type size" instead of "point size", but
consistent usage would demand a much more intrusive change. --GBR]
---
doc/meref.me | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/doc/meref.me b/doc/meref.me
index ea0bf7f..15456f7 100644
--- a/doc/meref.me
+++ b/doc/meref.me
@@ -1136,13 +1136,15 @@ The point size is set to
.i P
[10p],
and the line spacing is set proportionally.
-The line spacing as a percentage of the point size expressed in units
+The line spacing as a percentage of the point size
is stored in
-.NR ($v .
+.NR ($v
+[120].
The percentage used internally
by displays and annotations
is stored in
.NR ($V
+[120]
(although this is not used by
.b .sz ).
This size is
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 05/05: doc/meref.me: Fix content nit.,
G. Branden Robinson <=