bug#50727: Contradictory conventions with new command kbd-macro-display

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

>>     The key sequences [C-x C-k 0] through [C-x C-k 9] and [C-x C-k A]
>>     through [C-x C-k Z] are reserved for user bindings, and to bind to
>>     one of these sequences, just enter the digit or letter, rather than
>>     the whole sequence.
>
> Regardless of the main issue here, why does this doc string use this
> strange notation for key sequences?  What is the meaning of the
> brackets here, and why don't we use `..' as usual?

AFAICT, there is no particular reason for using that notation here.
I'll push a fix for that shortly, lumped in with some other checkdoc
fixes.