--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/lisp/packages/desktop.el	Mon Aug 13 08:45:50 2007 +0200
@@ -0,0 +1,566 @@
+;;; desktop.el --- save partial status of Emacs when killed
+
+;; Copyright (C) 1993, 1994, 1995 Free Software Foundation, Inc.
+
+;; Author: Morten Welinder <terra@diku.dk>
+;; Version: 2.09?  RMS has an obnoxious tendency to remove version
+;; numbers from packages, and he did in this case.
+;; Keywords: customization
+;; Favourite-brand-of-beer: None, I hate beer.
+
+;; This file is part of XEmacs.
+
+;; XEmacs is free software; you can redistribute it and/or modify it
+;; under the terms of the GNU General Public License as published by
+;; the Free Software Foundation; either version 2, or (at your option)
+;; any later version.
+
+;; XEmacs is distributed in the hope that it will be useful, but
+;; WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+;; General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with XEmacs; see the file COPYING.  If not, write to the Free
+;; Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+
+;;; Synched up with: FSF 19.30.
+
+;;; Commentary:
+
+;; Save the Desktop, i.e.,
+;;	- some global variables
+;; 	- the list of buffers with associated files.  For each buffer also
+;;		- the major mode
+;;		- the default directory
+;;		- the point
+;;		- the mark & mark-active
+;;		- buffer-read-only
+;;		- some local variables
+
+;; To use this, first put these three lines in the bottom of your .emacs
+;; file (the later the better):
+;;
+;;	(load "desktop")
+;;	(desktop-load-default)
+;;	(desktop-read)
+;;
+;; Between the second and the third line you may wish to add something that
+;; updates the variables `desktop-globals-to-save' and/or
+;; `desktop-locals-to-save'.  If for instance you want to save the local
+;; variable `foobar' for every buffer in which it is local, you could add
+;; the line
+;;
+;;	(setq desktop-locals-to-save (cons 'foobar desktop-locals-to-save))
+;;
+;; To avoid saving excessive amounts of data you may also wish to add
+;; something like the following
+;;
+;;	(add-hook 'kill-emacs-hook
+;;		  '(lambda ()
+;;		     (desktop-truncate search-ring 3)
+;;		     (desktop-truncate regexp-search-ring 3)))
+;;
+;; which will make sure that no more than three search items are saved.  You
+;; must place this line *after* the (load "desktop") line.  See also the
+;; variable desktop-save-hook.
+
+;; Start Emacs in the root directory of your "project". The desktop saver
+;; is inactive by default.  You activate it by M-x desktop-save RET.  When
+;; you exit the next time the above data will be saved.  This ensures that
+;; all the files you were editing will be reloaded the next time you start
+;; Emacs from the same directory and that points will be set where you
+;; left them.  If you save a desktop file in your home directory it will
+;; act as a default desktop when you start Emacs from a directory that
+;; doesn't have its own.  I never do this, but you may want to.
+
+;; By the way: don't use desktop.el to customize Emacs -- the file .emacs
+;; in your home directory is used for that.  Saving global default values
+;; for buffers is an example of misuse.
+
+;; PLEASE NOTE: The kill ring can be saved as specified by the variable
+;; `desktop-globals-to-save' (by default it isn't).  This may result in saving
+;; things you did not mean to keep.  Use M-x desktop-clear RET.
+
+;; Thanks to  hetrick@phys.uva.nl (Jim Hetrick)      for useful ideas.
+;;            avk@rtsg.mot.com (Andrew V. Klein)     for a dired tip.
+;;            chris@tecc.co.uk (Chris Boucher)       for a mark tip.
+;;            f89-kam@nada.kth.se (Klas Mellbourn)   for a mh-e tip.
+;;            kifer@sbkifer.cs.sunysb.edu (M. Kifer) for a bug hunt.
+;;            treese@lcs.mit.edu (Win Treese)        for ange-ftp tips.
+;; ---------------------------------------------------------------------------
+;; TODO:
+;;
+;; Save window configuration.
+;; Recognize more minor modes.
+;; Save mark rings.
+;; Start-up with buffer-menu???
+
+;;; Code:
+
+;; Make the compilation more silent
+(eval-when-compile
+  ;; We use functions from these modules
+  ;; We can't (require 'mh-e) since that wants to load something.
+  (mapcar 'require '(info dired reporter)))
+;; ----------------------------------------------------------------------------
+;; USER OPTIONS -- settings you might want to play with.
+;; ----------------------------------------------------------------------------
+(defconst desktop-basefilename
+  (if (or (eq system-type 'ms-dos) (eq system-type 'windows-nt))
+      "emacs.dsk" ; Ms-Dos does not support multiple dots in file name
+    ".emacs.desktop")
+  "File for Emacs desktop, not including the directory name.")
+
+(defvar desktop-missing-file-warning t
+  "*If non-nil then desktop warns when a file no longer exists.
+Otherwise it simply ignores that file.")
+
+(defvar desktop-globals-to-save
+  (list 'desktop-missing-file-warning
+	;; Feature: saving kill-ring implies saving kill-ring-yank-pointer
+	;; 'kill-ring
+	'tags-file-name
+	'tags-table-list
+	'search-ring
+	'regexp-search-ring
+	'register-alist
+	;; 'desktop-globals-to-save	; Itself!
+	)
+  "List of global variables to save when killing Emacs.
+An element may be variable name (a symbol)
+or a cons cell of the form  (VAR . MAX-SIZE),
+which means to truncate VAR's value to at most MAX-SIZE elements
+\(if the value is a list) before saving the value.")
+
+(defvar desktop-locals-to-save
+  (list 'desktop-locals-to-save		; Itself!  Think it over.
+        'truncate-lines
+	'case-fold-search
+	'case-replace
+	'fill-column
+	'overwrite-mode
+	'change-log-default-name
+	'line-number-mode
+	)
+  "List of local variables to save for each buffer.
+The variables are saved only when they really are local.")
+(make-variable-buffer-local 'desktop-locals-to-save)
+
+;; We skip .log files because they are normally temporary.
+;;         (ftp) files because they require passwords and whatsnot.
+;;         TAGS files to save time (tags-file-name is saved instead).
+(defvar desktop-buffers-not-to-save
+ "\\(^nn\\.a[0-9]+\\|\\.log\\|(ftp)\\|^tags\\|^TAGS\\)$"
+ "Regexp identifying buffers that are to be excluded from saving.")
+
+;; Skip ange-ftp files
+(defvar desktop-files-not-to-save
+  "^/[^/:]*:"
+  "Regexp identifying files whose buffers are to be excluded from saving.")
+
+(defvar desktop-buffer-handlers
+  '(desktop-buffer-dired
+    desktop-buffer-rmail
+    desktop-buffer-mh
+    desktop-buffer-info
+    desktop-buffer-file)
+  "*List of functions to call in order to create a buffer.
+The functions are called without explicit parameters but may access
+the the major mode as `mam', the file name as `fn', the buffer name as
+`bn', the default directory as `dd'.  If some function returns non-nil
+no further functions are called.  If the function returns t then the
+buffer is considered created.")
+
+(defvar desktop-create-buffer-form "(desktop-create-buffer 205"
+  "Opening of form for creation of new buffers.")
+
+(defvar desktop-save-hook nil
+  "Hook run before saving the desktop to allow you to cut history lists and
+the like shorter.")
+;; ----------------------------------------------------------------------------
+(defvar desktop-dirname nil
+  "The directory in which the current desktop file resides.")
+
+(defconst desktop-header
+";; --------------------------------------------------------------------------
+;; Desktop File for Emacs
+;; --------------------------------------------------------------------------
+" "*Header to place in Desktop file.")
+
+(defvar desktop-delay-hook nil
+  "Hooks run after all buffers are loaded; intended for internal use.")
+;; ----------------------------------------------------------------------------
+(defun desktop-truncate (l n)
+  "Truncate LIST to at most N elements destructively."
+  (let ((here (nthcdr (1- n) l)))
+    (if (consp here)
+	(setcdr here nil))))
+;; ----------------------------------------------------------------------------
+(defun desktop-clear () "Empty the Desktop."
+  (interactive)
+  (setq kill-ring nil
+	kill-ring-yank-pointer nil
+	search-ring nil
+	search-ring-yank-pointer nil
+	regexp-search-ring nil
+	regexp-search-ring-yank-pointer nil)
+  (mapcar (function (lambda (x)
+		      ;; XEmacs change
+		      (if (not (equal (buffer-name x) "*Warnings*"))
+			  (kill-buffer x)))) (buffer-list))
+  (delete-other-windows))
+;; ----------------------------------------------------------------------------
+(add-hook 'kill-emacs-hook 'desktop-kill)
+
+(defun desktop-kill ()
+  (if desktop-dirname
+      (condition-case err
+	  (desktop-save desktop-dirname)
+	(file-error
+	 (if (yes-or-no-p "Error while saving the desktop.  Quit anyway? ")
+	     nil
+	   (signal (car err) (cdr err)))))))
+;; ----------------------------------------------------------------------------
+(defun desktop-internal-v2s (val)
+  "Convert VALUE to a pair (QUOTE . TXT); (eval (read TXT)) gives VALUE.
+TXT is a string that when read and evaluated yields value.
+QUOTE may be `may' (value may be quoted),
+`must' (values must be quoted), or nil (value may not be quoted)."
+  (cond
+   ((or (numberp val) (null val) (eq t val))
+    (cons 'may (prin1-to-string val)))
+   ((stringp val)
+    (let ((copy (copy-sequence val)))
+      (set-text-properties 0 (length copy) nil copy)
+      ;; Get rid of text properties because we cannot read them
+      (cons 'may (prin1-to-string copy))))
+   ((symbolp val)
+    (cons 'must (prin1-to-string val)))
+   ((vectorp val)
+    (let* ((special nil)
+	   (pass1 (mapcar
+		   (lambda (el)
+		     (let ((res (desktop-internal-v2s el)))
+		       (if (null (car res))
+			   (setq special t))
+		       res))
+		   val)))
+      (if special
+	  (cons nil (concat "(vector "
+			    (mapconcat (lambda (el)
+					 (if (eq (car el) 'must)
+					     (concat "'" (cdr el))
+					   (cdr el)))
+				       pass1
+				       " ")
+			    ")"))
+	(cons 'may (concat "[" (mapconcat 'cdr pass1 " ") "]")))))
+   ((consp val)
+    (let ((p val)
+	  newlist
+	  anynil)
+      (while (consp p)
+	(let ((q.txt (desktop-internal-v2s (car p))))
+	  (or anynil (setq anynil (null (car q.txt))))
+	  (setq newlist (cons q.txt newlist)))
+	(setq p (cdr p)))
+      (if p
+	  (let ((last (desktop-internal-v2s p))
+		(el (car newlist)))
+	    (setcar newlist
+		    (if (or anynil (setq anynil (null (car last))))
+			(cons nil
+			      (concat "(cons "
+				      (if (eq (car el) 'must) "'" "")
+				      (cdr el)
+				      " "
+				      (if (eq (car last) 'must) "'" "")
+				      (cdr last)
+				      ")"))
+		      (cons 'must
+			    (concat (cdr el) " . " (cdr last)))))))
+      (setq newlist (nreverse newlist))
+      (if anynil
+	  (cons nil
+		(concat "(list "
+			(mapconcat (lambda (el)
+				     (if (eq (car el) 'must)
+					 (concat "'" (cdr el))
+				       (cdr el)))
+				   newlist
+				   " ")
+			")"))
+	(cons 'must
+	      (concat "(" (mapconcat 'cdr newlist " ") ")")))))
+   ((subrp val)
+    (cons nil (concat "(symbol-function '"
+		      (substring (prin1-to-string val) 7 -1)
+		      ")")))
+   ((markerp val)
+    (let ((pos (prin1-to-string (marker-position val)))
+	  (buf (prin1-to-string (buffer-name (marker-buffer val)))))
+      (cons nil (concat "(let ((mk (make-marker)))"
+			" (add-hook 'desktop-delay-hook"
+			" (list 'lambda '() (list 'set-marker mk "
+			pos " (get-buffer " buf ")))) mk)"))))
+   (t					; save as text
+    (cons 'may "\"Unprintable entity\""))))
+
+(defun desktop-value-to-string (val)
+  "Convert VALUE to a string that when read evaluates to the same value.
+Not all types of values are supported."
+  (let* ((print-escape-newlines t)
+	 (float-output-format nil)
+	 (quote.txt (desktop-internal-v2s val))
+	 (quote (car quote.txt))
+	 (txt (cdr quote.txt)))
+    (if (eq quote 'must)
+	(concat "'" txt)
+      txt)))
+;; ----------------------------------------------------------------------------
+(defun desktop-outvar (varspec)
+  "Output a setq statement for variable VAR to the desktop file.
+The argument VARSPEC may be the variable name VAR (a symbol),
+or a cons cell of the form  (VAR . MAX-SIZE),
+which means to truncate VAR's value to at most MAX-SIZE elements
+\(if the value is a list) before saving the value."
+  (let (var size)
+    (if (consp varspec)
+	(setq var (car varspec) size (cdr varspec))
+      (setq var varspec))
+    (if (boundp var)
+	(progn
+	  (if (and (integerp size)
+		   (> size 0)
+		   (listp (eval var)))
+	      (desktop-truncate (eval var) size)) 
+	  (insert "(setq "
+		  (symbol-name var)
+		  " "
+		  (desktop-value-to-string (symbol-value var))
+		  ")\n")))))
+;; ----------------------------------------------------------------------------
+(defun desktop-save-buffer-p (filename bufname mode &rest dummy)
+  "Return t if the desktop should record a particular buffer for next startup.
+FILENAME is the visited file name, BUFNAME is the buffer name, and
+MODE is the major mode."
+  (let ((case-fold-search nil))
+    (or (and filename
+	     (not (string-match desktop-buffers-not-to-save bufname))
+	     (not (string-match desktop-files-not-to-save filename)))
+	(and (eq mode 'dired-mode)
+	     (save-excursion
+	       (set-buffer (get-buffer bufname))
+	       (not (string-match desktop-files-not-to-save
+				  default-directory))))
+	(and (null filename)
+	     (memq mode '(Info-mode rmail-mode))))))
+;; ----------------------------------------------------------------------------
+(defun desktop-save (dirname)
+  "Save the Desktop file.  Parameter DIRNAME specifies where to save desktop."
+  (interactive "DDirectory to save desktop file in: ")
+  (run-hooks 'desktop-save-hook)
+  (save-excursion
+    (let ((filename (expand-file-name
+		     (concat dirname desktop-basefilename)))
+	  (info (nreverse
+		 (mapcar
+		  (function (lambda (b)
+			      (set-buffer b)
+			      (list
+			       (buffer-file-name)
+			       (buffer-name)
+			       major-mode
+			       (list	; list explaining minor modes
+				(not (null auto-fill-function)))
+			       (point)
+			       (list (mark t) ;; mark-active
+				     (not (null (mark)))) ; XEmacs
+			       buffer-read-only
+			       (cond ((eq major-mode 'Info-mode)
+				      (list Info-current-file
+					    Info-current-node))
+				     ((eq major-mode 'dired-mode)
+				      (cons
+				       (expand-file-name dired-directory)
+				       (cdr
+					(nreverse
+					 (mapcar
+					  (function car)
+					  dired-subdir-alist))))))
+			       (let ((locals desktop-locals-to-save)
+				     (loclist (buffer-local-variables))
+				     (ll))
+				 (while locals
+				   (let ((here (assq (car locals) loclist)))
+				     (if here
+					 (setq ll (cons here ll))
+				       (if (member (car locals) loclist)
+					   (setq ll (cons (car locals) ll)))))
+				   (setq locals (cdr locals)))
+				 ll)
+			       )))
+		  (buffer-list))))
+	  (buf (get-buffer-create "*desktop*")))
+      (set-buffer buf)
+      (erase-buffer)
+
+      (insert desktop-header
+	      ";; Created " (current-time-string) "\n"
+	      ";; Emacs version " emacs-version "\n\n"
+	      ";; Global section:\n")
+      (mapcar (function desktop-outvar) desktop-globals-to-save)
+      (if (memq 'kill-ring desktop-globals-to-save)
+	  (insert "(setq kill-ring-yank-pointer (nthcdr "
+		  (int-to-string
+		   (- (length kill-ring) (length kill-ring-yank-pointer)))
+		  " kill-ring))\n"))
+
+      (insert "\n;; Buffer section:\n")
+      (mapcar
+       (function (lambda (l)
+		   (if (apply 'desktop-save-buffer-p l)
+		       (progn
+			 (insert desktop-create-buffer-form)
+			 (mapcar
+			  (function (lambda (e)
+				      (insert "\n  "
+					      (desktop-value-to-string e))))
+			  l)
+			 (insert ")\n\n")))))
+       info)
+      (setq default-directory dirname)
+      (if (file-exists-p filename) (delete-file filename))
+      (write-region (point-min) (point-max) filename nil 'nomessage)))
+  (setq desktop-dirname dirname))
+;; ----------------------------------------------------------------------------
+(defun desktop-remove ()
+  "Delete the Desktop file and inactivate the desktop system."
+  (interactive)
+  (if desktop-dirname
+      (let ((filename (concat desktop-dirname desktop-basefilename)))
+	(setq desktop-dirname nil)
+	(if (file-exists-p filename)
+	    (delete-file filename)))))
+;; ----------------------------------------------------------------------------
+(defun desktop-read ()
+  "Read the Desktop file and the files it specifies."
+  (interactive)
+  (let ((filename))
+    (if (file-exists-p (concat "./" desktop-basefilename))
+	(setq desktop-dirname (expand-file-name "./"))
+      (if (file-exists-p (concat "~/" desktop-basefilename))
+	  (setq desktop-dirname (expand-file-name "~/"))
+	(setq desktop-dirname nil)))
+    (if desktop-dirname
+	(progn
+	  (load (concat desktop-dirname desktop-basefilename) t t t)
+	  (run-hooks 'desktop-delay-hook)
+	  (message "Desktop loaded."))
+      (desktop-clear))))
+;; ----------------------------------------------------------------------------
+(defun desktop-load-default ()
+  "Load the `default' start-up library manually.
+Also inhibit further loading of it.  Call this from your `.emacs' file
+to provide correct modes for autoloaded files."
+  (if (not inhibit-default-init)	; safety check
+      (progn
+	(load "default" t t)
+	(setq inhibit-default-init t))))
+;; ----------------------------------------------------------------------------
+;; Note: the following functions use the dynamic variable binding in Lisp.
+;;
+(defun desktop-buffer-info () "Load an info file."
+  (if (eq 'Info-mode mam)
+      (progn
+	(require 'info)
+	(Info-find-node (nth 0 misc) (nth 1 misc))
+	t)))
+;; ----------------------------------------------------------------------------
+(defun desktop-buffer-rmail () "Load an RMAIL file."
+  (if (eq 'rmail-mode mam)
+      (condition-case error
+	  (progn (rmail-input fn) t)
+	(file-locked
+	 (kill-buffer (current-buffer))
+	 'ignored))))
+;; ----------------------------------------------------------------------------
+(defun desktop-buffer-mh () "Load a folder in the mh system."
+  (if (eq 'mh-folder-mode mam)
+      (progn
+	(require 'mh-e)
+	(mh-find-path)
+	(mh-visit-folder bn)
+	t)))
+;; ----------------------------------------------------------------------------
+(defun desktop-buffer-dired () "Load a directory using dired."
+  (if (eq 'dired-mode mam)
+      (if (file-directory-p (file-name-directory (car misc)))
+	  (progn
+	    (dired (car misc))
+	    (mapcar 'dired-insert-subdir (cdr misc))
+	    t)
+	(message "Directory %s no longer exists." (car misc))
+	(sit-for 1)
+	'ignored)))
+;; ----------------------------------------------------------------------------
+(defun desktop-buffer-file () "Load a file."
+  (if fn
+      (if (or (file-exists-p fn)
+	      (and desktop-missing-file-warning
+		   (y-or-n-p (format
+			      "File \"%s\" no longer exists. Re-create? "
+			      fn))))
+	  (progn (find-file fn) t)
+	'ignored)))
+;; ----------------------------------------------------------------------------
+;; Create a buffer, load its file, set is mode, ...;  called from Desktop file
+;; only.
+(defun desktop-create-buffer (ver fn bn mam mim pt mk ro misc &optional locals)
+  (let ((hlist desktop-buffer-handlers)
+	(result)
+	(handler))
+    (while (and (not result) hlist)
+      (setq handler (car hlist))
+      (setq result (funcall handler))
+      (setq hlist (cdr hlist)))
+    (if (eq result t)
+	(progn
+	  (if (not (equal (buffer-name) bn))
+	      (rename-buffer bn))
+	  (auto-fill-mode (if (nth 0 mim) 1 0))
+	  (goto-char pt)
+	  (if (consp mk)
+	      (progn
+		(set-mark (car mk))
+;;		(setq mark-active (car (cdr mk))))
+                (if (car (cdr mk)) (zmacs-activate-region))) ; XEmacs
+	    (set-mark mk))
+	  ;; Never override file system if the file really is read-only marked.
+	  (if ro (setq buffer-read-only ro))
+	  (while locals
+	    (let ((this (car locals)))
+	      (if (consp this)
+		  ;; an entry of this form `(symbol . value)'
+		  (progn
+		    (make-local-variable (car this))
+		    (set (car this) (cdr this)))
+		;; an entry of the form `symbol'
+		(make-local-variable this)
+		(makunbound this)))
+	    (setq locals (cdr locals)))
+	  ))))
+
+;; Backward compatibility -- update parameters to 205 standards.
+(defun desktop-buffer (fn bn mam mim pt mk ro tl fc cfs cr misc)
+  (desktop-create-buffer 205 fn bn mam (cdr mim) pt mk ro misc
+			 (list (cons 'truncate-lines tl)
+			       (cons 'fill-column fc)
+			       (cons 'case-fold-search cfs)
+			       (cons 'case-replace cr)
+			       (cons 'overwrite-mode (car mim)))))
+;; ----------------------------------------------------------------------------
+(provide 'desktop)
+
+;; desktop.el ends here.