[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.
- Lispref add-to-list - doc is unnecessary convoluted, Arthur Miller, 2020/12/03
- Re: Lispref add-to-list - doc is unnecessary convoluted, Christopher Dimech, 2020/12/03
- Re: Lispref add-to-list - doc is unnecessary convoluted, Robin Tarsiger, 2020/12/03
- Re: Lispref add-to-list - doc is unnecessary convoluted,
Eli Zaretskii <=
- Re: Lispref add-to-list - doc is unnecessary convoluted, Arthur Miller, 2020/12/04
- Re: Lispref add-to-list - doc is unnecessary convoluted, Robin Tarsiger, 2020/12/04
- Re: Ad-hoc list structure tutorializing (was: Lispref add-to-list - doc is unnecessary convoluted), Robin Tarsiger, 2020/12/04
- Re: Ad-hoc list structure tutorializing, Stefan Monnier, 2020/12/04
- Re: Ad-hoc list structure tutorializing, Christopher Dimech, 2020/12/04
- Re: Ad-hoc list structure tutorializing, Eli Zaretskii, 2020/12/05
- Re: Ad-hoc list structure tutorializing, Richard Stallman, 2020/12/06
- Re: Ad-hoc list structure tutorializing, Robin Tarsiger, 2020/12/06
- Re: Ad-hoc list structure tutorializing, Arthur Miller, 2020/12/06
- Re: Ad-hoc list structure tutorializing, Richard Stallman, 2020/12/06