(minor-mode-list): New variable.
[bpt/emacs.git] / lisp / desktop.el
CommitLineData
6343ed61
RS
1;;; desktop.el --- save partial status of Emacs when killed
2
291e3b68
GM
3;; Copyright (C) 1993, 1994, 1995, 1997, 2000, 2001
4;; Free Software Foundation, Inc.
6343ed61
RS
5
6;; Author: Morten Welinder <terra@diku.dk>
3ea96cac 7;; Keywords: convenience
b6105c76 8;; Favourite-brand-of-beer: None, I hate beer.
6343ed61
RS
9
10;; This file is part of GNU Emacs.
11
12;; GNU Emacs is free software; you can redistribute it and/or modify
13;; it under the terms of the GNU General Public License as published by
14;; the Free Software Foundation; either version 2, or (at your option)
15;; any later version.
16
17;; GNU Emacs is distributed in the hope that it will be useful,
18;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20;; GNU General Public License for more details.
21
22;; You should have received a copy of the GNU General Public License
b578f267
EN
23;; along with GNU Emacs; see the file COPYING. If not, write to the
24;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
25;; Boston, MA 02111-1307, USA.
6343ed61
RS
26
27;;; Commentary:
28
0b9bd504
RS
29;; Save the Desktop, i.e.,
30;; - some global variables
31;; - the list of buffers with associated files. For each buffer also
32;; - the major mode
33;; - the default directory
34;; - the point
35;; - the mark & mark-active
36;; - buffer-read-only
ec4c6f22 37;; - some local variables
6343ed61 38
478653c9 39;; To use this, first put these two lines in the bottom of your .emacs
0b9bd504
RS
40;; file (the later the better):
41;;
0b9bd504
RS
42;; (desktop-load-default)
43;; (desktop-read)
44;;
47640244
GM
45;; Between these two lines you may wish to add something that updates the
46;; variables `desktop-globals-to-save' and/or `desktop-locals-to-save'. If
47;; for instance you want to save the local variable `foobar' for every buffer
48;; in which it is local, you could add the line
ec4c6f22
RS
49;;
50;; (setq desktop-locals-to-save (cons 'foobar desktop-locals-to-save))
51;;
f4c73d07 52;; To avoid saving excessive amounts of data you may also wish to add
ec4c6f22
RS
53;; something like the following
54;;
55;; (add-hook 'kill-emacs-hook
de9e2828 56;; '(lambda ()
ec4c6f22
RS
57;; (desktop-truncate search-ring 3)
58;; (desktop-truncate regexp-search-ring 3)))
59;;
60;; which will make sure that no more than three search items are saved. You
47640244
GM
61;; must place this line *after* the `(desktop-load-default)' line. See also
62;; the variable `desktop-save-hook'.
6343ed61 63
0b9bd504
RS
64;; Start Emacs in the root directory of your "project". The desktop saver
65;; is inactive by default. You activate it by M-x desktop-save RET. When
66;; you exit the next time the above data will be saved. This ensures that
67;; all the files you were editing will be reloaded the next time you start
68;; Emacs from the same directory and that points will be set where you
ec4c6f22 69;; left them. If you save a desktop file in your home directory it will
de9e2828 70;; act as a default desktop when you start Emacs from a directory that
ec4c6f22
RS
71;; doesn't have its own. I never do this, but you may want to.
72
47640244
GM
73;; Some words on minor modes: Most minor modes are controlled by
74;; buffer-local variables, which have a standard save / restore
75;; mechanism. To handle all minor modes, we take the following
76;; approach: (1) check whether the variable name from
77;; `minor-mode-alist' is also a function; and (2) use translation
78;; table `desktop-minor-mode-table' in the case where the two names
79;; are not the same.
80
ec4c6f22
RS
81;; By the way: don't use desktop.el to customize Emacs -- the file .emacs
82;; in your home directory is used for that. Saving global default values
83;; for buffers is an example of misuse.
84
0b9bd504
RS
85;; PLEASE NOTE: The kill ring can be saved as specified by the variable
86;; `desktop-globals-to-save' (by default it isn't). This may result in saving
87;; things you did not mean to keep. Use M-x desktop-clear RET.
ec4c6f22 88
fa379636
KH
89;; Thanks to hetrick@phys.uva.nl (Jim Hetrick) for useful ideas.
90;; avk@rtsg.mot.com (Andrew V. Klein) for a dired tip.
91;; chris@tecc.co.uk (Chris Boucher) for a mark tip.
92;; f89-kam@nada.kth.se (Klas Mellbourn) for a mh-e tip.
93;; kifer@sbkifer.cs.sunysb.edu (M. Kifer) for a bug hunt.
f4c73d07 94;; treese@lcs.mit.edu (Win Treese) for ange-ftp tips.
253406b9 95;; pot@cnuce.cnr.it (Francesco Potorti`) for misc. tips.
0b9bd504
RS
96;; ---------------------------------------------------------------------------
97;; TODO:
98;;
99;; Save window configuration.
100;; Recognize more minor modes.
101;; Save mark rings.
102;; Start-up with buffer-menu???
6343ed61
RS
103
104;;; Code:
105
ec4c6f22
RS
106;; Make the compilation more silent
107(eval-when-compile
108 ;; We use functions from these modules
fa379636
KH
109 ;; We can't (require 'mh-e) since that wants to load something.
110 (mapcar 'require '(info dired reporter)))
ec4c6f22 111;; ----------------------------------------------------------------------------
0b9bd504
RS
112;; USER OPTIONS -- settings you might want to play with.
113;; ----------------------------------------------------------------------------
bbf5eb28
RS
114
115(defgroup desktop nil
116 "Save status of Emacs when you exit."
117 :group 'frames)
118
813dbb2d
RS
119(defcustom desktop-enable nil
120 "*Non-nil enable Desktop to save the state of Emacs when you exit."
121 :group 'desktop
122 :type 'boolean
123 :require 'desktop
cd32a7ba
DN
124 :initialize 'custom-initialize-default
125 :version "20.3")
813dbb2d
RS
126
127(defcustom desktop-basefilename
fc715501 128 (convert-standard-filename ".emacs.desktop")
813dbb2d
RS
129 "File for Emacs desktop, not including the directory name."
130 :type 'file
131 :group 'desktop)
6343ed61 132
bbf5eb28 133(defcustom desktop-missing-file-warning nil
577ed2b2 134 "*If non-nil then desktop warns when a file no longer exists.
bbf5eb28
RS
135Otherwise it simply ignores that file."
136 :type 'boolean
137 :group 'desktop)
6343ed61 138
0b9bd504 139(defvar desktop-globals-to-save
6343ed61 140 (list 'desktop-missing-file-warning
0b9bd504 141 ;; Feature: saving kill-ring implies saving kill-ring-yank-pointer
ec4c6f22 142 ;; 'kill-ring
0b9bd504
RS
143 'tags-file-name
144 'tags-table-list
ec4c6f22
RS
145 'search-ring
146 'regexp-search-ring
de9e2828 147 'register-alist
0b9bd504 148 ;; 'desktop-globals-to-save ; Itself!
b6105c76 149 )
0e7c8611
RS
150 "List of global variables to save when killing Emacs.
151An element may be variable name (a symbol)
152or a cons cell of the form (VAR . MAX-SIZE),
153which means to truncate VAR's value to at most MAX-SIZE elements
154\(if the value is a list) before saving the value.")
6343ed61 155
ec4c6f22
RS
156(defvar desktop-locals-to-save
157 (list 'desktop-locals-to-save ; Itself! Think it over.
158 'truncate-lines
159 'case-fold-search
160 'case-replace
161 'fill-column
162 'overwrite-mode
163 'change-log-default-name
fa379636 164 'line-number-mode
ec4c6f22 165 )
577ed2b2
RS
166 "List of local variables to save for each buffer.
167The variables are saved only when they really are local.")
de9e2828 168(make-variable-buffer-local 'desktop-locals-to-save)
ec4c6f22 169
0b9bd504 170;; We skip .log files because they are normally temporary.
a7acbbe4 171;; (ftp) files because they require passwords and whatnot.
0b9bd504 172;; TAGS files to save time (tags-file-name is saved instead).
bbf5eb28 173(defcustom desktop-buffers-not-to-save
de9e2828 174 "\\(^nn\\.a[0-9]+\\|\\.log\\|(ftp)\\|^tags\\|^TAGS\\)$"
bbf5eb28
RS
175 "Regexp identifying buffers that are to be excluded from saving."
176 :type 'regexp
177 :group 'desktop)
6343ed61 178
fa379636 179;; Skip ange-ftp files
bbf5eb28 180(defcustom desktop-files-not-to-save
fa379636 181 "^/[^/:]*:"
bbf5eb28
RS
182 "Regexp identifying files whose buffers are to be excluded from saving."
183 :type 'regexp
184 :group 'desktop)
fa379636 185
b6b70cda
JW
186(defcustom desktop-buffer-modes-to-save
187 '(Info-mode rmail-mode)
188 "If a buffer is of one of these major modes, save the buffer name.
189It is up to the functions in `desktop-buffer-handlers' to decide
190whether the buffer should be recreated or not, and how."
191 :type '(repeat symbol)
192 :group 'desktop)
193
80f9f3db
SM
194(defcustom desktop-modes-not-to-save nil
195 "List of major modes whose buffers should not be saved."
196 :type '(repeat symbol)
197 :group 'desktop)
198
bbf5eb28
RS
199(defcustom desktop-buffer-major-mode nil
200 "When desktop creates a buffer, this holds the desired Major mode."
201 :type 'symbol
202 :group 'desktop)
569c754e 203
bbf5eb28
RS
204(defcustom desktop-buffer-file-name nil
205 "When desktop creates a buffer, this holds the file name to visit."
206 :type '(choice file (const nil))
207 :group 'desktop)
569c754e 208
bbf5eb28
RS
209(defcustom desktop-buffer-name nil
210 "When desktop creates a buffer, this holds the desired buffer name."
211 :type '(choice string (const nil))
212 :group 'desktop)
569c754e 213
2699e23e
RS
214(defvar desktop-buffer-misc nil
215 "When desktop creates a buffer, this holds a list of misc info.
216It is used by the `desktop-buffer-handlers' functions.")
217
b6b70cda
JW
218(defcustom desktop-buffer-misc-functions
219 '(desktop-buffer-info-misc-data
220 desktop-buffer-dired-misc-data)
221 "*Functions used to determine auxiliary information for a buffer.
222These functions are called in order, with no arguments. If a function
223returns non-nil, its value is saved along with the desktop buffer for
224which it was called; no further functions will be called.
225
226Later, when desktop.el restores the buffers it has saved, each of the
227`desktop-buffer-handlers' functions will have access to a buffer local
228variable, named `desktop-buffer-misc', whose value is what the
229\"misc\" function returned previously."
230 :type '(repeat function)
231 :group 'desktop)
232
bbf5eb28 233(defcustom desktop-buffer-handlers
0b9bd504 234 '(desktop-buffer-dired
6343ed61 235 desktop-buffer-rmail
ec4c6f22 236 desktop-buffer-mh
6343ed61
RS
237 desktop-buffer-info
238 desktop-buffer-file)
577ed2b2 239 "*List of functions to call in order to create a buffer.
569c754e
RS
240The functions are called without explicit parameters but can use the
241variables `desktop-buffer-major-mode', `desktop-buffer-file-name',
242`desktop-buffer-name'.
243If one function returns non-nil, no further functions are called.
0a8c8225
RS
244If the function returns a buffer, then the saved mode settings
245and variable values for that buffer are copied into it."
bbf5eb28
RS
246 :type '(repeat function)
247 :group 'desktop)
ec4c6f22 248
b6b70cda
JW
249(put 'desktop-buffer-handlers 'risky-local-variable t)
250
ec4c6f22
RS
251(defvar desktop-create-buffer-form "(desktop-create-buffer 205"
252 "Opening of form for creation of new buffers.")
fa379636 253
bbf5eb28 254(defcustom desktop-save-hook nil
813dbb2d
RS
255 "Hook run before desktop saves the state of Emacs.
256This is useful for truncating history lists, for example."
bbf5eb28
RS
257 :type 'hook
258 :group 'desktop)
813dbb2d 259
47640244
GM
260(defcustom desktop-minor-mode-table
261 '((auto-fill-function auto-fill-mode)
262 (vc-mode nil))
263 "Table mapping minor mode variables to minor mode functions.
264Each entry has the form (NAME RESTORE-FUNCTION).
265NAME is the name of the buffer-local variable indicating that the minor
266mode is active. RESTORE-FUNCTION is the function to activate the minor mode.
267called. RESTORE-FUNCTION nil means don't try to restore the minor mode.
268Only minor modes for which the name of the buffer-local variable
269and the name of the minor mode function are different have to added to
270this table."
271 :type 'sexp
272 :group 'desktop)
273
0b9bd504
RS
274;; ----------------------------------------------------------------------------
275(defvar desktop-dirname nil
6343ed61
RS
276 "The directory in which the current desktop file resides.")
277
278(defconst desktop-header
0b9bd504
RS
279";; --------------------------------------------------------------------------
280;; Desktop File for Emacs
281;; --------------------------------------------------------------------------
6343ed61 282" "*Header to place in Desktop file.")
de9e2828
RS
283
284(defvar desktop-delay-hook nil
285 "Hooks run after all buffers are loaded; intended for internal use.")
813dbb2d 286
0b9bd504 287;; ----------------------------------------------------------------------------
ec4c6f22
RS
288(defun desktop-truncate (l n)
289 "Truncate LIST to at most N elements destructively."
290 (let ((here (nthcdr (1- n) l)))
291 (if (consp here)
de9e2828 292 (setcdr here nil))))
ec4c6f22 293;; ----------------------------------------------------------------------------
f9be4574
RS
294(defcustom desktop-clear-preserve-buffers
295 '("*scratch*" "*Messages*")
296 "*Buffer names that `desktop-clear' should not delete."
297 :type '(repeat string)
298 :group 'desktop)
299
300(defun desktop-clear ()
301 "Empty the Desktop.
302This kills all buffers except for internal ones
303and those listed in `desktop-clear-preserve-buffers'."
6343ed61 304 (interactive)
fa379636
KH
305 (setq kill-ring nil
306 kill-ring-yank-pointer nil
307 search-ring nil
308 search-ring-yank-pointer nil
309 regexp-search-ring nil
310 regexp-search-ring-yank-pointer nil)
f9be4574
RS
311 (let ((buffers (buffer-list)))
312 (while buffers
313 (or (member (buffer-name (car buffers)) desktop-clear-preserve-buffers)
2f348ca3 314 (null (buffer-name (car buffers)))
f9be4574
RS
315 ;; Don't kill buffers made for internal purposes.
316 (and (not (equal (buffer-name (car buffers)) ""))
317 (eq (aref (buffer-name (car buffers)) 0) ?\ ))
318 (kill-buffer (car buffers)))
319 (setq buffers (cdr buffers))))
b6105c76 320 (delete-other-windows))
0b9bd504 321;; ----------------------------------------------------------------------------
de9e2828 322(add-hook 'kill-emacs-hook 'desktop-kill)
ec4c6f22 323
6343ed61 324(defun desktop-kill ()
0b9bd504 325 (if desktop-dirname
fa379636
KH
326 (condition-case err
327 (desktop-save desktop-dirname)
328 (file-error
329 (if (yes-or-no-p "Error while saving the desktop. Quit anyway? ")
330 nil
331 (signal (car err) (cdr err)))))))
0b9bd504 332;; ----------------------------------------------------------------------------
ed2f7fc8
RS
333(defun desktop-list* (&rest args)
334 (if (null (cdr args))
335 (car args)
336 (setq args (nreverse args))
337 (let ((value (cons (nth 1 args) (car args))))
338 (setq args (cdr (cdr args)))
339 (while args
340 (setq value (cons (car args) value))
341 (setq args (cdr args)))
342 value)))
343
de9e2828 344(defun desktop-internal-v2s (val)
577ed2b2
RS
345 "Convert VALUE to a pair (QUOTE . TXT); (eval (read TXT)) gives VALUE.
346TXT is a string that when read and evaluated yields value.
347QUOTE may be `may' (value may be quoted),
348`must' (values must be quoted), or nil (value may not be quoted)."
de9e2828 349 (cond
e2247420 350 ((or (numberp val) (null val) (eq t val))
de9e2828 351 (cons 'may (prin1-to-string val)))
e2247420 352 ((stringp val)
95bf6435
RS
353 (let ((copy (copy-sequence val)))
354 (set-text-properties 0 (length copy) nil copy)
355 ;; Get rid of text properties because we cannot read them
356 (cons 'may (prin1-to-string copy))))
de9e2828
RS
357 ((symbolp val)
358 (cons 'must (prin1-to-string val)))
359 ((vectorp val)
360 (let* ((special nil)
361 (pass1 (mapcar
362 (lambda (el)
363 (let ((res (desktop-internal-v2s el)))
364 (if (null (car res))
365 (setq special t))
366 res))
367 val)))
368 (if special
369 (cons nil (concat "(vector "
370 (mapconcat (lambda (el)
371 (if (eq (car el) 'must)
372 (concat "'" (cdr el))
373 (cdr el)))
374 pass1
375 " ")
376 ")"))
377 (cons 'may (concat "[" (mapconcat 'cdr pass1 " ") "]")))))
378 ((consp val)
b4929f75
RS
379 (let ((p val)
380 newlist
ed2f7fc8 381 use-list*
b4929f75
RS
382 anynil)
383 (while (consp p)
384 (let ((q.txt (desktop-internal-v2s (car p))))
385 (or anynil (setq anynil (null (car q.txt))))
386 (setq newlist (cons q.txt newlist)))
387 (setq p (cdr p)))
388 (if p
389 (let ((last (desktop-internal-v2s p))
390 (el (car newlist)))
ed2f7fc8
RS
391 (or anynil (setq anynil (null (car last))))
392 (or anynil
393 (setq newlist (cons '(must . ".") newlist)))
394 (setq use-list* t)
395 (setq newlist (cons last newlist))))
b4929f75
RS
396 (setq newlist (nreverse newlist))
397 (if anynil
398 (cons nil
ed2f7fc8 399 (concat (if use-list* "(desktop-list* " "(list ")
b4929f75
RS
400 (mapconcat (lambda (el)
401 (if (eq (car el) 'must)
402 (concat "'" (cdr el))
403 (cdr el)))
404 newlist
405 " ")
406 ")"))
407 (cons 'must
408 (concat "(" (mapconcat 'cdr newlist " ") ")")))))
de9e2828
RS
409 ((subrp val)
410 (cons nil (concat "(symbol-function '"
411 (substring (prin1-to-string val) 7 -1)
412 ")")))
413 ((markerp val)
414 (let ((pos (prin1-to-string (marker-position val)))
415 (buf (prin1-to-string (buffer-name (marker-buffer val)))))
416 (cons nil (concat "(let ((mk (make-marker)))"
417 " (add-hook 'desktop-delay-hook"
418 " (list 'lambda '() (list 'set-marker mk "
419 pos " (get-buffer " buf ")))) mk)"))))
420 (t ; save as text
fa379636 421 (cons 'may "\"Unprintable entity\""))))
de9e2828 422
ec4c6f22 423(defun desktop-value-to-string (val)
577ed2b2
RS
424 "Convert VALUE to a string that when read evaluates to the same value.
425Not all types of values are supported."
de9e2828
RS
426 (let* ((print-escape-newlines t)
427 (float-output-format nil)
428 (quote.txt (desktop-internal-v2s val))
429 (quote (car quote.txt))
430 (txt (cdr quote.txt)))
431 (if (eq quote 'must)
432 (concat "'" txt)
433 txt)))
ec4c6f22 434;; ----------------------------------------------------------------------------
0e7c8611
RS
435(defun desktop-outvar (varspec)
436 "Output a setq statement for variable VAR to the desktop file.
437The argument VARSPEC may be the variable name VAR (a symbol),
438or a cons cell of the form (VAR . MAX-SIZE),
439which means to truncate VAR's value to at most MAX-SIZE elements
440\(if the value is a list) before saving the value."
441 (let (var size)
442 (if (consp varspec)
443 (setq var (car varspec) size (cdr varspec))
444 (setq var varspec))
445 (if (boundp var)
446 (progn
447 (if (and (integerp size)
448 (> size 0)
449 (listp (eval var)))
47640244 450 (desktop-truncate (eval var) size))
0e7c8611
RS
451 (insert "(setq "
452 (symbol-name var)
453 " "
454 (desktop-value-to-string (symbol-value var))
455 ")\n")))))
0b9bd504 456;; ----------------------------------------------------------------------------
ec4c6f22 457(defun desktop-save-buffer-p (filename bufname mode &rest dummy)
b6105c76 458 "Return t if the desktop should record a particular buffer for next startup.
0b9bd504 459FILENAME is the visited file name, BUFNAME is the buffer name, and
6343ed61 460MODE is the major mode."
fa379636 461 (let ((case-fold-search nil))
80f9f3db
SM
462 (and (not (string-match desktop-buffers-not-to-save bufname))
463 (not (memq mode desktop-modes-not-to-save))
464 (or (and filename
465 (not (string-match desktop-files-not-to-save filename)))
466 (and (eq mode 'dired-mode)
467 (save-excursion
468 (set-buffer (get-buffer bufname))
469 (not (string-match desktop-files-not-to-save
470 default-directory))))
471 (and (null filename)
b6b70cda 472 (memq mode desktop-buffer-modes-to-save))))))
0b9bd504 473;; ----------------------------------------------------------------------------
e5714620
JB
474(defcustom desktop-relative-file-names nil
475 "*Store relative file names in the desktop file."
476 :type 'boolean
477 :group 'desktop)
478
6343ed61
RS
479(defun desktop-save (dirname)
480 "Save the Desktop file. Parameter DIRNAME specifies where to save desktop."
481 (interactive "DDirectory to save desktop file in: ")
fa379636 482 (run-hooks 'desktop-save-hook)
6343ed61 483 (save-excursion
14d8c7f0 484 (let ((filename (expand-file-name desktop-basefilename dirname))
0b9bd504
RS
485 (info (nreverse
486 (mapcar
47640244
GM
487 (function
488 (lambda (b)
e5714620
JB
489 (set-buffer b)
490 (list
491 (let ((bn (buffer-file-name)))
492 (if bn
493 (if desktop-relative-file-names
494 (file-relative-name bn dirname)
495 bn)))
496 (buffer-name)
497 major-mode
498 ;; minor modes
499 (let (ret)
500 (mapcar
501 #'(lambda (mim)
502 (and (boundp mim)
503 (symbol-value mim)
504 (setq ret
505 (cons (let ((special (assq mim desktop-minor-mode-table)))
506 (if special
507 (cadr special)
508 mim))
509 ret))))
510 (mapcar #'car minor-mode-alist))
511 ret)
512 (point)
513 (list (mark t) mark-active)
514 buffer-read-only
515 (run-hook-with-args-until-success
516 'desktop-buffer-misc-functions)
517 (let ((locals desktop-locals-to-save)
518 (loclist (buffer-local-variables))
519 (ll))
520 (while locals
521 (let ((here (assq (car locals) loclist)))
522 (if here
523 (setq ll (cons here ll))
524 (if (member (car locals) loclist)
525 (setq ll (cons (car locals) ll)))))
526 (setq locals (cdr locals)))
527 ll)
528 )))
6343ed61
RS
529 (buffer-list))))
530 (buf (get-buffer-create "*desktop*")))
531 (set-buffer buf)
532 (erase-buffer)
fa379636 533
cceff8d6
EZ
534 (insert ";; -*- coding: emacs-mule; -*-\n"
535 desktop-header
0b9bd504 536 ";; Created " (current-time-string) "\n"
fa379636
KH
537 ";; Emacs version " emacs-version "\n\n"
538 ";; Global section:\n")
6343ed61
RS
539 (mapcar (function desktop-outvar) desktop-globals-to-save)
540 (if (memq 'kill-ring desktop-globals-to-save)
0b9bd504
RS
541 (insert "(setq kill-ring-yank-pointer (nthcdr "
542 (int-to-string
6343ed61
RS
543 (- (length kill-ring) (length kill-ring-yank-pointer)))
544 " kill-ring))\n"))
545
0b9bd504 546 (insert "\n;; Buffer section:\n")
de9e2828
RS
547 (mapcar
548 (function (lambda (l)
e5714620
JB
549 (if (apply 'desktop-save-buffer-p l)
550 (progn
551 (insert desktop-create-buffer-form)
552 (mapcar
553 (function (lambda (e)
554 (insert "\n "
555 (desktop-value-to-string e))))
556 l)
557 (insert ")\n\n")))))
de9e2828 558 info)
6343ed61
RS
559 (setq default-directory dirname)
560 (if (file-exists-p filename) (delete-file filename))
7642acca
GM
561 (let ((coding-system-for-write 'emacs-mule))
562 (write-region (point-min) (point-max) filename nil 'nomessage))))
6343ed61 563 (setq desktop-dirname dirname))
0b9bd504 564;; ----------------------------------------------------------------------------
6343ed61
RS
565(defun desktop-remove ()
566 "Delete the Desktop file and inactivate the desktop system."
567 (interactive)
568 (if desktop-dirname
569 (let ((filename (concat desktop-dirname desktop-basefilename)))
fa379636
KH
570 (setq desktop-dirname nil)
571 (if (file-exists-p filename)
572 (delete-file filename)))))
0b9bd504 573;; ----------------------------------------------------------------------------
478653c9 574;;;###autoload
6343ed61 575(defun desktop-read ()
253406b9
RS
576 "Read the Desktop file and the files it specifies.
577This is a no-op when Emacs is running in batch mode."
6343ed61 578 (interactive)
253406b9
RS
579 (if noninteractive
580 nil
581 (let ((dirs '("./" "~/")))
582 (while (and dirs
583 (not (file-exists-p (expand-file-name
584 desktop-basefilename
585 (car dirs)))))
586 (setq dirs (cdr dirs)))
587 (setq desktop-dirname (and dirs (expand-file-name (car dirs))))
588 (if desktop-dirname
1d500ca6
GM
589 (let ((desktop-last-buffer nil))
590 ;; `load-with-code-conversion' calls `eval-buffer' which
591 ;; contains a `save-excursion', so we end up with the same
592 ;; buffer before and after the load. This is a problem
593 ;; when the desktop is read initially when Emacs starts up
594 ;; because, if we still are in *scratch* after running
595 ;; `after-init-hook', the splash screen will be displayed.
253406b9
RS
596 (load (expand-file-name desktop-basefilename desktop-dirname)
597 t t t)
1d500ca6
GM
598 (when desktop-last-buffer
599 (switch-to-buffer desktop-last-buffer))
253406b9
RS
600 (run-hooks 'desktop-delay-hook)
601 (setq desktop-delay-hook nil)
602 (message "Desktop loaded."))
603 (desktop-clear)))))
0b9bd504 604;; ----------------------------------------------------------------------------
478653c9 605;;;###autoload
6343ed61 606(defun desktop-load-default ()
577ed2b2
RS
607 "Load the `default' start-up library manually.
608Also inhibit further loading of it. Call this from your `.emacs' file
609to provide correct modes for autoloaded files."
0b9bd504 610 (if (not inhibit-default-init) ; safety check
6343ed61
RS
611 (progn
612 (load "default" t t)
613 (setq inhibit-default-init t))))
0b9bd504
RS
614;; ----------------------------------------------------------------------------
615;; Note: the following functions use the dynamic variable binding in Lisp.
0b9bd504 616;;
b6b70cda
JW
617(defun desktop-buffer-info-misc-data ()
618 (if (eq major-mode 'Info-mode)
619 (list Info-current-file
620 Info-current-node)))
621
622(defun desktop-buffer-dired-misc-data ()
623 (if (eq major-mode 'dired-mode)
624 (cons
625 (expand-file-name dired-directory)
626 (cdr
627 (nreverse
628 (mapcar
629 (function car)
630 dired-subdir-alist))))))
631
6343ed61 632(defun desktop-buffer-info () "Load an info file."
569c754e 633 (if (eq 'Info-mode desktop-buffer-major-mode)
6343ed61 634 (progn
b6b70cda
JW
635 (let ((first (nth 0 desktop-buffer-misc))
636 (second (nth 1 desktop-buffer-misc)))
637 (when (and first second)
638 (require 'info)
639 (Info-find-node first second)
640 (current-buffer))))))
0b9bd504 641;; ----------------------------------------------------------------------------
b6105c76 642(defun desktop-buffer-rmail () "Load an RMAIL file."
569c754e 643 (if (eq 'rmail-mode desktop-buffer-major-mode)
e36d00d4 644 (condition-case error
608b9ed2
RS
645 (progn (rmail-input desktop-buffer-file-name)
646 (if (eq major-mode 'rmail-mode)
647 (current-buffer)
648 rmail-buffer))
e2247420
RS
649 (file-locked
650 (kill-buffer (current-buffer))
651 'ignored))))
0b9bd504 652;; ----------------------------------------------------------------------------
ec4c6f22 653(defun desktop-buffer-mh () "Load a folder in the mh system."
569c754e 654 (if (eq 'mh-folder-mode desktop-buffer-major-mode)
ec4c6f22
RS
655 (progn
656 (require 'mh-e)
657 (mh-find-path)
608b9ed2
RS
658 (mh-visit-folder desktop-buffer-name)
659 (current-buffer))))
ec4c6f22 660;; ----------------------------------------------------------------------------
6343ed61 661(defun desktop-buffer-dired () "Load a directory using dired."
569c754e 662 (if (eq 'dired-mode desktop-buffer-major-mode)
2699e23e 663 (if (file-directory-p (file-name-directory (car desktop-buffer-misc)))
fa379636 664 (progn
608b9ed2 665 (dired (car desktop-buffer-misc))
581bba23 666 (mapcar 'dired-maybe-insert-subdir (cdr desktop-buffer-misc))
608b9ed2 667 (current-buffer))
2699e23e 668 (message "Directory %s no longer exists." (car desktop-buffer-misc))
fa379636
KH
669 (sit-for 1)
670 'ignored)))
0b9bd504 671;; ----------------------------------------------------------------------------
6343ed61 672(defun desktop-buffer-file () "Load a file."
569c754e
RS
673 (if desktop-buffer-file-name
674 (if (or (file-exists-p desktop-buffer-file-name)
6343ed61 675 (and desktop-missing-file-warning
0b9bd504
RS
676 (y-or-n-p (format
677 "File \"%s\" no longer exists. Re-create? "
569c754e 678 desktop-buffer-file-name))))
80f9f3db
SM
679 (let ((buf (find-file-noselect desktop-buffer-file-name)))
680 (condition-case nil
681 (switch-to-buffer buf)
0a8c8225
RS
682 (error (pop-to-buffer buf)))
683 buf)
6343ed61 684 'ignored)))
0b9bd504
RS
685;; ----------------------------------------------------------------------------
686;; Create a buffer, load its file, set is mode, ...; called from Desktop file
6343ed61 687;; only.
1d500ca6
GM
688
689(defvar desktop-last-buffer nil
690 "Last buffer read. Dynamically bound in `desktop-read'.")
691
569c754e
RS
692(defun desktop-create-buffer (ver desktop-buffer-file-name desktop-buffer-name
693 desktop-buffer-major-mode
47640244
GM
694 mim pt mk ro desktop-buffer-misc
695 &optional locals)
6343ed61
RS
696 (let ((hlist desktop-buffer-handlers)
697 (result)
698 (handler))
699 (while (and (not result) hlist)
700 (setq handler (car hlist))
701 (setq result (funcall handler))
702 (setq hlist (cdr hlist)))
608b9ed2 703 (when (bufferp result)
1d500ca6 704 (setq desktop-last-buffer result)
608b9ed2
RS
705 (set-buffer result)
706 (if (not (equal (buffer-name) desktop-buffer-name))
707 (rename-buffer desktop-buffer-name))
47640244
GM
708 ;; minor modes
709 (cond ((equal '(t) mim) (auto-fill-mode 1)) ; backwards compatible
710 ((equal '(nil) mim) (auto-fill-mode 0))
711 (t (mapcar #'(lambda (minor-mode)
2916afbd
SM
712 (when (functionp minor-mode)
713 (funcall minor-mode 1)))
714 mim)))
7c3d2af2 715 (goto-char pt)
608b9ed2
RS
716 (if (consp mk)
717 (progn
718 (set-mark (car mk))
719 (setq mark-active (car (cdr mk))))
720 (set-mark mk))
721 ;; Never override file system if the file really is read-only marked.
722 (if ro (setq buffer-read-only ro))
723 (while locals
724 (let ((this (car locals)))
725 (if (consp this)
726 ;; an entry of this form `(symbol . value)'
0b9bd504 727 (progn
608b9ed2
RS
728 (make-local-variable (car this))
729 (set (car this) (cdr this)))
730 ;; an entry of the form `symbol'
731 (make-local-variable this)
732 (makunbound this)))
733 (setq locals (cdr locals))))))
ec4c6f22
RS
734
735;; Backward compatibility -- update parameters to 205 standards.
569c754e
RS
736(defun desktop-buffer (desktop-buffer-file-name desktop-buffer-name
737 desktop-buffer-major-mode
2699e23e 738 mim pt mk ro tl fc cfs cr desktop-buffer-misc)
569c754e 739 (desktop-create-buffer 205 desktop-buffer-file-name desktop-buffer-name
2699e23e
RS
740 desktop-buffer-major-mode (cdr mim) pt mk ro
741 desktop-buffer-misc
ec4c6f22
RS
742 (list (cons 'truncate-lines tl)
743 (cons 'fill-column fc)
744 (cons 'case-fold-search cfs)
745 (cons 'case-replace cr)
746 (cons 'overwrite-mode (car mim)))))
0b9bd504 747;; ----------------------------------------------------------------------------
813dbb2d
RS
748
749;; If the user set desktop-enable to t with Custom,
750;; do the rest of what it takes to use desktop,
751;; but do it after finishing loading the init file.
752(add-hook 'after-init-hook
753 '(lambda ()
754 (when desktop-enable
755 (desktop-load-default)
756 (desktop-read))))
757
ab1d55ea 758(provide 'desktop)
6343ed61 759
80f9f3db 760;;; desktop.el ends here