bug#34708: alist-get has unclear documentation

[Michael Heerdegen]

"Miguel V. S. Frasson" <mvsfrasson@gmail.com> 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.