|
From: | Paul Eggert |
Subject: | Re: master 1d4862e: Fix English grammar in some doc strings and comments |
Date: | Fri, 8 Nov 2019 13:31:01 -0800 |
User-agent: | Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.9.0 |
On 11/7/19 8:24 PM, Juanma Barranquero wrote:
-This function only handles buffers that are visiting files. +This function handles only buffers that are visiting files.
there's no additional clarity. It could also be argued that, in those cases where the result is less natural-sounding it diminishes clarity,
I'm not aware of any such cases. To my ear, the revised text in the example you gave is just as natural-sounding as the original. I agree that we shouldn't be pedantic about "only" in places where that would reduce clarity.
I'm willing to put up with these less-important changes, if consistent use of the style helps to fix confusion elsewhere (as that patch did). It's akin to preferring signed to unsigned arithmetic in C code - even in places where this makes no real difference - because being reasonably consistent about preferring signed arithmetic helps makes Emacs more reliable overall.
[Prev in Thread] | Current Thread | [Next in Thread] |