From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Drew Adams <drew.adams@oracle.com>
Newsgroups: gmane.emacs.bugs
Subject: bug#13451: 24.3.50;
	doc of `window-persistent-parameters' and window parameters generally
Date: Fri, 13 Feb 2015 13:06:58 -0800 (PST)
Message-ID: <3745b225-b269-4bb0-8c65-5fbe5b6515c8@default>
References: <E171D6D6D5AD420F9B758EA4431CB047@us.oracle.com>
	<54DE40DE.2090506@gmx.at>
NNTP-Posting-Host: plane.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Trace: ger.gmane.org 1423861713 30286 80.91.229.3 (13 Feb 2015 21:08:33 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Fri, 13 Feb 2015 21:08:33 +0000 (UTC)
To: martin rudalics <rudalics@gmx.at>, 13451@debbugs.gnu.org
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Feb 13 22:08:13 2015
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1YMNT8-0007F2-NC
	for geb-bug-gnu-emacs@m.gmane.org; Fri, 13 Feb 2015 22:08:10 +0100
Original-Received: from localhost ([::1]:57470 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1YMNT7-0002Rz-Uo
	for geb-bug-gnu-emacs@m.gmane.org; Fri, 13 Feb 2015 16:08:09 -0500
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43685)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YMNT4-0002Qd-AU
	for bug-gnu-emacs@gnu.org; Fri, 13 Feb 2015 16:08:07 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YMNT0-0005Xk-2Z
	for bug-gnu-emacs@gnu.org; Fri, 13 Feb 2015 16:08:06 -0500
Original-Received: from debbugs.gnu.org ([140.186.70.43]:51062)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YMNSz-0005Xg-Vb
	for bug-gnu-emacs@gnu.org; Fri, 13 Feb 2015 16:08:02 -0500
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YMNSz-0005aP-N2
	for bug-gnu-emacs@gnu.org; Fri, 13 Feb 2015 16:08:01 -0500
X-Loop: help-debbugs@gnu.org
Resent-From: Drew Adams <drew.adams@oracle.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Fri, 13 Feb 2015 21:08:01 +0000
Resent-Message-ID: <handler.13451.B13451.142386162921405@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 13451
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
Original-Received: via spool by 13451-submit@debbugs.gnu.org id=B13451.142386162921405
	(code B ref 13451); Fri, 13 Feb 2015 21:08:01 +0000
Original-Received: (at 13451) by debbugs.gnu.org; 13 Feb 2015 21:07:09 +0000
Original-Received: from localhost ([127.0.0.1]:42302 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1YMNS8-0005ZA-N9
	for submit@debbugs.gnu.org; Fri, 13 Feb 2015 16:07:09 -0500
Original-Received: from userp1040.oracle.com ([156.151.31.81]:34287)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <drew.adams@oracle.com>) id 1YMNS6-0005Yf-KQ
	for 13451@debbugs.gnu.org; Fri, 13 Feb 2015 16:07:07 -0500
Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93])
	by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with
	ESMTP id t1DL70u5001680
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
	Fri, 13 Feb 2015 21:07:00 GMT
Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231])
	by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	t1DL6xT5012999
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL);
	Fri, 13 Feb 2015 21:06:59 GMT
Original-Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7])
	by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	t1DL6wlD003361; Fri, 13 Feb 2015 21:06:58 GMT
In-Reply-To: <54DE40DE.2090506@gmx.at>
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2  (807160) [OL
	12.0.6691.5000 (x86)]
X-Source-IP: ucsinet21.oracle.com [156.151.31.93]
X-BeenThere: debbugs-submit@debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x
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" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=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:99329
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/99329>

>  > I'm looking for information about window configurations and what
>  > gets saved/restored etc.
>  >
>  > I do `C-h v window-persistent-parameters', and I see that the current
>  > value, which is apparently the default, is ((clone-of . t)).
>  >
>  > Naturally, I want to know what this means, so I read the rest of the
>  > *Help* buffer.  Nada.  Well, the `t' is explained, but not the
>  > `clone-of'.  Not very helpful help.
>  >
>  > So I search the Elisp manual.  I come across nodes `Window
>  > Configurations' and `Window Parameters'.  The latter, in particular,
>  > seems like it should list the possible parameters, including `clone-of=
',
>  > which is the parameter saved in a window config by default.
>  >
>  > Nada.  Again, the CDR of `window-persistent-parameters' is described
>  > (possible values nil, t, writable), but nothing about the CAR - its
>  > possible values.  Again, not very helpful help.
>  >
>  > Please document the possible values for the CAR, at least the most
>  > common ones, and at the very least `clone-of', which is apparently the
>  > only one saved/restored by default (at least on MS Windows).
>  >
>  > Please describe the window parameters: what they are, what behaviors t=
hey
>  > affect, and how.  Describing a window configuration as a saved set of
>  > window parameters is not very useful if one cannot find out what the
>  > parameters are or what they do.
>=20
> I'm not sure what to do.  If there is something particular that is
> unclear or you don't understand, please point that out.  The CAR of a
> `window-persistent-parameters' entry specifies the parameter that shall
> be treated specially.  What more do you want me to say about it?  The
> `clone-of' parameter is used by the window code itself and the manual
> tells so.  If there's anything particular the user or application
> programmer should know, the manual will have to be rewritten.  Currently
> there isn't.

I think the request is pretty clear:

  Please document the possible values for the CAR [of
  `window-persistent-parameters'], at least the most common ones, and at th=
e
  very least `clone-of', which is apparently the only one saved/restored by
  default (at least on MS Windows).

  Please describe the window parameters: what they are, what behaviors they
  affect, and how.  Describing a window configuration as a saved set of
  window parameters is not very useful if one cannot find out what the
  parameters are or what they do.

That's what to do.  Thx.