From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: "Richard M. Stallman" <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: completion-auto-help
Date: Fri, 11 Nov 2005 22:38:50 -0500
Message-ID: <E1EamE6-0002Rl-JM@fencepost.gnu.org>
References: <MEEKKIABFKKDFJMPIOEBIEGFCNAA.drew.adams@oracle.com>
	<87lkzvpz2s.fsf-monnier+emacs@gnu.org>
Reply-To: rms@gnu.org
NNTP-Posting-Host: main.gmane.org
Content-Type: text/plain; charset=ISO-8859-15
X-Trace: sea.gmane.org 1131766897 28128 80.91.229.2 (12 Nov 2005 03:41:37 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Sat, 12 Nov 2005 03:41:37 +0000 (UTC)
Cc: drew.adams@oracle.com, emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Nov 12 04:41:36 2005
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Original-Received: from lists.gnu.org ([199.232.76.165])
	by ciao.gmane.org with esmtp (Exim 4.43)
	id 1EamFn-00022C-H1
	for ged-emacs-devel@m.gmane.org; Sat, 12 Nov 2005 04:40:35 +0100
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1EamFm-0002ZN-Tl
	for ged-emacs-devel@m.gmane.org; Fri, 11 Nov 2005 22:40:34 -0500
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1EamE8-0001wu-DX
	for emacs-devel@gnu.org; Fri, 11 Nov 2005 22:38:52 -0500
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1EamE7-0001wP-In
	for emacs-devel@gnu.org; Fri, 11 Nov 2005 22:38:51 -0500
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1EamE7-0001wJ-9W
	for emacs-devel@gnu.org; Fri, 11 Nov 2005 22:38:51 -0500
Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.34) id 1EamE7-0005sC-H8
	for emacs-devel@gnu.org; Fri, 11 Nov 2005 22:38:51 -0500
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34)
	id 1EamE6-0002Rl-JM; Fri, 11 Nov 2005 22:38:50 -0500
Original-To: Stefan Monnier <monnier@iro.umontreal.ca>
In-reply-to: <87lkzvpz2s.fsf-monnier+emacs@gnu.org> (message from Stefan
	Monnier on Thu, 10 Nov 2005 23:55:28 -0500)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=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:45795
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/45795>

    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.

Could you document this?  It seems not to be documented now,
not even in complete.el.  It would be convenient to document this
in the doc string of that variable.