[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[bug #61314] [PATCH] [me] clarify documentation of $v and $V registers

From: G. Branden Robinson
Subject: [bug #61314] [PATCH] [me] clarify documentation of $v and $V registers
Date: Thu, 28 Oct 2021 22:39:13 -0400 (EDT)
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Firefox/78.0

Update of bug #61314 (project groff):

                  Status:             In Progress => Fixed                  
             Open/Closed:                    Open => Closed                 
         Planned Release:                    None => 1.23.0                 


Follow-up Comment #1:

commit 342dabb0becc2fdb8688d4a1e5d961833126c061 (origin/master, origin/HEAD)
Author: Dave Kemper <saint.snit@gmail.com>
Date:   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]


Reply to this item at:


  Message sent via Savannah

reply via email to

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