From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: storm@cua.dk (Kim F. Storm) Newsgroups: gmane.emacs.devel Subject: Re: lispref/variables.texi Date: Fri, 24 Jun 2005 10:14:39 +0200 Message-ID: References: <200506240108.j5O182U06623@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1119601716 14366 80.91.229.2 (24 Jun 2005 08:28:36 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 24 Jun 2005 08:28:36 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jun 24 10:28:25 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DljXu-0006L6-HD for ged-emacs-devel@m.gmane.org; Fri, 24 Jun 2005 10:28:18 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dljes-0002VL-OE for ged-emacs-devel@m.gmane.org; Fri, 24 Jun 2005 04:35:30 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Dljck-0002In-3b for emacs-devel@gnu.org; Fri, 24 Jun 2005 04:33:18 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Dljch-0002IB-It for emacs-devel@gnu.org; Fri, 24 Jun 2005 04:33:17 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dljc7-0001r3-NE for emacs-devel@gnu.org; Fri, 24 Jun 2005 04:32:39 -0400 Original-Received: from [195.41.46.236] (helo=pfepb.post.tele.dk) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DljOe-0007UM-43 for emacs-devel@gnu.org; Fri, 24 Jun 2005 04:18:44 -0400 Original-Received: from kfs-l.imdomain.dk.cua.dk (unknown [80.165.4.124]) by pfepb.post.tele.dk (Postfix) with SMTP id EADDE5EE036; Fri, 24 Jun 2005 10:14:59 +0200 (CEST) Original-To: Luc Teirlinck In-Reply-To: <200506240108.j5O182U06623@raven.dms.auburn.edu> (Luc Teirlinck's message of "Thu, 23 Jun 2005 20:08:02 -0500 (CDT)") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) 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:39415 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:39415 Luc Teirlinck writes: > I propose the following changes to the description of > `add-to-ordered' list in variables.texi. I can install if desired. These are good changes (with a few corrections). Please install. > ! in non-decreasing numerical order. @var{order} may also be omitted or > ! @code{nil}. Then the numeric order of @var{element} stays unchanged > ! if it already has one; otherwise, @var{element} has no numeric order. I suggest breaking that up for clarity: in non-decreasing numerical order. @var{order} may also be omitted or @code{nil}. Then the numeric order of @var{element} stays unchanged if it already has one; otherwise, @var{element} has no numeric order. > ! The ordering information is stored in a hash table on @var{symbol}'s > ! @code{list-order} property. You can change the numeric list order of > ! an element by a new call to @code{add-to-ordered-list}, but the only > ! way to remove the numeric order of an element once it has one is to > ! manipulate the internal hash table directly. To "remove" the order, you can specify a non-nil, non-numeric value for ORDER -- in that case, the element's order in the hash table is set to nil (which effitively means "no" ordering). -- Kim F. Storm http://www.cua.dk