1 ;;; w32-fns.el --- Lisp routines for Windows NT
3 ;; Copyright (C) 1994, 2001 Free Software Foundation, Inc.
5 ;; Author: Geoff Voelker <voelker@cs.washington.edu>
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.
30 ;; (November 21, 1994)
31 ;; [C-M-backspace] defined.
32 ;; mode-line-format defined to show buffer file type.
33 ;; audio bell initialized.
37 ;; Map delete and backspace
38 (define-key function-key-map
[backspace] "\177")
39 (define-key function-key-map [delete] "\C-d")
40 (define-key function-key-map [M-backspace] [?\M-\177])
41 (define-key function-key-map [C-M-backspace] [\C-\M-delete])
43 ;; Ignore case on file-name completion
44 (setq completion-ignore-case t)
46 ;; Map all versions of a filename (8.3, longname, mixed case) to the
48 (setq find-file-visit-truename t)
51 "Return the MS-Windows version numbers.
52 The value is a list of three integers: the major and minor version
53 numbers, and the build number."
56 (defvar w32-system-shells '("cmd" "cmd.exe" "command" "command.com"
57 "4nt" "4nt.exe" "4dos" "4dos.exe"
59 "List of strings recognized as Windows NT/9X system shells.")
61 (defun w32-using-nt ()
62 "Return non-nil if literally running on Windows NT (i.e., not Windows 9X)."
63 (and (eq system-type 'windows-nt) (getenv "SystemRoot")))
65 (defun w32-shell-name ()
66 "Return the name of the shell being used."
67 (or (and (boundp 'explicit-shell-file-name) explicit-shell-file-name)
70 (and (w32-using-nt) "cmd.exe")
73 (defun w32-system-shell-p (shell-name)
75 (member (downcase (file-name-nondirectory shell-name))
78 (defun w32-shell-dos-semantics ()
79 "Return t if the interactive shell being used expects msdos shell semantics."
80 (or (w32-system-shell-p (w32-shell-name))
81 (and (member (downcase (file-name-nondirectory (w32-shell-name)))
82 '("cmdproxy" "cmdproxy.exe"))
83 (w32-system-shell-p (getenv "COMSPEC")))))
85 (defvar w32-allow-system-shell nil
86 "*Disable startup warning when using \"system\" shells.")
88 (defun w32-check-shell-configuration ()
89 "Check the configuration of shell variables on Windows NT/9X.
90 This function is invoked after loading the init files and processing
91 the command line arguments. It issues a warning if the user or site
92 has configured the shell with inappropriate settings."
94 (let ((prev-buffer (current-buffer))
95 (buffer (get-buffer-create "*Shell Configuration*"))
99 (if (w32-system-shell-p (getenv "ESHELL"))
100 (insert (format "Warning! The ESHELL environment variable uses %s.
101 You probably want to change it so that it uses cmdproxy.exe instead.\n\n"
103 (if (w32-system-shell-p (getenv "SHELL"))
104 (insert (format "Warning! The SHELL environment variable uses %s.
105 You probably want to change it so that it uses cmdproxy.exe instead.\n\n"
107 (if (w32-system-shell-p shell-file-name)
108 (insert (format "Warning! shell-file-name uses %s.
109 You probably want to change it so that it uses cmdproxy.exe instead.\n\n"
111 (if (and (boundp 'explicit-shell-file-name)
112 (w32-system-shell-p explicit-shell-file-name))
113 (insert (format "Warning! explicit-shell-file-name uses %s.
114 You probably want to change it so that it uses cmdproxy.exe instead.\n\n"
115 explicit-shell-file-name)))
116 (setq system-shell (> (buffer-size) 0))
118 ;; Allow user to specify that they really do want to use one of the
119 ;; "system" shells, despite the drawbacks, but still warn if
120 ;; shell-command-switch doesn't match.
121 (if w32-allow-system-shell
126 (if (string-equal "-c" shell-command-switch)
127 (insert "Warning! shell-command-switch is \"-c\".
128 You should set this to \"/c\" when using a system shell.\n\n"))
129 (if w32-quote-process-args
130 (insert "Warning! w32-quote-process-args is t.
131 You should set this to nil when using a system shell.\n\n")))
132 ;; Non-system shells.
134 (if (string-equal "/c" shell-command-switch)
135 (insert "Warning! shell-command-switch is \"/c\".
136 You should set this to \"-c\" when using a non-system shell.\n\n"))
137 (if (not w32-quote-process-args)
138 (insert "Warning! w32-quote-process-args is nil.
139 You should set this to t when using a non-system shell.\n\n"))))
140 (if (> (buffer-size) 0)
141 (display-buffer buffer)
142 (kill-buffer buffer))
143 (set-buffer prev-buffer)))
145 (add-hook 'after-init-hook 'w32-check-shell-configuration)
147 ;;; Override setting chosen at startup.
148 (defun set-default-process-coding-system ()
149 ;; Most programs on Windows will accept Unix line endings on input
150 ;; (and some programs ported from Unix require it) but most will
151 ;; produce DOS line endings on output.
152 (setq default-process-coding-system
153 (if default-enable-multibyte-characters
154 '(undecided-dos . undecided-unix)
155 '(raw-text-dos . raw-text-unix)))
157 ;; On Windows 9x, make cmdproxy default to using DOS line endings
158 ;; for input, because command.com requires this.
159 (setq process-coding-system-alist
160 `(("[cC][mM][dD][pP][rR][oO][xX][yY]"
161 . ,(if default-enable-multibyte-characters
162 '(undecided-dos . undecided-dos)
163 '(raw-text-dos . raw-text-dos)))))))
165 (add-hook 'before-init-hook 'set-default-process-coding-system)
168 ;;; Basic support functions for managing Emacs' locale setting
170 (defvar w32-valid-locales nil
171 "List of locale ids known to be supported.")
173 ;;; This is the brute-force version; an efficient version is now
175 (if (not (fboundp 'w32-get-valid-locale-ids))
176 (defun w32-get-valid-locale-ids ()
177 "Return list of all valid Windows locale ids."
181 (if (w32-get-locale-info i)
182 (setq locales (cons i locales)))
186 (defun w32-list-locales ()
187 "List the name and id of all locales supported by Windows."
189 (if (null w32-valid-locales)
190 (setq w32-valid-locales (w32-get-valid-locale-ids)))
191 (switch-to-buffer-other-window (get-buffer-create "*Supported Locales*"))
193 (insert "LCID\tAbbrev\tFull name\n\n")
198 (w32-get-locale-info x)
199 (w32-get-locale-info x t)))
200 w32-valid-locales "\n"))
202 (goto-char (point-min)))
205 ;;; Setup Info-default-directory-list to include the info directory
206 ;;; near where Emacs executable was installed. We used to set INFOPATH,
207 ;;; but when this is set Info-default-directory-list is ignored. We
208 ;;; also cannot rely upon what is set in paths.el because they assume
209 ;;; that configuration during build time is correct for runtime.
210 (defun w32-init-info ()
211 (let* ((instdir (file-name-directory invocation-directory))
212 (dir1 (expand-file-name "../info/" instdir))
213 (dir2 (expand-file-name "../../../info/" instdir)))
214 (if (file-exists-p dir1)
215 (setq Info-default-directory-list
216 (append Info-default-directory-list (list dir1)))
217 (if (file-exists-p dir2)
218 (setq Info-default-directory-list
219 (append Info-default-directory-list (list dir2)))))))
221 (add-hook 'before-init-hook 'w32-init-info)
223 ;;; The variable source-directory is used to initialize Info-directory-list.
224 ;;; However, the common case is that Emacs is being used from a binary
225 ;;; distribution, and the value of source-directory is meaningless in that
226 ;;; case. Even worse, source-directory can refer to a directory on a drive
227 ;;; on the build machine that happens to be a removable drive on the user's
228 ;;; machine. When this happens, Emacs tries to access the removable drive
229 ;;; and produces the abort/retry/ignore dialog. Since we do not use
230 ;;; source-directory, set it to something that is a reasonable approximation
231 ;;; on the user's machine.
233 ;(add-hook 'before-init-hook
235 ; (setq source-directory (file-name-as-directory
236 ; (expand-file-name ".." exec-directory)))))
238 ;; Avoid creating auto-save file names containing invalid characters.
239 (fset 'original-make-auto-save-file-name
240 (symbol-function 'make-auto-save-file-name))
242 (defun make-auto-save-file-name ()
243 "Return file name to use for auto-saves of current buffer.
244 Does not consider `auto-save-visited-file-name' as that variable is checked
245 before calling this function. You can redefine this for customization.
246 See also `auto-save-file-name-p'."
247 (let ((filename (original-make-auto-save-file-name)))
248 ;; Don't modify remote (ange-ftp) filenames
249 (if (string-match "^/\\w+@[-A-Za-z0-9._]+:" filename)
251 (convert-standard-filename filename))))
253 (defun convert-standard-filename (filename)
254 "Convert a standard file's name to something suitable for the current OS.
255 This function's standard definition is trivial; it just returns the argument.
256 However, on some systems, the function is redefined
257 with a definition that really does change some file names."
258 (let ((name (copy-sequence filename))
260 ;; leave ':' if part of drive specifier
261 (if (and (> (length name) 1)
262 (eq (aref name 1) ?:))
264 ;; destructively replace invalid filename characters with !
265 (while (string-match "[?*:<>|\"\000-\037]" name start)
266 (aset name (match-beginning 0) ?!)
267 (setq start (match-end 0)))
268 ;; convert directory separators to Windows format
269 ;; (but only if the shell in use requires it)
270 (when (w32-shell-dos-semantics)
272 (while (string-match "/" name start)
273 (aset name (match-beginning 0) ?\\)
274 (setq start (match-end 0))))
277 ;;; Fix interface to (X-specific) mouse.el
278 (defun x-set-selection (type data)
279 (or type (setq type 'PRIMARY))
280 (put 'x-selections type data))
282 (defun x-get-selection (&optional type data-type)
283 (or type (setq type 'PRIMARY))
284 (get 'x-selections type))
286 (defun set-w32-system-coding-system (coding-system)
287 "Set the coding system used by the Windows System to CODING-SYSTEM.
288 This is used for things like passing font names with non-ASCII
289 characters in them to the system. For a list of possible values of
290 CODING-SYSTEM, use \\[list-coding-systems]."
292 (list (let ((default w32-system-coding-system))
294 (format "Coding system for system calls (default, %s): "
297 (check-coding-system coding-system)
298 (setq w32-system-coding-system coding-system))
299 ;; Set system coding system initially from locale-coding-system.
300 ;; In future, when defvaralias is available, this will become an alias.
301 (set-w32-system-coding-system locale-coding-system)
303 ;;; Set to a system sound if you want a fancy bell.
304 (set-message-beep nil)
306 ;;; The "Windows" keys on newer keyboards bring up the Start menu
307 ;;; whether you want it or not - make Emacs ignore these keystrokes
308 ;;; rather than beep.
309 (global-set-key [lwindow] 'ignore)
310 (global-set-key [rwindow] 'ignore)
312 ;; Map certain keypad keys into ASCII characters
313 ;; that people usually expect.
314 (define-key function-key-map [tab] [?\t])
315 (define-key function-key-map [linefeed] [?\n])
316 (define-key function-key-map [clear] [11])
317 (define-key function-key-map [return] [13])
318 (define-key function-key-map [escape] [?\e])
319 (define-key function-key-map [M-tab] [?\M-\t])
320 (define-key function-key-map [M-linefeed] [?\M-\n])
321 (define-key function-key-map [M-clear] [?\M-\013])
322 (define-key function-key-map [M-return] [?\M-\015])
323 (define-key function-key-map [M-escape] [?\M-\e])
325 ;; These don't do the right thing (voelker)
326 ;(define-key function-key-map [backspace] [127])
327 ;(define-key function-key-map [delete] [127])
328 ;(define-key function-key-map [M-backspace] [?\M-\d])
329 ;(define-key function-key-map [M-delete] [?\M-\d])
331 ;; These tell read-char how to convert
332 ;; these special chars to ASCII.
333 (put 'tab
'ascii-character ?
\t)
334 (put 'linefeed
'ascii-character ?
\n)
335 (put 'clear
'ascii-character
12)
336 (put 'return
'ascii-character
13)
337 (put 'escape
'ascii-character ?\e
)
338 (put 'backspace
'ascii-character
127)
339 (put 'delete
'ascii-character
127)
341 ;; W32 uses different color indexes than standard:
343 (defvar w32-tty-standard-colors
344 '(("white" 15 65535 65535 65535)
345 ("yellow" 14 65535 65535 0) ; Yellow
346 ("lightmagenta" 13 65535 0 65535) ; Magenta
347 ("lightred" 12 65535 0 0) ; Red
348 ("lightcyan" 11 0 65535 65535) ; Cyan
349 ("lightgreen" 10 0 65535 0) ; Green
350 ("lightblue" 9 0 0 65535) ; Blue
351 ("darkgray" 8 26112 26112 26112) ; Gray40
352 ("lightgray" 7 48640 48640 48640) ; Gray
353 ("brown" 6 40960 20992 11520) ; Sienna
354 ("magenta" 5 35584 0 35584) ; DarkMagenta
355 ("red" 4 45568 8704 8704) ; FireBrick
356 ("cyan" 3 0 52736 53504) ; DarkTurquoise
357 ("green" 2 8704 35584 8704) ; ForestGreen
358 ("blue" 1 0 0 52480) ; MediumBlue
360 "A list of VGA console colors, their indices and 16-bit RGB values.")
363 (defun w32-add-charset-info (xlfd-charset windows-charset codepage
)
364 "Function to add character sets to display with Windows fonts.
365 Creates entries in `w32-charset-info-alist'.
366 XLFD-CHARSET is a string which will appear in the XLFD font name to
367 identify the character set. WINDOWS-CHARSET is a symbol identifying
368 the Windows character set this maps to. For the list of possible
369 values, see the documentation for `w32-charset-info-alist'. CODEPAGE
370 can be a numeric codepage that Windows uses to display the character
371 set, t for Unicode output with no codepage translation or nil for 8
372 bit output with no translation."
373 (add-to-list 'w32-charset-info-alist
374 (cons xlfd-charset
(cons windows-charset codepage
)))
377 (w32-add-charset-info "iso8859-1" 'w32-charset-ansi
1252)
378 (w32-add-charset-info "iso8859-14" 'w32-charset-ansi
28604)
379 (w32-add-charset-info "iso8859-15" 'w32-charset-ansi
28605)
380 (w32-add-charset-info "jisx0208-sjis" 'w32-charset-shiftjis
932)
381 (w32-add-charset-info "jisx0201-latin" 'w32-charset-shiftjis
932)
382 (w32-add-charset-info "jisx0201-katakana" 'w32-charset-shiftjis
932)
383 (w32-add-charset-info "ksc5601.1987" 'w32-charset-hangeul
949)
384 (w32-add-charset-info "big5" 'w32-charset-chinesebig5
950)
385 (w32-add-charset-info "gb2312" 'w32-charset-gb2312
936)
386 (w32-add-charset-info "ms-symbol" 'w32-charset-symbol nil
)
387 (w32-add-charset-info "ms-oem" 'w32-charset-oem
437)
388 (w32-add-charset-info "ms-oemlatin" 'w32-charset-oem
850)
389 (if (boundp 'w32-extra-charsets-defined
)
391 (w32-add-charset-info "iso8859-2" 'w32-charset-easteurope
28592)
392 (w32-add-charset-info "iso8859-3" 'w32-charset-turkish
28593)
393 (w32-add-charset-info "iso8859-4" 'w32-charset-baltic
28594)
394 (w32-add-charset-info "iso8859-5" 'w32-charset-russian
28595)
395 (w32-add-charset-info "iso8859-6" 'w32-charset-arabic
28596)
396 (w32-add-charset-info "iso8859-7" 'w32-charset-greek
28597)
397 (w32-add-charset-info "iso8859-8" 'w32-charset-hebrew
1255)
398 (w32-add-charset-info "iso8859-9" 'w32-charset-turkish
1254)
399 (w32-add-charset-info "iso8859-13" 'w32-charset-baltic
1257)
400 (w32-add-charset-info "koi8-r" 'w32-charset-russian
20866)
401 (w32-add-charset-info "tis620" 'w32-charset-thai
874)
402 (w32-add-charset-info "ksc5601.1992" 'w32-charset-johab
1361)
403 (w32-add-charset-info "mac" 'w32-charset-mac nil
)))
404 (if (boundp 'w32-unicode-charset-defined
)
406 (w32-add-charset-info "iso10646-1" 'w32-charset-unicode t
)
407 (w32-add-charset-info "unicode" 'w32-charset-unicode t
))
408 ;; Most Windows fonts cover a large part of the Unicode range,
409 ;; so use ansi fonts if unicode is not an option.
410 (w32-add-charset-info "iso10646-1" 'w32-charset-ansi t
))
412 (make-obsolete-variable 'w32-enable-italics
413 'w32-enable-synthesized-fonts
"21.1")
414 (make-obsolete-variable 'w32-charset-to-codepage-alist
415 'w32-charset-info-alist
"21.1")
418 ;;;; Selections and cut buffers
420 ;;; We keep track of the last text selected here, so we can check the
421 ;;; current selection against it, and avoid passing back our own text
422 ;;; from x-cut-buffer-or-selection-value.
423 (defvar x-last-selected-text nil
)
425 ;;; It is said that overlarge strings are slow to put into the cut buffer.
426 ;;; Note this value is overridden below.
427 (defvar x-cut-buffer-max
20000
428 "Max number of characters to put in the cut buffer.")
430 (defcustom x-select-enable-clipboard t
431 "Non-nil means cutting and pasting uses the clipboard.
432 This is in addition to the primary selection."
436 (defun x-select-text (text &optional push
)
437 "Make TEXT the last selected text.
438 If `x-select-enable-clipboard' is non-nil, copy the text to the system
439 clipboard as well. Optional PUSH is ignored on Windows."
440 (if x-select-enable-clipboard
441 (w32-set-clipboard-data text
))
442 (setq x-last-selected-text text
))
444 (defun x-get-selection-value ()
445 "Return the value of the current selection.
446 Consult the selection, then the cut buffer. Treat empty strings as if
448 (if x-select-enable-clipboard
450 ;; Don't die if x-get-selection signals an error.
452 (setq text
(w32-get-clipboard-data))
453 (error (message "w32-get-clipboard-data:%s" c
)))
454 (if (string= text
"") (setq text nil
))
457 ((eq text x-last-selected-text
) nil
)
458 ((string= text x-last-selected-text
)
459 ;; Record the newer string, so subsequent calls can use the 'eq' test.
460 (setq x-last-selected-text text
)
463 (setq x-last-selected-text text
))))))
465 (defalias 'x-cut-buffer-or-selection-value
'x-get-selection-value
)
467 ;;; Arrange for the kill and yank functions to set and check the clipboard.
468 (setq interprogram-cut-function
'x-select-text
)
469 (setq interprogram-paste-function
'x-get-selection-value
)
472 ;;; w32-fns.el ends here