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

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Tue, 21 Sep 2021 23:53:06 -0700
> Cc: 50727@debbugs.gnu.org, larsi@gnus.org, marcowahlsoft@gmail.com
> 
> 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.

Thanks.