emacs-devel
[Top][All Lists]
Advanced

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

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


From: Eli Zaretskii
Subject: Re: Lispref add-to-list - doc is unnecessary convoluted
Date: Fri, 04 Dec 2020 10:29:36 +0200

> From: Arthur Miller <arthur.miller@live.com>
> Date: Fri, 04 Dec 2020 03:17:19 +0100
> 
> +This function adds the @var{element} to a list @var{list} if

This will produce "... to a list LIST if ...", which is sub-optimal.

You omitted the part where the current doc string warns against an
argument that is not a list, and that's losing information.

> -The argument @var{symbol} is not implicitly quoted; @code{add-to-list}
> -is an ordinary function, like @code{set} and unlike @code{setq}.  Quote
> -the argument yourself if that is what you want.
> +The argument @var{list} is not implicitly quoted; @code{add-to-list}
> +is an ordinary function, like @code{set} and unlike @code{setq}.

Not sure why you want to drop the explicit suggestion to quote the
list symbol here: it's also losing information.



reply via email to

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