Subject: Re: bug#34708: alist-get has unclear documentation

From: Michael Heerdegen <[email-masked]>
Date: Sat, 02 Mar 2019 10:25:45 +0100

"Miguel V. S. Frasson" <[email-masked]> writes:

> * Last paragraph starts with `This'. What is `this'? ALIST? TESTFN?
> alist-get itself?

Only one of those makes sense to me.  Do you know what a generalized
variable is?

> * How do I use `this' or `it' to set a value? Function is alist-*get*
> but somehow I can set values. A simple example on doc-string and/or
> info node would explain everything.

That could make sense, since it's an important use case and generalized
variables are probably not something everyone is used to.

> * Action of REMOVE is described, but it doesn't correspond to code.
> REMOVE is ignored.

That's ok: the generalized variable is implemented in gv.el.

Michael.