From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: delete-other-frames Date: Sat, 27 Aug 2016 10:40:29 +0300 Message-ID: <83inumd5hu.fsf@gnu.org> References: <57BC072F.9070704@gmx.at> <83k2f7fugv.fsf@gnu.org> <57BD63A9.8040502@gmx.at> <57BEB772.60100@gmx.at> <83inuoewjy.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1472283636 27287 195.159.176.226 (27 Aug 2016 07:40:36 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 27 Aug 2016 07:40:36 +0000 (UTC) Cc: emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Aug 27 09:40:32 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bdYEA-0006Yl-6Y for ged-emacs-devel@m.gmane.org; Sat, 27 Aug 2016 09:40:30 +0200 Original-Received: from localhost ([::1]:35040 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bdYE7-0004yj-KQ for ged-emacs-devel@m.gmane.org; Sat, 27 Aug 2016 03:40:27 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42335) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bdYE1-0004yZ-Jq for emacs-devel@gnu.org; Sat, 27 Aug 2016 03:40:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bdYDv-0000g4-L5 for emacs-devel@gnu.org; Sat, 27 Aug 2016 03:40:20 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:34386) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bdYDv-0000fy-HZ for emacs-devel@gnu.org; Sat, 27 Aug 2016 03:40:15 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4923 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bdYDm-00027F-Nh; Sat, 27 Aug 2016 03:40:07 -0400 In-reply-to: (message from Richard Stallman on Fri, 26 Aug 2016 21:32:57 -0400) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:206826 Archived-At: > From: Richard Stallman > cc: emacs-devel@gnu.org > Date: Fri, 26 Aug 2016 21:32:57 -0400 > > > This function deletes the frame @var{frame}. > > The latter is the grammatically correct way. A parameter name in > italics, such as "@var{frame}", acts as a _name_ that refers to the > actual value of the argument. (In Info files, the parameter is just up-cased, it isn't in italics.) If the name of the argument is different, I don't object to the latter form, provided that it has the comma. But when it is the same word, the result reads as incorrect English, especially when there's no comma between them, as things usually stand. > Just as we would write > > Send it to my assistant, Jeanne. > > we should write, > > delete the frame, @var{f}. > > or > > delete the frame, @var{frame}. But Send it to my assistant ASSISTANT. and delete the frame FRAME don't sound right to me. The speller even highlights them as mis-spellings, because it flags repeated adjacent words. (It doesn't when there's a comma between them.) An additional advantage of my proposal is that it goes well with the style we use in the doc strings, because the form I proposed is shorter. In any case, we have quite a few of instances in our documentation that use the form I proposed, so if we really think it's incorrect (I don't agree), we have to change them all first.