From unknown Sun Jun 22 22:41:59 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#12181 <12181@debbugs.gnu.org> To: bug#12181 <12181@debbugs.gnu.org> Subject: Status: 24.1.50; doc of `switch-to-buffer' Reply-To: bug#12181 <12181@debbugs.gnu.org> Date: Mon, 23 Jun 2025 05:41:59 +0000 retitle 12181 24.1.50; doc of `switch-to-buffer' reassign 12181 emacs submitter 12181 "Drew Adams" severity 12181 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 11 11:31:40 2012 Received: (at submit) by debbugs.gnu.org; 11 Aug 2012 15:31:40 +0000 Received: from localhost ([127.0.0.1]:49580 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T0DfA-00029k-Aq for submit@debbugs.gnu.org; Sat, 11 Aug 2012 11:31:40 -0400 Received: from eggs.gnu.org ([208.118.235.92]:48757) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T0Df8-00029d-5B for submit@debbugs.gnu.org; Sat, 11 Aug 2012 11:31:38 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1T0DX0-0004JA-LL for submit@debbugs.gnu.org; Sat, 11 Aug 2012 11:23:16 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:48221) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T0DX0-0004J6-IS for submit@debbugs.gnu.org; Sat, 11 Aug 2012 11:23:14 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40045) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T0DWy-0003sa-7w for bug-gnu-emacs@gnu.org; Sat, 11 Aug 2012 11:23:14 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1T0DWx-0004Ij-5k for bug-gnu-emacs@gnu.org; Sat, 11 Aug 2012 11:23:12 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:33776) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T0DWw-0004If-V6 for bug-gnu-emacs@gnu.org; Sat, 11 Aug 2012 11:23:11 -0400 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q7BFN8mf031536 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 11 Aug 2012 15:23:09 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q7BFN7Ip015345 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 11 Aug 2012 15:23:07 GMT Received: from abhmt119.oracle.com (abhmt119.oracle.com [141.146.116.71]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q7BFN5A2018609 for ; Sat, 11 Aug 2012 10:23:07 -0500 Received: from dradamslap1 (/10.159.168.229) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 11 Aug 2012 08:23:04 -0700 From: "Drew Adams" To: Subject: 24.1.50; doc of `switch-to-buffer' Date: Sat, 11 Aug 2012 08:22:57 -0700 Message-ID: <524DDEA121B9498F842F2E873C14B37E@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac131S+/yfdDKe2XR4uStDkbI0R9Pw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] 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: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit 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: -6.1 (------) The doc, in both the doc string and the Elisp manual, is not clear. It says that the function displays the buffer in the selected window. But later it says that it might display it in another window or it might raise an error and not display it at all. The description should be reworded to say that it generally _tries_ to display the buffer in the selected window. Otherwise it just sounds contradictory. Note the evolution: Emacs prior to Emacs 23: We just said that it displayed the buffer in the selected window. (We actually said "current" window - back then we used both "selected" and "current" for both buffers and windows.) Emacs 23: We said the same thing, but we added that if the selected window is a minibuffer window or is dedicated then we just call `pop-to-buffer'. Already that is dodging things a bit and sending the user off to read about `pop-to-buffer', which itself is complicated (even if clear). Emacs 24: We added argument FORCE-SAME-WINDOW and complicated the description some more: it's like Emacs 23, but non-nil FORCE-SAME-WINDOW raises an error if it cannot be displayed in the selected window. The Emacs 24 description is actually less clear because it does not refer the reader to the doc for `pop-to-buffer', which doc explains in detail what happens. Now, all the reader learns is that the buffer "may be displayed in another window". May be? Under what circumstances? Another window? What other window? Those things were clearer in the Emacs 23 doc because of the explanation of `pop-to-buffer'. This is all OK in general, but the various possibilities need to be tied together better. The description sort of reflects the implementation as having been a history of patches. It will help to say at the outset that the function _tries_ to use the selected window. Then you can speak to what happens if it cannot. That "what" should be detailed clearly, or it can refer to functions etc. whose doc will explain clearly just what happens (as was true in the Emacs 23 case, where readers could read about `pop-to-buffer'). In GNU Emacs 24.1.50.1 (i386-mingw-nt5.1.2600) of 2012-08-08 on DANI-PC Bzr revision: 109511 michael.albinus@gmx.de-20120808134045-t26l1voivvzfypey Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -I../../libs/libxpm-3.5.8/include -I../../libs/libxpm-3.5.8/src -I../../libs/libpng-1.4.10 -I../../libs/zlib-1.2.6 -I../../libs/giflib-4.1.4-1/include -I../../libs/jpeg-6b-4/include -I../../libs/tiff-3.8.2-1/include -I../../libs/libxml2-2.7.8-w32-bin/include/libxml2 -I../../libs/gnutls-3.0.16/include -I../../libs/libiconv-1.14-2-mingw32-dev/include' From debbugs-submit-bounces@debbugs.gnu.org Fri Sep 07 09:52:56 2012 Received: (at 12181) by debbugs.gnu.org; 7 Sep 2012 13:52:56 +0000 Received: from localhost ([127.0.0.1]:45803 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9yzN-0004Lh-6T for submit@debbugs.gnu.org; Fri, 07 Sep 2012 09:52:55 -0400 Received: from mail-ie0-f172.google.com ([209.85.223.172]:45043) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9yzJ-0004LR-34 for 12181@debbugs.gnu.org; Fri, 07 Sep 2012 09:52:50 -0400 Received: by ieak13 with SMTP id k13so5015012iea.3 for <12181@debbugs.gnu.org>; Fri, 07 Sep 2012 06:52:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=/84MHCuUE1sdkDJNGz8jyYvKbtCZflSKh+Hkuih0aXU=; b=b1QdeG67NL0Um4MnAMVrxYFvXDQuN8Wa691CaQwDrKrCkMqUHImX3bU/8CLfUPXirc bSYxYHQrotO0KVDbrJzfKHiJ9vYFhBwbXzii26AEpNK2p74BwgnHvSaequLDwyli/62b QnGZTy9rSULb6YlsqjDz25YEEt2HqyI5ewWpUnJxTJUYEBhBqhVQSd1AQN6VwdippLlu rwnXZI3TmvSfv5IJonQmOofnSYo+eJW/CExDmVlAXojfl5XYo/mCs6N+SORzfVtxOjYL BGHM43dtxiOU1sIoE/nBHOEXT1tDfZVmJX8S6PB6NlTy+UjkYHGkA5zmal9M81fptxBX yPUA== Received: by 10.50.217.137 with SMTP id oy9mr8852464igc.56.1347025949520; Fri, 07 Sep 2012 06:52:29 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id p8sm8158181igl.16.2012.09.07.06.52.26 (version=SSLv3 cipher=OTHER); Fri, 07 Sep 2012 06:52:28 -0700 (PDT) From: Chong Yidong To: "Drew Adams" Subject: Re: bug#12181: 24.1.50; doc of `switch-to-buffer' References: <524DDEA121B9498F842F2E873C14B37E@us.oracle.com> Date: Fri, 07 Sep 2012 21:52:12 +0800 In-Reply-To: <524DDEA121B9498F842F2E873C14B37E@us.oracle.com> (Drew Adams's message of "Sat, 11 Aug 2012 08:22:57 -0700") Message-ID: <87y5km2b5f.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 12181 Cc: 12181@debbugs.gnu.org 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: -2.6 (--) "Drew Adams" writes: > It says that the function displays the buffer in the selected window. > But later it says that it might display it in another window or it might > raise an error and not display it at all. > > The description should be reworded to say that it generally _tries_ to > display the buffer in the selected window. Otherwise it just sounds > contradictory. This is pretty pedantic, but I clarified the text anyway. From debbugs-submit-bounces@debbugs.gnu.org Fri Sep 07 09:52:53 2012 Received: (at control) by debbugs.gnu.org; 7 Sep 2012 13:52:53 +0000 Received: from localhost ([127.0.0.1]:45801 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9yzL-0004Ld-ND for submit@debbugs.gnu.org; Fri, 07 Sep 2012 09:52:52 -0400 Received: from mail-ie0-f172.google.com ([209.85.223.172]:52188) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9yzI-0004LP-Bh for control@debbugs.gnu.org; Fri, 07 Sep 2012 09:52:49 -0400 Received: by ieak13 with SMTP id k13so5014990iea.3 for ; Fri, 07 Sep 2012 06:52:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:subject:date:message-id:mime-version:content-type; bh=SYEQQnTlcMZZUjmKT3JX6XDTLT4jSgtHrgOfrGd1Q5g=; b=hDskajQY0pPDQfPVXOPmM26HvXjVygjuHA+V0PKV5EJq9c48e3eumZfW20h/FmrXPn Om5Vc59/DT1lKAc9DKMGt6QSE5rXd3Xu2ooZoz+zg0Wov9nY9vaen32BKSGQQEQO9vVT pIUsJ7JGa+/elmi72ujk35ufap4VTnDBqvrf0Kkp1dDnfuS14XxsWDzW54n2D8N2U2jA PakLXz/lYJ3Fo+4gXdYjbNJljM8D4O2O9WV9oMreoTrqv5CKfGVs7wsL/tecF6pAxoj6 Es4kT/pzpbkncXanQyKMSFEa9mWoH5y6Uf6+wsDpMeYJixO/zXFE614rbChEL0rIvaWh ThWg== Received: by 10.43.45.200 with SMTP id ul8mr7066921icb.36.1347025949909; Fri, 07 Sep 2012 06:52:29 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id ch4sm8190877igb.2.2012.09.07.06.52.27 (version=SSLv3 cipher=OTHER); Fri, 07 Sep 2012 06:52:29 -0700 (PDT) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 12181 Date: Fri, 07 Sep 2012 21:52:22 +0800 Message-ID: <87zk52ey95.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) 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: -2.6 (--) close 12181 thanks From unknown Sun Jun 22 22:41:59 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 06 Oct 2012 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator