Re: 29.0.60; keymap-local-set and keymap-global-set became less strict

[Eli Zaretskii]

> From: Richard Stallman <rms@gnu.org>
> Cc: emacs-devel@gnu.org
> Date: Fri, 03 Feb 2023 04:56:49 -0500
> 
>   > The advertised API wouldn't change.  We don't expect anyone to use the
>   > additional argument in non-interactive invocation.  We can use
>   > advertised-calling-convention declaration to hide that argument from
>   > documented interfaces.
> 
> Why hide it?   It's better to document it.
> Occasionally, passing a nontrivial value for that argument is useful.

We don't want Lisp programs to call this function pretending to be the
user, because this function's raison d'être is to catch invalid key
sequences.  So we don't want to advertise that argument in the
documentation.  Of course, anyone who looks at the source will quickly
discover the argument and will be able to take advantage of it.  But
we don't want that to be too easy.

As for documenting it: I don't see the need, as its role is crystal
clear once one looks at the code which uses it.