GNU bug report logs - #3320
23.0.93; Rename `mini-' options

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 3320 in the body.
You can then email your comments to 3320 AT debbugs.gnu.org in the normal way.

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

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <emacs-pretest-bug <at> gnu.org>
Subject: 23.0.93; Rename `mini-' options
Date: Sun, 17 May 2009 15:44:58 -0700

See the discussion at emacs-devel <at> gnu.org with the same Subject line.
 
It was suggested that I also file a bug for this:
 
> Drew, could you report this as a bug to emacs-pretest-bug <at> gnu.org?
> I understand that you started a discussion in emacs-devel to reach
> a wider audience, but unless it is not in the bug database, it will
> remain unfixed, and these misleading names have bitten me too.
 
So this is that bug report.
 
Please rename these options from using `mini-' to something that
indicates what they act on. Suggestions:
 
* Rename `resize-mini-windows' to `minibuffer-echo-area-resize'.
 
* Rename `max-mini-window-height' to
  `minibuffer-echo-area-max-height'.
 
Please also change the doc strings to not mention `mini-windows',
which are not defined, in any case. Make it clear that these act on
the minibuffer and echo area.
 

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)'
 

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

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 3320 <at> debbugs.gnu.org
Subject: Re: 23.0.93; Rename `mini-' options
Date: Mon, 11 Jul 2011 17:55:52 +0200

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

> Please rename these options from using `mini-' to something that
> indicates what they act on. Suggestions:
>
> * Rename `resize-mini-windows' to `minibuffer-echo-area-resize'.
>
> * Rename `max-mini-window-height' to
>   `minibuffer-echo-area-max-height'.

Renaming these would create too much churn for too little benefit.

> Please also change the doc strings to not mention `mini-windows',
> which are not defined, in any case. Make it clear that these act on
> the minibuffer and echo area.

I've now clarified this.

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

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Lars Magne Ingebrigtsen'" <larsi <at> gnus.org>
Cc: 3320 <at> debbugs.gnu.org
Subject: RE: 23.0.93; Rename `mini-' options
Date: Mon, 11 Jul 2011 09:21:22 -0700

> > Please rename these options from using `mini-' to something that
> > indicates what they act on. Suggestions:
> >
> > * Rename `resize-mini-windows' to `minibuffer-echo-area-resize'.
> > * Rename `max-mini-window-height' to
> >   `minibuffer-echo-area-max-height'.
> 
> Renaming these would create too much churn for too little benefit.

1. What churn?  Only a few source-code lines to change and 2 aliases to create.
User clarity going forward.

2. Read the subject line.  You did not fix this bug, so do not classify it as
"fixed".  Classify it as "won't fix", if that is the Emacs Dev decision.

Previous Next

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