1 ;;; pc-win.el --- setup support for `PC windows' (whatever that is) -*- lexical-binding:t -*-
3 ;; Copyright (C) 1994, 1996-1997, 1999, 2001-2018 Free Software
6 ;; Author: Morten Welinder <terra@diku.dk>
7 ;; Maintainer: emacs-devel@gnu.org
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
26 ;; This file is preloaded into Emacs by loadup.el. The functions in
27 ;; this file are then called during startup from startup.el. This
28 ;; means that just loading this file should not have any side effects
29 ;; besides defining functions and variables, and in particular should
30 ;; NOT initialize any window systems.
32 ;; The main entry points to this file's features are msdos-handle-args,
33 ;; msdos-create-frame-with-faces, msdos-initialize-window-system,
34 ;; terminal-init-internal. The last one is not supposed to be called,
35 ;; so it just errors out.
39 (if (not (fboundp 'msdos-remember-default-colors
))
40 (error "%s: Loading pc-win.el but not compiled for MS-DOS"
43 (declare-function msdos-remember-default-colors
"msdos.c")
44 (declare-function w16-set-clipboard-data
"w16select.c")
45 (declare-function w16-get-clipboard-data
"w16select.c")
46 (declare-function msdos-setup-keyboard
"internal" (frame))
48 ;; This was copied from etc/rgb.txt, except that some values were changed
49 ;; a bit to make them consistent with DOS console colors, and the RGB
50 ;; values were scaled up to 16 bits, as `tty-define-color' requires.
52 ;; The mapping between the 16 standard EGA/VGA colors and X color names
53 ;; was done by running a Unix version of Emacs inside an X client and a
54 ;; DJGPP-compiled Emacs on the same PC. The names of X colors used to
55 ;; define the pixel values are shown as comments to each color below.
57 ;; If you want to change the RGB values, keep in mind that various pieces
58 ;; of Emacs think that a color whose RGB values add up to less than 0.6 of
59 ;; the values for WHITE (i.e. less than 117963) are ``dark'', otherwise the
60 ;; color is ``light''; see `frame-set-background-mode' in lisp/faces.el for
62 (defvar msdos-color-values
64 ("blue" 1 0 0 52480) ; MediumBlue
65 ("green" 2 8704 35584 8704) ; ForestGreen
66 ("cyan" 3 0 52736 53504) ; DarkTurquoise
67 ("red" 4 45568 8704 8704) ; FireBrick
68 ("magenta" 5 35584 0 35584) ; DarkMagenta
69 ("brown" 6 40960 20992 11520) ; Sienna
70 ("lightgray" 7 48640 48640 48640) ; Gray
71 ("darkgray" 8 26112 26112 26112) ; Gray40
72 ("lightblue" 9 0 0 65535) ; Blue
73 ("lightgreen" 10 0 65535 0) ; Green
74 ("lightcyan" 11 0 65535 65535) ; Cyan
75 ("lightred" 12 65535 0 0) ; Red
76 ("lightmagenta" 13 65535 0 65535) ; Magenta
77 ("yellow" 14 65535 65535 0) ; Yellow
78 ("white" 15 65535 65535 65535))
79 "A list of MS-DOS console colors, their indices and 16-bit RGB values.")
81 ;; ---------------------------------------------------------------------------
82 ;; We want to delay setting frame parameters until the faces are setup
83 (defvar default-frame-alist nil
)
84 ;(modify-frame-parameters terminal-frame default-frame-alist)
86 (defun msdos-face-setup ()
87 "Initial setup of faces for the MS-DOS display."
88 (set-face-foreground 'bold
"yellow")
89 (set-face-foreground 'italic
"red")
90 (set-face-foreground 'bold-italic
"lightred")
91 (set-face-foreground 'underline
"white")
93 (make-face 'msdos-menu-active-face
)
94 (make-face 'msdos-menu-passive-face
)
95 (make-face 'msdos-menu-select-face
)
96 (set-face-foreground 'msdos-menu-active-face
"white")
97 (set-face-foreground 'msdos-menu-passive-face
"lightgray")
98 (set-face-background 'msdos-menu-active-face
"blue")
99 (set-face-background 'msdos-menu-passive-face
"blue")
100 (set-face-background 'msdos-menu-select-face
"red"))
102 (defun msdos-handle-reverse-video (frame parameters
)
103 "Handle the reverse-video frame parameter on MS-DOS frames."
104 (when (cdr (or (assq 'reverse parameters
)
105 (assq 'reverse default-frame-alist
)))
106 (let* ((params (frame-parameters frame
))
107 (fg (cdr (assq 'foreground-color params
)))
108 (bg (cdr (assq 'background-color params
))))
109 (if (equal fg
(cdr (assq 'mouse-color params
)))
110 (modify-frame-parameters frame
111 (list (cons 'mouse-color bg
))))
112 (if (equal fg
(cdr (assq 'cursor-color params
)))
113 (modify-frame-parameters frame
114 (list (cons 'cursor-color bg
)))))))
116 ;; This must run after all the default colors are inserted into
117 ;; tty-color-alist, since msdos-handle-reverse-video needs to know the
118 ;; actual frame colors.
119 (defun msdos-setup-initial-frame ()
120 (modify-frame-parameters terminal-frame default-frame-alist
)
121 ;; This remembers the screen colors after applying default-frame-alist,
122 ;; so that all subsequent frames could begin with those colors.
123 (msdos-remember-default-colors terminal-frame
)
124 (modify-frame-parameters terminal-frame initial-frame-alist
)
125 (msdos-handle-reverse-video terminal-frame
126 (frame-parameters terminal-frame
))
128 (frame-set-background-mode terminal-frame
)
129 (face-set-after-frame-default terminal-frame
))
131 ;; We create frames as if we were a terminal, but without invoking the
132 ;; terminal-initialization function. Also, our handling of reverse
133 ;; video is slightly different.
134 (defun msdos-create-frame-with-faces (&optional parameters
)
135 "Create a frame on MS-DOS display.
136 Optional frame parameters PARAMETERS specify the frame parameters.
137 Parameters not specified by PARAMETERS are taken from
138 `default-frame-alist'. If either PARAMETERS or `default-frame-alist'
139 contains a `reverse' parameter, handle that. Value is the new frame
141 (let ((frame (make-terminal-frame parameters
))
144 (with-selected-frame frame
145 (msdos-handle-reverse-video frame
(frame-parameters frame
))
146 (unless (terminal-parameter frame
'terminal-initted
)
147 (set-terminal-parameter frame
'terminal-initted t
))
148 (frame-set-background-mode frame
)
149 (face-set-after-frame-default frame
)
151 (unless success
(delete-frame frame
)))
154 ;; ---------------------------------------------------------------------------
155 ;; More or less useful imitations of certain X-functions. A lot of the
156 ;; values returned are questionable, but usually only the form of the
157 ;; returned value matters. Also, by the way, recall that `ignore' is
158 ;; a useful function for returning 'nil regardless of argument.
160 ;; Note: Any re-definition in this file of a function that is defined
161 ;; in C on other platforms, should either have a doc-string that
162 ;; starts with "SKIP", or one that is identical to the C version,
163 ;; but with the arglist signature at the end. Otherwise
164 ;; help-split-fundoc gets confused on other platforms. (Bug#10783)
166 (defun x-list-fonts (_pattern &optional _face _frame _maximum width
)
167 "SKIP: real doc in xfaces.c."
168 (if (or (null width
) (and (numberp width
) (= width
1)))
170 (list "no-such-font")))
171 (defun x-display-pixel-width (&optional frame
)
172 "SKIP: real doc in xfns.c."
174 (defun x-display-pixel-height (&optional frame
)
175 "SKIP: real doc in xfns.c."
176 (frame-height frame
))
177 (defun x-display-planes (&optional _frame
)
178 "SKIP: real doc in xfns.c."
179 4) ;bg switched to 16 colors as well
180 (defun x-display-color-cells (&optional _frame
)
181 "SKIP: real doc in xfns.c."
183 (defun x-server-max-request-size (&optional _frame
)
184 "SKIP: real doc in xfns.c."
186 (defun x-server-vendor (&optional _frame
)
187 "SKIP: real doc in xfns.c."
189 (defun x-server-version (&optional _frame
)
190 "SKIP: real doc in xfns.c."
192 (defun x-display-screens (&optional _frame
)
193 "SKIP: real doc in xfns.c."
195 (defun x-display-mm-height (&optional _frame
)
196 "SKIP: real doc in xfns.c."
197 245) ; Guess the size of my...
198 (defun x-display-mm-width (&optional _frame
)
199 "SKIP: real doc in xfns.c."
200 322) ; ...monitor, EZ...
201 (defun x-display-backing-store (&optional _frame
)
202 "SKIP: real doc in xfns.c."
204 (defun x-display-visual-class (&optional _frame
)
205 "SKIP: real doc in xfns.c."
207 (fset 'x-display-save-under
'ignore
)
208 (fset 'x-get-resource
'ignore
)
210 (defvar x-display-name
"pc"
211 "SKIP: real doc in common-win.el.")
212 (defvar x-colors
(mapcar 'car msdos-color-values
)
213 "SKIP: real doc in common-win.el.")
215 ;; From lisp/term/w32-win.el
219 ;; gui-get-selection is used in select.el
220 (cl-defmethod gui-backend-get-selection (_selection-symbol _target-type
221 &context
(window-system pc
))
222 "Return the value of the current selection.
223 Consult the selection. Treat empty strings as if they were unset."
224 ;; Don't die if x-get-selection signals an error.
225 (with-demoted-errors "w16-get-clipboard-data:%s"
226 (w16-get-clipboard-data)))
228 (declare-function w16-selection-exists-p
"w16select.c")
229 ;; gui-selection-owner-p is used in simple.el.
230 (cl-defmethod gui-backend-selection-exists-p (selection
231 &context
(window-system pc
))
232 (w16-selection-exists-p selection
))
234 (cl-defmethod gui-backend-selection-owner-p (selection
235 &context
(window-system pc
))
236 (w16-selection-owner-p selection
))
238 (defun w16-selection-owner-p (_selection)
239 ;; FIXME: Other systems don't obey select-enable-clipboard here.
240 (if select-enable-clipboard
242 ;; Don't die if w16-get-clipboard-data signals an error.
243 (with-demoted-errors "w16-get-clipboard-data: %S"
244 (w16-get-clipboard-data))))
245 ;; We consider ourselves the owner of the selection
246 ;; if it does not exist, or exists and compares
247 ;; equal with the last text we've put into the
248 ;; Windows clipboard.
251 ((equal text gui--last-selected-text-clipboard
) text
)
254 ;; gui-set-selection is used in gui-set-selection.
255 (declare-function w16-set-clipboard-data
"w16select.c"
256 (string &optional ignored
))
257 (cl-defmethod gui-backend-set-selection (selection value
258 &context
(window-system pc
))
260 (if (w16-selection-owner-p selection
)
262 ;; FIXME: Other systems don't obey
263 ;; select-enable-clipboard here.
264 (with-demoted-errors "w16-set-clipboard-data: %S"
265 (w16-set-clipboard-data value
))
268 ;; From src/fontset.c:
269 (fset 'query-fontset
'ignore
)
271 ;; From lisp/term/x-win.el: make iconify-or-deiconify-frame a no-op.
272 (fset 'iconify-or-deiconify-frame
'ignore
)
274 ;; From lisp/frame.el
275 (fset 'set-default-font
'ignore
)
276 (fset 'set-mouse-color
'ignore
) ; We cannot, I think.
277 (fset 'set-cursor-color
'ignore
) ; Hardware determined by char under.
278 (fset 'set-border-color
'ignore
) ; Not useful.
280 (defvar msdos-last-help-message nil
281 "The last help message received via `show-help-function'.
282 This is used by `msdos-show-help'.")
284 (defvar msdos-previous-message nil
285 "The content of the echo area before help echo was displayed.")
287 (defun msdos-show-help (help)
288 "Function installed as `show-help-function' on MS-DOS frames."
289 (when (and (not (window-minibuffer-p)) ;Don't overwrite minibuffer contents.
290 (not cursor-in-echo-area
)) ;Don't overwrite a prompt.
293 (setq help
(replace-regexp-in-string "\n" ", " help
))
294 (unless (or msdos-previous-message
295 (string-equal help
(current-message))
296 (and (stringp msdos-last-help-message
)
297 (string-equal msdos-last-help-message
299 (setq msdos-previous-message
(current-message)))
300 (setq msdos-last-help-message help
)
301 (let ((message-truncate-lines nil
)
302 (message-log-max nil
))
303 (message "%s" help
)))
304 ((stringp msdos-previous-message
)
305 (let ((message-log-max nil
))
306 (message "%s" msdos-previous-message
)
307 (setq msdos-previous-message nil
)))
313 ;; ---------------------------------------------------------------------------
314 ;; This function is run, by the tty method of `frame-creation-function'
315 ;; (in faces.el), only for the initial frame (on each terminal, but we have
317 ;; This works by setting the `terminal-initted' terminal parameter to
318 ;; this function, the first time `frame-creation-function' is
319 ;; called on that terminal. `frame-creation-function' is called
320 ;; directly from startup.el and also by `make-frame'.
321 ;; `make-frame' should call our own `frame-creation-function' method instead
322 ;; (see below) so if terminal-init-internal is called it means something is
323 ;; _very_ wrong, because "internal" terminal emulator should not be
324 ;; turned on if our window-system is not `pc'. Therefore, the only
325 ;; Right Thing for us to do here is scream bloody murder.
326 (defun terminal-init-internal ()
327 "Terminal initialization function for the MS-DOS \"internal\" terminal.
328 Errors out because it is not supposed to be called, ever."
329 (error "terminal-init-internal called for window-system `%s'"
332 ;; window-system-initialization is called by startup.el:command-line.
333 (cl-defmethod window-system-initialization (&context
(window-system pc
)
335 "Initialization function for the `pc' \"window system\"."
336 (or (eq (window-system) 'pc
)
338 "`msdos-initialize-window-system' called, but window-system is `%s'"
340 ;; First, the keyboard.
341 (msdos-setup-keyboard terminal-frame
) ; see internal.el
342 ;; Next, register the default colors.
343 (let* ((colors msdos-color-values
)
344 (color (car colors
)))
347 (tty-color-define (car color
) (cadr color
) (cddr color
))
348 (setq colors
(cdr colors
) color
(car colors
))))
349 ;; Modifying color mappings means realized faces don't
350 ;; use the right colors, so clear them.
352 ;; Now set up some additional faces.
354 ;; Set up the initial frame.
355 (msdos-setup-initial-frame)
356 ;; Help echo is displayed in the echo area.
357 (setq show-help-function
'msdos-show-help
)
358 ;; We want to delay the codepage-related setup until after user's
359 ;; .emacs is processed, because people might define their
360 ;; `dos-codepage-setup-hook' there.
361 (add-hook 'after-init-hook
'dos-codepage-setup
)
362 ;; In multibyte mode, we want unibyte buffers to be displayed
363 ;; using the terminal coding system, so that they display
364 ;; correctly on the DOS terminal; in unibyte mode we want to see
365 ;; all 8-bit characters verbatim. In both cases, we want the
366 ;; entire range of 8-bit characters to arrive at our display code
368 (standard-display-8bit 127 255)
369 ;; We are fast enough to make this optimization unnecessary.
370 (setq split-window-keep-point t
)
371 ;; Arrange for the kill and yank functions to set and check the
373 (menu-bar-enable-clipboard)
374 (run-hooks 'terminal-init-msdos-hook
))
376 ;; frame-creation-function is called by frame.el:make-frame.
377 (cl-defmethod frame-creation-function (params &context
(window-system pc
))
378 (msdos-create-frame-with-faces params
))
380 ;; We don't need anything beyond tty-handle-args for handling
381 ;; command-line argument; see startup.el.
382 (cl-defmethod handle-args-function (args &context
(window-system pc
))
383 (tty-handle-args args
))
385 ;; ---------------------------------------------------------------------------
388 (provide 'term
/pc-win
)
390 ;;; pc-win.el ends here