Subject: bug#60859: [PATCH] Remove reference to the kbd function from documentation

From: Robert Pluim <[email-masked]>
Date: Tue, 17 Jan 2023 15:56:27 +0100

>>>>> On Tue, 17 Jan 2023 16:20:38 +0200, Panagiotis Koutsourakis <[email-masked]> said:
    Panagiotis> +Please note that these functions do not accept a simple string to
    Panagiotis> +specify the binding but need a key sequence. The easiest way to
    Panagiotis> +produce one is to use the function @code{kbd}.  For more details about
    Panagiotis> +binding keys using Lisp @ref{Keymaps,,, elisp, The Emacs Lisp
    Panagiotis> +Reference Manual}.
    Panagiotis> +

Those functions *do* accept simple strings, you just have to write them
a certain way, eg "\C-ca" :-)

How about

--begin--
There are several syntaxes that can be used to specify the binding,
but the simplest and most consistent is the one accepted by
@code{kbd}, which is basically a series of characters separated by
spaces.  Keys with modifiers can be specified by prepending the
modifier, such as @samp{C-} for Control, or @samp{M-} for Meta.  For
example, to bind @samp{C-x} followed by @samp{a}, use

@example
kbd("C-x a")
@end example
--end--

Robert
--