Re: map.el documentation

[Eli Zaretskii]

> From: Robert Pluim <rpluim@gmail.com>
> Cc: arash@gnu.org,  emacs-devel@gnu.org
> Date: Thu, 23 Jan 2025 18:26:08 +0100
> 
> >>>>> On Thu, 23 Jan 2025 17:16:12 +0200, Eli Zaretskii <eliz@gnu.org> said:
>     >> 
>     >> Then where do we put the explanations about things to look out for
>     >> when using arrays with "map.el"?
> 
>     Eli> What things?
> 
> Arrays inherently canʼt grow or shrink, so if you do
> 
> (setq x (map-delete [a b c] 2))
> 
> then
> 
> (map-contains-key x 2) => t
> 
> which is counterintuitive for a data structure that purports to map
> keys to values.

If you want to suggest changes to the doc strings for the above issue
(doesn't the existing doc string already says to expect the result?),
please go ahead, and thanks.