groff-commit
[Top][All Lists]
Advanced

[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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]