Doc fix for xterm-extra-capabilities

* lisp/term/xterm.el (xterm-extra-capabilities): Doc fix.

* etc/PROBLEMS: Mention xterm-extra-capabilities issue.
This commit is contained in:
Glenn Morris 2012-03-31 13:22:04 -07:00
parent 7019c1775e
commit 40f86458cc
3 changed files with 28 additions and 3 deletions

View file

@ -1679,6 +1679,23 @@ recommended way of turning on Font-lock is by typing "M-x
global-font-lock-mode RET" or by customizing the variable
`global-font-lock-mode'.
** Unexpected characters inserted into the buffer when you start Emacs.
See eg http://debbugs.gnu.org/11129
This can happen when you start Emacs in -nw mode in an Xterm.
For example, in the *scratch* buffer, you might see something like:
0;276;0c
This is more likely to happen if you are using Emacs over a slow
connection, and begin typing before Emacs is ready to respond.
This occurs when Emacs tries to query the terminal to see what
capabilities it supports, and gets confused by the answer.
To avoid it, set xterm-extra-capabilities to a value other than
`check' (the default). See that variable's documentation (in
term/xterm.el) for more details.
* Runtime problems specific to individual Unix variants
** GNU/Linux

View file

@ -1,5 +1,7 @@
2012-03-31 Glenn Morris <rgm@gnu.org>
* term/xterm.el (xterm-extra-capabilities): Doc fix.
* language/indian.el ("Devanagari"): Fix typo. (Bug#11103)
* calendar/calendar.el (calendar-window-list)

View file

@ -30,9 +30,15 @@
:group 'emacs)
(defcustom xterm-extra-capabilities 'check
"Set to a list if the XTerm supports modifyOtherKeys or
reporting the background color. Set to 'check to check for those
features. Set to nil to skip the checks."
"Whether Xterm supports some additional, more modern, features.
If nil, just assume that it does not.
If `check', try to check if it does.
If a list, assume that the listed features are supported, without checking.
The relevant features are:
modifyOtherKeys -- if supported, more key bindings work (e.g, \"\\C-,\")
reportBackground -- if supported, Xterm reports its background color
"
:version "24.1"
:group 'xterm
:type '(choice (const :tag "No" nil)