x-win.el 15.5 KB
Newer Older
Eric S. Raymond's avatar
Eric S. Raymond committed
1
;;; x-win.el --- parse switches controlling interface with X window system
Richard M. Stallman's avatar
Richard M. Stallman committed
2
;; Copyright (C) 1993 Free Software Foundation, Inc.
Eric S. Raymond's avatar
Eric S. Raymond committed
3 4 5 6

;; Author: FSF
;; Keywords: terminals

Richard M. Stallman's avatar
Richard M. Stallman committed
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
;;; This file is part of GNU Emacs.
;;;
;;; GNU Emacs is free software; you can redistribute it and/or modify
;;; it under the terms of the GNU General Public License as published by
;;; the Free Software Foundation; either version 2, or (at your option)
;;; any later version.
;;;
;;; GNU Emacs is distributed in the hope that it will be useful,
;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;; GNU General Public License for more details.
;;;
;;; You should have received a copy of the GNU General Public License
;;; along with GNU Emacs; see the file COPYING.  If not, write to
;;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
Jim Blandy's avatar
Jim Blandy committed
22

Eric S. Raymond's avatar
Eric S. Raymond committed
23
;;; Commentary:
Jim Blandy's avatar
Jim Blandy committed
24 25 26 27 28 29 30 31

;; X-win.el:  this file is loaded from ../lisp/startup.el when it recognizes
;; that X windows are to be used.  Command line switches are parsed and those
;; pertaining to X are processed and removed from the command line.  The
;; X display is opened and hooks are set for popping up the initial window.

;; startup.el will then examine startup files, and eventually call the hooks
;; which create the first window (s).
Eric S. Raymond's avatar
Eric S. Raymond committed
32 33

;;; Code:
Jim Blandy's avatar
Jim Blandy committed
34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53

;; These are the standard X switches from the Xt Initialize.c file of
;; Release 4.

;; Command line		Resource Manager string

;; +rv			*reverseVideo
;; +synchronous		*synchronous
;; -background		*background
;; -bd			*borderColor
;; -bg			*background
;; -bordercolor		*borderColor
;; -borderwidth		.borderWidth
;; -bw			.borderWidth
;; -display		.display
;; -fg			*foreground
;; -fn			*font
;; -font		*font
;; -foreground		*foreground
;; -geometry		.geometry
54 55
;; -i			.iconType
;; -itype		.iconType
Jim Blandy's avatar
Jim Blandy committed
56 57 58 59 60 61 62 63 64 65 66
;; -iconic		.iconic
;; -name		.name
;; -reverse		*reverseVideo
;; -rv			*reverseVideo
;; -selectionTimeout    .selectionTimeout
;; -synchronous		*synchronous
;; -xrm

;; An alist of X options and the function which handles them.  See
;; ../startup.el.

Jim Blandy's avatar
Jim Blandy committed
67 68 69
(if (not (eq window-system 'x))
    (error "Loading x-win.el but not compiled for X"))
	 
Jim Blandy's avatar
Jim Blandy committed
70
(require 'frame)
Jim Blandy's avatar
Jim Blandy committed
71
(require 'mouse)
72
(require 'scroll-bar)
73 74
(require 'faces)
(require 'select)
Richard M. Stallman's avatar
Richard M. Stallman committed
75
(require 'menu-bar)
Jim Blandy's avatar
Jim Blandy committed
76

77 78
(defvar x-invocation-args)

79 80
(defvar x-command-line-resources nil)

Jim Blandy's avatar
Jim Blandy committed
81
(setq command-switch-alist
Jim Blandy's avatar
Jim Blandy committed
82
      (append '(("-bw" .	x-handle-numeric-switch)
Jim Blandy's avatar
Jim Blandy committed
83 84 85 86 87 88 89 90 91
		("-d" .		x-handle-display)
		("-display" .	x-handle-display)
		("-name" .	x-handle-switch)
		("-T" .		x-handle-switch)
		("-r" .		x-handle-switch)
		("-rv" .	x-handle-switch)
		("-reverse" .	x-handle-switch)
		("-fn" .	x-handle-switch)
		("-font" .	x-handle-switch)
92
		("-ib" .	x-handle-numeric-switch)
Jim Blandy's avatar
Jim Blandy committed
93 94 95 96 97 98 99
		("-g" .		x-handle-geometry)
		("-geometry" .	x-handle-geometry)
		("-fg" .	x-handle-switch)
		("-foreground".	x-handle-switch)
		("-bg" .	x-handle-switch)
		("-background".	x-handle-switch)
		("-ms" .	x-handle-switch)
100
		("-itype" .	x-handle-switch)
101
		("-i" 	.	x-handle-switch)
Jim Blandy's avatar
Jim Blandy committed
102
		("-iconic" .	x-handle-switch)
103
		("-rn" .        x-handle-rn-switch)
Jim Blandy's avatar
Jim Blandy committed
104 105 106 107
		("-cr" .	x-handle-switch)
		("-vb" .	x-handle-switch)
		("-hb" .	x-handle-switch)
		("-bd" .	x-handle-switch))
Jim Blandy's avatar
Jim Blandy committed
108 109 110 111 112
	      command-switch-alist))

(defconst x-switch-definitions
  '(("-name" name)
    ("-T" name)
113 114 115
    ("-r" reverse t)
    ("-rv" reverse t)
    ("-reverse" reverse t)
Jim Blandy's avatar
Jim Blandy committed
116 117 118 119 120 121 122 123 124
    ("-fn" font)
    ("-font" font)
    ("-ib" internal-border-width)
    ("-fg" foreground-color)
    ("-foreground" foreground-color)
    ("-bg" background-color)
    ("-background" background-color)
    ("-ms" mouse-color)
    ("-cr" cursor-color)
125
    ("-itype" icon-type t)
126
    ("-i" icon-type t)
127
    ("-iconic" visibility icon)
128 129
    ("-vb" vertical-scroll-bars t)
    ("-hb" horizontal-scroll-bars t)
Jim Blandy's avatar
Jim Blandy committed
130 131 132 133 134 135 136 137
    ("-bd" border-color)
    ("-bw" border-width)))

;; Handler for switches of the form "-switch value" or "-switch".
(defun x-handle-switch (switch)
  (let ((aelt (assoc switch x-switch-definitions)))
    (if aelt
	(if (nth 2 aelt)
Jim Blandy's avatar
Jim Blandy committed
138
	    (setq default-frame-alist
Jim Blandy's avatar
Jim Blandy committed
139
		  (cons (cons (nth 1 aelt) (nth 2 aelt))
Jim Blandy's avatar
Jim Blandy committed
140 141
			default-frame-alist))
	  (setq default-frame-alist
Jim Blandy's avatar
Jim Blandy committed
142 143
		(cons (cons (nth 1 aelt)
			    (car x-invocation-args))
Jim Blandy's avatar
Jim Blandy committed
144
		      default-frame-alist)
Jim Blandy's avatar
Jim Blandy committed
145 146 147 148 149 150
		x-invocation-args (cdr x-invocation-args))))))

;; Handler for switches of the form "-switch n"
(defun x-handle-numeric-switch (switch)
  (let ((aelt (assoc switch x-switch-definitions)))
    (if aelt
Jim Blandy's avatar
Jim Blandy committed
151
	(setq default-frame-alist
Jim Blandy's avatar
Jim Blandy committed
152 153
	      (cons (cons (nth 1 aelt)
			  (string-to-int (car x-invocation-args)))
Jim Blandy's avatar
Jim Blandy committed
154
		    default-frame-alist)
Jim Blandy's avatar
Jim Blandy committed
155 156 157
	      x-invocation-args
	      (cdr x-invocation-args)))))

158 159 160 161 162
;; Handle the -rn option.
(defun x-handle-rn-switch (switch)
  (setq x-command-line-resources (car x-invocation-args))
  (setq x-invocation-args (cdr x-invocation-args)))

Jim Blandy's avatar
Jim Blandy committed
163 164
;; Handle the geometry option
(defun x-handle-geometry (switch)
165 166 167
  (setq initial-frame-alist
	(append initial-frame-alist
		(x-parse-geometry (car x-invocation-args)))
Jim Blandy's avatar
Jim Blandy committed
168 169 170
	x-invocation-args (cdr x-invocation-args)))

(defvar x-display-name nil
Jim Blandy's avatar
Jim Blandy committed
171
  "The X display name specifying server and X frame.")
Jim Blandy's avatar
Jim Blandy committed
172 173 174 175 176 177 178

(defun x-handle-display (switch)
  (setq x-display-name (car x-invocation-args)
	x-invocation-args (cdr x-invocation-args)))

(defvar x-invocation-args nil)

Jim Blandy's avatar
Jim Blandy committed
179 180 181 182 183 184 185
(defun x-handle-args (args)
  "Here the X-related command line options in ARGS are processed,
before the user's startup file is loaded.  They are copied to
x-invocation args from which the X-related things are extracted, first
the switch (e.g., \"-fg\") in the following code, and possible values
(e.g., \"black\") in the option handler code (e.g., x-handle-switch).
This returns ARGS with the arguments that have been processed removed."
Jim Blandy's avatar
Jim Blandy committed
186 187 188 189 190 191 192 193 194 195 196
  (setq x-invocation-args args
	args nil)
  (while x-invocation-args
    (let* ((this-switch (car x-invocation-args))
	   (aelt (assoc this-switch command-switch-alist)))
      (setq x-invocation-args (cdr x-invocation-args))
      (if aelt
	  (funcall (cdr aelt) this-switch)
	(setq args (cons this-switch args)))))
  (setq args (nreverse args)))

Jim Blandy's avatar
Jim Blandy committed
197

Jim Blandy's avatar
Jim Blandy committed
198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436

;;
;; Standard X cursor shapes, courtesy of Mr. Fox, who wanted ALL of them.
;;

(defconst x-pointer-X-cursor 0)
(defconst x-pointer-arrow 2)
(defconst x-pointer-based-arrow-down 4)
(defconst x-pointer-based-arrow-up 6)
(defconst x-pointer-boat 8)
(defconst x-pointer-bogosity 10)
(defconst x-pointer-bottom-left-corner 12)
(defconst x-pointer-bottom-right-corner 14)
(defconst x-pointer-bottom-side 16)
(defconst x-pointer-bottom-tee 18)
(defconst x-pointer-box-spiral 20)
(defconst x-pointer-center-ptr 22)
(defconst x-pointer-circle 24)
(defconst x-pointer-clock 26)
(defconst x-pointer-coffee-mug 28)
(defconst x-pointer-cross 30)
(defconst x-pointer-cross-reverse 32)
(defconst x-pointer-crosshair 34)
(defconst x-pointer-diamond-cross 36)
(defconst x-pointer-dot 38)
(defconst x-pointer-dotbox 40)
(defconst x-pointer-double-arrow 42)
(defconst x-pointer-draft-large 44)
(defconst x-pointer-draft-small 46)
(defconst x-pointer-draped-box 48)
(defconst x-pointer-exchange 50)
(defconst x-pointer-fleur 52)
(defconst x-pointer-gobbler 54)
(defconst x-pointer-gumby 56)
(defconst x-pointer-hand1 58)
(defconst x-pointer-hand2 60)
(defconst x-pointer-heart 62)
(defconst x-pointer-icon 64)
(defconst x-pointer-iron-cross 66)
(defconst x-pointer-left-ptr 68)
(defconst x-pointer-left-side 70)
(defconst x-pointer-left-tee 72)
(defconst x-pointer-leftbutton 74)
(defconst x-pointer-ll-angle 76)
(defconst x-pointer-lr-angle 78)
(defconst x-pointer-man 80)
(defconst x-pointer-middlebutton 82)
(defconst x-pointer-mouse 84)
(defconst x-pointer-pencil 86)
(defconst x-pointer-pirate 88)
(defconst x-pointer-plus 90)
(defconst x-pointer-question-arrow 92)
(defconst x-pointer-right-ptr 94)
(defconst x-pointer-right-side 96)
(defconst x-pointer-right-tee 98)
(defconst x-pointer-rightbutton 100)
(defconst x-pointer-rtl-logo 102)
(defconst x-pointer-sailboat 104)
(defconst x-pointer-sb-down-arrow 106)
(defconst x-pointer-sb-h-double-arrow 108)
(defconst x-pointer-sb-left-arrow 110)
(defconst x-pointer-sb-right-arrow 112)
(defconst x-pointer-sb-up-arrow 114)
(defconst x-pointer-sb-v-double-arrow 116)
(defconst x-pointer-shuttle 118)
(defconst x-pointer-sizing 120)
(defconst x-pointer-spider 122)
(defconst x-pointer-spraycan 124)
(defconst x-pointer-star 126)
(defconst x-pointer-target 128)
(defconst x-pointer-tcross 130)
(defconst x-pointer-top-left-arrow 132)
(defconst x-pointer-top-left-corner 134)
(defconst x-pointer-top-right-corner 136)
(defconst x-pointer-top-side 138)
(defconst x-pointer-top-tee 140)
(defconst x-pointer-trek 142)
(defconst x-pointer-ul-angle 144)
(defconst x-pointer-umbrella 146)
(defconst x-pointer-ur-angle 148)
(defconst x-pointer-watch 150)
(defconst x-pointer-xterm 152)

;;
;; Available colors
;;

(defvar x-colors '("aquamarine"
		   "Aquamarine"
		   "medium aquamarine"
		   "MediumAquamarine"
		   "black"
		   "Black"
		   "blue"
		   "Blue"
		   "cadet blue"
		   "CadetBlue"
		   "cornflower blue"
		   "CornflowerBlue"
		   "dark slate blue"
		   "DarkSlateBlue"
		   "light blue"
		   "LightBlue"
		   "light steel blue"
		   "LightSteelBlue"
		   "medium blue"
		   "MediumBlue"
		   "medium slate blue"
		   "MediumSlateBlue"
		   "midnight blue"
		   "MidnightBlue"
		   "navy blue"
		   "NavyBlue"
		   "navy"
		   "Navy"
		   "sky blue"
		   "SkyBlue"
		   "slate blue"
		   "SlateBlue"
		   "steel blue"
		   "SteelBlue"
		   "coral"
		   "Coral"
		   "cyan"
		   "Cyan"
		   "firebrick"
		   "Firebrick"
		   "brown"
		   "Brown"
		   "gold"
		   "Gold"
		   "goldenrod"
		   "Goldenrod"
		   "medium goldenrod"
		   "MediumGoldenrod"
		   "green"
		   "Green"
		   "dark green"
		   "DarkGreen"
		   "dark olive green"
		   "DarkOliveGreen"
		   "forest green"
		   "ForestGreen"
		   "lime green"
		   "LimeGreen"
		   "medium forest green"
		   "MediumForestGreen"
		   "medium sea green"
		   "MediumSeaGreen"
		   "medium spring green"
		   "MediumSpringGreen"
		   "pale green"
		   "PaleGreen"
		   "sea green"
		   "SeaGreen"
		   "spring green"
		   "SpringGreen"
		   "yellow green"
		   "YellowGreen"
		   "dark slate grey"
		   "DarkSlateGrey"
		   "dark slate gray"
		   "DarkSlateGray"
		   "dim grey"
		   "DimGrey"
		   "dim gray"
		   "DimGray"
		   "light grey"
		   "LightGrey"
		   "light gray"
		   "LightGray"
		   "gray"
		   "grey"
		   "Gray"
		   "Grey"
		   "khaki"
		   "Khaki"
		   "magenta"
		   "Magenta"
		   "maroon"
		   "Maroon"
		   "orange"
		   "Orange"
		   "orchid"
		   "Orchid"
		   "dark orchid"
		   "DarkOrchid"
		   "medium orchid"
		   "MediumOrchid"
		   "pink"
		   "Pink"
		   "plum"
		   "Plum"
		   "red"
		   "Red"
		   "indian red"
		   "IndianRed"
		   "medium violet red"
		   "MediumVioletRed"
		   "orange red"
		   "OrangeRed"
		   "violet red"
		   "VioletRed"
		   "salmon"
		   "Salmon"
		   "sienna"
		   "Sienna"
		   "tan"
		   "Tan"
		   "thistle"
		   "Thistle"
		   "turquoise"
		   "Turquoise"
		   "dark turquoise"
		   "DarkTurquoise"
		   "medium turquoise"
		   "MediumTurquoise"
		   "violet"
		   "Violet"
		   "blue violet"
		   "BlueViolet"
		   "wheat"
		   "Wheat"
		   "white"
		   "White"
		   "yellow"
		   "Yellow"
		   "green yellow"
		   "GreenYellow")
  "The full list of X colors from the rgb.text file.")

(defun x-defined-colors ()
  "Return a list of colors supported by the current X-Display."
  (let ((all-colors x-colors)
	(this-color nil)
	(defined-colors nil))
    (while all-colors
      (setq this-color (car all-colors)
	    all-colors (cdr all-colors))
437
      (and (x-color-defined-p this-color)
Jim Blandy's avatar
Jim Blandy committed
438 439 440
	   (setq defined-colors (cons this-color defined-colors))))
    defined-colors))

Jim Blandy's avatar
Jim Blandy committed
441 442
;;;; Function keys

443
(substitute-key-definition 'suspend-emacs 'iconify-frame global-map)
Jim Blandy's avatar
Jim Blandy committed
444

445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470
;; Map certain keypad keys into ASCII characters
;; that people usually expect.
(define-key function-key-map [backspace] [127])
(define-key function-key-map [delete] [127])
(define-key function-key-map [tab] [?\t])
(define-key function-key-map [linefeed] [?\n])
(define-key function-key-map [clear] [11])
(define-key function-key-map [return] [13])
(define-key function-key-map [escape] [?\e])
(define-key function-key-map [M-backspace] [?\M-\d])
(define-key function-key-map [M-delete] [?\M-\d])
(define-key function-key-map [M-tab] [?\M-\t])
(define-key function-key-map [M-linefeed] [?\M-\n])
(define-key function-key-map [M-clear] [?\M-\013])
(define-key function-key-map [M-return] [?\M-\015])
(define-key function-key-map [M-escape] [?\M-\e])

;; These tell read-char how to convert
;; these special chars to ASCII.
(put 'backspace 'ascii-character 127)
(put 'delete 'ascii-character 127)
(put 'tab 'ascii-character ?\t)
(put 'linefeed 'ascii-character ?\n)
(put 'clear 'ascii-character 12)
(put 'return 'ascii-character 13)
(put 'escape 'ascii-character ?\e)
Jim Blandy's avatar
Jim Blandy committed
471 472

;;;; Selections and cut buffers
Jim Blandy's avatar
Jim Blandy committed
473

Jim Blandy's avatar
Jim Blandy committed
474 475 476 477 478
;;; We keep track of the last text selected here, so we can check the
;;; current selection against it, and avoid passing back our own text
;;; from x-cut-buffer-or-selection-value.
(defvar x-last-selected-text nil)

Jim Blandy's avatar
Jim Blandy committed
479 480 481 482
;;; Make TEXT, a string, the primary and clipboard X selections.
;;; If you are running xclipboard, this means you can effectively
;;; have a window on a copy of the kill-ring.
;;; Also, set the value of X cut buffer 0, for backward compatibility
483
;;; with older X applications.
484 485
(defun x-select-text (text &optional push)
  (x-set-cut-buffer text push)
486 487
  (x-set-selection 'CLIPBOARD text)
  (x-set-selection 'PRIMARY text)
Jim Blandy's avatar
Jim Blandy committed
488
  (setq x-last-selected-text text))
Jim Blandy's avatar
Jim Blandy committed
489 490 491 492 493

;;; Return the value of the current X selection.  For compatibility
;;; with older X applications, this checks cut buffer 0 before
;;; retrieving the value of the primary selection.
(defun x-cut-buffer-or-selection-value ()
Jim Blandy's avatar
Jim Blandy committed
494 495 496 497 498 499
  (let (text)

    ;; Consult the cut buffer, then the selection.  Treat empty strings
    ;; as if they were unset.
    (setq text (x-get-cut-buffer 0))
    (if (string= text "") (setq text nil))
500
    (or text (setq text (x-get-selection 'PRIMARY)))
Jim Blandy's avatar
Jim Blandy committed
501 502 503 504 505 506 507 508 509 510 511
    (if (string= text "") (setq text nil))

    (cond
     ((not text) nil)
     ((eq text x-last-selected-text) nil)
     ((string= text x-last-selected-text)
      ;; Record the newer string, so subsequent calls can use the `eq' test.
      (setq x-last-selected-text text)
      nil)
     (t
      (setq x-last-selected-text text)))))
Jim Blandy's avatar
Jim Blandy committed
512

Jim Blandy's avatar
Jim Blandy committed
513 514 515 516 517 518

;;; Do the actual X Windows setup here; the above code just defines
;;; functions and variables that we use now.

(setq command-line-args (x-handle-args command-line-args))
(x-open-connection (or x-display-name
519 520
		       (setq x-display-name (getenv "DISPLAY")))
		   x-command-line-resources)
Jim Blandy's avatar
Jim Blandy committed
521

522
(setq frame-creation-function 'x-create-frame-with-faces)
523

524 525 526 527 528 529 530 531
;; Apply a geometry resource to the initial frame.  Put it at the end
;; of the alist, so that anything specified on the command line takes
;; precedence.
(let ((res-geometry (x-get-resource "geometry" "Geometry")))
  (if res-geometry
      (setq initial-frame-alist (append initial-frame-alist
					(x-parse-geometry res-geometry)))))

532 533 534 535 536 537 538
;; Set x-selection-timeout, measured in milliseconds.
(let ((res-selection-timeout
       (x-get-resource "selectionTimeout" "SelectionTimeout")))
  (setq x-selection-timeout 5000)
  (if res-selection-timeout
      (setq x-selection-timeout (string-to-number res-selection-timeout))))

539 540
(defun x-win-suspend-error ()
  (error "Suspending an emacs running under X makes no sense"))
541 542
(add-hook 'suspend-hook 'x-win-suspend-error)

Jim Blandy's avatar
Jim Blandy committed
543 544 545
;;; Arrange for the kill and yank functions to set and check the clipboard.
(setq interprogram-cut-function 'x-select-text)
(setq interprogram-paste-function 'x-cut-buffer-or-selection-value)
Jim Blandy's avatar
Jim Blandy committed
546

Jim Blandy's avatar
Jim Blandy committed
547 548 549
;;; Turn off window-splitting optimization; X is usually fast enough
;;; that this is only annoying.
(setq split-window-keep-point t)
Eric S. Raymond's avatar
Eric S. Raymond committed
550 551

;;; x-win.el ends here