Re: map.el documentation

[arthur miller]

> >     Augusto> At first I thought that would be a bad idea.  However, if one

> > actually

> >     Augusto> cares about speed and is fine with consing a possibly repeated

> > key, then

> >     Augusto> arguably one shouldn't use map.el -- there already is cons for

> > that.  So

> >     Augusto> it makes sense to use map.el to supply an implementation of the

> >     Augusto> operation you want.

> >

> > Yes. If we worry about backwards compatibility we can call it

> > `map-insert!'

>

> Please don't do that :-).

>

> map-insert! should be reserved for the destructive version.

Can you please not?

If you want a destructive operation, at least use a name that is

traditionally used in Elisp, something like map-ninsert.

On international keyboards, at least Swedish, it is less ergonomic to

type "!"  than "n". It also puts unnecessary cognitive dissonance on

the API, where now some destructive operations are prefixed with "n" and

some with "!".