| blob | c32566181e580d120ea4de88b4bfdc9f766fcd9a |
1 ;;; x-win.el --- parse relevant switches and set up for X -*-coding: utf-8; lexical-binding:t -*-
3 ;; Copyright (C) 1993-1994, 2001-2015 Free Software Foundation, Inc.
5 ;; Author: FSF
6 ;; Keywords: terminals, i18n
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 3 of the License, or
13 ;; (at your option) any later version.
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. If not, see <http://www.gnu.org/licenses/>.
23 ;;; Commentary:
25 ;; X-win.el: this file defines functions to initialize the X window
26 ;; system and process X-specific command line parameters before
27 ;; creating the first X frame.
29 ;; Beginning in Emacs 23, the act of loading this file should not have
30 ;; the side effect of initializing the window system or processing
31 ;; command line arguments (this file is now loaded in loadup.el). See
32 ;; `handle-args-function' and `window-system-initialization' for more details.
34 ;; startup.el will then examine startup files, and eventually call the hooks
35 ;; which create the first window(s).
37 ;;; Code:
38 \f
39 ;; These are the standard X switches from the Xt Initialize.c file of
40 ;; Release 4.
42 ;; Command line Resource Manager string
44 ;; +rv *reverseVideo
45 ;; +synchronous *synchronous
46 ;; -background *background
47 ;; -bd *borderColor
48 ;; -bg *background
49 ;; -bordercolor *borderColor
50 ;; -borderwidth .borderWidth
51 ;; -bw .borderWidth
52 ;; -display .display
53 ;; -fg *foreground
54 ;; -fn *font
55 ;; -font *font
56 ;; -foreground *foreground
57 ;; -geometry .geometry
58 ;; -iconic .iconic
59 ;; -name .name
60 ;; -reverse *reverseVideo
61 ;; -rv *reverseVideo
62 ;; -selectionTimeout .selectionTimeout
63 ;; -synchronous *synchronous
64 ;; -xrm
66 ;; An alist of X options and the function which handles them. See
67 ;; ../startup.el.
93 ;; Handle the --parent-id option.
100 initial-frame-alist)
103 ;; Handle the --smid switch. This is used by the session manager
104 ;; to give us back our session id we had on the previous run.
112 "Special hook run when a save-session event occurs.
113 The functions do not get any argument.
114 Functions can return non-nil to inform the session manager that the
115 window system shutdown should be aborted.
120 "Construct a filename to save the session in based on SESSION-ID.
121 Return a filename in `user-emacs-directory', unless the session file
122 already exists in the home directory."
128 "This function is called when the window system is shutting down.
129 If this function returns non-nil, the window system shutdown is canceled.
131 When a session manager tells Emacs that the window system is shutting
132 down, this function is called. It calls the functions in the hook
133 `emacs-save-session-functions'. Functions are called with the current
134 buffer set to a temporary buffer. Functions should use `insert' to insert
135 lisp code to save the session state. The buffer is saved in a file in the
136 home directory of the user running Emacs. The file is evaluated when
137 Emacs is restarted by the session manager.
139 If any of the functions returns non-nil, no more functions are called
140 and this function returns non-nil. This will inform the session manager
141 that it should abort the window system shutdown."
148 ;; A return of t means cancel the shutdown.
155 cancel-shutdown))))
158 "Restore the Emacs session if started by a session manager.
159 The file saved by `emacs-session-save' is evaluated and deleted if it
160 exists."
169 \f
170 ;;
171 ;; Standard X cursor shapes, courtesy of Mr. Fox, who wanted ALL of them.
172 ;;
253 \f
254 ;;;; Keysyms
257 "Return the appropriate value of `system-key-alist' for VENDOR.
258 VENDOR is a string containing the name of the X Server's vendor,
259 as returned by `x-server-vendor'."
281 ;; Fixme: What about non-X11/NeWS sun server?
287 ;; These are for Sun under X11R6
295 ;; This is used by DEC's X server.
298 ;; Latin-1
304 ;; Table from Kuhn's proposed additions to the `KEYSYM Encoding'
305 ;; appendix to the X protocol definition.
308 '(
309 ;; Latin-2
367 ;; Latin-3
390 ;; Latin-4
490 ;; Arabic
539 ;; Cyrillic
663 ;; Greek
735 ;; Technical
778 ;; Special
802 ;; Publishing
880 ;; APL
900 ;; Hebrew
929 ;; Thai
1013 ;; Korean
1105 ;; Latin-5
1106 ;; Latin-6
1107 ;; Latin-7
1108 ;; Latin-8
1109 ;; Latin-9
1113 ;; Currency
1128 ;; The following keysym codes for graphics are listed in the document
1129 ;; as not having unicodes available:
1131 ;; #x08b1 TOP LEFT SUMMATION Technical
1132 ;; #x08b2 BOTTOM LEFT SUMMATION Technical
1133 ;; #x08b3 TOP VERTICAL SUMMATION CONNECTOR Technical
1134 ;; #x08b4 BOTTOM VERTICAL SUMMATION CONNECTOR Technical
1135 ;; #x08b5 TOP RIGHT SUMMATION Technical
1136 ;; #x08b6 BOTTOM RIGHT SUMMATION Technical
1137 ;; #x08b7 RIGHT MIDDLE SUMMATION Technical
1138 ;; #x0aac SIGNIFICANT BLANK SYMBOL Publish
1139 ;; #x0abd DECIMAL POINT Publish
1140 ;; #x0abf MARKER Publish
1141 ;; #x0acb TRADEMARK SIGN IN CIRCLE Publish
1142 ;; #x0ada HEXAGRAM Publish
1143 ;; #x0aff CURSOR Publish
1144 ;; #x0dde THAI MAIHANAKAT Thai
1146 \f
1147 ;;;; Selections
1152 ;; Arrange for the kill and yank functions to set and check the clipboard.
1155 "Insert the clipboard contents, or the last stretch of killed text."
1167 "Open the menu bar if it is shown.
1168 `popup-menu' is used if it is off."
1177 \f
1178 ;;; Window system initialization.
1181 "Report an error when a suspend is attempted.
1182 This returns an error if any Emacs frames are X frames."
1183 ;; Don't allow suspending if any of the frames are X frames.
1202 "Initialize Emacs for X frames and open the first connection to an X server."
1205 ;; Make sure we have a valid resource name.
1210 ;; Change any . or * characters in x-resource-name to hyphens,
1211 ;; so as not to choke when we use it in X resource queries.
1218 x-command-line-resources
1219 ;; Exit Emacs with fatal error if this fails and we
1220 ;; are the initial display.
1223 ;; Create the default fontset.
1226 ;; Create the standard fontset.
1230 'initialization
1234 ;; Create fontset specified in X resources "Fontset-N" (N is 0, 1, ...).
1237 ;; Set scroll bar mode to right if set by X resources. Default is left.
1241 ;; Apply a geometry resource to the initial frame. Put it at the end
1242 ;; of the alist, so that anything specified on the command line takes
1243 ;; precedence.
1245 parsed)
1249 ;; If the resource specifies a position,
1250 ;; call the position and size "user-specified".
1254 ;; All geometry parms apply to the initial frame.
1256 ;; The size parms apply to all frames. Don't set it if there are
1257 ;; sizes there already (from command line).
1262 default-frame-alist)))
1267 default-frame-alist))))))
1269 ;; Check the reverseVideo resource.
1277 ;; Set x-selection-timeout, measured in milliseconds.
1285 ;; Don't let Emacs suspend under X.
1288 ;; During initialization, we defer sending size hints to the window
1289 ;; manager, because that can induce a race condition:
1290 ;; http://lists.gnu.org/archive/html/emacs-devel/2008-10/msg00033.html
1291 ;; Send the size hints once initialization is done.
1294 ;; Turn off window-splitting optimization; X is usually fast enough
1295 ;; that this is only annoying.
1298 ;; Motif direct handling of f10 wasn't working right,
1299 ;; So temporarily we've turned it off in lwlib-Xm.c
1300 ;; and turned the Emacs f10 back on.
1301 ;; ;; Motif normally handles f10 itself, so don't try to handle it a second time.
1302 ;; (if (featurep 'motif)
1303 ;; (global-set-key [f10] 'ignore))
1305 ;; Enable CLIPBOARD copy/paste through menu bar commands.
1308 ;; ;; Override Paste so it looks at CLIPBOARD first.
1309 ;; (define-key menu-bar-edit-menu [paste]
1310 ;; (append '(menu-item "Paste" x-clipboard-yank
1311 ;; :enable (not buffer-read-only)
1312 ;; :help "Paste (yank) text most recently cut/copied")
1313 ;; nil))
1354 ;; Initiate drag and drop
1361 '(
1385 ;; Used in Gnus and/or MH-E:
1392 ;; ("etc/images/exit" . "gtk-exit")
1417 ;; Used for GDB Graphical Interface
1421 ;; No themed versions available:
1422 ;; mail/preview (combining stock_mail and stock_zoom)
1423 ;; mail/save (combining stock_mail, stock_save and stock_convert)
1424 ))
1425 "How icons for tool bars are mapped to Gtk+ stock items.
1426 Emacs must be compiled with the Gtk+ toolkit for this to have any effect.
1427 A value that begins with n: denotes a named icon instead of a stock icon."
1438 "A list of alists that map icon file names to stock/named icons.
1439 The alists are searched in the order they appear. The first match is used.
1440 The keys in the alists are file names without extension and with two directory
1441 components. For example, to map /usr/share/emacs/22.1.1/etc/images/open.xpm
1442 to stock item gtk-open, use:
1446 Themes also have named icons. To map to one of those, use n: before the name:
1450 The list elements are either the symbol name for the alist or the
1451 alist itself.
1453 If you don't want stock icons, set the variable to nil."
1464 "Map icon with file name FILE to a Gtk+ stock name.
1465 This uses `icon-map-list' to map icon file names to stock icon names."
1469 file
1473 file-sans)
1476 elem value)
1482 elem))
1485 x-gtk-stock-cache))))
1489 (provide 'x-win)
1491 ;;; x-win.el ends here