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: Thu, 9 Aug 2012 07:21:06 -0700 Message-ID: <7F77380D0CBD41C0AC4452F9BACC9709@us.oracle.com> References: <50237869.5000004@gmx.at> 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 1344522127 10756 80.91.229.3 (9 Aug 2012 14:22:07 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 9 Aug 2012 14:22:07 +0000 (UTC) Cc: 12158@debbugs.gnu.org To: "'martin rudalics'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Aug 09 16:22:06 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 1SzTcg-0007Qo-Oe for geb-bug-gnu-emacs@m.gmane.org; Thu, 09 Aug 2012 16:22:02 +0200 Original-Received: from localhost ([::1]:43155 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SzTcf-0007qB-T4 for geb-bug-gnu-emacs@m.gmane.org; Thu, 09 Aug 2012 10:22:01 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:52239) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SzTca-0007eJ-T3 for bug-gnu-emacs@gnu.org; Thu, 09 Aug 2012 10:21:57 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SzTcW-0001s3-TZ for bug-gnu-emacs@gnu.org; Thu, 09 Aug 2012 10:21:56 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:35330) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SzTcW-0001rz-Q6 for bug-gnu-emacs@gnu.org; Thu, 09 Aug 2012 10:21:52 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SzTkQ-0003p7-Bo for bug-gnu-emacs@gnu.org; Thu, 09 Aug 2012 10:30: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: Thu, 09 Aug 2012 14:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12158 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 12158-submit@debbugs.gnu.org id=B12158.134452256814631 (code B ref 12158); Thu, 09 Aug 2012 14:30:02 +0000 Original-Received: (at 12158) by debbugs.gnu.org; 9 Aug 2012 14:29:28 +0000 Original-Received: from localhost ([127.0.0.1]:44875 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SzTjs-0003nw-Jf for submit@debbugs.gnu.org; Thu, 09 Aug 2012 10:29:28 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]:30621) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SzTjp-0003nl-AE for 12158@debbugs.gnu.org; Thu, 09 Aug 2012 10:29:26 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q79ELDnb023046 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 9 Aug 2012 14:21:14 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q79ELC5S006035 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 9 Aug 2012 14:21:13 GMT Original-Received: from abhmt120.oracle.com (abhmt120.oracle.com [141.146.116.72]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q79ELCxg010399; Thu, 9 Aug 2012 09:21:12 -0500 Original-Received: from dradamslap1 (/10.159.217.233) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 09 Aug 2012 07:21:12 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <50237869.5000004@gmx.at> Thread-Index: Ac12CzDbLyChUVBWTqC0lVN66/UmEgALlW2A X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] 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:62972 Archived-At: > The value of the `quit-restore' parameter is set by the buffer display > routines and inspected when quitting the window. Applications are not > supposed to inspect or alter the value of this parameter. If this is supposed to be internal, then do not doc it. If not, please doc it so readers can understand. I only came to this doc because you pointed me to it explicitly, when trying to investigate a (user) bug. So it's not super clear (to me) just how internal this topic should be. > The window-pub branch contains a detailed description of an earlier > version of this parameter. You can find it here: > http://bzr.savannah.gnu.org/lh/emacs/old-branches/window-pub/a nnotate/head:/doc/lispref/windows.texi The existence of that description outside of Emacs does not help users much. > In the course of subsequent changes to the buffer display code, this > description was omitted from the current version of the manual. I guess you are saying that that omission was a mistake. Please include the missing info, then. > These parameters are listed in this node in order to tell programmers > that their names are in use and which parts of the Emacs code use it. > If any information is missing, please provide a report. It is not up to me to determine all that might be missing - I have no idea. The explanation should be be complete and understandable; that's all.