From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: Documentation not clear for the Lisp function set-variable
Date: Tue, 28 Jun 2005 06:37:25 +0200
Message-ID: <uvf3zdrlm.fsf@gnu.org>
References: <b6d534df05061904146383fed@mail.gmail.com>
	<E1DkDIo-0004LD-FN@fencepost.gnu.org> <87slz6nr3h.fsf@jurta.org>
	<f7ccd24b050627060437f84b8b@mail.gmail.com> <u7jgffxuw.fsf@gnu.org>
	<f7ccd24b050627143848fe593@mail.gmail.com>
Reply-To: Eli Zaretskii <eliz@gnu.org>
NNTP-Posting-Host: main.gmane.org
X-Trace: sea.gmane.org 1119929768 14381 80.91.229.2 (28 Jun 2005 03:36:08 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Tue, 28 Jun 2005 03:36:08 +0000 (UTC)
Cc: emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jun 28 05:36:00 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 1Dn6sv-00010d-8u
	for ged-emacs-devel@m.gmane.org; Tue, 28 Jun 2005 05:35:41 +0200
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1Dn70g-0005OQ-Ny
	for ged-emacs-devel@m.gmane.org; Mon, 27 Jun 2005 23:43:42 -0400
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1Dn6ww-00046z-5S
	for emacs-devel@gnu.org; Mon, 27 Jun 2005 23:39:50 -0400
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1Dn6ws-00043e-CQ
	for emacs-devel@gnu.org; Mon, 27 Jun 2005 23:39:46 -0400
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1Dn6ws-00043N-1A
	for emacs-devel@gnu.org; Mon, 27 Jun 2005 23:39:46 -0400
Original-Received: from [192.114.186.66] (helo=romy.inter.net.il)
	by monty-python.gnu.org with esmtp (Exim 4.34) id 1Dn6z1-0008Uh-OE
	for emacs-devel@gnu.org; Mon, 27 Jun 2005 23:42:01 -0400
Original-Received: from HOME-C4E4A596F7 (IGLD-80-230-84-173.inter.net.il
	[80.230.84.173]) by romy.inter.net.il (MOS 3.5.8-GR)
	with ESMTP id BQY24782 (AUTH halo1);
	Tue, 28 Jun 2005 06:37:26 +0300 (IDT)
Original-To: Juanma Barranquero <lekktu@gmail.com>
In-reply-to: <f7ccd24b050627143848fe593@mail.gmail.com> (message from Juanma
	Barranquero on Mon, 27 Jun 2005 23:38:52 +0200)
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:39722
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:39722

> Date: Mon, 27 Jun 2005 23:38:52 +0200
> From: Juanma Barranquero <lekktu@gmail.com>
> Cc: emacs-devel@gnu.org
> 
> What about this patch? Do you like it a bit more?
> 
> +VARIABLE is considered to be a `user variable' if
> +\(1) the first character of its documentation is `*', or
> +\(2) it is customizable (its property list contains a non-nil value
> +    of `standard-value' or `custom-autoload'), or
> +\(3) it is an alias for another user variable.
> +Return nil if VARIABLE is an alias and there is a loop in the
> +chain of symbols.  */)

It is better, but I think if you start the sentence with

  A variable is a user variable if

it would be better yet.

Thanks.