Re: Lispref add-to-list - doc is unnecessary convoluted

[Arthur Miller]

Robin Tarsiger <rtt@dasyatidae.com> writes:

> Arthur Miller wrote:
>> I think it is more clear to use word 'list' instead of 'symbol' (element
>> is a symbol too for example). Not least because docs later says: "better
>> be a list". It clarifies intentions, and hopefully removes the need to say
>> things like 'better be a list'.
>
> The first argument is not itself a list. The value (as in symbol-value) of
> the first argument is expected to be a list. The first sentence of the
> documentation has that many levels of indirection because that's how many
> levels of indirection there actually are in the behavior of the function.
> Your new text does not describe it correctly.
Indeed after thinking more, I agree, the value should be a list; It
might be important to point it out :-). Sorry :-)

But can we express it somewhat simpler? LIST-VALUE? Is it more
descriptive than SYMBOL or LIST-VAR.