bug#74999: [PATCH v4] Use `keymap*-set' over `global-set-key'/`define-key' in elisp intro

[Hong Xu]

On 2024-12-26 Thu 13:46 GMT-08, Hong Xu <hong@topbug.net> wrote:

> * doc/lispintro/emacs-lisp-intro.texi (Key Bindings): Since
> `global-set-key' and `define-key' are considered legacy, we encourage
> `keymap-global-set' and `keymap-set' now.
> ---
> <...>
>
> +@findex global-unset-key
> +Historically, keys are unbound globally using a lower-function,
> +@code{global-unset-key}, which is now considered legacy.  Its key
> +binding format follows that of @code{global-set-key}.  The above key
> +unbinding example can be rewritten as:
> +@smallexample
> +@group
> +;;; Unbind 'C-x f'
> +(global-unset-key "\C-xf")
> +@end group
> +@end smallexample
> +

I'm thinking about dropping this paragraph, because `global-unset-key'
isn't commonly seen, and there's no point to over fill an introduction
with less used functions.  Please advice.

-- 
Hong