From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Documentation not clear for the Lisp function set-variable Date: Sun, 19 Jun 2005 23:50:26 -0400 Message-ID: References: Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1119239743 3879 80.91.229.2 (20 Jun 2005 03:55:43 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 20 Jun 2005 03:55:43 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jun 20 05:55:39 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DkDNq-0008EZ-P7 for ged-emacs-devel@m.gmane.org; Mon, 20 Jun 2005 05:55:39 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DkDTz-00058x-Ms for ged-emacs-devel@m.gmane.org; Mon, 20 Jun 2005 00:01:59 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DkDRe-00040e-9G for emacs-devel@gnu.org; Sun, 19 Jun 2005 23:59:34 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DkDRX-0003w6-F7 for emacs-devel@gnu.org; Sun, 19 Jun 2005 23:59:28 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DkDRW-0003th-JK for emacs-devel@gnu.org; Sun, 19 Jun 2005 23:59:26 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DkDLw-00006g-4E for emacs-devel@gnu.org; Sun, 19 Jun 2005 23:53:40 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1DkDIo-0004LD-FN; Sun, 19 Jun 2005 23:50:26 -0400 Original-To: Yoni Rabkin In-reply-to: (message from Yoni Rabkin on Sun, 19 Jun 2005 14:14:10 +0300) 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:39144 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:39144 How about this doc string? (defun set-variable (var val &optional make-local) "Set VARIABLE to VALUE. VALUE is a Lisp object. VARIABLE should be a user option variable name, a Lisp variable meant to be customized by users. You should enter VALUE in Lisp syntax, so 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."