[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#42835: 26.3; Doc of `cl-' functions, (cl) Naming Conventions
From: |
Drew Adams |
Subject: |
bug#42835: 26.3; Doc of `cl-' functions, (cl) Naming Conventions |
Date: |
Wed, 9 Dec 2020 08:27:46 -0800 (PST) |
> > This node has a list of functions and macros, some of which have
> > footnotes. I don't understand the footnotes (which are not
> > sentences, BTW). For example, `cl-incf' has footnote [1], which says:
> > [1] Only when PLACE is a plain variable name.
>
> This is modifying the statement before the table:
>
> ---
> The following simple functions and macros are defined in
> @file{cl-lib.el}; they do not cause other components like
> @file{cl-extra} to be loaded.
> ---
Still not clear. They are defined in cl-lib only when
PLACE is a var name? They don't cause other components
to be loaded only when PLACE is a var name?
> > Similarly for the other names and their footnotes.
>
> Same for them.
It's not clear to me whether you've fixed the doc or are
just trying to explain it to me. If the latter then this
is, I guess, a "won't fix". (It needs to be fixed.)
> > The manual entry for `cl-pushnew' is even worse. It talks only about
> > `eql' and doesn't say anything about :test. There's an xref to node
> > `Lists as Sets' for info about the keyword args, but that node also
> > says nothing about :test. Instead, that node just punts further, to
> > node `Sequences'.
>
> I've now removed the eql claim, and punted the explanation for :test to
> "Lists as Sets".
Dunno what that means. Does it mean that `Lists as Sets'
has been updated to cover the keyword args, including
:test?