* bug#13363: Documentation bug - nXML mode: C-return is not defined as stated
@ 2013-01-05 14:38 John Brown
2013-01-05 19:23 ` Glenn Morris
0 siblings, 1 reply; 6+ messages in thread
From: John Brown @ 2013-01-05 14:38 UTC (permalink / raw)
To: 13363
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.
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#13363: Documentation bug - nXML mode: C-return is not defined as stated
2013-01-05 14:38 bug#13363: Documentation bug - nXML mode: C-return is not defined as stated John Brown
@ 2013-01-05 19:23 ` Glenn Morris
2013-01-06 1:26 ` John Brown
0 siblings, 1 reply; 6+ messages in thread
From: Glenn Morris @ 2013-01-05 19:23 UTC (permalink / raw)
To: 13363-done
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.)
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#13363: Documentation bug - nXML mode: C-return is not defined as stated
2013-01-05 19:23 ` Glenn Morris
@ 2013-01-06 1:26 ` John Brown
2013-01-06 6:18 ` Jambunathan K
0 siblings, 1 reply; 6+ messages in thread
From: John Brown @ 2013-01-06 1:26 UTC (permalink / raw)
To: 13363-done@debbugs.gnu.org
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.
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#13363: Documentation bug - nXML mode: C-return is not defined as stated
2013-01-06 1:26 ` John Brown
@ 2013-01-06 6:18 ` Jambunathan K
2013-01-06 7:27 ` Dmitry Gutov
2013-01-06 10:06 ` John Brown
0 siblings, 2 replies; 6+ messages in thread
From: Jambunathan K @ 2013-01-06 6:18 UTC (permalink / raw)
To: John Brown; +Cc: 13363-done@debbugs.gnu.org
John Brown <johnbrown_105@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.
>
>
>
>
--
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#13363: Documentation bug - nXML mode: C-return is not defined as stated
2013-01-06 6:18 ` Jambunathan K
@ 2013-01-06 7:27 ` Dmitry Gutov
2013-01-06 10:06 ` John Brown
1 sibling, 0 replies; 6+ messages in thread
From: Dmitry Gutov @ 2013-01-06 7:27 UTC (permalink / raw)
To: Jambunathan K; +Cc: 13363-done@debbugs.gnu.org
Jambunathan K <kjambunathan@gmail.com> writes:
> John Brown <johnbrown_105@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.
> `----
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#13363: Documentation bug - nXML mode: C-return is not defined as stated
2013-01-06 6:18 ` Jambunathan K
2013-01-06 7:27 ` Dmitry Gutov
@ 2013-01-06 10:06 ` John Brown
1 sibling, 0 replies; 6+ messages in thread
From: John Brown @ 2013-01-06 10:06 UTC (permalink / raw)
To: 13363-done@debbugs.gnu.org
Jambunathan K wrote:
>
> John Brown <johnbrown_105@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.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2013-01-06 10:06 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-01-05 14:38 bug#13363: Documentation bug - nXML mode: C-return is not defined as stated John Brown
2013-01-05 19:23 ` Glenn Morris
2013-01-06 1:26 ` John Brown
2013-01-06 6:18 ` Jambunathan K
2013-01-06 7:27 ` Dmitry Gutov
2013-01-06 10:06 ` John Brown
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).