From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: Rename `mini-' options Date: Sat, 16 May 2009 18:21:53 +0900 Message-ID: <87fxf5768e.fsf@catnip.gol.com> References: <26694.128.165.0.81.1242438439.squirrel@webmail.lanl.gov> <002f01c9d5cb$9fd36b00$0200a8c0@us.oracle.com> <003001c9d5ce$a044ea20$0200a8c0@us.oracle.com> <873ab5fsyu.fsf@uwakimon.sk.tsukuba.ac.jp> <87r5yp7c74.fsf@catnip.gol.com> <000001c9d5ff$c53ebe10$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1242465756 25957 80.91.229.12 (16 May 2009 09:22:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 16 May 2009 09:22:36 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat May 16 11:22:28 2009 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1M5G66-00057i-1W for ged-emacs-devel@m.gmane.org; Sat, 16 May 2009 11:22:26 +0200 Original-Received: from localhost ([127.0.0.1]:48212 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M5G65-00027u-90 for ged-emacs-devel@m.gmane.org; Sat, 16 May 2009 05:22:25 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1M5G5w-00027j-FS for emacs-devel@gnu.org; Sat, 16 May 2009 05:22:16 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1M5G5r-00027K-4m for emacs-devel@gnu.org; Sat, 16 May 2009 05:22:15 -0400 Original-Received: from [199.232.76.173] (port=55331 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M5G5r-00027H-0M for emacs-devel@gnu.org; Sat, 16 May 2009 05:22:11 -0400 Original-Received: from main.gmane.org ([80.91.229.2]:56408 helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1M5G5q-0007gV-NL for emacs-devel@gnu.org; Sat, 16 May 2009 05:22:10 -0400 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1M5G5k-0004S2-CI for emacs-devel@gnu.org; Sat, 16 May 2009 09:22:04 +0000 Original-Received: from 218.231.109.29.eo.eaccess.ne.jp ([218.231.109.29]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 16 May 2009 09:22:04 +0000 Original-Received: from miles by 218.231.109.29.eo.eaccess.ne.jp with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 16 May 2009 09:22:04 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 49 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: 218.231.109.29.eo.eaccess.ne.jp System-Type: x86_64-unknown-linux-gnu Cancel-Lock: sha1:F4EmtbOawfziiCdMrJ5pq/G8gS0= X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:110921 Archived-At: "Drew Adams" writes: >> For better or worse, Emacs traditionally distinguishes "the >> minibuffer" from "the echo area", and resize-mini-windows applies to >> both. So a name which captures this subtlety is arguably better than >> one which lies a bit for the sake of convenient document searching. > > And the name `resize-mini-windows' captures this subtlety just how? Is > it because it cleverly doesn't mention _either_ the minibuffer or the > echo area? That's supposed to help somehow? Sure. If no existing term captures a concept, then it seems a reasonable argument that it's better to make a new term than use an incorrect one. Of course, it's not always to come up with a good term, but I'm not sure what other term would be better. The terms you suggested are pithy, but seem inaccurate. Maybe it's better to just declare that "minibuffer-window" always includes the echo-area, but it's not clear to me whether this would run into other conflicts or not (e.g. uses of that term that really only intend to refer to the minibuffer's window). > The more important point is that this is an _exception_ to the rest of > the "existing practice". No where else does `mini-' occur. Eh? An "exception" to _what_ existing practice? Are there other variables/functions which control both echo-area and the minibuffer display, which use some other term than "mini-window"? > And it remains unexplained, undocumented. Perhaps the documentation could use improvement of course. Indeed, that seems like the most reasonable solution to this issue (certainly in the short term): Make sure these variables are mentioned in every place where they should be; in the end (while apropos is very convenient, it's not a replacement for the real documentation). > I apologize for not catching this bug sooner. It's not a bug, of course. -Miles -- Any man who is a triangle, has thee right, when in Cartesian Space, to have angles, which when summed, come to know more, nor no less, than nine score degrees, should he so wish. [TEMPLE OV THEE LEMUR]