From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eric Abrahamsen Newsgroups: gmane.emacs.devel Subject: Re: Manual suggestions for quit-restore documentation Date: Sat, 04 Mar 2017 20:39:16 -0800 Message-ID: <87mvd0gwwb.fsf@ericabrahamsen.net> References: <87varoh5ka.fsf@ericabrahamsen.net> <9507c432-6677-4f76-a7c4-b5958f126106@default> <87r32cgwz1.fsf@ericabrahamsen.net> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1488688854 22556 195.159.176.226 (5 Mar 2017 04:40:54 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 5 Mar 2017 04:40:54 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Mar 05 05:40:50 2017 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 1ckNyP-00055D-Tr for ged-emacs-devel@m.gmane.org; Sun, 05 Mar 2017 05:40:46 +0100 Original-Received: from localhost ([::1]:37503 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ckNyW-0003AQ-1o for ged-emacs-devel@m.gmane.org; Sat, 04 Mar 2017 23:40:52 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48518) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ckNxx-0003AJ-1C for emacs-devel@gnu.org; Sat, 04 Mar 2017 23:40:17 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ckNxt-0002BW-VR for emacs-devel@gnu.org; Sat, 04 Mar 2017 23:40:17 -0500 Original-Received: from [195.159.176.226] (port=49634 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ckNxt-0002B8-OO for emacs-devel@gnu.org; Sat, 04 Mar 2017 23:40:13 -0500 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1ckNxk-0001BJ-HB for emacs-devel@gnu.org; Sun, 05 Mar 2017 05:40:04 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 34 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:FsE889CZrvIR6MoiRevr1P0euLw= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 195.159.176.226 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:212761 Archived-At: Eric Abrahamsen writes: > Drew Adams writes: > >>> As mentioned in a thread in emacs.help, I've got some suggestions for >>> the parts of the Elisp manual that touch on the quit-restore window >>> parameter, and its behaviors. >>> >>> I've attached a diff with my edits; if/when some version of this is >>> eventually approved I can do a proper commit. >>> >>> I didn't add anything in the Window Parameters section about the first >>> two elements of the quit-restore parameter, simply because I don't >>> understand them well enough. I still think something should be said >>> there about how they influence quit behavior, though -- this is the >>> first place that people will look to find out how this works, and the >>> current docs are very clear about "what", but beg the question of "why". >> >> Good initiative! Thanks. I agree that more is needed, but I >> too don't understand it well enough. > > There's some pretty deep grass, here. I only just came across "Side > Windows", which is pretty interesting -- that could conceivably do away > with Gnus' whole homemade window configuration setup. > > If Marcin ends up patching `display-buffer-record-window' to un-set *Martin, sorry. > buffer history when appropriate, I think it would also be worth > mentioning that function in the docs, as the go-to function for setting > the quit-restore parameter. > > E