GNU bug report logs - #13363
Documentation bug - nXML mode: C-return is not defined as stated

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 13363 in the body.
You can then email your comments to 13363 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: John Brown <johnbrown_105 <at> yahoo.com>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
Subject: Documentation bug  - nXML mode: C-return is not defined as stated
Date: Sat, 5 Jan 2013 06:38:11 -0800 (PST)

Hello All,


The nXML mode documentation distributed with Emacs (24.2.1)
states:

<C-return> performs completion on the symbol preceding point.

The GNU Emacs manual at
http://www.gnu.org/software/emacs/manual/html_mono/emacs.html:
also states:


"The major mode for editing XML documents is called nXML mode.
This is a powerful major mode that can recognize many existing
XML schema and use them to provide completion of XML elements
via C-<RET> or M-<TAB> ..."

However, C-Return does not work (message is "C-Return is
undefined"). 


Apparently this key binding was removed deliberately:

http://debbugs.gnu.org/cgi/bugreport.cgi?bug=6776

The documentation should be updated to show the correct key
binding for completion.

Regards,
John Brown.

Message #10 received at 13363-done <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: 13363-done <at> debbugs.gnu.org
Subject: Re: bug#13363: Documentation bug - nXML mode: C-return is not defined
	as stated
Date: Sat, 05 Jan 2013 14:23:02 -0500

Version: 24.2.92

John Brown wrote:

> The nXML mode documentation distributed with Emacs (24.2.1)
> states:
>
> <C-return> performs completion on the symbol preceding point.

That was fixed in the sources some time ago.

> The GNU Emacs manual at
> http://www.gnu.org/software/emacs/manual/html_mono/emacs.html:
> also states:
>
> "The major mode for editing XML documents is called nXML mode.
> This is a powerful major mode that can recognize many existing
> XML schema and use them to provide completion of XML elements
> via C-<RET> or M-<TAB> ..."

Thanks, I fixed that in the source too. (The web-page probably won't be
regenerated till at least when 24.3 is released though.)

Message #13 received at 13363-done <at> debbugs.gnu.org (full text, mbox):

From: John Brown <johnbrown_105 <at> yahoo.com>
To: "13363-done <at> debbugs.gnu.org" <13363-done <at> debbugs.gnu.org>
Subject: Re: bug#13363: Documentation bug - nXML mode: C-return is not defined
	as stated
Date: Sat, 5 Jan 2013 17:26:20 -0800 (PST)

Hello Glenn,


Glenn Morris wrote:
> 
> John Brown wrote:
> 
>>  The nXML mode documentation distributed with Emacs (24.2.1)
>>  states:
>> 
>>  <C-return> performs completion on the symbol preceding point.
> 
> That was fixed in the sources some time ago.
> 
>>  The GNU Emacs manual at
>>  http://www.gnu.org/software/emacs/manual/html_mono/emacs.html:
>>  also states:
>> 
>>  "The major mode for editing XML documents is called nXML mode.
>>  This is a powerful major mode that can recognize many existing
>>  XML schema and use them to provide completion of XML elements
>>  via C-<RET> or M-<TAB> ..."
> 
> Thanks, I fixed that in the source too. (The web-page probably won't be
> regenerated till at least when 24.3 is released though.)
> 

Looking at nxml-mode.el, I see that the correct keystroke is M-TAB.
Since this combination is used to switch from one main application
window to the next by the MS Windows and Ubuntu Linux GUIs (and
no doubt other GUIs because they tend to copy one another),it is
likely to be a problem for many users.

I recommend that the documentation suggest ways to work around
this.

Regards,
John brown.

Message #16 received at 13363-done <at> debbugs.gnu.org (full text, mbox):

From: Jambunathan K <kjambunathan <at> gmail.com>
To: John Brown <johnbrown_105 <at> yahoo.com>
Cc: "13363-done <at> debbugs.gnu.org" <13363-done <at> debbugs.gnu.org>
Subject: Re: bug#13363: Documentation bug - nXML mode: C-return is not defined
	as stated
Date: Sun, 06 Jan 2013 11:48:54 +0530

John Brown <johnbrown_105 <at> yahoo.com> writes:

> Hello Glenn,
>
>
> Glenn Morris wrote:
>> 
>> John Brown wrote:
>> 
>>>  The nXML mode documentation distributed with Emacs (24.2.1)
>>>  states:
>>> 
>>>  <C-return> performs completion on the symbol preceding point.
>> 
>> That was fixed in the sources some time ago.
>> 
>>>  The GNU Emacs manual at
>>>  http://www.gnu.org/software/emacs/manual/html_mono/emacs.html:
>>>  also states:
>>> 
>>>  "The major mode for editing XML documents is called nXML mode.
>>>  This is a powerful major mode that can recognize many existing
>>>  XML schema and use them to provide completion of XML elements
>>>  via C-<RET> or M-<TAB> ..."
>> 
>> Thanks, I fixed that in the source too. (The web-page probably won't be
>> regenerated till at least when 24.3 is released though.)
>> 
>
> Looking at nxml-mode.el, I see that the correct keystroke is M-TAB.
> Since this combination is used to switch from one main application
> window to the next by the MS Windows and Ubuntu Linux GUIs (and
> no doubt other GUIs because they tend to copy one another),it is
> likely to be a problem for many users.
>
> I recommend that the documentation suggest ways to work around
> this.

I use C-M-i.

    ,---- NEWS
    | ** nXML mode no longer binds C-RET to `nxml-complete'.
    | Completion is now performed via `completion-at-point', bound to C-M-i
    | or M-TAB.  If `nxml-bind-meta-tab-to-complete-flag' is non-nil (the
    | default), this performs tag completion.
    `----




>
> Regards,
> John brown.
>
>
>
>

-- 

Message #19 received at 13363-done <at> debbugs.gnu.org (full text, mbox):

From: Dmitry Gutov <dgutov <at> yandex.ru>
To: Jambunathan K <kjambunathan <at> gmail.com>
Cc: John Brown <johnbrown_105 <at> yahoo.com>,
	"13363-done <at> debbugs.gnu.org" <13363-done <at> debbugs.gnu.org>
Subject: Re: bug#13363: Documentation bug - nXML mode: C-return is not defined
	as stated
Date: Sun, 06 Jan 2013 11:27:20 +0400

Jambunathan K <kjambunathan <at> gmail.com> writes:

> John Brown <johnbrown_105 <at> yahoo.com> writes:
>
>> Hello Glenn,
>>
>>
>> Glenn Morris wrote:
>>> 
>>> John Brown wrote:
>>> 
>>>>  The nXML mode documentation distributed with Emacs (24.2.1)
>>>>  states:
>>>> 
>>>>  <C-return> performs completion on the symbol preceding point.
>>> 
>>> That was fixed in the sources some time ago.
>>> 
>>>>  The GNU Emacs manual at
>>>>  http://www.gnu.org/software/emacs/manual/html_mono/emacs.html:
>>>>  also states:
>>>> 
>>>>  "The major mode for editing XML documents is called nXML mode.
>>>>  This is a powerful major mode that can recognize many existing
>>>>  XML schema and use them to provide completion of XML elements
>>>>  via C-<RET> or M-<TAB> ..."
>>> 
>>> Thanks, I fixed that in the source too. (The web-page probably won't be
>>> regenerated till at least when 24.3 is released though.)
>>> 
>>
>> Looking at nxml-mode.el, I see that the correct keystroke is M-TAB.
>> Since this combination is used to switch from one main application
>> window to the next by the MS Windows and Ubuntu Linux GUIs (and
>> no doubt other GUIs because they tend to copy one another),it is
>> likely to be a problem for many users.
>>
>> I recommend that the documentation suggest ways to work around
>> this.
>
> I use C-M-i.

Me too.

And ESC TAB is another synonym one can use.

>     ,---- NEWS
>     | ** nXML mode no longer binds C-RET to `nxml-complete'.
>     | Completion is now performed via `completion-at-point', bound to C-M-i
>     | or M-TAB.  If `nxml-bind-meta-tab-to-complete-flag' is non-nil (the
>     | default), this performs tag completion.
>     `----

Message #22 received at 13363-done <at> debbugs.gnu.org (full text, mbox):

From: John Brown <johnbrown_105 <at> yahoo.com>
To: "13363-done <at> debbugs.gnu.org" <13363-done <at> debbugs.gnu.org>
Subject: Re: bug#13363: Documentation bug - nXML mode: C-return is not defined
	as stated
Date: Sun, 6 Jan 2013 02:06:37 -0800 (PST)

Jambunathan K wrote:

> 
> John Brown <johnbrown_105 <at> yahoo.com> writes:
> 
>>  Hello Glenn,
>> 
>> 
>>  Glenn Morris wrote:
>>> 
>>>  John Brown wrote:
>> 
>> ... M-TAB ... is likely to be a problem for many users.
>> 
>>  I recommend that the documentation suggest ways to work around
>>  this.
> 
> I use C-M-i.
> 
>     ,---- NEWS
>     | ** nXML mode no longer binds C-RET to `nxml-complete'.
>     | Completion is now performed via `completion-at-point', bound to C-M-i
>     | or M-TAB.  If `nxml-bind-meta-tab-to-complete-flag' is non-nil (the
>     | default), this performs tag completion.
>     `----
>


OK, but this information does not belong in the NEWS (only).
Further investigation reveals that the alternative keystrokes
may also be found buried at:
Help -> More Manuals -> All Other Manuals (Info) -> 
nXML Mode topic.

But given that "C-h m" says the keystroke is C-Return and
"C-h b" shows only "M-TAB" bound to completion-at-point, 
why would I expect to find something different in the Info
manual? The answer: I wouldn't. However, they have promised
to fix the documentation.

Now that I have reverted to my original xml-mode.elc, C-M-i
(and ESC TAB as mentioned by another poster) works.

This, at last, is the true solution: use C-M-i or <ESC><TAB>
as stated in the nXML Mode Info manual, i.e, the "nXML Mode"
topic in Help -> More Manuals -> All Other Manuals (Info).
In addition "C-h m" and "C-h b" should show this information 
when Emacs is in nXML mode.

Regards,
John Brown.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.