Re: map.el documentation

[Augusto Stoffel]

On Thu, 23 Jan 2025 at 11:33, Robert Pluim wrote:

> I must admit, the semantics of `map-insert' feel more natural to me
> than `map-put!', but I guess both are needed.

I've argued in some previous bug that map-put! is misguided and should
be obsoleted.

The right concept is a map-insert! function that _may_ act destructively
on the argument.  This is the bread and butter of Lisp semantics and
gets rid of the weird `map-not-inplace` error.

(There are some other funny behaviors in map.el which IMHO should be
fixed while it's still not heavily used.)