[Emacs-diffs] /srv/bzr/emacs/trunk r107718: Doc fix for xterm-extra-capabilities

[Glenn Morris]

------------------------------------------------------------
revno: 107718
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sat 2012-03-31 13:22:04 -0700
message:
  Doc fix for xterm-extra-capabilities
  
  * lisp/term/xterm.el (xterm-extra-capabilities): Doc fix.
  
  * etc/PROBLEMS: Mention xterm-extra-capabilities issue.
modified:
  etc/PROBLEMS
  lisp/ChangeLog
  lisp/term/xterm.el

=== modified file 'etc/PROBLEMS'
--- a/etc/PROBLEMS      2012-03-12 09:55:35 +0000
+++ b/etc/PROBLEMS      2012-03-31 20:22:04 +0000
@@ -1679,6 +1679,23 @@
 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

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2012-03-31 20:05:46 +0000
+++ b/lisp/ChangeLog    2012-03-31 20:22:04 +0000
@@ -1,5 +1,7 @@
 2012-03-31  Glenn Morris  <address@hidden>
 
+       * term/xterm.el (xterm-extra-capabilities): Doc fix.
+
        * language/indian.el ("Devanagari"): Fix typo.  (Bug#11103)
 
        * calendar/calendar.el (calendar-window-list)

=== modified file 'lisp/term/xterm.el'
--- a/lisp/term/xterm.el        2012-02-11 22:13:29 +0000
+++ b/lisp/term/xterm.el        2012-03-31 20:22:04 +0000
@@ -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)