From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: Documentation not clear for the Lisp function set-variable Date: Mon, 27 Jun 2005 13:49:14 -0500 (CDT) Message-ID: <200506271849.j5RInEv22163@raven.dms.auburn.edu> References: <87slz6nr3h.fsf@jurta.org> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1119899117 3746 80.91.229.2 (27 Jun 2005 19:05:17 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 27 Jun 2005 19:05:17 +0000 (UTC) Cc: lekktu@gmail.com, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jun 27 21:05:16 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Dmyub-00023x-7e for ged-emacs-devel@m.gmane.org; Mon, 27 Jun 2005 21:04:53 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dmz2G-0004oF-At for ged-emacs-devel@m.gmane.org; Mon, 27 Jun 2005 15:12:48 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Dmz0V-0004BK-Lt for emacs-devel@gnu.org; Mon, 27 Jun 2005 15:10:59 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Dmyxx-0003SL-4g for emacs-devel@gnu.org; Mon, 27 Jun 2005 15:08:22 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dmyxn-0003KS-PX for emacs-devel@gnu.org; Mon, 27 Jun 2005 15:08:11 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DmylR-000843-CV; Mon, 27 Jun 2005 14:55:25 -0400 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id j5RIowCK017647; Mon, 27 Jun 2005 13:50:58 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id j5RInEv22163; Mon, 27 Jun 2005 13:49:14 -0500 (CDT) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: eliz@gnu.org In-reply-to: (message from Eli Zaretskii on Mon, 27 Jun 2005 20:39:19 +0200) 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:39683 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:39683 Eli Zaretskii wrote: This patch produces the following text: Determined by whether the first character of the documentation for the variable is `*', the variable is customizable (has a non-nil value of `standard-value' or of `custom-autoload' on its property list), or it is a non-obsolete alias for another user variable. Does anyone else think that this sentence is so confusing in its structure as to be almost unparsable? (The old sentence was even less clear.) I believe that it is also incorrect. I believe that we decided that a variable was customizable if either its docstring starts with `*' or it is defined with defcustom. Unless I misunderstood or misremember, we decided that `*' was no lomger necessary for variables defined with defcustom. Sincerely, Luc.