Re: lispref/variables.texi

[storm@cua.dk (Kim F. Storm)]

Luc Teirlinck <teirllm@dms.auburn.edu> 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 <storm@cua.dk> http://www.cua.dk