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:37:38 -0800 Message-ID: <87r32cgwz1.fsf@ericabrahamsen.net> References: <87varoh5ka.fsf@ericabrahamsen.net> <9507c432-6677-4f76-a7c4-b5958f126106@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1488688724 5678 195.159.176.226 (5 Mar 2017 04:38:44 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 5 Mar 2017 04:38:44 +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:38:38 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 1ckNwM-0000PF-5Z for ged-emacs-devel@m.gmane.org; Sun, 05 Mar 2017 05:38:38 +0100 Original-Received: from localhost ([::1]:37496 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ckNwO-0002XE-Mn for ged-emacs-devel@m.gmane.org; Sat, 04 Mar 2017 23:38:40 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48185) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ckNvp-0002X4-KM for emacs-devel@gnu.org; Sat, 04 Mar 2017 23:38:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ckNvm-0001Qm-IW for emacs-devel@gnu.org; Sat, 04 Mar 2017 23:38:05 -0500 Original-Received: from [195.159.176.226] (port=46749 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ckNvm-0001QI-B5 for emacs-devel@gnu.org; Sat, 04 Mar 2017 23:38:02 -0500 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1ckNvb-0004bh-50 for emacs-devel@gnu.org; Sun, 05 Mar 2017 05:37:51 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 29 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:axjqHHQmIr/ReeHFfJNZHQ7j91M= 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:212760 Archived-At: 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 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