From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#12158: 24.1; unclear, incomplete doc of window parameter `quit-restore' Date: Wed, 8 Aug 2012 09:11:31 -0700 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1344442334 25093 80.91.229.3 (8 Aug 2012 16:12:14 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 8 Aug 2012 16:12:14 +0000 (UTC) To: 12158@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Aug 08 18:12:14 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Sz8rj-0003qr-5F for geb-bug-gnu-emacs@m.gmane.org; Wed, 08 Aug 2012 18:12:11 +0200 Original-Received: from localhost ([::1]:37004 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sz8ri-0006BS-CH for geb-bug-gnu-emacs@m.gmane.org; Wed, 08 Aug 2012 12:12:10 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:51082) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sz8rc-0006BA-15 for bug-gnu-emacs@gnu.org; Wed, 08 Aug 2012 12:12:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Sz8rW-00048v-1D for bug-gnu-emacs@gnu.org; Wed, 08 Aug 2012 12:12:03 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:33072) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sz8rV-00048r-Tw for bug-gnu-emacs@gnu.org; Wed, 08 Aug 2012 12:11:57 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1Sz8zK-0002ZT-HE for bug-gnu-emacs@gnu.org; Wed, 08 Aug 2012 12:20:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 08 Aug 2012 16:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12158 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.13444427969865 (code B ref -1); Wed, 08 Aug 2012 16:20:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 8 Aug 2012 16:19:56 +0000 Original-Received: from localhost ([127.0.0.1]:42618 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sz8zD-0002Z4-RQ for submit@debbugs.gnu.org; Wed, 08 Aug 2012 12:19:56 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:35928) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sz8zB-0002Yv-1t for submit@debbugs.gnu.org; Wed, 08 Aug 2012 12:19:54 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Sz8rI-00047D-1n for submit@debbugs.gnu.org; Wed, 08 Aug 2012 12:11:47 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:46578) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sz8rH-000479-US for submit@debbugs.gnu.org; Wed, 08 Aug 2012 12:11:43 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:50986) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sz8rG-0006Al-Rh for bug-gnu-emacs@gnu.org; Wed, 08 Aug 2012 12:11:43 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Sz8rA-00041g-WD for bug-gnu-emacs@gnu.org; Wed, 08 Aug 2012 12:11:42 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:30191) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Sz8rA-00040u-PU for bug-gnu-emacs@gnu.org; Wed, 08 Aug 2012 12:11:36 -0400 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q78GBX21008178 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 8 Aug 2012 16:11:34 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q78GBXBm021998 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 8 Aug 2012 16:11:33 GMT Original-Received: from abhmt112.oracle.com (abhmt112.oracle.com [141.146.116.64]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q78GBXj1031354 for ; Wed, 8 Aug 2012 11:11:33 -0500 Original-Received: from dradamslap1 (/130.35.178.248) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 08 Aug 2012 09:11:32 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac11gHmItvtV23eISQufY1wLlessKw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:62946 Archived-At: In (elisp) `Window Parameters', the description of `quit-restore' is not very helpful. It says what the parameter is used for, and how it is established, and even which function uses it. But it says _nothing_ about what the parameter value is or how to understand its various components. >From the description of `window-parameters' and experimenting using that function we can discover that `quit-restore' has a value that is a list. But that is all. What the parts of that list are and what they mean or are used for is a complete mystery. Here is an example `quit-restore' value: (frame frame # #) And? What is the expected form of the parameter value? Does it always have 4 elements? What are they - what do they mean? How are they used? OK, so there are two cross references here, that should presumably enlighten us. Following the first and searching for `quit-restore', we find NOTHING - it is not even mentioned in that node. Following the second and searching for `quit-restore', we find only this: "The function `quit-window' bases its decisions on information stored in WINDOW's `quit-restore' window parameter (*note Window Parameters::), and resets that parameter to `nil' after it's done." That does not help us at all to understand the `quit-restore' value. Searching the rest of the manual shows that there is nothing anywhere that helps us interpret `quit-restore' values. NOTE: It is possible that this comment applies also to other window parameters listed in this node. Please describe each parameter: its format (possible values), including the use/meaning of any components of possible values. In GNU Emacs 24.1.1 (i386-mingw-nt5.1.2600) of 2012-06-10 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include'