From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Documentation not clear for the Lisp function set-variable Date: Mon, 27 Jun 2005 20:39:19 +0200 Message-ID: References: <87slz6nr3h.fsf@jurta.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1119895628 25608 80.91.229.2 (27 Jun 2005 18:07:08 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 27 Jun 2005 18:07:08 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jun 27 20:07:00 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Dmy0G-0006tO-Ob for ged-emacs-devel@m.gmane.org; Mon, 27 Jun 2005 20:06:41 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dmy7x-0006sK-4l for ged-emacs-devel@m.gmane.org; Mon, 27 Jun 2005 14:14:37 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Dmy6n-0006Tq-2B for emacs-devel@gnu.org; Mon, 27 Jun 2005 14:13:25 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Dmy6l-0006T7-AJ for emacs-devel@gnu.org; Mon, 27 Jun 2005 14:13:24 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dmy2X-00055m-8r for emacs-devel@gnu.org; Mon, 27 Jun 2005 14:09:01 -0400 Original-Received: from [192.114.186.24] (helo=legolas.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Dmxe6-0003Be-7E for emacs-devel@gnu.org; Mon, 27 Jun 2005 13:43:46 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-84-228-165-2.inter.net.il [84.228.165.2]) by legolas.inter.net.il (MOS 3.5.8-GR) with ESMTP id ESS60053 (AUTH halo1); Mon, 27 Jun 2005 20:39:20 +0300 (IDT) Original-To: Juanma Barranquero In-reply-to: (message from Juanma Barranquero on Mon, 27 Jun 2005 15:04:58 +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:39677 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:39677 > Date: Mon, 27 Jun 2005 15:04:58 +0200 > From: Juanma Barranquero > Cc: rms@gnu.org, emacs-devel@gnu.org > > Try this patch, please. It doesn't modify `set-variable' but > `user-variable-p', so it returns t for non-obsolete aliases of user > variables. 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 think this sentence sorely needs rephrasing. For starters, it should not use passive tense.