1993-04-16 23:43:57 +00:00
|
|
|
;;; loadhist.el --- lisp functions for working with feature groups
|
1996-01-14 07:34:30 +00:00
|
|
|
|
2000-05-22 19:35:34 +00:00
|
|
|
;; Copyright (C) 1995, 1998, 2000 Free Software Foundation, Inc.
|
1993-04-16 23:43:57 +00:00
|
|
|
|
|
|
|
;; Author: Eric S. Raymond <esr@snark.thyrsus.com>
|
2000-05-22 19:35:34 +00:00
|
|
|
;; Maintainer: FSF
|
1993-04-16 23:43:57 +00:00
|
|
|
;; Keywords: internal
|
|
|
|
|
1995-04-08 02:24:20 +00:00
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
|
|
|
|
;; GNU Emacs 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.
|
|
|
|
|
|
|
|
;; GNU Emacs 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
|
1996-01-14 07:34:30 +00:00
|
|
|
;; along with GNU Emacs; see the file COPYING. If not, write to the
|
|
|
|
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
;; Boston, MA 02111-1307, USA.
|
1995-04-08 02:24:20 +00:00
|
|
|
|
1993-04-16 23:43:57 +00:00
|
|
|
;;; Commentary:
|
|
|
|
|
|
|
|
;; These functions exploit the load-history system variable.
|
1998-06-13 01:38:33 +00:00
|
|
|
;; Entry points include `unload-feature', `symbol-file', and
|
|
|
|
;; `feature-file', documented in the Emacs Lisp manual.
|
1993-04-16 23:43:57 +00:00
|
|
|
|
|
|
|
;;; Code:
|
|
|
|
|
|
|
|
(defun feature-symbols (feature)
|
2002-08-24 03:00:29 +00:00
|
|
|
"Return the file and list of definitions associated with FEATURE.
|
|
|
|
The value is actually the element of `load-history'
|
|
|
|
for the file that did (provide FEATURE)."
|
1993-04-16 23:43:57 +00:00
|
|
|
(catch 'foundit
|
2000-05-22 19:35:34 +00:00
|
|
|
(mapc (lambda (x)
|
|
|
|
(if (member (cons 'provide feature) (cdr x))
|
|
|
|
(throw 'foundit x)))
|
|
|
|
load-history)
|
1993-04-16 23:43:57 +00:00
|
|
|
nil))
|
|
|
|
|
|
|
|
(defun feature-file (feature)
|
|
|
|
"Return the file name from which a given FEATURE was loaded.
|
|
|
|
Actually, return the load argument, if any; this is sometimes the name of a
|
2000-05-22 19:35:34 +00:00
|
|
|
Lisp file without an extension. If the feature came from an `eval-buffer' on
|
|
|
|
a buffer with no associated file, or an `eval-region', return nil."
|
1993-04-16 23:43:57 +00:00
|
|
|
(if (not (featurep feature))
|
2000-05-22 19:35:34 +00:00
|
|
|
(error "%S is not a currently loaded feature" feature)
|
1993-04-16 23:43:57 +00:00
|
|
|
(car (feature-symbols feature))))
|
|
|
|
|
2005-01-02 23:43:51 +00:00
|
|
|
(defun file-loadhist-lookup (file)
|
|
|
|
"Return the `load-history' element for FILE."
|
|
|
|
;; First look for FILE as given.
|
|
|
|
(let ((symbols (assoc file load-history)))
|
|
|
|
;; Try converting a library name to an absolute file name.
|
|
|
|
(and (null symbols)
|
|
|
|
(let ((absname (find-library-name file)))
|
|
|
|
(if (not (equal absname file))
|
|
|
|
(setq symbols (cdr (assoc absname load-history))))))
|
|
|
|
;; Try converting an absolute file name to a library name.
|
|
|
|
(and (null symbols) (string-match "[.]el\\'" file)
|
|
|
|
(let ((libname (file-name-nondirectory file)))
|
|
|
|
(string-match "[.]el\\'" libname)
|
|
|
|
(setq libname (substring libname 0 (match-beginning 0)))
|
|
|
|
(setq symbols (cdr (assoc libname load-history)))))
|
|
|
|
symbols))
|
|
|
|
|
1993-04-16 23:43:57 +00:00
|
|
|
(defun file-provides (file)
|
|
|
|
"Return the list of features provided by FILE."
|
2005-01-02 23:43:51 +00:00
|
|
|
(let ((symbols (file-loadhist-lookup file))
|
2000-05-22 19:35:34 +00:00
|
|
|
provides)
|
|
|
|
(mapc (lambda (x)
|
|
|
|
(if (and (consp x) (eq (car x) 'provide))
|
|
|
|
(setq provides (cons (cdr x) provides))))
|
|
|
|
symbols)
|
|
|
|
provides))
|
1993-04-16 23:43:57 +00:00
|
|
|
|
|
|
|
(defun file-requires (file)
|
|
|
|
"Return the list of features required by FILE."
|
2005-01-02 23:43:51 +00:00
|
|
|
(let ((symbols (file-loadhist-lookup file))
|
2000-05-22 19:35:34 +00:00
|
|
|
requires)
|
|
|
|
(mapc (lambda (x)
|
|
|
|
(if (and (consp x) (eq (car x) 'require))
|
|
|
|
(setq requires (cons (cdr x) requires))))
|
|
|
|
symbols)
|
|
|
|
requires))
|
|
|
|
|
|
|
|
(defsubst file-set-intersect (p q)
|
|
|
|
"Return the set intersection of two lists."
|
1993-04-16 23:43:57 +00:00
|
|
|
(let ((ret nil))
|
2000-05-22 19:35:34 +00:00
|
|
|
(dolist (x p ret)
|
|
|
|
(if (memq x q) (setq ret (cons x ret))))
|
|
|
|
ret))
|
1993-04-16 23:43:57 +00:00
|
|
|
|
|
|
|
(defun file-dependents (file)
|
1995-01-20 23:13:51 +00:00
|
|
|
"Return the list of loaded libraries that depend on FILE.
|
|
|
|
This can include FILE itself."
|
2000-05-22 19:35:34 +00:00
|
|
|
(let ((provides (file-provides file))
|
|
|
|
(dependents nil))
|
|
|
|
(dolist (x load-history dependents)
|
|
|
|
(if (file-set-intersect provides (file-requires (car x)))
|
|
|
|
(setq dependents (cons (car x) dependents))))
|
|
|
|
dependents))
|
1993-04-16 23:43:57 +00:00
|
|
|
|
1996-09-12 18:31:16 +00:00
|
|
|
(defun read-feature (prompt)
|
1998-06-13 01:38:33 +00:00
|
|
|
"Read a feature name \(string\) from the minibuffer.
|
|
|
|
Prompt with PROMPT and completing from `features', and
|
1996-09-12 18:31:16 +00:00
|
|
|
return the feature \(symbol\)."
|
|
|
|
(intern (completing-read prompt
|
2000-05-22 19:35:34 +00:00
|
|
|
(mapcar (lambda (feature)
|
|
|
|
(list (symbol-name feature)))
|
1996-09-12 18:31:16 +00:00
|
|
|
features)
|
|
|
|
nil t)))
|
|
|
|
|
2003-10-05 13:50:18 +00:00
|
|
|
(defvaralias 'loadhist-hook-functions 'unload-feature-special-hooks)
|
|
|
|
(defvar unload-feature-special-hooks
|
2000-05-31 23:02:45 +00:00
|
|
|
'(after-change-functions
|
2002-08-24 03:00:29 +00:00
|
|
|
after-insert-file-functions auto-fill-function
|
|
|
|
before-change-functions blink-paren-function
|
|
|
|
buffer-access-fontify-functions command-line-functions
|
|
|
|
comment-indent-function kill-buffer-query-functions
|
|
|
|
kill-emacs-query-functions lisp-indent-function
|
|
|
|
mouse-position-function
|
|
|
|
redisplay-end-trigger-functions temp-buffer-show-function
|
|
|
|
window-scroll-functions window-size-change-functions
|
|
|
|
write-region-annotate-functions)
|
2000-10-31 12:02:51 +00:00
|
|
|
"A list of special hooks from Info node `(elisp)Standard Hooks'.
|
1998-06-13 01:38:33 +00:00
|
|
|
|
|
|
|
These are symbols with hook-type values whose names don't end in
|
|
|
|
`-hook' or `-hooks', from which `unload-feature' tries to remove
|
|
|
|
pertinent symbols.")
|
|
|
|
|
2004-02-16 17:50:32 +00:00
|
|
|
(defvar unload-hook-features-list nil
|
|
|
|
"List of features of the package being unloaded.
|
|
|
|
|
|
|
|
This is meant to be used by FEATURE-unload-hook hooks, see the
|
|
|
|
documentation of `unload-feature' for details.")
|
|
|
|
|
1993-04-16 23:43:57 +00:00
|
|
|
;;;###autoload
|
|
|
|
(defun unload-feature (feature &optional force)
|
|
|
|
"Unload the library that provided FEATURE, restoring all its autoloads.
|
2000-05-26 11:06:05 +00:00
|
|
|
If the feature is required by any other loaded code, and prefix arg FORCE
|
2004-02-16 17:39:38 +00:00
|
|
|
is nil, raise an error.
|
|
|
|
|
|
|
|
This function tries to undo modifications made by the package to
|
|
|
|
hooks. Packages may define a hook FEATURE-unload-hook that is called
|
|
|
|
instead of the normal heuristics for doing this. Such a hook should
|
|
|
|
undo all the relevant global state changes that may have been made by
|
|
|
|
loading the package or executing functions in it. It has access to
|
|
|
|
the package's feature list (before anything is unbound) in the
|
|
|
|
variable `unload-hook-features-list' and could remove features from it
|
|
|
|
in the event that the package has done something normally-ill-advised,
|
|
|
|
such as redefining an Emacs function."
|
2000-05-26 11:06:05 +00:00
|
|
|
(interactive (list (read-feature "Feature: ") current-prefix-arg))
|
1993-04-16 23:43:57 +00:00
|
|
|
(if (not (featurep feature))
|
1995-08-02 18:34:19 +00:00
|
|
|
(error "%s is not a currently loaded feature" (symbol-name feature)))
|
1993-04-16 23:43:57 +00:00
|
|
|
(if (not force)
|
1995-01-20 23:13:51 +00:00
|
|
|
(let* ((file (feature-file feature))
|
|
|
|
(dependents (delete file (copy-sequence (file-dependents file)))))
|
1993-04-16 23:43:57 +00:00
|
|
|
(if dependents
|
1995-08-02 18:34:19 +00:00
|
|
|
(error "Loaded libraries %s depend on %s"
|
1998-06-13 01:38:33 +00:00
|
|
|
(prin1-to-string dependents) file))))
|
2004-02-16 17:39:38 +00:00
|
|
|
(let* ((unload-hook-features-list (feature-symbols feature))
|
|
|
|
(file (car unload-hook-features-list))
|
1998-06-13 01:38:33 +00:00
|
|
|
(unload-hook (intern-soft (concat (symbol-name feature)
|
|
|
|
"-unload-hook"))))
|
|
|
|
;; Try to avoid losing badly when hooks installed in critical
|
|
|
|
;; places go away. (Some packages install things on
|
|
|
|
;; `kill-buffer-hook', `activate-menubar-hook' and the like.)
|
2004-01-16 18:26:32 +00:00
|
|
|
;; First off, provide a clean way for package FOO to arrange
|
|
|
|
;; this by adding hooks on the variable `FOO-unload-hook'.
|
1998-06-13 01:38:33 +00:00
|
|
|
(if unload-hook
|
|
|
|
(run-hooks unload-hook)
|
|
|
|
;; Otherwise, do our best. Look through the obarray for symbols
|
|
|
|
;; which seem to be hook variables or special hook functions and
|
|
|
|
;; remove anything from them which matches the feature-symbols
|
|
|
|
;; about to get zapped. Obviously this won't get anonymous
|
|
|
|
;; functions which the package might just have installed, and
|
|
|
|
;; there might be other important state, but this tactic
|
|
|
|
;; normally works.
|
|
|
|
(mapatoms
|
|
|
|
(lambda (x)
|
|
|
|
(if (or (and (boundp x) ; Random hooks.
|
|
|
|
(consp (symbol-value x))
|
|
|
|
(string-match "-hooks?\\'" (symbol-name x)))
|
2000-08-16 20:51:48 +00:00
|
|
|
(and (boundp x) ; Known abnormal hooks etc.
|
2003-10-05 13:50:18 +00:00
|
|
|
(memq x unload-feature-special-hooks)))
|
2004-02-16 17:39:38 +00:00
|
|
|
(dolist (y (cdr unload-hook-features-list))
|
2000-05-22 19:35:34 +00:00
|
|
|
(remove-hook x y))))))
|
2000-10-31 12:02:51 +00:00
|
|
|
(if (fboundp 'elp-restore-function) ; remove ELP stuff first
|
2004-02-16 17:39:38 +00:00
|
|
|
(dolist (elt (cdr unload-hook-features-list))
|
2000-10-31 12:02:51 +00:00
|
|
|
(if (symbolp elt)
|
|
|
|
(elp-restore-function elt))))
|
2000-05-22 19:35:34 +00:00
|
|
|
(mapc
|
|
|
|
(lambda (x)
|
1998-06-13 01:38:33 +00:00
|
|
|
(cond ((stringp x) nil)
|
|
|
|
((consp x)
|
|
|
|
;; Remove any feature names that this file provided.
|
|
|
|
(if (eq (car x) 'provide)
|
2002-08-24 03:00:29 +00:00
|
|
|
(setq features (delq (cdr x) features)))
|
2002-09-29 03:34:12 +00:00
|
|
|
(when (eq (car x) 'defvar)
|
|
|
|
;; Kill local values as much as possible.
|
|
|
|
(dolist (buf (buffer-list))
|
|
|
|
(with-current-buffer buf
|
|
|
|
(kill-local-variable (cdr x))))
|
|
|
|
;; Get rid of the default binding if we can.
|
|
|
|
(unless (local-variable-if-set-p (cdr x))
|
|
|
|
(makunbound (cdr x)))))
|
2000-05-31 23:02:45 +00:00
|
|
|
(t
|
|
|
|
(when (fboundp x)
|
2000-09-17 19:29:19 +00:00
|
|
|
(if (fboundp 'ad-unadvise)
|
|
|
|
(ad-unadvise x))
|
2000-05-31 23:02:45 +00:00
|
|
|
(fmakunbound x)
|
|
|
|
(let ((aload (get x 'autoload)))
|
|
|
|
(if aload (fset x (cons 'autoload aload))))))))
|
2004-02-16 17:39:38 +00:00
|
|
|
(cdr unload-hook-features-list))
|
1995-08-02 18:34:19 +00:00
|
|
|
;; Delete the load-history element for this file.
|
|
|
|
(let ((elt (assoc file load-history)))
|
|
|
|
(setq load-history (delq elt load-history)))))
|
1993-04-16 23:43:57 +00:00
|
|
|
|
|
|
|
(provide 'loadhist)
|
|
|
|
|
2003-09-01 15:45:59 +00:00
|
|
|
;;; arch-tag: 70bb846a-c413-4f01-bf88-78dba4ac0798
|
1993-04-16 23:43:57 +00:00
|
|
|
;;; loadhist.el ends here
|