1 ;;; x-win.el --- parse switches controlling interface with X window system
6 ;; Copyright (C) 1993 Free Software Foundation, Inc.
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is distributed in the hope that it will be useful,
11 ;; but WITHOUT ANY WARRANTY. No author or distributor
12 ;; accepts responsibility to anyone for the consequences of using it
13 ;; or for whether it serves any particular purpose or works at all,
14 ;; unless he says so in writing. Refer to the GNU Emacs General Public
15 ;; License for full details.
17 ;; Everyone is granted permission to copy, modify and redistribute
18 ;; GNU Emacs, but only under the conditions described in the
19 ;; GNU Emacs General Public License. A copy of this license is
20 ;; supposed to have been given to you along with GNU Emacs so you
21 ;; can know your rights and responsibilities. It should be in a
22 ;; file named COPYING. Among other things, the copyright notice
23 ;; and this notice must be preserved on all copies.
27 ;; X-win.el: this file is loaded from ../lisp/startup.el when it recognizes
28 ;; that X windows are to be used. Command line switches are parsed and those
29 ;; pertaining to X are processed and removed from the command line. The
30 ;; X display is opened and hooks are set for popping up the initial window.
32 ;; startup.el will then examine startup files, and eventually call the hooks
33 ;; which create the first window (s).
37 ;; These are the standard X switches from the Xt Initialize.c file of
40 ;; Command line Resource Manager string
43 ;; +synchronous *synchronous
44 ;; -background *background
47 ;; -bordercolor *borderColor
48 ;; -borderwidth .borderWidth
54 ;; -foreground *foreground
55 ;; -geometry .geometry
58 ;; -reverse *reverseVideo
60 ;; -selectionTimeout .selectionTimeout
61 ;; -synchronous *synchronous
64 ;; An alist of X options and the function which handles them. See
67 (if (not (eq window-system 'x))
68 (error "Loading x-win.el but not compiled for X"))
77 (setq command-switch-alist
78 (append '(("-bw" . x-handle-numeric-switch)
79 ("-d" . x-handle-display)
80 ("-display" . x-handle-display)
81 ("-name" . x-handle-switch)
82 ("-T" . x-handle-switch)
83 ("-r" . x-handle-switch)
84 ("-rv" . x-handle-switch)
85 ("-reverse" . x-handle-switch)
86 ("-fn" . x-handle-switch)
87 ("-font" . x-handle-switch)
88 ("-ib" . x-handle-switch)
89 ("-g" . x-handle-geometry)
90 ("-geometry" . x-handle-geometry)
91 ("-fg" . x-handle-switch)
92 ("-foreground". x-handle-switch)
93 ("-bg" . x-handle-switch)
94 ("-background". x-handle-switch)
95 ("-ms" . x-handle-switch)
96 ("-itype" . x-handle-switch)
97 ("-iconic" . x-handle-switch)
98 ("-cr" . x-handle-switch)
99 ("-vb" . x-handle-switch)
100 ("-hb" . x-handle-switch)
101 ("-bd" . x-handle-switch))
102 command-switch-alist))
104 (defconst x-switch-definitions
112 ("-ib" internal-border-width)
113 ("-fg" foreground-color)
114 ("-foreground" foreground-color)
115 ("-bg" background-color)
116 ("-background" background-color)
119 ("-itype" icon-type t)
120 ("-iconic" iconic-startup t)
121 ("-vb" vertical-scroll-bars t)
122 ("-hb" horizontal-scroll-bars t)
124 ("-bw" border-width)))
126 ;; Handler for switches of the form "-switch value" or "-switch".
127 (defun x-handle-switch (switch)
128 (let ((aelt (assoc switch x-switch-definitions)))
131 (setq default-frame-alist
132 (cons (cons (nth 1 aelt) (nth 2 aelt))
133 default-frame-alist))
134 (setq default-frame-alist
135 (cons (cons (nth 1 aelt)
136 (car x-invocation-args))
138 x-invocation-args (cdr x-invocation-args))))))
140 ;; Handler for switches of the form "-switch n"
141 (defun x-handle-numeric-switch (switch)
142 (let ((aelt (assoc switch x-switch-definitions)))
144 (setq default-frame-alist
145 (cons (cons (nth 1 aelt)
146 (string-to-int (car x-invocation-args)))
149 (cdr x-invocation-args)))))
151 ;; Handle the geometry option
152 (defun x-handle-geometry (switch)
153 (setq initial-frame-alist
154 (append initial-frame-alist
155 (x-parse-geometry (car x-invocation-args)))
156 x-invocation-args (cdr x-invocation-args)))
158 (defvar x-display-name nil
159 "The X display name specifying server and X frame.")
161 (defun x-handle-display (switch)
162 (setq x-display-name (car x-invocation-args)
163 x-invocation-args (cdr x-invocation-args)))
165 (defvar x-invocation-args nil)
167 (defun x-handle-args (args)
168 "Here the X-related command line options in ARGS are processed,
169 before the user's startup file is loaded. They are copied to
170 x-invocation args from which the X-related things are extracted, first
171 the switch (e.g., \"-fg\") in the following code, and possible values
172 (e.g., \"black\") in the option handler code (e.g., x-handle-switch).
173 This returns ARGS with the arguments that have been processed removed."
174 (setq x-invocation-args args
176 (while x-invocation-args
177 (let* ((this-switch (car x-invocation-args))
178 (aelt (assoc this-switch command-switch-alist)))
179 (setq x-invocation-args (cdr x-invocation-args))
181 (funcall (cdr aelt) this-switch)
182 (setq args (cons this-switch args)))))
183 (setq args (nreverse args)))
188 ;; Standard X cursor shapes, courtesy of Mr. Fox, who wanted ALL of them.
191 (defconst x-pointer-X-cursor 0)
192 (defconst x-pointer-arrow 2)
193 (defconst x-pointer-based-arrow-down 4)
194 (defconst x-pointer-based-arrow-up 6)
195 (defconst x-pointer-boat 8)
196 (defconst x-pointer-bogosity 10)
197 (defconst x-pointer-bottom-left-corner 12)
198 (defconst x-pointer-bottom-right-corner 14)
199 (defconst x-pointer-bottom-side 16)
200 (defconst x-pointer-bottom-tee 18)
201 (defconst x-pointer-box-spiral 20)
202 (defconst x-pointer-center-ptr 22)
203 (defconst x-pointer-circle 24)
204 (defconst x-pointer-clock 26)
205 (defconst x-pointer-coffee-mug 28)
206 (defconst x-pointer-cross 30)
207 (defconst x-pointer-cross-reverse 32)
208 (defconst x-pointer-crosshair 34)
209 (defconst x-pointer-diamond-cross 36)
210 (defconst x-pointer-dot 38)
211 (defconst x-pointer-dotbox 40)
212 (defconst x-pointer-double-arrow 42)
213 (defconst x-pointer-draft-large 44)
214 (defconst x-pointer-draft-small 46)
215 (defconst x-pointer-draped-box 48)
216 (defconst x-pointer-exchange 50)
217 (defconst x-pointer-fleur 52)
218 (defconst x-pointer-gobbler 54)
219 (defconst x-pointer-gumby 56)
220 (defconst x-pointer-hand1 58)
221 (defconst x-pointer-hand2 60)
222 (defconst x-pointer-heart 62)
223 (defconst x-pointer-icon 64)
224 (defconst x-pointer-iron-cross 66)
225 (defconst x-pointer-left-ptr 68)
226 (defconst x-pointer-left-side 70)
227 (defconst x-pointer-left-tee 72)
228 (defconst x-pointer-leftbutton 74)
229 (defconst x-pointer-ll-angle 76)
230 (defconst x-pointer-lr-angle 78)
231 (defconst x-pointer-man 80)
232 (defconst x-pointer-middlebutton 82)
233 (defconst x-pointer-mouse 84)
234 (defconst x-pointer-pencil 86)
235 (defconst x-pointer-pirate 88)
236 (defconst x-pointer-plus 90)
237 (defconst x-pointer-question-arrow 92)
238 (defconst x-pointer-right-ptr 94)
239 (defconst x-pointer-right-side 96)
240 (defconst x-pointer-right-tee 98)
241 (defconst x-pointer-rightbutton 100)
242 (defconst x-pointer-rtl-logo 102)
243 (defconst x-pointer-sailboat 104)
244 (defconst x-pointer-sb-down-arrow 106)
245 (defconst x-pointer-sb-h-double-arrow 108)
246 (defconst x-pointer-sb-left-arrow 110)
247 (defconst x-pointer-sb-right-arrow 112)
248 (defconst x-pointer-sb-up-arrow 114)
249 (defconst x-pointer-sb-v-double-arrow 116)
250 (defconst x-pointer-shuttle 118)
251 (defconst x-pointer-sizing 120)
252 (defconst x-pointer-spider 122)
253 (defconst x-pointer-spraycan 124)
254 (defconst x-pointer-star 126)
255 (defconst x-pointer-target 128)
256 (defconst x-pointer-tcross 130)
257 (defconst x-pointer-top-left-arrow 132)
258 (defconst x-pointer-top-left-corner 134)
259 (defconst x-pointer-top-right-corner 136)
260 (defconst x-pointer-top-side 138)
261 (defconst x-pointer-top-tee 140)
262 (defconst x-pointer-trek 142)
263 (defconst x-pointer-ul-angle 144)
264 (defconst x-pointer-umbrella 146)
265 (defconst x-pointer-ur-angle 148)
266 (defconst x-pointer-watch 150)
267 (defconst x-pointer-xterm 152)
273 (defvar x-colors '("aquamarine"
331 "medium forest green"
335 "medium spring green"
415 "The full list of X colors from the rgb.text file.")
417 (defun x-defined-colors ()
418 "Return a list of colors supported by the current X-Display."
419 (let ((all-colors x-colors)
421 (defined-colors nil))
423 (setq this-color (car all-colors)
424 all-colors (cdr all-colors))
425 (and (x-color-defined-p this-color)
426 (setq defined-colors (cons this-color defined-colors))))
431 (substitute-key-definition 'suspend-emacs 'iconify-frame global-map)
433 ;; Map certain keypad keys into ASCII characters
434 ;; that people usually expect.
435 (define-key function-key-map [backspace] [127])
436 (define-key function-key-map [delete] [127])
437 (define-key function-key-map [tab] [?\t])
438 (define-key function-key-map [linefeed] [?\n])
439 (define-key function-key-map [clear] [11])
440 (define-key function-key-map [return] [13])
441 (define-key function-key-map [escape] [?\e])
442 (define-key function-key-map [M-backspace] [?\M-\d])
443 (define-key function-key-map [M-delete] [?\M-\d])
444 (define-key function-key-map [M-tab] [?\M-\t])
445 (define-key function-key-map [M-linefeed] [?\M-\n])
446 (define-key function-key-map [M-clear] [?\M-\013])
447 (define-key function-key-map [M-return] [?\M-\015])
448 (define-key function-key-map [M-escape] [?\M-\e])
450 ;; These tell read-char how to convert
451 ;; these special chars to ASCII.
452 (put 'backspace 'ascii-character 127)
453 (put 'delete 'ascii-character 127)
454 (put 'tab 'ascii-character ?\t)
455 (put 'linefeed 'ascii-character ?\n)
456 (put 'clear 'ascii-character 12)
457 (put 'return 'ascii-character 13)
458 (put 'escape 'ascii-character ?\e)
460 ;;;; Selections and cut buffers
462 ;;; We keep track of the last text selected here, so we can check the
463 ;;; current selection against it, and avoid passing back our own text
464 ;;; from x-cut-buffer-or-selection-value.
465 (defvar x-last-selected-text nil)
467 ;;; Make TEXT, a string, the primary and clipboard X selections.
468 ;;; If you are running xclipboard, this means you can effectively
469 ;;; have a window on a copy of the kill-ring.
470 ;;; Also, set the value of X cut buffer 0, for backward compatibility
471 ;;; with older X applications.
472 (defun x-select-text (text)
473 (x-set-cut-buffer text)
474 (x-set-selection 'CLIPBOARD text)
475 (x-set-selection 'PRIMARY text)
476 (setq x-last-selected-text text))
478 ;;; Return the value of the current X selection. For compatibility
479 ;;; with older X applications, this checks cut buffer 0 before
480 ;;; retrieving the value of the primary selection.
481 (defun x-cut-buffer-or-selection-value ()
484 ;; Consult the cut buffer, then the selection. Treat empty strings
485 ;; as if they were unset.
486 (setq text (x-get-cut-buffer 0))
487 (if (string= text "") (setq text nil))
488 (or text (setq text (x-get-selection 'PRIMARY)))
489 (if (string= text "") (setq text nil))
493 ((eq text x-last-selected-text) nil)
494 ((string= text x-last-selected-text)
495 ;; Record the newer string, so subsequent calls can use the `eq' test.
496 (setq x-last-selected-text text)
499 (setq x-last-selected-text text)))))
502 ;;; Do the actual X Windows setup here; the above code just defines
503 ;;; functions and variables that we use now.
505 (setq command-line-args (x-handle-args command-line-args))
506 (x-open-connection (or x-display-name
507 (setq x-display-name (getenv "DISPLAY"))))
509 (setq frame-creation-function 'x-create-frame-with-faces)
511 (defun x-win-suspend-error ()
512 (error "Suspending an emacs running under X makes no sense"))
513 (add-hook 'suspend-hook 'x-win-suspend-error)
515 ;;; Arrange for the kill and yank functions to set and check the clipboard.
516 (setq interprogram-cut-function 'x-select-text)
517 (setq interprogram-paste-function 'x-cut-buffer-or-selection-value)
519 ;;; Turn off window-splitting optimization; X is usually fast enough
520 ;;; that this is only annoying.
521 (setq split-window-keep-point t)
523 ;;; x-win.el ends here