bug#17766: 24.3; error message on [M-RET] not to [?\M-\r] but to "\M-\r"

[Emanuel Berg]

>From a post on gnu.emacs.help:

... another thing, when you do

(global-set-key [M-RET] 'find-file-at-line)

it says

(error "To bind the key M-RET, use \"\\M-\\r\", not [M-RET]")

- that should indicate "\M-\r", right?

So why does the [...] syntax recommend the "..."
syntax, if the "..." is the one outdated/incomplete and
[...] the one modern/universal?

- and I was told it is a bug. It makes sense it is a
bug, because it doesn't make any sense, *if* indeed the
"..." is considered legacy (which I haven't done
anything to verify, but I believed him).


In GNU Emacs 24.3.1 (x86_64-pc-linux-gnu, GTK+ Version 3.8.6)
 of 2013-12-22 on brahms, modified by Debian
System Description:     Debian GNU/Linux 7.5 (wheezy)

Configured using:
 `configure '--build' 'x86_64-linux-gnu' '--build'
 'x86_64-linux-gnu' '--prefix=/usr'
 '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib'
 '--localstatedir=/var/lib' '--infodir=/usr/share/info'
 '--mandir=/usr/share/man' '--with-pop=yes'
 
'--enable-locallisppath=/etc/emacs24:/etc/emacs:/usr/local/share/emacs/24.3/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/24.3/site-lisp:/usr/share/emacs/site-lisp'
 '--with-crt-dir=/usr/lib/x86_64-linux-gnu'
 '--with-x=yes' '--with-x-toolkit=gtk3'
 '--with-toolkit-scroll-bars'
 'build_alias=x86_64-linux-gnu' 'CFLAGS=-g -O2
 -fstack-protector --param=ssp-buffer-size=4 -Wformat
 -Werror=format-security -Wall' 'LDFLAGS=-Wl,-z,relro'
 'CPPFLAGS=-D_FORTIFY_SOURCE=2''

Important settings:
  value of $LANG: en_US.UTF-8
  locale-coding-system: utf-8-unix
  default enable-multibyte-characters: t

Major mode: Message

Minor modes in effect:
  gnus-message-citation-mode: t
  show-paren-mode: t
  shell-dirtrack-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  auto-composition-mode: t
  auto-fill-function: message-do-auto-fill
  transient-mark-mode: t
  abbrev-mode: t

Recent input:
C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p 
C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p 
C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p 
C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p 
C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p 
C-p C-p C-p C-p C-p C-p C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-p RET ESC o ESC p 
C-n C-n TAB RET TAB RET ဃ i ဃ ESC o ESC o ESC x s e 
e DEL n t m a i l RET ESC o ESC o ESC p i RET C-x k 
RET n ESC 0 m ESC 0 ခ m ESC 0 ခ n m DEL DEL Đ Đ Đ Đ 
Đ Đ Đ Đ C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p 
C-p C-p C-p C-p C-p C-p C-a C-@ C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-p C-p C-e ESC w ESC x r e p o r t - b u g 
RET

Recent messages:
Processing kill file /home/incal/News/KILL...done
No more unseen articles
No more unread articles
Mark set
byte-code: Beginning of buffer [13 times]
widget-move: No buttons or fields found
Follow the link
Directory has changed on disk; type g to update Dired
Undo! [3 times]
Auto-saving...done

Load-path shadows:
/usr/share/emacs/24.3/site-lisp/debian-startup hides 
/usr/share/emacs/site-lisp/debian-startup
/usr/share/emacs24/site-lisp/flim/md4 hides /usr/share/emacs/24.3/lisp/md4
/usr/share/emacs24/site-lisp/flim/hex-util hides 
/usr/share/emacs/24.3/lisp/hex-util
/usr/share/emacs24/site-lisp/dictionaries-common/ispell hides 
/usr/share/emacs/24.3/lisp/textmodes/ispell
/usr/share/emacs24/site-lisp/dictionaries-common/flyspell hides 
/usr/share/emacs/24.3/lisp/textmodes/flyspell
/usr/share/emacs24/site-lisp/flim/ntlm hides /usr/share/emacs/24.3/lisp/net/ntlm
/usr/share/emacs24/site-lisp/flim/sasl hides /usr/share/emacs/24.3/lisp/net/sasl
/usr/share/emacs24/site-lisp/flim/sasl-digest hides 
/usr/share/emacs/24.3/lisp/net/sasl-digest
/usr/share/emacs24/site-lisp/flim/hmac-md5 hides 
/usr/share/emacs/24.3/lisp/net/hmac-md5
/usr/share/emacs24/site-lisp/flim/sasl-ntlm hides 
/usr/share/emacs/24.3/lisp/net/sasl-ntlm
/usr/share/emacs24/site-lisp/flim/hmac-def hides 
/usr/share/emacs/24.3/lisp/net/hmac-def
/usr/share/emacs24/site-lisp/flim/sasl-cram hides 
/usr/share/emacs/24.3/lisp/net/sasl-cram

Features:
(shadow emacsbug sh-script smie executable ffap
url-parse url-vars w3m-form w3m-filter mule-util
w3m-cookie w3m-bookmark w3m-session w3m-search latexenc
conf-mode mailalias canlock ispell debug sort gnus-cite
mail-extr gnus-async gnus-bcklg gnus-kill gnus-ml pop3
nndraft nnmh nnml nnfolder parse-time netrc gnutls
network-stream starttls tls gnus-agent gnus-srvr
gnus-score score-mode nnvirtual gnus-msg gnus-art mm-uu
mml2015 epg-config mm-view mml-smime smime dig mailcap
nntp gnus-cache gnus-sum nnoo gnus-group gnus-undo
nnmail mail-source gnus-start gnus-spec gnus-int
gnus-range gnus-win thingatpt tabify paren w3m
browse-url doc-view image-mode timezone w3m-hist w3m-fb
bookmark-w3m w3m-ems w3m-ccl ccl w3m-favicon w3m-image
w3m-proc w3m-util cl ascii-art-to-unicode help-fns
cl-macs gv pcase cl-lib t-mouse jka-compr cus-edit
cus-start cus-load message format-spec rfc822 mml
mml-sec mm-decode mm-bodies mm-encode mail-parse
rfc2231 mailabbrev gmm-utils mailheader man disp-table
tex-mode compile shell pcomplete comint ansi-color ring
help-mode easymenu smtpmail auth-source eieio byte-opt
bytecomp byte-compile cconv password-cache sendmail
rfc2047 rfc2045 ietf-drums gnus gnus-ems nnheader
gnus-util time-date mail-utils mm-util mail-prsvr
wid-edit edmacro kmacro dired easy-mmode w3m-load
tooltip ediff-hook vc-hooks lisp-float-type mwheel
x-win x-dnd tool-bar dnd fontset image regexp-opt
fringe tabulated-list newcomment lisp-mode register
page menu-bar rfn-eshadow timer select scroll-bar mouse
jit-lock font-lock syntax facemenu font-core frame cham
georgian utf-8-lang misc-lang vietnamese tibetan thai
tai-viet lao korean japanese hebrew greek romanian
slovak czech european ethiopic indian cyrillic chinese
case-table epa-hook jka-cmpr-hook help simple abbrev
minibuffer loaddefs button faces cus-face macroexp
files text-properties overlay sha1 md5 base64 format
env code-pages mule custom widget
hashtable-print-readable backquote make-network-process
dbusbind dynamic-setting system-font-setting
font-render-setting move-toolbar gtk x-toolkit x
multi-tty emacs)