lisp/term/xterm.el

   1 ;;; xterm.el --- define function key sequences and standard colors for xterm
   2
   3 ;; Copyright (C) 1995, 2001-2012 Free Software Foundation, Inc.
   4
   5 ;; Author: FSF
   6 ;; Keywords: terminals
   7
   8 ;; This file is part of GNU Emacs.
   9
  10 ;; GNU Emacs is free software: you can redistribute it and/or modify
  11 ;; it under the terms of the GNU General Public License as published by
  12 ;; the Free Software Foundation, either version 3 of the License, or
  13 ;; (at your option) any later version.
  14
  15 ;; GNU Emacs is distributed in the hope that it will be useful,
  16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 ;; GNU General Public License for more details.
  19
  20 ;; You should have received a copy of the GNU General Public License
  21 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  22
  23 ;;; Commentary:
  24
  25 ;;; Code:
  26
  27 (defgroup xterm nil
  28   "XTerm support."
  29   :version "24.1"
  30   :group 'emacs)
  31
  32 (defcustom xterm-extra-capabilities 'check
  33   "Set to a list if the XTerm supports modifyOtherKeys or
  34 reporting the background color.  Set to 'check to check for those
  35 features.  Set to nil to skip the checks."
  36   :group 'xterm
  37   :type '(choice (const :tag "No" nil)
  38                  (const :tag "Check" check)
  39                  ;; NOTE: If you add entries here, make sure to update
  40                  ;; `tocheck-capabilities' in `terminal-init-xterm' as well.
  41                  (set (const :tag "modifyOtherKeys support" modifyOtherKeys)
  42                       (const :tag "report background" reportBackground))))
  43
  44 (defvar xterm-function-map
  45   (let ((map (make-sparse-keymap)))
  46
  47     ;; xterm from X.org 6.8.2 uses these key definitions.
  48     (define-key map "\eOP" [f1])
  49     (define-key map "\eOQ" [f2])
  50     (define-key map "\eOR" [f3])
  51     (define-key map "\eOS" [f4])
  52     (define-key map "\e[15~" [f5])
  53     (define-key map "\e[17~" [f6])
  54     (define-key map "\e[18~" [f7])
  55     (define-key map "\e[19~" [f8])
  56     (define-key map "\e[20~" [f9])
  57     (define-key map "\e[21~" [f10])
  58     (define-key map "\e[23~" [f11])
  59     (define-key map "\e[24~" [f12])
  60
  61     (define-key map "\eO2P" [S-f1])
  62     (define-key map "\eO2Q" [S-f2])
  63     (define-key map "\eO2R" [S-f3])
  64     (define-key map "\eO2S" [S-f4])
  65     (define-key map "\e[1;2P" [S-f1])
  66     (define-key map "\e[1;2Q" [S-f2])
  67     (define-key map "\e[1;2R" [S-f3])
  68     (define-key map "\e[1;2S" [S-f4])
  69     (define-key map "\e[15;2~" [S-f5])
  70     (define-key map "\e[17;2~" [S-f6])
  71     (define-key map "\e[18;2~" [S-f7])
  72     (define-key map "\e[19;2~" [S-f8])
  73     (define-key map "\e[20;2~" [S-f9])
  74     (define-key map "\e[21;2~" [S-f10])
  75     (define-key map "\e[23;2~" [S-f11])
  76     (define-key map "\e[24;2~" [S-f12])
  77
  78     (define-key map "\eO5P" [C-f1])
  79     (define-key map "\eO5Q" [C-f2])
  80     (define-key map "\eO5R" [C-f3])
  81     (define-key map "\eO5S" [C-f4])
  82     (define-key map "\e[15;5~" [C-f5])
  83     (define-key map "\e[17;5~" [C-f6])
  84     (define-key map "\e[18;5~" [C-f7])
  85     (define-key map "\e[19;5~" [C-f8])
  86     (define-key map "\e[20;5~" [C-f9])
  87     (define-key map "\e[21;5~" [C-f10])
  88     (define-key map "\e[23;5~" [C-f11])
  89     (define-key map "\e[24;5~" [C-f12])
  90
  91     (define-key map "\eO6P" [C-S-f1])
  92     (define-key map "\eO6Q" [C-S-f2])
  93     (define-key map "\eO6R" [C-S-f3])
  94     (define-key map "\eO6S" [C-S-f4])
  95     (define-key map "\e[15;6~" [C-S-f5])
  96     (define-key map "\e[17;6~" [C-S-f6])
  97     (define-key map "\e[18;6~" [C-S-f7])
  98     (define-key map "\e[19;6~" [C-S-f8])
  99     (define-key map "\e[20;6~" [C-S-f9])
 100     (define-key map "\e[21;6~" [C-S-f10])
 101     (define-key map "\e[23;6~" [C-S-f11])
 102     (define-key map "\e[24;6~" [C-S-f12])
 103
 104     (define-key map "\eO3P" [M-f1])
 105     (define-key map "\eO3Q" [M-f2])
 106     (define-key map "\eO3R" [M-f3])
 107     (define-key map "\eO3S" [M-f4])
 108     (define-key map "\e[15;3~" [M-f5])
 109     (define-key map "\e[17;3~" [M-f6])
 110     (define-key map "\e[18;3~" [M-f7])
 111     (define-key map "\e[19;3~" [M-f8])
 112     (define-key map "\e[20;3~" [M-f9])
 113     (define-key map "\e[21;3~" [M-f10])
 114     (define-key map "\e[23;3~" [M-f11])
 115     (define-key map "\e[24;3~" [M-f12])
 116
 117     (define-key map "\eO4P" [M-S-f1])
 118     (define-key map "\eO4Q" [M-S-f2])
 119     (define-key map "\eO4R" [M-S-f3])
 120     (define-key map "\eO4S" [M-S-f4])
 121     (define-key map "\e[15;4~" [M-S-f5])
 122     (define-key map "\e[17;4~" [M-S-f6])
 123     (define-key map "\e[18;4~" [M-S-f7])
 124     (define-key map "\e[19;4~" [M-S-f8])
 125     (define-key map "\e[20;4~" [M-S-f9])
 126     (define-key map "\e[21;4~" [M-S-f10])
 127     (define-key map "\e[23;4~" [M-S-f11])
 128     (define-key map "\e[24;4~" [M-S-f12])
 129
 130     (define-key map "\eOA" [up])
 131     (define-key map "\eOB" [down])
 132     (define-key map "\eOC" [right])
 133     (define-key map "\eOD" [left])
 134     (define-key map "\eOF" [end])
 135     (define-key map "\eOH" [home])
 136
 137     (define-key map "\e[1;2A" [S-up])
 138     (define-key map "\e[1;2B" [S-down])
 139     (define-key map "\e[1;2C" [S-right])
 140     (define-key map "\e[1;2D" [S-left])
 141     (define-key map "\e[1;2F" [S-end])
 142     (define-key map "\e[1;2H" [S-home])
 143
 144     (define-key map "\e[1;4A" [M-S-up])
 145     (define-key map "\e[1;4B" [M-S-down])
 146     (define-key map "\e[1;4C" [M-S-right])
 147     (define-key map "\e[1;4D" [M-S-left])
 148     (define-key map "\e[1;4F" [M-S-end])
 149     (define-key map "\e[1;4H" [M-S-home])
 150
 151     (define-key map "\e[1;5A" [C-up])
 152     (define-key map "\e[1;5B" [C-down])
 153     (define-key map "\e[1;5C" [C-right])
 154     (define-key map "\e[1;5D" [C-left])
 155     (define-key map "\e[1;5F" [C-end])
 156     (define-key map "\e[1;5H" [C-home])
 157
 158     (define-key map "\e[1;6A" [C-S-up])
 159     (define-key map "\e[1;6B" [C-S-down])
 160     (define-key map "\e[1;6C" [C-S-right])
 161     (define-key map "\e[1;6D" [C-S-left])
 162     (define-key map "\e[1;6F" [C-S-end])
 163     (define-key map "\e[1;6H" [C-S-home])
 164
 165     (define-key map "\e[1;7A" [C-M-up])
 166     (define-key map "\e[1;7B" [C-M-down])
 167     (define-key map "\e[1;7C" [C-M-right])
 168     (define-key map "\e[1;7D" [C-M-left])
 169     (define-key map "\e[1;7F" [C-M-end])
 170     (define-key map "\e[1;7H" [C-M-home])
 171
 172     (define-key map "\e[1;8A" [C-M-S-up])
 173     (define-key map "\e[1;8B" [C-M-S-down])
 174     (define-key map "\e[1;8C" [C-M-S-right])
 175     (define-key map "\e[1;8D" [C-M-S-left])
 176     (define-key map "\e[1;8F" [C-M-S-end])
 177     (define-key map "\e[1;8H" [C-M-S-home])
 178
 179     (define-key map "\e[1;3A" [M-up])
 180     (define-key map "\e[1;3B" [M-down])
 181     (define-key map "\e[1;3C" [M-right])
 182     (define-key map "\e[1;3D" [M-left])
 183     (define-key map "\e[1;3F" [M-end])
 184     (define-key map "\e[1;3H" [M-home])
 185
 186     (define-key map "\e[2~" [insert])
 187     (define-key map "\e[3~" [delete])
 188     (define-key map "\e[5~" [prior])
 189     (define-key map "\e[6~" [next])
 190
 191     (define-key map "\e[2;2~" [S-insert])
 192     (define-key map "\e[3;2~" [S-delete])
 193     (define-key map "\e[5;2~" [S-prior])
 194     (define-key map "\e[6;2~" [S-next])
 195
 196     (define-key map "\e[2;4~" [M-S-insert])
 197     (define-key map "\e[3;4~" [M-S-delete])
 198     (define-key map "\e[5;4~" [M-S-prior])
 199     (define-key map "\e[6;4~" [M-S-next])
 200
 201     (define-key map "\e[2;5~" [C-insert])
 202     (define-key map "\e[3;5~" [C-delete])
 203     (define-key map "\e[5;5~" [C-prior])
 204     (define-key map "\e[6;5~" [C-next])
 205
 206     (define-key map "\e[2;6~" [C-S-insert])
 207     (define-key map "\e[3;6~" [C-S-delete])
 208     (define-key map "\e[5;6~" [C-S-prior])
 209     (define-key map "\e[6;6~" [C-S-next])
 210
 211     (define-key map "\e[2;7~" [C-M-insert])
 212     (define-key map "\e[3;7~" [C-M-delete])
 213     (define-key map "\e[5;7~" [C-M-prior])
 214     (define-key map "\e[6;7~" [C-M-next])
 215
 216     (define-key map "\e[2;8~" [C-M-S-insert])
 217     (define-key map "\e[3;8~" [C-M-S-delete])
 218     (define-key map "\e[5;8~" [C-M-S-prior])
 219     (define-key map "\e[6;8~" [C-M-S-next])
 220
 221     (define-key map "\e[2;3~" [M-insert])
 222     (define-key map "\e[3;3~" [M-delete])
 223     (define-key map "\e[5;3~" [M-prior])
 224     (define-key map "\e[6;3~" [M-next])
 225
 226     (define-key map "\e[4~" [select])
 227     (define-key map "\e[29~" [print])
 228
 229     (define-key map "\eOj" [kp-multiply])
 230     (define-key map "\eOk" [kp-add])
 231     (define-key map "\eOl" [kp-separator])
 232     (define-key map "\eOm" [kp-subtract])
 233     (define-key map "\eOo" [kp-divide])
 234     (define-key map "\eOp" [kp-0])
 235     (define-key map "\eOq" [kp-1])
 236     (define-key map "\eOr" [kp-2])
 237     (define-key map "\eOs" [kp-3])
 238     (define-key map "\eOt" [kp-4])
 239     (define-key map "\eOu" [kp-5])
 240     (define-key map "\eOv" [kp-6])
 241     (define-key map "\eOw" [kp-7])
 242     (define-key map "\eOx" [kp-8])
 243     (define-key map "\eOy" [kp-9])
 244
 245     ;; These keys are available in xterm starting from version 216
 246     ;; if the modifyOtherKeys resource is set to 1.
 247
 248     (define-key map "\e[27;5;9~"   [C-tab])
 249     (define-key map "\e[27;5;13~"  [C-return])
 250     (define-key map "\e[27;5;39~"  [?\C-\'])
 251     (define-key map "\e[27;5;44~"  [?\C-,])
 252     (define-key map "\e[27;5;45~"  [?\C--])
 253     (define-key map "\e[27;5;46~"  [?\C-.])
 254     (define-key map "\e[27;5;47~"  [?\C-/])
 255     (define-key map "\e[27;5;48~"  [?\C-0])
 256     (define-key map "\e[27;5;49~"  [?\C-1])
 257     ;; Not all C-DIGIT keys have a distinct binding.
 258     (define-key map "\e[27;5;57~"  [?\C-9])
 259     (define-key map "\e[27;5;59~"  [?\C-\;])
 260     (define-key map "\e[27;5;61~"  [?\C-=])
 261     (define-key map "\e[27;5;92~"  [?\C-\\])
 262
 263     (define-key map "\e[27;6;33~"  [?\C-!])
 264     (define-key map "\e[27;6;34~"  [?\C-\"])
 265     (define-key map "\e[27;6;35~"  [?\C-#])
 266     (define-key map "\e[27;6;36~"  [?\C-$])
 267     (define-key map "\e[27;6;37~"  [?\C-%])
 268     (define-key map "\e[27;6;38~"  [?\C-&])
 269     (define-key map "\e[27;6;40~"  [?\C-(])
 270     (define-key map "\e[27;6;41~"  [?\C-)])
 271     (define-key map "\e[27;6;42~"  [?\C-*])
 272     (define-key map "\e[27;6;43~"  [?\C-+])
 273     (define-key map "\e[27;6;58~"  [?\C-:])
 274     (define-key map "\e[27;6;60~"  [?\C-<])
 275     (define-key map "\e[27;6;62~"  [?\C->])
 276     (define-key map "\e[27;6;63~"  [(control ??)])
 277
 278     ;; These are the strings emitted for various C-M- combinations
 279     ;; for keyboards that the Meta and Alt modifiers are on the same
 280     ;; key (usually labeled "Alt").
 281     (define-key map "\e[27;13;9~"  [C-M-tab])
 282     (define-key map "\e[27;13;13~" [C-M-return])
 283
 284     (define-key map "\e[27;13;39~" [?\C-\M-\'])
 285     (define-key map "\e[27;13;44~" [?\C-\M-,])
 286     (define-key map "\e[27;13;45~" [?\C-\M--])
 287     (define-key map "\e[27;13;46~" [?\C-\M-.])
 288     (define-key map "\e[27;13;47~" [?\C-\M-/])
 289     (define-key map "\e[27;13;48~" [?\C-\M-0])
 290     (define-key map "\e[27;13;49~" [?\C-\M-1])
 291     (define-key map "\e[27;13;50~" [?\C-\M-2])
 292     (define-key map "\e[27;13;51~" [?\C-\M-3])
 293     (define-key map "\e[27;13;52~" [?\C-\M-4])
 294     (define-key map "\e[27;13;53~" [?\C-\M-5])
 295     (define-key map "\e[27;13;54~" [?\C-\M-6])
 296     (define-key map "\e[27;13;55~" [?\C-\M-7])
 297     (define-key map "\e[27;13;56~" [?\C-\M-8])
 298     (define-key map "\e[27;13;57~" [?\C-\M-9])
 299     (define-key map "\e[27;13;59~" [?\C-\M-\;])
 300     (define-key map "\e[27;13;61~" [?\C-\M-=])
 301     (define-key map "\e[27;13;92~" [?\C-\M-\\])
 302
 303     (define-key map "\e[27;14;33~"  [?\C-\M-!])
 304     (define-key map "\e[27;14;34~"  [?\C-\M-\"])
 305     (define-key map "\e[27;14;35~"  [?\C-\M-#])
 306     (define-key map "\e[27;14;36~"  [?\C-\M-$])
 307     (define-key map "\e[27;14;37~"  [?\C-\M-%])
 308     (define-key map "\e[27;14;38~"  [?\C-\M-&])
 309     (define-key map "\e[27;14;40~"  [?\C-\M-\(])
 310     (define-key map "\e[27;14;41~"  [?\C-\M-\)])
 311     (define-key map "\e[27;14;42~"  [?\C-\M-*])
 312     (define-key map "\e[27;14;43~"  [?\C-\M-+])
 313     (define-key map "\e[27;14;58~"  [?\C-\M-:])
 314     (define-key map "\e[27;14;60~"  [?\C-\M-<])
 315     (define-key map "\e[27;14;62~"  [?\C-\M->])
 316     (define-key map "\e[27;14;63~"  [(control meta ??)])
 317
 318     (define-key map "\e[27;7;9~"  [C-M-tab])
 319     (define-key map "\e[27;7;13~" [C-M-return])
 320
 321     (define-key map "\e[27;7;32~" [?\C-\M-\s])
 322     (define-key map "\e[27;7;39~" [?\C-\M-\'])
 323     (define-key map "\e[27;7;44~" [?\C-\M-,])
 324     (define-key map "\e[27;7;45~" [?\C-\M--])
 325     (define-key map "\e[27;7;46~" [?\C-\M-.])
 326     (define-key map "\e[27;7;47~" [?\C-\M-/])
 327     (define-key map "\e[27;7;48~" [?\C-\M-0])
 328     (define-key map "\e[27;7;49~" [?\C-\M-1])
 329     (define-key map "\e[27;7;50~" [?\C-\M-2])
 330     (define-key map "\e[27;7;51~" [?\C-\M-3])
 331     (define-key map "\e[27;7;52~" [?\C-\M-4])
 332     (define-key map "\e[27;7;53~" [?\C-\M-5])
 333     (define-key map "\e[27;7;54~" [?\C-\M-6])
 334     (define-key map "\e[27;7;55~" [?\C-\M-7])
 335     (define-key map "\e[27;7;56~" [?\C-\M-8])
 336     (define-key map "\e[27;7;57~" [?\C-\M-9])
 337     (define-key map "\e[27;7;59~" [?\C-\M-\;])
 338     (define-key map "\e[27;7;61~" [?\C-\M-=])
 339     (define-key map "\e[27;7;92~" [?\C-\M-\\])
 340
 341     (define-key map "\e[27;8;33~"  [?\C-\M-!])
 342     (define-key map "\e[27;8;34~"  [?\C-\M-\"])
 343     (define-key map "\e[27;8;35~"  [?\C-\M-#])
 344     (define-key map "\e[27;8;36~"  [?\C-\M-$])
 345     (define-key map "\e[27;8;37~"  [?\C-\M-%])
 346     (define-key map "\e[27;8;38~"  [?\C-\M-&])
 347     (define-key map "\e[27;8;40~"  [?\C-\M-\(])
 348     (define-key map "\e[27;8;41~"  [?\C-\M-\)])
 349     (define-key map "\e[27;8;42~"  [?\C-\M-*])
 350     (define-key map "\e[27;8;43~"  [?\C-\M-+])
 351     (define-key map "\e[27;8;58~"  [?\C-\M-:])
 352     (define-key map "\e[27;8;60~"  [?\C-\M-<])
 353     (define-key map "\e[27;8;62~"  [?\C-\M->])
 354     (define-key map "\e[27;8;63~"  [(control meta ??)])
 355
 356     (define-key map "\e[27;2;9~"   [S-tab])
 357     (define-key map "\e[27;2;13~"  [S-return])
 358
 359     (define-key map "\e[27;6;9~"   [C-S-tab])
 360     (define-key map "\e[27;6;13~"  [C-S-return])
 361
 362     ;; Other versions of xterm might emit these.
 363     (define-key map "\e[A" [up])
 364     (define-key map "\e[B" [down])
 365     (define-key map "\e[C" [right])
 366     (define-key map "\e[D" [left])
 367     (define-key map "\e[1~" [home])
 368
 369     (define-key map "\eO2A" [S-up])
 370     (define-key map "\eO2B" [S-down])
 371     (define-key map "\eO2C" [S-right])
 372     (define-key map "\eO2D" [S-left])
 373     (define-key map "\eO2F" [S-end])
 374     (define-key map "\eO2H" [S-home])
 375
 376     (define-key map "\eO5A" [C-up])
 377     (define-key map "\eO5B" [C-down])
 378     (define-key map "\eO5C" [C-right])
 379     (define-key map "\eO5D" [C-left])
 380     (define-key map "\eO5F" [C-end])
 381     (define-key map "\eO5H" [C-home])
 382
 383     (define-key map "\e[11~" [f1])
 384     (define-key map "\e[12~" [f2])
 385     (define-key map "\e[13~" [f3])
 386     (define-key map "\e[14~" [f4])
 387     map)
 388   "Function key map overrides for xterm.")
 389
 390 (defvar xterm-alternatives-map
 391   (let ((map (make-sparse-keymap)))
 392     ;; The terminal initialization C code file might have initialized
 393     ;; function keys F13->F60 from the termcap/terminfo information.
 394     ;; On a PC-style keyboard these keys correspond to
 395     ;; MODIFIER-FUNCTION_KEY, where modifier is S-, C, A-, C-S-.  The code
 396     ;; here substitutes the corresponding definitions in function-key-map.
 397     ;; The mapping from escape sequences to Fn is done in input-decode-map
 398     ;; whereas this here mapping is done in local-function-key-map so that
 399     ;; bindings to f45 still work, in case your keyboard really has an f45
 400     ;; key rather than C-S-f9.
 401     (define-key map [f13] [S-f1])
 402     (define-key map [f14] [S-f2])
 403     (define-key map [f15] [S-f3])
 404     (define-key map [f16] [S-f4])
 405     (define-key map [f17] [S-f5])
 406     (define-key map [f18] [S-f6])
 407     (define-key map [f19] [S-f7])
 408     (define-key map [f20] [S-f8])
 409     (define-key map [f21] [S-f9])
 410     (define-key map [f22] [S-f10])
 411     (define-key map [f23] [S-f11])
 412     (define-key map [f24] [S-f12])
 413
 414     (define-key map [f25] [C-f1])
 415     (define-key map [f26] [C-f2])
 416     (define-key map [f27] [C-f3])
 417     (define-key map [f28] [C-f4])
 418     (define-key map [f29] [C-f5])
 419     (define-key map [f30] [C-f6])
 420     (define-key map [f31] [C-f7])
 421     (define-key map [f32] [C-f8])
 422     (define-key map [f33] [C-f9])
 423     (define-key map [f34] [C-f10])
 424     (define-key map [f35] [C-f11])
 425     (define-key map [f36] [C-f12])
 426
 427     (define-key map [f37] [C-S-f1])
 428     (define-key map [f38] [C-S-f2])
 429     (define-key map [f39] [C-S-f3])
 430     (define-key map [f40] [C-S-f4])
 431     (define-key map [f41] [C-S-f5])
 432     (define-key map [f42] [C-S-f6])
 433     (define-key map [f43] [C-S-f7])
 434     (define-key map [f44] [C-S-f8])
 435     (define-key map [f45] [C-S-f9])
 436     (define-key map [f46] [C-S-f10])
 437     (define-key map [f47] [C-S-f11])
 438     (define-key map [f48] [C-S-f12])
 439
 440     (define-key map [f49] [M-f1])
 441     (define-key map [f50] [M-f2])
 442     (define-key map [f51] [M-f3])
 443     (define-key map [f52] [M-f4])
 444     (define-key map [f53] [M-f5])
 445     (define-key map [f54] [M-f6])
 446     (define-key map [f55] [M-f7])
 447     (define-key map [f56] [M-f8])
 448     (define-key map [f57] [M-f9])
 449     (define-key map [f58] [M-f10])
 450     (define-key map [f59] [M-f11])
 451     (define-key map [f60] [M-f12])
 452
 453     map)
 454   "Keymap of possible alternative meanings for some keys.")
 455
 456 ;; List of terminals for which modify-other-keys has been turned on.
 457 (defvar xterm-modify-other-keys-terminal-list nil)
 458
 459 (defun terminal-init-xterm ()
 460   "Terminal initialization function for xterm."
 461   ;; rxvt terminals sometimes set the TERM variable to "xterm", but
 462   ;; rxvt's keybindings are incompatible with xterm's. It is
 463   ;; better in that case to use rxvt's initialization function.
 464   (if (and (getenv "COLORTERM" (selected-frame))
 465            (string-match "\\`rxvt" (getenv "COLORTERM" (selected-frame))))
 466       (tty-run-terminal-initialization (selected-frame) "rxvt")
 467
 468     (let ((map (copy-keymap xterm-alternatives-map)))
 469       (set-keymap-parent map (keymap-parent local-function-key-map))
 470       (set-keymap-parent local-function-key-map map))
 471
 472     (let ((map (copy-keymap xterm-function-map)))
 473
 474       ;; Use inheritance to let the main keymap override those defaults.
 475       ;; This way we don't override terminfo-derived settings or settings
 476       ;; made in the .emacs file.
 477       (set-keymap-parent map (keymap-parent input-decode-map))
 478       (set-keymap-parent input-decode-map map)))
 479
 480   (xterm-register-default-colors)
 481   (tty-set-up-initial-frame-faces)
 482
 483   ;; Try to turn on the modifyOtherKeys feature on modern xterms.
 484   ;; When it is turned on many more key bindings work: things like
 485   ;; C-. C-, etc.
 486   ;; To do that we need to find out if the current terminal supports
 487   ;; modifyOtherKeys.  At this time only xterm does.
 488   (when xterm-extra-capabilities
 489     (let ((coding-system-for-read 'binary)
 490           (chr nil)
 491           (str "")
 492           (recompute-faces nil)
 493           ;; If `xterm-extra-capabilities' is 'check, we don't know
 494           ;; the capabilities.  We need to check for those defined
 495           ;; as `xterm-extra-capabilities' set options.  Otherwise,
 496           ;; we don't need to check for any capabilities because
 497           ;; they are given by setting `xterm-extra-capabilities' to
 498           ;; a list (which could be empty).
 499           (tocheck-capabilities (if (eq 'check xterm-extra-capabilities)
 500                                     '(modifyOtherKeys reportBackground)))
 501           ;; The given capabilities are either the contents of
 502           ;; `xterm-extra-capabilities', if it's a list, or an empty list.
 503           (given-capabilities (if (consp xterm-extra-capabilities)
 504                                   xterm-extra-capabilities))
 505           version)
 506       ;; 1. Set `version'
 507
 508       ;; Pending input can be mistakenly returned by the calls to
 509       ;; read-event below.  Discard it.
 510       (discard-input)
 511       ;; Try to find out the type of terminal by sending a "Secondary
 512       ;; Device Attributes (DA)" query.
 513       (send-string-to-terminal "\e[>0c")
 514
 515       ;; The reply should be: \e [ > NUMBER1 ; NUMBER2 ; NUMBER3 c
 516       ;; If the timeout is completely removed for read-event, this
 517       ;; might hang for terminals that pretend to be xterm, but don't
 518       ;; respond to this escape sequence.  RMS' opinion was to remove
 519       ;; it completely.  That might be right, but let's first try to
 520       ;; see if by using a longer timeout we get rid of most issues.
 521       (when (and (equal (read-event nil nil 2) ?\e)
 522                  (equal (read-event nil nil 2) ?\[))
 523         (while (not (equal (setq chr (read-event nil nil 2)) ?c))
 524           (setq str (concat str (string chr))))
 525         (if (string-match ">0;\\([0-9]+\\);0" str)
 526             (setq version (string-to-number (match-string 1 str)))))
 527       ;; 2. If reportBackground is known to be supported, or the
 528       ;; version is 242 or higher, assume the xterm supports
 529       ;; reporting the background color (TODO: maybe earlier
 530       ;; versions do too...)
 531       (when (or (memq 'reportBackground given-capabilities)
 532                 (and (memq 'reportBackground tocheck-capabilities)
 533                      version
 534                      (>= version 242)))
 535         (send-string-to-terminal "\e]11;?\e\\")
 536         (when (and (equal (read-event nil nil 2) ?\e)
 537                    (equal (read-event nil nil 2) ?\]))
 538           (setq str "")
 539           (while (not (equal (setq chr (read-event nil nil 2)) ?\\))
 540             (setq str (concat str (string chr))))
 541           (if (string-match
 542                "11;rgb:\\([a-f0-9]+\\)/\\([a-f0-9]+\\)/\\([a-f0-9]+\\)" str)
 543               (setq recompute-faces
 544                     (xterm-maybe-set-dark-background-mode
 545                      (string-to-number (match-string 1 str) 16)
 546                      (string-to-number (match-string 2 str) 16)
 547                      (string-to-number (match-string 3 str) 16))))))
 548
 549       ;; 3. If modifyOtherKeys is known to be supported or the
 550       ;; version is 216 (the version when modifyOtherKeys was
 551       ;; introduced) or higher, initialize the modifyOtherKeys support.
 552       (if (or (memq 'modifyOtherKeys given-capabilities)
 553               (and (memq 'modifyOtherKeys tocheck-capabilities)
 554                    version
 555                    (>= version 216)))
 556           (terminal-init-xterm-modify-other-keys))
 557
 558       ;; Recompute faces here in case the background mode was
 559       ;; set to dark.  We used to call
 560       ;; `tty-set-up-initial-frame-faces' only once, but that
 561       ;; caused the light background faces to be computed
 562       ;; incorrectly.  See:
 563       ;; http://permalink.gmane.org/gmane.emacs.devel/119627
 564       (when recompute-faces
 565         (tty-set-up-initial-frame-faces))))
 566
 567     (run-hooks 'terminal-init-xterm-hook))
 568
 569 (defun terminal-init-xterm-modify-other-keys ()
 570   "Terminal initialization for xterm's modifyOtherKeys support."
 571   ;; Make sure that the modifyOtherKeys state is restored when
 572   ;; suspending, resuming and exiting.
 573   (add-hook 'suspend-hook 'xterm-turn-off-modify-other-keys)
 574   (add-hook 'suspend-resume-hook 'xterm-turn-on-modify-other-keys)
 575   (add-hook 'kill-emacs-hook 'xterm-remove-modify-other-keys)
 576   (add-hook 'delete-terminal-functions 'xterm-remove-modify-other-keys)
 577   ;; Add the selected frame to the list of frames that
 578   ;; need to deal with modify-other-keys.
 579   (push (frame-terminal (selected-frame))
 580       xterm-modify-other-keys-terminal-list)
 581   (xterm-turn-on-modify-other-keys))
 582
 583 ;; Set up colors, for those versions of xterm that support it.
 584 (defvar xterm-standard-colors
 585   ;; The names in the comments taken from XTerm-col.ad in the xterm
 586   ;; distribution, see ftp://dickey.his.com/xterm/.  RGB values are
 587   ;; from rgb.txt.
 588   '(("black"          0 (  0   0   0))  ; black
 589     ("red"            1 (205   0   0))  ; red3
 590     ("green"          2 (  0 205   0))  ; green3
 591     ("yellow"         3 (205 205   0))  ; yellow3
 592     ("blue"           4 (  0   0 238))  ; blue2
 593     ("magenta"        5 (205   0 205))  ; magenta3
 594     ("cyan"           6 (  0 205 205))  ; cyan3
 595     ("white"          7 (229 229 229))  ; gray90
 596     ("brightblack"    8 (127 127 127))  ; gray50
 597     ("brightred"      9 (255   0   0))  ; red
 598     ("brightgreen"   10 (  0 255   0))  ; green
 599     ("brightyellow"  11 (255 255   0))  ; yellow
 600     ("brightblue"    12 (92   92 255))  ; rgb:5c/5c/ff
 601     ("brightmagenta" 13 (255   0 255))  ; magenta
 602     ("brightcyan"    14 (  0 255 255))  ; cyan
 603     ("brightwhite"   15 (255 255 255))) ; white
 604   "Names of 16 standard xterm/aixterm colors, their numbers, and RGB values.")
 605
 606 (defun xterm-rgb-convert-to-16bit (prim)
 607   "Convert an 8-bit primary color value PRIM to a corresponding 16-bit value."
 608   (logior prim (lsh prim 8)))
 609
 610 (defun xterm-register-default-colors ()
 611   "Register the default set of colors for xterm or compatible emulator.
 612
 613 This function registers the number of colors returned by `display-color-cells'
 614 for the currently selected frame.  The first 16 colors are taken from
 615 `xterm-standard-colors', which see, while the rest are computed assuming
 616 either the 88- or 256-color standard color scheme supported by latest
 617 versions of xterm."
 618   (let* ((ncolors (display-color-cells (selected-frame)))
 619          (colors xterm-standard-colors)
 620          (color (car colors)))
 621     (if (> ncolors 0)
 622         ;; Clear the 8 default tty colors registered by startup.el
 623         (tty-color-clear))
 624     ;; Only register as many colors as are supported by the display.
 625     (while (and (> ncolors 0) colors)
 626       (tty-color-define (car color) (cadr color)
 627                         (mapcar 'xterm-rgb-convert-to-16bit
 628                                 (car (cddr color))))
 629       (setq colors (cdr colors)
 630             color (car colors)
 631             ncolors (1- ncolors)))
 632     ;; We've exhausted the colors from `xterm-standard-colors'.  If there
 633     ;; are more colors to support, compute them now.
 634     (when (> ncolors 0)
 635       (cond
 636        ((= ncolors 240) ; 256-color xterm
 637         ;; 216 non-gray colors first
 638         (let ((r 0) (g 0) (b 0))
 639           (while (> ncolors 24)
 640             ;; This and other formulas taken from 256colres.pl and
 641             ;; 88colres.pl in the xterm distribution.
 642             (tty-color-define (format "color-%d" (- 256 ncolors))
 643                               (- 256 ncolors)
 644                               (mapcar 'xterm-rgb-convert-to-16bit
 645                                       (list (if (zerop r) 0 (+ (* r 40) 55))
 646                                             (if (zerop g) 0 (+ (* g 40) 55))
 647                                             (if (zerop b) 0 (+ (* b 40) 55)))))
 648
 649             (setq b (1+ b))
 650             (if (> b 5)
 651                 (setq g (1+ g)
 652                       b 0))
 653             (if (> g 5)
 654                 (setq r (1+ r)
 655                       g 0))
 656             (setq ncolors (1- ncolors))))
 657         ;; Now the 24 gray colors
 658         (while (> ncolors 0)
 659           (setq color (xterm-rgb-convert-to-16bit (+ 8 (* (- 24 ncolors) 10))))
 660           (tty-color-define (format "color-%d" (- 256 ncolors))
 661                             (- 256 ncolors)
 662                             (list color color color))
 663           (setq ncolors (1- ncolors))))
 664        ((= ncolors 72)  ; 88-color xterm
 665         ;; 64 non-gray colors
 666         (let ((levels '(0 139 205 255))
 667               (r 0) (g 0) (b 0))
 668           (while (> ncolors 8)
 669             (tty-color-define (format "color-%d" (- 88 ncolors))
 670                               (- 88 ncolors)
 671                               (mapcar 'xterm-rgb-convert-to-16bit
 672                                       (list (nth r levels)
 673                                             (nth g levels)
 674                                             (nth b levels))))
 675             (setq b (1+ b))
 676             (if (> b 3)
 677                 (setq g (1+ g)
 678                       b 0))
 679             (if (> g 3)
 680                 (setq r (1+ r)
 681                       g 0))
 682             (setq ncolors (1- ncolors))))
 683         ;; Now the 8 gray colors
 684         (while (> ncolors 0)
 685           (setq color (xterm-rgb-convert-to-16bit
 686                        (floor
 687                         (if (= ncolors 8)
 688                             46.36363636
 689                           (+ (* (- 8 ncolors) 23.18181818) 69.54545454)))))
 690           (tty-color-define (format "color-%d" (- 88 ncolors))
 691                             (- 88 ncolors)
 692                             (list color color color))
 693           (setq ncolors (1- ncolors))))
 694        (t (error "Unsupported number of xterm colors (%d)" (+ 16 ncolors)))))
 695     ;; Modifying color mappings means realized faces don't use the
 696     ;; right colors, so clear them.
 697     (clear-face-cache)))
 698
 699 (defun xterm-turn-on-modify-other-keys ()
 700   "Turn the modifyOtherKeys feature of xterm back on."
 701   (let ((terminal (frame-terminal (selected-frame))))
 702     (when (and (terminal-live-p terminal)
 703                (memq terminal xterm-modify-other-keys-terminal-list))
 704       (send-string-to-terminal "\e[>4;1m" terminal))))
 705
 706 (defun xterm-turn-off-modify-other-keys (&optional frame)
 707   "Temporarily turn off the modifyOtherKeys feature of xterm."
 708   (let ((terminal (when frame (frame-terminal frame))))
 709     (when (and (terminal-live-p terminal)
 710                (memq terminal xterm-modify-other-keys-terminal-list))
 711       (send-string-to-terminal "\e[>4m" terminal))))
 712
 713 (defun xterm-remove-modify-other-keys (&optional terminal)
 714   "Turn off the modifyOtherKeys feature of xterm for good."
 715   (setq terminal (or terminal (frame-terminal (selected-frame))))
 716   (when (and (terminal-live-p terminal)
 717              (memq terminal xterm-modify-other-keys-terminal-list))
 718     (setq xterm-modify-other-keys-terminal-list
 719           (delq terminal xterm-modify-other-keys-terminal-list))
 720     (send-string-to-terminal "\e[>4m" terminal)))
 721
 722 (defun xterm-maybe-set-dark-background-mode (redc greenc bluec)
 723   ;; Use the heuristic in `frame-set-background-mode' to decide if a
 724   ;; frame is dark.
 725   (when (< (+ redc greenc bluec) (* .6 (+ 65535 65535 65535)))
 726     (set-terminal-parameter nil 'background-mode 'dark)
 727     t))
 728
 729 ;;; xterm.el ends here