emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: lispref/variables.texi


From: Kim F. Storm
Subject: Re: lispref/variables.texi
Date: Fri, 24 Jun 2005 10:14:39 +0200
User-agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux)

Luc Teirlinck <address@hidden> 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 <address@hidden> http://www.cua.dk





reply via email to

[Prev in Thread] Current Thread [Next in Thread]