From unknown Fri Jun 20 18:19:40 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9980: 24.0.91; doc string of `with-selected-frame' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 06 Nov 2011 23:16:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 9980 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 9980@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.13206213017914 (code B ref -1); Sun, 06 Nov 2011 23:16:02 +0000 Received: (at submit) by debbugs.gnu.org; 6 Nov 2011 23:15:01 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RNBvY-000233-Tq for submit@debbugs.gnu.org; Sun, 06 Nov 2011 18:15:01 -0500 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RNBvX-00022x-3v for submit@debbugs.gnu.org; Sun, 06 Nov 2011 18:14:59 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RNBsn-0007pO-Qe for submit@debbugs.gnu.org; Sun, 06 Nov 2011 18:12:10 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-5.4 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD,UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:52814) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RNBsn-0007pK-NE for submit@debbugs.gnu.org; Sun, 06 Nov 2011 18:12:09 -0500 Received: from eggs.gnu.org ([140.186.70.92]:55839) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RNBsm-0001Cn-T0 for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2011 18:12:09 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RNBsl-0007p4-Mz for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2011 18:12:08 -0500 Received: from acsinet15.oracle.com ([141.146.126.227]:32004) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RNBsl-0007p0-GB for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2011 18:12:07 -0500 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id pA6NC5WB003380 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 6 Nov 2011 23:12:06 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id pA6NC4I3028070 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sun, 6 Nov 2011 23:12:05 GMT Received: from abhmt114.oracle.com (abhmt114.oracle.com [141.146.116.66]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id pA6NBxU8009763 for ; Sun, 6 Nov 2011 17:11:59 -0600 Received: from dradamslap1 (/10.159.60.254) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 06 Nov 2011 15:11:59 -0800 From: "Drew Adams" Date: Sun, 6 Nov 2011 15:11:56 -0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Acyc2XqGGkymDk//RkOGiv+aZoL3rw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-CT-RefId: str=0001.0A090209.4EB71446.0088,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -6.2 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) 1. The doc string is incomplete. You need to do the same kind of thing you did for `with-selected-window' for this macro as well. What's missing is mention that some state is saved and restored. When you say only that the body is executed with FRAME as the selected frame you mislead people into thinking that FRAME stays selected throughout. In fact, what happens is that FRAME and the config are saved at the beginning and then restored at the end. Compare/contrast with the doc string for `with-selected-window' and you should see the light. 2. The grammar of this sentence is anyway incorrect: "This macro neither changes the order of recently selected windows nor the buffer list." It should say something like, "This macro changes the order of neither the recently selected windows nor the buffers in the buffer list." IOW, "neither changes X nor" requires another verb: "neither changes X nor throws up on Y." What you are looking for is "changes neither X nor Y." In GNU Emacs 24.0.91.1 (i386-mingw-nt5.1.2600) of 2011-10-30 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.6) --no-opt --cflags -I"D:/devel/emacs/libs/libXpm-3.5.8/include" -I"D:/devel/emacs/libs/libXpm-3.5.8/src" -I"D:/devel/emacs/libs/libpng-dev_1.4.3-1/include" -I"D:/devel/emacs/libs/zlib-dev_1.2.5-2/include" -I"D:/devel/emacs/libs/giflib-4.1.4-1/include" -I"D:/devel/emacs/libs/jpeg-6b-4/include" -I"D:/devel/emacs/libs/tiff-3.8.2-1/include" -I"D:/devel/emacs/libs/gnutls-2.10.1/include" --ldflags -L"D:/devel/emacs/libs/gnutls-2.10.1/lib"' From unknown Fri Jun 20 18:19:40 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9980: 24.0.91; doc string of `with-selected-frame' Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 07 Jan 2012 05:59:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9980 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 9980@debbugs.gnu.org Received: via spool by 9980-submit@debbugs.gnu.org id=B9980.132591592723634 (code B ref 9980); Sat, 07 Jan 2012 05:59:01 +0000 Received: (at 9980) by debbugs.gnu.org; 7 Jan 2012 05:58:47 +0000 Received: from localhost ([127.0.0.1]:47556 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjPIk-000697-H2 for submit@debbugs.gnu.org; Sat, 07 Jan 2012 00:58:46 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:56548) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjPIi-00068w-6L for 9980@debbugs.gnu.org; Sat, 07 Jan 2012 00:58:45 -0500 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=stories.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1RjPIb-0003GF-L6; Sat, 07 Jan 2012 06:58:37 +0100 From: Lars Magne Ingebrigtsen References: X-Now-Playing: LA Vampires's _So Unreal_: "Don't Dance Along" Date: Sat, 07 Jan 2012 06:58:37 +0100 In-Reply-To: (Drew Adams's message of "Sun, 6 Nov 2011 15:11:56 -0800") Message-ID: User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.92 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1RjPIb-0003GF-L6 X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1326520717.78477@pS8pohPe+oqOeOdRNxRE7A X-Spam-Status: No X-Spam-Score: -1.9 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.9 (-) "Drew Adams" writes: > 1. The doc string is incomplete. You need to do the same kind of thing you > did for `with-selected-window' for this macro as well. Ok; fixed. > 2. The grammar of this sentence is anyway incorrect: "This macro neither > changes the order of recently selected windows nor the buffer list." It > should say something like, "This macro changes the order of neither the > recently selected windows nor the buffers in the buffer list." > > IOW, "neither changes X nor" requires another verb: "neither changes X > nor throws up on Y." What you are looking for is "changes neither X nor > Y." I've adapted your suggestion. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Sat Jan 07 00:58:50 2012 Received: (at control) by debbugs.gnu.org; 7 Jan 2012 05:58:50 +0000 Received: from localhost ([127.0.0.1]:47559 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjPIn-00069K-48 for submit@debbugs.gnu.org; Sat, 07 Jan 2012 00:58:50 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:56554) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjPIk-000696-Ie for control@debbugs.gnu.org; Sat, 07 Jan 2012 00:58:47 -0500 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=stories.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1RjPIe-0003GO-AO for control@debbugs.gnu.org; Sat, 07 Jan 2012 06:58:40 +0100 Date: Sat, 07 Jan 2012 06:58:39 +0100 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #9980 X-MailScanner-ID: 1RjPIe-0003GO-AO X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1326520720.70083@+UuNGt4v2Cxrveb4tq4ZeQ X-Spam-Status: No X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.9 (-) tags 9980 fixed close 9980 24.1