GNU bug report logs - #13451
24.3.50; doc of `window-persistent-parameters' and window parameters generally

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 13451 in the body.
You can then email your comments to 13451 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.3.50;
	doc of `window-persistent-parameters' and window parameters generally
Date: Tue, 15 Jan 2013 10:36:57 -0800

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 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.
 
In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600)
 of 2012-12-31 on ODIEONE
Bzr revision: 111388 rudalics <at> gmx.at-20121231113513-subz2dazg6yjukzh
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.7) --no-opt --enable-checking --cflags
 -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'
 

Message #8 received at 13451 <at> debbugs.gnu.org (full text, mbox):

From: martin rudalics <rudalics <at> gmx.at>
To: Drew Adams <drew.adams <at> oracle.com>, 13451 <at> debbugs.gnu.org
Subject: Re: bug#13451: 24.3.50; doc of `window-persistent-parameters' and
 window parameters generally
Date: Fri, 13 Feb 2015 19:22:22 +0100

> 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 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.

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.

martin

Message #11 received at 13451 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: martin rudalics <rudalics <at> gmx.at>, 13451 <at> debbugs.gnu.org
Subject: RE: bug#13451: 24.3.50; doc of `window-persistent-parameters' and
 window parameters generally
Date: Fri, 13 Feb 2015 13:06:58 -0800 (PST)

>  > 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 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.
> 
> 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 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 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.

Message #14 received at 13451 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: martin rudalics <rudalics <at> gmx.at>, 13451 <at> debbugs.gnu.org
Subject: Re: bug#13451: 24.3.50; doc of `window-persistent-parameters' and
 window parameters generally
Date: Thu, 15 Jul 2021 11:14:05 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> 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 the
>   very least `clone-of', which is apparently the only one saved/restored by
>   default (at least on MS Windows).

These are described (now) in the Window Parameters section in the
lispref manual.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.