1 ;;; x-win.el --- parse switches controlling interface with X window system
3 ;; Copyright (C) 1993, 1994 Free Software Foundation, Inc.
8 ;; This file is part of GNU Emacs.
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 2, or (at your option)
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.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
22 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 ;; Boston, MA 02111-1307, USA.
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
60 ;; -reverse *reverseVideo
62 ;; -selectionTimeout .selectionTimeout
63 ;; -synchronous *synchronous
66 ;; An alist of X options and the function which handles them. See
69 (if (not (eq window-system
'x
))
70 (error "%s: Loading x-win.el but not compiled for X" (invocation-name)))
78 (if (fboundp 'new-fontset
)
81 (defvar x-invocation-args
)
83 (defvar x-command-line-resources nil
)
85 ;; Handler for switches of the form "-switch value" or "-switch".
86 (defun x-handle-switch (switch)
87 (let ((aelt (assoc switch command-line-x-option-alist
)))
89 (let ((param (nth 3 aelt
))
92 (setq default-frame-alist
93 (cons (cons param value
)
95 (setq default-frame-alist
97 (car x-invocation-args
))
99 x-invocation-args
(cdr x-invocation-args
)))))))
101 ;; Handler for switches of the form "-switch n"
102 (defun x-handle-numeric-switch (switch)
103 (let ((aelt (assoc switch command-line-x-option-alist
)))
105 (let ((param (nth 3 aelt
)))
106 (setq default-frame-alist
108 (string-to-int (car x-invocation-args
)))
111 (cdr x-invocation-args
))))))
113 ;; Make -iconic apply only to the initial frame!
114 (defun x-handle-iconic (switch)
115 (setq initial-frame-alist
116 (cons '(visibility . icon
) initial-frame-alist
)))
118 ;; Handle the -xrm option.
119 (defun x-handle-xrm-switch (switch)
120 (or (consp x-invocation-args
)
121 (error "%s: missing argument to `%s' option" (invocation-name) switch
))
122 (setq x-command-line-resources
(car x-invocation-args
))
123 (setq x-invocation-args
(cdr x-invocation-args
)))
125 ;; Handle the geometry option
126 (defun x-handle-geometry (switch)
127 (let ((geo (x-parse-geometry (car x-invocation-args
))))
128 (setq initial-frame-alist
129 (append initial-frame-alist
130 (if (or (assq 'left geo
) (assq 'top geo
))
131 '((user-position . t
)))
132 (if (or (assq 'height geo
) (assq 'width geo
))
135 x-invocation-args
(cdr x-invocation-args
))))
137 ;; Handle the -name option. Set the variable x-resource-name
138 ;; to the option's operand; set the name of
139 ;; the initial frame, too.
140 (defun x-handle-name-switch (switch)
141 (or (consp x-invocation-args
)
142 (error "%s: missing argument to `%s' option" (invocation-name) switch
))
143 (setq x-resource-name
(car x-invocation-args
)
144 x-invocation-args
(cdr x-invocation-args
))
145 (setq initial-frame-alist
(cons (cons 'name x-resource-name
)
146 initial-frame-alist
)))
148 (defvar x-display-name nil
149 "The X display name specifying server and X frame.")
151 (defun x-handle-display (switch)
152 (setq x-display-name
(car x-invocation-args
)
153 x-invocation-args
(cdr x-invocation-args
))
154 ;; Make subshell programs see the same DISPLAY value Emacs really uses.
155 ;; Note that this isn't completely correct, since Emacs can use
156 ;; multiple displays. However, there is no way to tell an already
157 ;; running subshell which display the user is currently typing on.
158 (setenv "DISPLAY" x-display-name
))
160 (defun x-handle-args (args)
161 "Process the X-related command line options in ARGS.
162 This is done before the user's startup file is loaded. They are copied to
163 `x-invocation-args', from which the X-related things are extracted, first
164 the switch (e.g., \"-fg\") in the following code, and possible values
165 \(e.g., \"black\") in the option handler code (e.g., x-handle-switch).
166 This function returns ARGS minus the arguments that have been processed."
167 ;; We use ARGS to accumulate the args that we don't handle here, to return.
168 (setq x-invocation-args args
170 (while (and x-invocation-args
171 (not (equal (car x-invocation-args
) "--")))
172 (let* ((this-switch (car x-invocation-args
))
173 (orig-this-switch this-switch
)
174 completion argval aelt handler
)
175 (setq x-invocation-args
(cdr x-invocation-args
))
176 ;; Check for long options with attached arguments
177 ;; and separate out the attached option argument into argval.
178 (if (string-match "^--[^=]*=" this-switch
)
179 (setq argval
(substring this-switch
(match-end 0))
180 this-switch
(substring this-switch
0 (1- (match-end 0)))))
181 ;; Complete names of long options.
182 (if (string-match "^--" this-switch
)
184 (setq completion
(try-completion this-switch command-line-x-option-alist
))
185 (if (eq completion t
)
186 ;; Exact match for long option.
188 (if (stringp completion
)
189 (let ((elt (assoc completion command-line-x-option-alist
)))
190 ;; Check for abbreviated long option.
192 (error "Option `%s' is ambiguous" this-switch
))
193 (setq this-switch completion
))))))
194 (setq aelt
(assoc this-switch command-line-x-option-alist
))
195 (if aelt
(setq handler
(nth 2 aelt
)))
198 (let ((x-invocation-args
199 (cons argval x-invocation-args
)))
200 (funcall handler this-switch
))
201 (funcall handler this-switch
))
202 (setq args
(cons orig-this-switch args
)))))
203 (nconc (nreverse args
) x-invocation-args
))
206 ;; Standard X cursor shapes, courtesy of Mr. Fox, who wanted ALL of them.
209 (defconst x-pointer-X-cursor
0)
210 (defconst x-pointer-arrow
2)
211 (defconst x-pointer-based-arrow-down
4)
212 (defconst x-pointer-based-arrow-up
6)
213 (defconst x-pointer-boat
8)
214 (defconst x-pointer-bogosity
10)
215 (defconst x-pointer-bottom-left-corner
12)
216 (defconst x-pointer-bottom-right-corner
14)
217 (defconst x-pointer-bottom-side
16)
218 (defconst x-pointer-bottom-tee
18)
219 (defconst x-pointer-box-spiral
20)
220 (defconst x-pointer-center-ptr
22)
221 (defconst x-pointer-circle
24)
222 (defconst x-pointer-clock
26)
223 (defconst x-pointer-coffee-mug
28)
224 (defconst x-pointer-cross
30)
225 (defconst x-pointer-cross-reverse
32)
226 (defconst x-pointer-crosshair
34)
227 (defconst x-pointer-diamond-cross
36)
228 (defconst x-pointer-dot
38)
229 (defconst x-pointer-dotbox
40)
230 (defconst x-pointer-double-arrow
42)
231 (defconst x-pointer-draft-large
44)
232 (defconst x-pointer-draft-small
46)
233 (defconst x-pointer-draped-box
48)
234 (defconst x-pointer-exchange
50)
235 (defconst x-pointer-fleur
52)
236 (defconst x-pointer-gobbler
54)
237 (defconst x-pointer-gumby
56)
238 (defconst x-pointer-hand1
58)
239 (defconst x-pointer-hand2
60)
240 (defconst x-pointer-heart
62)
241 (defconst x-pointer-icon
64)
242 (defconst x-pointer-iron-cross
66)
243 (defconst x-pointer-left-ptr
68)
244 (defconst x-pointer-left-side
70)
245 (defconst x-pointer-left-tee
72)
246 (defconst x-pointer-leftbutton
74)
247 (defconst x-pointer-ll-angle
76)
248 (defconst x-pointer-lr-angle
78)
249 (defconst x-pointer-man
80)
250 (defconst x-pointer-middlebutton
82)
251 (defconst x-pointer-mouse
84)
252 (defconst x-pointer-pencil
86)
253 (defconst x-pointer-pirate
88)
254 (defconst x-pointer-plus
90)
255 (defconst x-pointer-question-arrow
92)
256 (defconst x-pointer-right-ptr
94)
257 (defconst x-pointer-right-side
96)
258 (defconst x-pointer-right-tee
98)
259 (defconst x-pointer-rightbutton
100)
260 (defconst x-pointer-rtl-logo
102)
261 (defconst x-pointer-sailboat
104)
262 (defconst x-pointer-sb-down-arrow
106)
263 (defconst x-pointer-sb-h-double-arrow
108)
264 (defconst x-pointer-sb-left-arrow
110)
265 (defconst x-pointer-sb-right-arrow
112)
266 (defconst x-pointer-sb-up-arrow
114)
267 (defconst x-pointer-sb-v-double-arrow
116)
268 (defconst x-pointer-shuttle
118)
269 (defconst x-pointer-sizing
120)
270 (defconst x-pointer-spider
122)
271 (defconst x-pointer-spraycan
124)
272 (defconst x-pointer-star
126)
273 (defconst x-pointer-target
128)
274 (defconst x-pointer-tcross
130)
275 (defconst x-pointer-top-left-arrow
132)
276 (defconst x-pointer-top-left-corner
134)
277 (defconst x-pointer-top-right-corner
136)
278 (defconst x-pointer-top-side
138)
279 (defconst x-pointer-top-tee
140)
280 (defconst x-pointer-trek
142)
281 (defconst x-pointer-ul-angle
144)
282 (defconst x-pointer-umbrella
146)
283 (defconst x-pointer-ur-angle
148)
284 (defconst x-pointer-watch
150)
285 (defconst x-pointer-xterm
152)
291 (defvar x-colors
'("aquamarine"
349 "medium spring green"
429 "The list of X colors from the `rgb.txt' file.")
431 (defun xw-defined-colors (&optional frame
)
432 "Internal function called by `defined-colors', which see."
433 (or frame
(setq frame
(selected-frame)))
434 (let ((all-colors x-colors
)
436 (defined-colors nil
))
438 (setq this-color
(car all-colors
)
439 all-colors
(cdr all-colors
))
440 (and (color-supported-p this-color frame t
)
441 (setq defined-colors
(cons this-color defined-colors
))))
446 (defun iconify-or-deiconify-frame ()
447 "Iconify the selected frame, or deiconify if it's currently an icon."
449 (if (eq (cdr (assq 'visibility
(frame-parameters))) t
)
451 (make-frame-visible)))
453 (substitute-key-definition 'suspend-emacs
'iconify-or-deiconify-frame
456 ;; Map certain keypad keys into ASCII characters
457 ;; that people usually expect.
458 (define-key function-key-map
[backspace] [127])
459 (define-key function-key-map [delete] [127])
460 (define-key function-key-map [tab] [?\t])
461 (define-key function-key-map [linefeed] [?\n])
462 (define-key function-key-map [clear] [?\C-l])
463 (define-key function-key-map [return] [?\C-m])
464 (define-key function-key-map [escape] [?\e])
465 (define-key function-key-map [M-backspace] [?\M-\d])
466 (define-key function-key-map [M-delete] [?\M-\d])
467 (define-key function-key-map [M-tab] [?\M-\t])
468 (define-key function-key-map [M-linefeed] [?\M-\n])
469 (define-key function-key-map [M-clear] [?\M-\C-l])
470 (define-key function-key-map [M-return] [?\M-\C-m])
471 (define-key function-key-map [M-escape] [?\M-\e])
472 (define-key function-key-map [iso-lefttab] [backtab])
474 ;; These tell read-char how to convert
475 ;; these special chars to ASCII.
476 (put 'backspace 'ascii-character 127)
477 (put 'delete 'ascii-character 127)
478 (put 'tab 'ascii-character ?\t)
479 (put 'linefeed 'ascii-character ?\n)
480 (put 'clear 'ascii-character 12)
481 (put 'return 'ascii-character 13)
482 (put 'escape 'ascii-character ?\e)
484 (defun vendor-specific-keysyms (vendor)
485 "Return the appropriate value of system-key-alist for VENDOR.
486 VENDOR is a string containing the name of the X Server's vendor,
487 as returned by (x-server-vendor)."
488 (cond ((string-equal vendor "Apollo Computer Inc.")
510 ((or (string-equal vendor "Hewlett-Packard Incorporated")
511 (string-equal vendor "Hewlett-Packard Company"))
512 '(( 168 . mute-acute)
514 ( 170 . mute-asciicircum)
515 ( 171 . mute-diaeresis)
516 ( 172 . mute-asciitilde)
530 (65397 . kp-backtab)))
531 ((or (string-equal vendor "X11/NeWS - Sun Microsystems Inc.")
532 (string-equal vendor "X Consortium"))
536 ;; These are for Sun under X11R6
544 ;; This is used by DEC's X server.
545 '((65280 . remove)))))
548 ;;;; Selections and cut buffers
550 ;;; We keep track of the last text selected here, so we can check the
551 ;;; current selection against it, and avoid passing back our own text
552 ;;; from x-cut-buffer-or-selection-value.
553 (defvar x-last-selected-text nil)
555 ;;; It is said that overlarge strings are slow to put into the cut buffer.
556 ;;; Note this value is overridden below.
557 (defvar x-cut-buffer-max 20000
558 "Max number of characters to put in the cut buffer.")
560 (defvar x-select-enable-clipboard nil
561 "Non-nil means cutting and pasting uses the clipboard.
562 This is in addition to the primary selection.")
564 ;;; Make TEXT, a string, the primary X selection.
565 ;;; Also, set the value of X cut buffer 0, for backward compatibility
566 ;;; with older X applications.
567 ;;; gildea@lcs.mit.edu says it's not desirable to put kills
568 ;;; in the clipboard.
569 (defun x-select-text (text &optional push)
570 ;; Don't send the cut buffer too much text.
571 ;; It becomes slow, and if really big it causes errors.
572 (if (< (length text) x-cut-buffer-max)
573 (x-set-cut-buffer text push)
574 (x-set-cut-buffer "" push))
575 (x-set-selection 'PRIMARY text)
576 (if x-select-enable-clipboard
577 (x-set-selection 'CLIPBOARD text))
578 (setq x-last-selected-text text))
580 ;;; Return the value of the current X selection.
581 ;;; Consult the selection, then the cut buffer. Treat empty strings
582 ;;; as if they were unset.
583 ;;; If this function is called twice and finds the same text,
584 ;;; it returns nil the second time. This is so that a single
585 ;;; selection won't be added to the kill ring over and over.
586 (defun x-cut-buffer-or-selection-value ()
588 (when x-select-enable-clipboard
591 (setq text (x-get-selection 'CLIPBOARD 'COMPOUND_TEXT))
595 (setq text (x-get-selection 'CLIPBOARD 'STRING))
597 (if (string= text "") (setq text nil)))
599 ;; Don't die if x-get-selection signals an error.
602 (setq text (x-get-selection 'PRIMARY 'COMPOUND_TEXT))
606 (setq text (x-get-selection 'PRIMARY 'STRING))
608 (if (string= text "") (setq text nil))
610 (or text (setq text (x-get-cut-buffer 0)))
611 (if (string= text "") (setq text nil))
615 ((eq text x-last-selected-text) nil)
616 ((string= text x-last-selected-text)
617 ;; Record the newer string, so subsequent calls can use the `eq' test.
618 (setq x-last-selected-text text)
621 (setq x-last-selected-text text)))))
624 ;;; Do the actual X Windows setup here; the above code just defines
625 ;;; functions and variables that we use now.
627 (setq command-line-args (x-handle-args command-line-args))
629 ;;; Make sure we have a valid resource name.
630 (or (stringp x-resource-name)
632 (setq x-resource-name (invocation-name))
634 ;; Change any . or * characters in x-resource-name to hyphens,
635 ;; so as not to choke when we use it in X resource queries.
636 (while (setq i (string-match "[.*]" x-resource-name))
637 (aset x-resource-name i ?-))))
639 ;; For the benefit of older Emacses (19.27 and earlier) that are sharing
640 ;; the same lisp directory, don't pass the third argument unless we seem
641 ;; to have the multi-display support.
642 (if (fboundp 'x-close-connection)
643 (x-open-connection (or x-display-name
644 (setq x-display-name (getenv "DISPLAY")))
645 x-command-line-resources
646 ;; Exit Emacs with fatal error if this fails.
648 (x-open-connection (or x-display-name
649 (setq x-display-name (getenv "DISPLAY")))
650 x-command-line-resources))
652 (setq frame-creation-function 'x-create-frame-with-faces)
654 (setq x-cut-buffer-max (min (- (/ (x-server-max-request-size) 2) 100)
657 (if (fboundp 'new-fontset)
659 ;; Create the standard fontset.
660 (create-fontset-from-fontset-spec standard-fontset-spec t)
662 ;; Create fontset specified in X resources "Fontset-N" (N is 0, 1, ...).
663 (create-fontset-from-x-resource)
665 ;; Try to create a fontset from a font specification which comes
666 ;; from initial-frame-alist, default-frame-alist, or X resource.
667 ;; A font specification in command line argument (i.e. -fn XXXX)
668 ;; should be already in default-frame-alist as a `font'
669 ;; parameter. However, any font specifications in site-start
670 ;; library, user's init file (.emacs), and default.el are not
673 (let ((font (or (cdr (assq 'font initial-frame-alist))
674 (cdr (assq 'font default-frame-alist))
675 (x-get-resource "font" "Font")))
676 xlfd-fields resolved-name)
678 (not (query-fontset font))
679 (setq resolved-name (x-resolve-font-name font))
680 (setq xlfd-fields (x-decompose-font-name font)))
681 (if (string= "fontset"
682 (aref xlfd-fields xlfd-regexp-registry-subnum))
683 (new-fontset font (x-complement-fontset-spec xlfd-fields nil))
684 ;; Create a fontset from FONT. The fontset name is
685 ;; generated from FONT. Create style variants of the
686 ;; fontset too. Font names in the variants are
687 ;; generated automatially unless X resources
688 ;; XXX.attribyteFont explicitly specify them.
689 (let ((styles (mapcar 'car x-style-funcs-alist))
690 (faces '(bold italic bold-italic))
691 face face-font fontset fontset-spec)
693 (setq face (car faces))
694 (setq face-font (x-get-resource (concat (symbol-name face)
696 "Face.AttributeFont"))
698 (setq styles (cons (cons face face-font)
699 (delq face styles))))
700 (setq faces (cdr faces)))
701 (aset xlfd-fields xlfd-regexp-foundry-subnum nil)
702 (aset xlfd-fields xlfd-regexp-family-subnum nil)
703 (aset xlfd-fields xlfd-regexp-registry-subnum "fontset")
704 (aset xlfd-fields xlfd-regexp-encoding-subnum "startup")
705 ;; The fontset name should have concrete values in
706 ;; weight and slant field.
707 (let ((weight (aref xlfd-fields xlfd-regexp-weight-subnum))
708 (slant (aref xlfd-fields xlfd-regexp-slant-subnum))
710 (if (and (or (not weight) (string-match "[*?]*" weight))
712 (x-decompose-font-name resolved-name)))
713 (aset xlfd-fields xlfd-regexp-weight-subnum
714 (aref xlfd-temp xlfd-regexp-weight-subnum)))
715 (if (and (or (not slant) (string-match "[*?]*" slant))
718 (x-decompose-font-name resolved-name))))
719 (aset xlfd-fields xlfd-regexp-slant-subnum
720 (aref xlfd-temp xlfd-regexp-slant-subnum))))
721 (setq fontset (x-compose-font-name xlfd-fields))
722 (create-fontset-from-fontset-spec
723 (concat fontset ", ascii:" font) styles)
726 ;; Sun expects the menu bar cut and paste commands to use the clipboard.
727 ;; This has ,? to match both on Sunos and on Solaris.
728 (if (string-match "Sun Microsystems,? Inc\\."
730 (menu-bar-enable-clipboard))
732 ;; Apply a geometry resource to the initial frame. Put it at the end
733 ;; of the alist, so that anything specified on the command line takes
735 (let* ((res-geometry (x-get-resource "geometry" "Geometry"))
739 (setq parsed (x-parse-geometry res-geometry))
740 ;; If the resource specifies a position,
741 ;; call the position and size "user-specified".
742 (if (or (assq 'top parsed) (assq 'left parsed))
743 (setq parsed (cons '(user-position . t)
744 (cons '(user-size . t) parsed))))
745 ;; All geometry parms apply to the initial frame.
746 (setq initial-frame-alist (append initial-frame-alist parsed))
747 ;; The size parms apply to all frames.
748 (if (assq 'height parsed)
749 (setq default-frame-alist
750 (cons (cons 'height (cdr (assq 'height parsed)))
751 default-frame-alist)))
752 (if (assq 'width parsed)
753 (setq default-frame-alist
754 (cons (cons 'width (cdr (assq 'width parsed)))
755 default-frame-alist))))))
757 ;; Check the reverseVideo resource.
758 (let ((case-fold-search t))
759 (let ((rv (x-get-resource "reverseVideo" "ReverseVideo")))
761 (string-match "^\\(true\\|yes\\|on\\)$" rv))
762 (setq default-frame-alist
763 (cons '(reverse . t) default-frame-alist)))))
765 ;; Set x-selection-timeout, measured in milliseconds.
766 (let ((res-selection-timeout
767 (x-get-resource "selectionTimeout" "SelectionTimeout")))
768 (setq x-selection-timeout 20000)
769 (if res-selection-timeout
770 (setq x-selection-timeout (string-to-number res-selection-timeout))))
772 (defun x-win-suspend-error ()
773 (error "Suspending an emacs running under X makes no sense"))
774 (add-hook 'suspend-hook 'x-win-suspend-error)
776 ;;; Arrange for the kill and yank functions to set and check the clipboard.
777 (setq interprogram-cut-function 'x-select-text)
778 (setq interprogram-paste-function 'x-cut-buffer-or-selection-value)
780 ;;; Turn off window-splitting optimization; X is usually fast enough
781 ;;; that this is only annoying.
782 (setq split-window-keep-point t)
784 ;; Don't show the frame name; that's redundant with X.
785 (setq-default mode-line-frame-identification " ")
787 ;;; Motif direct handling of f10 wasn't working right,
788 ;;; So temporarily we've turned it off in lwlib-Xm.c
789 ;;; and turned the Emacs f10 back on.
790 ;;; ;; Motif normally handles f10 itself, so don't try to handle it a second time.
791 ;;; (if (featurep 'motif)
792 ;;; (global-set-key [f10] 'ignore))
794 ;;; x-win.el ends here