From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Understanding atomic window groups Date: Sat, 25 May 2019 11:13:28 +0300 Message-ID: <83ftp33qaf.fsf@gnu.org> References: <87tvdmqsxq.fsf@ericabrahamsen.net> <0a820a2c-8b37-469e-6b0e-61b126b6c7b8@gmx.at> <87lfyxszb5.fsf@ericabrahamsen.net> <875zpzedy5.fsf@ericabrahamsen.net> <171bed6b-96d6-0fa0-f4f4-b09cb72c7192@gmx.at> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="196453"; mail-complaints-to="usenet@blaine.gmane.org" Cc: eric@ericabrahamsen.net, emacs-devel@gnu.org To: martin rudalics Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat May 25 10:26:23 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hUS0U-000oz1-K0 for ged-emacs-devel@m.gmane.org; Sat, 25 May 2019 10:26:22 +0200 Original-Received: from localhost ([127.0.0.1]:37900 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hUS0T-0004jB-L1 for ged-emacs-devel@m.gmane.org; Sat, 25 May 2019 04:26:21 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:34553) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hURzr-0004LB-9m for emacs-devel@gnu.org; Sat, 25 May 2019 04:25:44 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:56441) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hURo2-0001RT-MX; Sat, 25 May 2019 04:13:30 -0400 Original-Received: from [176.228.60.248] (port=2844 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hURo2-0004rN-1z; Sat, 25 May 2019 04:13:30 -0400 In-reply-to: <171bed6b-96d6-0fa0-f4f4-b09cb72c7192@gmx.at> (message from martin rudalics on Sat, 25 May 2019 09:59:03 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:236975 Archived-At: > From: martin rudalics > Date: Sat, 25 May 2019 09:59:03 +0200 > > > This is really helpful, and I see that the docstring of `delete-window' > > actually mentions the case of atomic windows. I agree with Eli that > > maybe more documentation is in order. I feel like all the pieces are > > present (here and there), but there's no one place to get a full > > overview. > > The "one place" should be section 28.18 of the Elisp manual. If > something is missing there, please complain right away. AFAICT, that section lists the functions affected by atomic windows, but doesn't tell what you said earlier: > 'quit-window' calls 'window-deletable-p' before it tries to delete a > window so it should never cause a "Root of atomic window is root > window of its frame" error. If it does cause an error we have a bug > so maybe check again. > > 'delete-window' OTOH will raise an error when the root of the atomic > window is the root of the frame. If you want to avoid that, typically > because most of your users who type C-x 0 expect the selected window > to disppear or those typing C-x 1 expect the selected window to become > the single window of its frame despite of atomicity, you will have to > adjust the behavior with the help of 'delete-window' and > 'delete-other-windows' parameters for all involved windows. > I'll now try to amend the manual entries for 'split-window', > 'delete-window' and 'delete-other-windows' appropriately as Eli > suggested. It's up to you whether to describe the behavior with atomic windows where the functions are described or where the atomic windows are described. In the latter case, the description of the functions should have a cross-reference to the atomic-windows section. Thanks.