From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: completion-auto-help Date: Fri, 11 Nov 2005 14:10:30 -0500 Message-ID: <87y83vngw6.fsf-monnier+emacs@gnu.org> References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1131736419 21413 80.91.229.2 (11 Nov 2005 19:13:39 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 11 Nov 2005 19:13:39 +0000 (UTC) Cc: Emacs-Devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 11 20:13:39 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EaeJ7-0007in-ON for ged-emacs-devel@m.gmane.org; Fri, 11 Nov 2005 20:11:30 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EaeJ7-0004LJ-52 for ged-emacs-devel@m.gmane.org; Fri, 11 Nov 2005 14:11:29 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EaeIC-0003vC-OU for emacs-devel@gnu.org; Fri, 11 Nov 2005 14:10:32 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EaeIB-0003uf-Th for emacs-devel@gnu.org; Fri, 11 Nov 2005 14:10:32 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EaeIB-0003uW-Lq for emacs-devel@gnu.org; Fri, 11 Nov 2005 14:10:31 -0500 Original-Received: from [209.226.175.25] (helo=tomts5-srv.bellnexxia.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EaeIB-0003Vw-Go for emacs-devel@gnu.org; Fri, 11 Nov 2005 14:10:31 -0500 Original-Received: from alfajor ([65.92.243.185]) by tomts5-srv.bellnexxia.net (InterMail vM.5.01.06.10 201-253-122-130-110-20040306) with ESMTP id <20051111191030.ODZY26967.tomts5-srv.bellnexxia.net@alfajor>; Fri, 11 Nov 2005 14:10:30 -0500 Original-Received: by alfajor (Postfix, from userid 1000) id BEBD4D7662; Fri, 11 Nov 2005 14:10:30 -0500 (EST) Original-To: "Drew Adams" In-Reply-To: (Drew Adams's message of "Fri, 11 Nov 2005 09:47:45 -0800") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) 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:45763 Archived-At: > complete.el extends the meaning of the variable so that a non-nil non-t > value means "show the help but only on the second attempt to complete". > I.e. if TAB finds nothing to complete, the first TAB will just > say "[Next > char not unique]" without bringing up the *Completions* buffer, and the > second TAB will then bring up the *Completions* buffer. > It happens to be my favorite behavior. > Thanks. I knew about that behavior, but I couldn't make out the related use > of completion-auto-help. > I still don't see it in complete.el (it is only tested there, never bound), > and I don't see it in C code either. Where is `completion-auto-help's > non-nil, non-t value bound? completion-auto-help is a user variable. It's only meant to be changed in the .emacs file. > If it is only a user who sets such a value, then shouldn't the non-nil, > non-t behavior be documented for the user option? I don't see that, as I > mentioned. It's not documented, because there's no place to document it: completion-auto-help is part of the basic completion facilities, whereas the added behavior is only provided in complete.el which is a separate package. > I proposed `eager' _without_ the automatic update after each keystroke, in > order to allow that as an additional (separate) option. I think that would > be better. Some people (or some functions) might like to display the list of > candidates right from the beginning, as a kind of menu, but prefer to update > it only upon demand (via `TAB'), not automatically at each keystroke. Some > people might find the automatic list updating to be distracting (I find it > very helpful, personally). I'd wait to see people complaint about one of the two behaviors before providing both. > gets called inside `completing-read', upon insertion, but I see no way to > get `completing-read' to display *Completions* without any user action. IIRC you can do it from minibuffer-setup-hook. Stefan