emacs-devel
[Top][All Lists]
Advanced

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

Re: master 1d4862e: Fix English grammar in some doc strings and comments


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.



reply via email to

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