GNU bug report logs - #61784
30.0.50; "Byte compile the file containing the current buffer."

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 61784 in the body.
You can then email your comments to 61784 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Stephen Berman <stephen.berman <at> gmx.net>
To: bug-gnu-emacs <at> gnu.org
Subject: 30.0.50; "Byte compile the file containing the current buffer."
Date: Sat, 25 Feb 2023 12:22:41 +0100

The docstring of the function emacs-lisp-byte-compile ("Byte compile the
file containing the current buffer.") sounds infelicitous; how about
changing it to "Byte compile the file visited by the current buffer."?
If that's rejected as passive, an alternative is "Byte compile the file
the current buffer is visiting.", though that sounds more awkward to me
than "visited by" (note "the file visited by the current buffer" occurs
several times in the Emacs and Elisp manuals, and I have found no other
use of (variants of) "file containing the current buffer" in the Emacs
sources).


In GNU Emacs 30.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version
 3.24.36, cairo version 1.17.6) of 2023-02-24 built on strobelfs
Repository revision: 1bed13111be2954e418f3cf43f30944ea5b82055
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12101007
System Description: Linux From Scratch r11.2-318

Message #10 received at 61784-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stephen Berman <stephen.berman <at> gmx.net>
Cc: 61784-done <at> debbugs.gnu.org
Subject: Re: bug#61784: 30.0.50;
 "Byte compile the file containing the current buffer."
Date: Sat, 25 Feb 2023 15:53:02 +0200

> From: Stephen Berman <stephen.berman <at> gmx.net>
> Date: Sat, 25 Feb 2023 12:22:41 +0100
> 
> The docstring of the function emacs-lisp-byte-compile ("Byte compile the
> file containing the current buffer.") sounds infelicitous; how about
> changing it to "Byte compile the file visited by the current buffer."?

Thanks, I fixed this in a slightly different way on the emacs-29
branch.

> If that's rejected as passive, an alternative is "Byte compile the file
> the current buffer is visiting.", though that sounds more awkward to me
> than "visited by" (note "the file visited by the current buffer" occurs
> several times in the Emacs and Elisp manuals, and I have found no other
> use of (variants of) "file containing the current buffer" in the Emacs
> sources).

My change avoids the passive voice.

Closing.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.