From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Yoni Rabkin Newsgroups: gmane.emacs.devel Subject: Documentation not clear for the Lisp function set-variable Date: Sun, 19 Jun 2005 14:14:10 +0300 Message-ID: Reply-To: Yoni Rabkin NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1119180412 23778 80.91.229.2 (19 Jun 2005 11:26:52 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 19 Jun 2005 11:26:52 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jun 19 13:26:50 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DjxwX-0001xi-4D for ged-emacs-devel@m.gmane.org; Sun, 19 Jun 2005 13:26:25 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Djy2X-0005fr-AY for ged-emacs-devel@m.gmane.org; Sun, 19 Jun 2005 07:32:37 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Djy0i-00055n-IX for emacs-devel@gnu.org; Sun, 19 Jun 2005 07:30:46 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Djy0a-00051n-LR for emacs-devel@gnu.org; Sun, 19 Jun 2005 07:30:40 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Djy0a-00050a-9q for emacs-devel@gnu.org; Sun, 19 Jun 2005 07:30:36 -0400 Original-Received: from [64.233.162.195] (helo=zproxy.gmail.com) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Djxn5-0005wb-OZ for emacs-devel@gnu.org; Sun, 19 Jun 2005 07:16:39 -0400 Original-Received: by zproxy.gmail.com with SMTP id 9so500005nzo for ; Sun, 19 Jun 2005 04:14:10 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:reply-to:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition; b=INLx9P4IBQiDP7KpmnwDApQEaLE4LNF1BtaPIaJI3Ru0Gqouiz74mUMP0n11O2+8VTspDzZd9A0VWzrAatBrho0tmAvijJqN8v4KFvwwDX/y7X4Dt3nwnmCA3VGJUNDttvQzwRpYoaRpOsRcAOUtiw+z0fjlu4XWZfnAikYDHl4= Original-Received: by 10.36.221.73 with SMTP id t73mr2242014nzg; Sun, 19 Jun 2005 04:14:10 -0700 (PDT) Original-Received: by 10.36.100.6 with HTTP; Sun, 19 Jun 2005 04:14:10 -0700 (PDT) Original-To: emacs-devel@gnu.org Content-Disposition: inline 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:39107 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:39107 Hello, I'm on CVS GNU Emacs 22.0.50.1 As far as I understand, the function set-variable, called interactively will only tab-complete the names of variables defined as "interactive". This fact is not stated in the documentation string for set-variable. This is only mentioned (or could be understood) from the documentation itself. The documentation string reads as follows: "Set VARIABLE to VALUE. VALUE is a Lisp object. When using this interactively, enter a Lisp object for VALUE. If you want VALUE to be a string, you must surround it with doublequotes. VALUE is used literally, not evaluated. If VARIABLE has a `variable-interactive' property, that is used as if it were the arg to `interactive' (which see) to interactively read VALUE. If VARIABLE has been defined with `defcustom', then the type information in the definition is used to check that VALUE is valid. With a prefix argument, set VARIABLE to VALUE buffer-locally." This caused the following confusion: A user logged onto the #emacs irc channel and asked why the variable frame-title-format was not listed in the tab-completion for M-x set-variable. This means that we have at least one case of someone being confused be this. Since the name of the function is "set-variable", the limited scope is not immediately clear. --=20 "Cut your own wood and it will warm you twice" =09Regards, Yoni Rabkin Katzenell