Subject: bug#3276 closed by Chong Yidong <[email-masked]> (Re: 23.0.93; doc for minibuffer-frame-alist)

From: [email-masked] (Emacs bug Tracking System)
Date: Thu, 14 May 2009 04:10:06 +0000

This is an automatic notification regarding your bug report
which was filed against the emacs package:

#3276: 23.0.93; doc for minibuffer-frame-alist

It has been closed by Chong Yidong <[email-masked]>.

Their explanation is attached below along with your original report.
If this explanation is unsatisfactory and you have not received a
better one in a separate message then please contact Chong Yidong <[email-masked]> by
replying to this email.

-- 
3276: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3276
Emacs Bug Tracking System
Contact [email-masked] with problems

Subject: Re: 23.0.93; doc for minibuffer-frame-alist
From: Chong Yidong <[email-masked]>
To: "Drew Adams" <[email-masked]>
Cc: [email-masked]
Date: Thu, 14 May 2009 00:02:10 -0400

>  Alist of parameters for initial minibuffer frame.
>  You can set this in your init file; for example,
> 
>   (setq minibuffer-frame-alist
>         '((top . 1) (left . 1) (width . 80) (height . 2)))
> 
>  Parameters specified here supersede the values given in
>  `default-frame-alist', for a minibuffer frame.
> 
> But this option is *only* for a standalone minibuffer frame, and such
> a frame must have this frame parameter: (minibuffer . only). So that
> example is a bad one.

Actually, (minibuffer . only) is automatically appended.

> What does "if such a frame is needed" mean here?  When (why) would it
> be needed?

I clarified this in the docstring and the manual.

Subject: 23.0.93; doc for minibuffer-frame-alist
From: "Drew Adams" <[email-masked]>
To: <[email-masked]>
Date: Wed, 13 May 2009 15:10:48 -0700

In GNU Emacs 23.0.93.1 (i386-mingw-nt5.1.2600)
 of 2009-05-02 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 
Doc string says:
 
 Alist of parameters for initial minibuffer frame.
 You can set this in your init file; for example,
 
  (setq minibuffer-frame-alist
        '((top . 1) (left . 1) (width . 80) (height . 2)))
 
 Parameters specified here supersede the values given in
 `default-frame-alist', for a minibuffer frame.
 
But this option is *only* for a standalone minibuffer frame, and such
a frame must have this frame parameter: (minibuffer . only). So that
example is a bad one.
 
Elisp manual says:
 
 This variable's value is an alist of parameter values used when
 creating an initial minibuffer-only frame--if such a frame is
 needed, according to the parameters for the main initial frame.
 
What does "if such a frame is needed" mean here?  When (why) would it
be needed?  What does "according to the parameters for the main
initial frame" mean here? 
 
This description is less informative than the doc string. And like the
doc string, it should mention that parameter `minibuffer' should have
value `only'.