Mercurial > emacs
annotate lisp/loadhist.el @ 85551:aaefd62ba61d
*** empty log message ***
author | Stefan Monnier <monnier@iro.umontreal.ca> |
---|---|
date | Mon, 22 Oct 2007 15:22:14 +0000 |
parents | cb2dd077ba75 |
children | b210bba3f477 4b09bb044f38 |
rev | line source |
---|---|
2543 | 1 ;;; loadhist.el --- lisp functions for working with feature groups |
14169 | 2 |
74442 | 3 ;; Copyright (C) 1995, 1998, 2000, 2001, 2002, 2003, 2004, |
75347 | 4 ;; 2005, 2006, 2007 Free Software Foundation, Inc. |
2543 | 5 |
6 ;; Author: Eric S. Raymond <esr@snark.thyrsus.com> | |
29090
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
7 ;; Maintainer: FSF |
2543 | 8 ;; Keywords: internal |
9 | |
11289 | 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 | |
78236
9355f9b7bbff
Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents:
76969
diff
changeset
|
14 ;; the Free Software Foundation; either version 3, or (at your option) |
11289 | 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 | |
14169 | 23 ;; along with GNU Emacs; see the file COPYING. If not, write to the |
64091 | 24 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
25 ;; Boston, MA 02110-1301, USA. | |
11289 | 26 |
2543 | 27 ;;; Commentary: |
28 | |
29 ;; These functions exploit the load-history system variable. | |
22459
bc88a299d2fc
(read-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
16173
diff
changeset
|
30 ;; Entry points include `unload-feature', `symbol-file', and |
bc88a299d2fc
(read-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
16173
diff
changeset
|
31 ;; `feature-file', documented in the Emacs Lisp manual. |
2543 | 32 |
33 ;;; Code: | |
34 | |
69935
3fc0524ae318
(unload-feature): A bit of sanity check of
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
69165
diff
changeset
|
35 (eval-when-compile (require 'cl)) |
3fc0524ae318
(unload-feature): A bit of sanity check of
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
69165
diff
changeset
|
36 |
2543 | 37 (defun feature-symbols (feature) |
47017
0ba62d75345e
(unload-feature): Distinguish functions from variables in load-history.
Richard M. Stallman <rms@gnu.org>
parents:
33094
diff
changeset
|
38 "Return the file and list of definitions associated with FEATURE. |
0ba62d75345e
(unload-feature): Distinguish functions from variables in load-history.
Richard M. Stallman <rms@gnu.org>
parents:
33094
diff
changeset
|
39 The value is actually the element of `load-history' |
0ba62d75345e
(unload-feature): Distinguish functions from variables in load-history.
Richard M. Stallman <rms@gnu.org>
parents:
33094
diff
changeset
|
40 for the file that did (provide FEATURE)." |
85370
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
41 (catch 'foundit |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
42 (let ((element (cons 'provide feature))) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
43 (dolist (x load-history nil) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
44 (when (member element (cdr x)) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
45 (throw 'foundit x)))))) |
2543 | 46 |
47 (defun feature-file (feature) | |
48 "Return the file name from which a given FEATURE was loaded. | |
49 Actually, return the load argument, if any; this is sometimes the name of a | |
29090
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
50 Lisp file without an extension. If the feature came from an `eval-buffer' on |
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
51 a buffer with no associated file, or an `eval-region', return nil." |
2543 | 52 (if (not (featurep feature)) |
29090
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
53 (error "%S is not a currently loaded feature" feature) |
2543 | 54 (car (feature-symbols feature)))) |
55 | |
59318
55722dde9e0a
(file-loadhist-lookup): New function.
Richard M. Stallman <rms@gnu.org>
parents:
54000
diff
changeset
|
56 (defun file-loadhist-lookup (file) |
66285
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
57 "Return the `load-history' element for FILE. |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
58 FILE can be a file name, or a library name. |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
59 A library name is equivalent to the file name that `load-library' would load." |
59318
55722dde9e0a
(file-loadhist-lookup): New function.
Richard M. Stallman <rms@gnu.org>
parents:
54000
diff
changeset
|
60 ;; First look for FILE as given. |
55722dde9e0a
(file-loadhist-lookup): New function.
Richard M. Stallman <rms@gnu.org>
parents:
54000
diff
changeset
|
61 (let ((symbols (assoc file load-history))) |
55722dde9e0a
(file-loadhist-lookup): New function.
Richard M. Stallman <rms@gnu.org>
parents:
54000
diff
changeset
|
62 ;; Try converting a library name to an absolute file name. |
55722dde9e0a
(file-loadhist-lookup): New function.
Richard M. Stallman <rms@gnu.org>
parents:
54000
diff
changeset
|
63 (and (null symbols) |
69165
cba71dc12c14
(file-loadhist-lookup): Use `get-load-suffixes' instead of `load-suffixes'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
68651
diff
changeset
|
64 (let ((absname |
cba71dc12c14
(file-loadhist-lookup): Use `get-load-suffixes' instead of `load-suffixes'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
68651
diff
changeset
|
65 (locate-file file load-path (get-load-suffixes)))) |
66285
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
66 (and absname (not (equal absname file)) |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
67 (setq symbols (cdr (assoc absname load-history)))))) |
59318
55722dde9e0a
(file-loadhist-lookup): New function.
Richard M. Stallman <rms@gnu.org>
parents:
54000
diff
changeset
|
68 symbols)) |
55722dde9e0a
(file-loadhist-lookup): New function.
Richard M. Stallman <rms@gnu.org>
parents:
54000
diff
changeset
|
69 |
2543 | 70 (defun file-provides (file) |
66285
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
71 "Return the list of features provided by FILE as it was loaded. |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
72 FILE can be a file name, or a library name. |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
73 A library name is equivalent to the file name that `load-library' would load." |
85370
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
74 (let (provides) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
75 (dolist (x (file-loadhist-lookup file) provides) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
76 (when (eq (car-safe x) 'provide) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
77 (push x provides))))) |
2543 | 78 |
79 (defun file-requires (file) | |
66285
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
80 "Return the list of features required by FILE as it was loaded. |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
81 FILE can be a file name, or a library name. |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
82 A library name is equivalent to the file name that `load-library' would load." |
85370
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
83 (let (requires) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
84 (dolist (x (file-loadhist-lookup file) requires) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
85 (when (eq (car-safe x) 'require) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
86 (push x requires))))) |
2543 | 87 |
29090
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
88 (defsubst file-set-intersect (p q) |
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
89 "Return the set intersection of two lists." |
85370
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
90 (let (ret) |
29090
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
91 (dolist (x p ret) |
85370
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
92 (when (memq x q) (push x ret))))) |
2543 | 93 |
94 (defun file-dependents (file) | |
10498
8fb25f247533
(unload-feature): Don't care if FILE is a dependency of itself.
Richard M. Stallman <rms@gnu.org>
parents:
8108
diff
changeset
|
95 "Return the list of loaded libraries that depend on FILE. |
66285
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
96 This can include FILE itself. |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
97 FILE can be a file name, or a library name. |
dc2f1300400b
(file-loadhist-lookup): Call locate-library
Richard M. Stallman <rms@gnu.org>
parents:
64762
diff
changeset
|
98 A library name is equivalent to the file name that `load-library' would load." |
29090
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
99 (let ((provides (file-provides file)) |
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
100 (dependents nil)) |
86d462e378ce
(feature-symbols, file-provides, file-requires): Use mapc.
Dave Love <fx@gnu.org>
parents:
23852
diff
changeset
|
101 (dolist (x load-history dependents) |
85370
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
102 (when (file-set-intersect provides (file-requires (car x))) |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
103 (push (car x) dependents))))) |
2543 | 104 |
76968
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
105 (defun read-feature (prompt &optional loaded-p) |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
106 "Read feature name from the minibuffer, prompting with string PROMPT. |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
107 If optional second arg LOADED-P is non-nil, the feature must be loaded |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
108 from a file." |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
109 (intern |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
110 (completing-read prompt |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
111 (cons nil features) |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
112 (and loaded-p |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
113 #'(lambda (f) |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
114 (and f ; ignore nil |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
115 (feature-file f)))) |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
116 loaded-p))) |
16173
9ba176963a26
(read-feature): New function.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
117 |
52755
6c7cae7ce71a
(unload-feature-special-hooks):
Richard M. Stallman <rms@gnu.org>
parents:
52401
diff
changeset
|
118 (defvaralias 'loadhist-hook-functions 'unload-feature-special-hooks) |
6c7cae7ce71a
(unload-feature-special-hooks):
Richard M. Stallman <rms@gnu.org>
parents:
52401
diff
changeset
|
119 (defvar unload-feature-special-hooks |
85370
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
120 '(after-change-functions after-insert-file-functions |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
121 after-make-frame-functions auto-fill-function before-change-functions |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
122 blink-paren-function buffer-access-fontify-functions command-line-functions |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
123 comment-indent-function compilation-finish-functions |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
124 disabled-command-function find-file-not-found-functions |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
125 font-lock-beginning-of-syntax-function font-lock-fontify-buffer-function |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
126 font-lock-fontify-region-function font-lock-mark-block-function |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
127 font-lock-syntactic-face-function font-lock-unfontify-buffer-function |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
128 font-lock-unfontify-region-function kill-buffer-query-functions |
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
129 kill-emacs-query-functions lisp-indent-function mouse-position-function |
47017
0ba62d75345e
(unload-feature): Distinguish functions from variables in load-history.
Richard M. Stallman <rms@gnu.org>
parents:
33094
diff
changeset
|
130 redisplay-end-trigger-functions temp-buffer-show-function |
0ba62d75345e
(unload-feature): Distinguish functions from variables in load-history.
Richard M. Stallman <rms@gnu.org>
parents:
33094
diff
changeset
|
131 window-scroll-functions window-size-change-functions |
85370
2ad51c213e7d
(feature-symbols, file-provides, file-requires, file-set-intersect,
Juanma Barranquero <lekktu@gmail.com>
parents:
79030
diff
changeset
|
132 write-contents-functions write-file-functions |
47017
0ba62d75345e
(unload-feature): Distinguish functions from variables in load-history.
Richard M. Stallman <rms@gnu.org>
parents:
33094
diff
changeset
|
133 write-region-annotate-functions) |
33094
51c874361c84
(unload-feature): Call elp-restore-function,
Dave Love <fx@gnu.org>
parents:
31674
diff
changeset
|
134 "A list of special hooks from Info node `(elisp)Standard Hooks'. |
22459
bc88a299d2fc
(read-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
16173
diff
changeset
|
135 |
bc88a299d2fc
(read-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
16173
diff
changeset
|
136 These are symbols with hook-type values whose names don't end in |
bc88a299d2fc
(read-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
16173
diff
changeset
|
137 `-hook' or `-hooks', from which `unload-feature' tries to remove |
bc88a299d2fc
(read-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
16173
diff
changeset
|
138 pertinent symbols.") |
bc88a299d2fc
(read-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
16173
diff
changeset
|
139 |
85437
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
140 (defvar unload-function-features-list nil |
54000
8d106818ca97
(unload-hook-features-list): New defvar.
Eli Zaretskii <eliz@is.elta.co.il>
parents:
53998
diff
changeset
|
141 "List of features of the package being unloaded. |
8d106818ca97
(unload-hook-features-list): New defvar.
Eli Zaretskii <eliz@is.elta.co.il>
parents:
53998
diff
changeset
|
142 |
85437
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
143 This is meant to be used by FEATURE-unload-function, see the |
54000
8d106818ca97
(unload-hook-features-list): New defvar.
Eli Zaretskii <eliz@is.elta.co.il>
parents:
53998
diff
changeset
|
144 documentation of `unload-feature' for details.") |
85437
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
145 (define-obsolete-variable-alias 'unload-hook-features-list |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
146 'unload-function-features-list "22.2") |
54000
8d106818ca97
(unload-hook-features-list): New defvar.
Eli Zaretskii <eliz@is.elta.co.il>
parents:
53998
diff
changeset
|
147 |
2543 | 148 ;;;###autoload |
149 (defun unload-feature (feature &optional force) | |
150 "Unload the library that provided FEATURE, restoring all its autoloads. | |
29241
a243b2d9c015
(unload-feature): Fix interactive spec [from
Dave Love <fx@gnu.org>
parents:
29090
diff
changeset
|
151 If the feature is required by any other loaded code, and prefix arg FORCE |
53998
2e361a295c26
(unload-feature): Doc fix. Rename flist to unload-hook-features-list.
Eli Zaretskii <eliz@is.elta.co.il>
parents:
53599
diff
changeset
|
152 is nil, raise an error. |
2e361a295c26
(unload-feature): Doc fix. Rename flist to unload-hook-features-list.
Eli Zaretskii <eliz@is.elta.co.il>
parents:
53599
diff
changeset
|
153 |
79030
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
154 This function tries to undo any modifications that the package has |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
155 made to hook values in Emacs. Normally it does this using heuristics. |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
156 The packages may define a hook `FEATURE-unload-hook'; if that exists, |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
157 it is called instead of the normal heuristics. |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
158 |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
159 Such a hook should undo all the relevant global state changes that may |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
160 have been made by loading the package or executing functions in it. |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
161 It has access to the package's feature list (before anything is unbound) |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
162 in the variable `unload-hook-features-list' and could remove features |
e8d941fbbe78
(unload-feature): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
163 from it in the event that the package has done something strange, |
53998
2e361a295c26
(unload-feature): Doc fix. Rename flist to unload-hook-features-list.
Eli Zaretskii <eliz@is.elta.co.il>
parents:
53599
diff
changeset
|
164 such as redefining an Emacs function." |
76968
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
165 (interactive |
a188649f301c
(read-feature): Reimplement. New optional arg LOADED-P.
Kim F. Storm <storm@cua.dk>
parents:
75797
diff
changeset
|
166 (list |
76969
8237a66e9288
(unload-feature): Add line break.
Kim F. Storm <storm@cua.dk>
parents:
76968
diff
changeset
|
167 (read-feature "Unload feature: " t) |
8237a66e9288
(unload-feature): Add line break.
Kim F. Storm <storm@cua.dk>
parents:
76968
diff
changeset
|
168 current-prefix-arg)) |
61664
79b58e05730b
(unload-feature): Update for new format of load-history. Simplify the code.
Lute Kamstra <lute@gnu.org>
parents:
61599
diff
changeset
|
169 (unless (featurep feature) |
79b58e05730b
(unload-feature): Update for new format of load-history. Simplify the code.
Lute Kamstra <lute@gnu.org>
parents:
61599
diff
changeset
|
170 (error "%s is not a currently loaded feature" (symbol-name feature))) |
79b58e05730b
(unload-feature): Update for new format of load-history. Simplify the code.
Lute Kamstra <lute@gnu.org>
parents:
61599
diff
changeset
|
171 (unless force |
79b58e05730b
(unload-feature): Update for new format of load-history. Simplify the code.
Lute Kamstra <lute@gnu.org>
parents:
61599
diff
changeset
|
172 (let* ((file (feature-file feature)) |
79b58e05730b
(unload-feature): Update for new format of load-history. Simplify the code.
Lute Kamstra <lute@gnu.org>
parents:
61599
diff
changeset
|
173 (dependents (delete file (copy-sequence (file-dependents file))))) |
79b58e05730b
(unload-feature): Update for new format of load-history. Simplify the code.
Lute Kamstra <lute@gnu.org>
parents:
61599
diff
changeset
|
174 (when dependents |
79b58e05730b
(unload-feature): Update for new format of load-history. Simplify the code.
Lute Kamstra <lute@gnu.org>
parents:
61599
diff
changeset
|
175 (error "Loaded libraries %s depend on %s" |
79b58e05730b
(unload-feature): Update for new format of load-history. Simplify the code.
Lute Kamstra <lute@gnu.org>
parents:
61599
diff
changeset
|
176 (prin1-to-string dependents) file)))) |
85437
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
177 (let* ((unload-function-features-list (feature-symbols feature)) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
178 (file (pop unload-function-features-list)) |
75797
1c398694f7b2
(unload-feature): Handle (t . SYMBOL) entries in load history.
Richard M. Stallman <rms@gnu.org>
parents:
75687
diff
changeset
|
179 ;; If non-nil, this is a symbol for which we should |
1c398694f7b2
(unload-feature): Handle (t . SYMBOL) entries in load history.
Richard M. Stallman <rms@gnu.org>
parents:
75687
diff
changeset
|
180 ;; restore a previous autoload if possible. |
1c398694f7b2
(unload-feature): Handle (t . SYMBOL) entries in load history.
Richard M. Stallman <rms@gnu.org>
parents:
75687
diff
changeset
|
181 restore-autoload |
85437
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
182 (name (symbol-name feature)) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
183 (unload-hook (intern-soft (concat name "-unload-hook"))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
184 (unload-func (intern-soft (concat name "-unload-function")))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
185 ;; If FEATURE-unload-function is defined and returns non-nil, |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
186 ;; don't try to do anything more; otherwise proceed normally. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
187 (unless (and (bound-and-true-p unload-func) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
188 (funcall unload-func)) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
189 ;; Try to avoid losing badly when hooks installed in critical |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
190 ;; places go away. (Some packages install things on |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
191 ;; `kill-buffer-hook', `activate-menubar-hook' and the like.) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
192 (if unload-hook |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
193 ;; First off, provide a clean way for package FOO to arrange |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
194 ;; this by adding hooks on the variable `FOO-unload-hook'. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
195 ;; This is obsolete; FEATURE-unload-function should be used now. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
196 (run-hooks unload-hook) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
197 ;; Otherwise, do our best. Look through the obarray for symbols |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
198 ;; which seem to be hook variables or special hook functions and |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
199 ;; remove anything from them which matches the feature-symbols |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
200 ;; about to get zapped. Obviously this won't get anonymous |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
201 ;; functions which the package might just have installed, and |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
202 ;; there might be other important state, but this tactic |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
203 ;; normally works. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
204 (mapatoms |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
205 (lambda (x) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
206 (when (and (boundp x) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
207 (or (and (consp (symbol-value x)) ; Random hooks. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
208 (string-match "-hooks?\\'" (symbol-name x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
209 (memq x unload-feature-special-hooks))) ; Known abnormal hooks etc. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
210 (dolist (y unload-function-features-list) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
211 (when (and (eq (car-safe y) 'defun) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
212 (not (get (cdr y) 'autoload))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
213 (remove-hook x (cdr y))))))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
214 ;; Remove any feature-symbols from auto-mode-alist as well. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
215 (dolist (y unload-function-features-list) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
216 (when (and (eq (car-safe y) 'defun) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
217 (not (get (cdr y) 'autoload))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
218 (setq auto-mode-alist |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
219 (rassq-delete-all (cdr y) auto-mode-alist))))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
220 (when (fboundp 'elp-restore-function) ; remove ELP stuff first |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
221 (dolist (elt unload-function-features-list) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
222 (when (symbolp elt) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
223 (elp-restore-function elt)))) |
75797
1c398694f7b2
(unload-feature): Handle (t . SYMBOL) entries in load history.
Richard M. Stallman <rms@gnu.org>
parents:
75687
diff
changeset
|
224 |
85437
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
225 (dolist (x unload-function-features-list) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
226 (if (consp x) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
227 (case (car x) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
228 ;; Remove any feature names that this file provided. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
229 (provide |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
230 (setq features (delq (cdr x) features))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
231 ((defun autoload) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
232 (let ((fun (cdr x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
233 (when (fboundp fun) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
234 (when (fboundp 'ad-unadvise) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
235 (ad-unadvise fun)) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
236 (let ((aload (get fun 'autoload))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
237 (if (and aload (eq fun restore-autoload)) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
238 (fset fun (cons 'autoload aload)) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
239 (fmakunbound fun)))))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
240 ;; (t . SYMBOL) comes before (defun . SYMBOL) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
241 ;; and says we should restore SYMBOL's autoload |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
242 ;; when we undefine it. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
243 ((t) (setq restore-autoload (cdr x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
244 ((require defface) nil) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
245 (t (message "Unexpected element %s in load-history" x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
246 ;; Kill local values as much as possible. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
247 (dolist (buf (buffer-list)) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
248 (with-current-buffer buf |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
249 (if (and (boundp x) (timerp (symbol-value x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
250 (cancel-timer (symbol-value x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
251 (kill-local-variable x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
252 (if (and (boundp x) (timerp (symbol-value x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
253 (cancel-timer (symbol-value x))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
254 ;; Get rid of the default binding if we can. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
255 (unless (local-variable-if-set-p x) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
256 (makunbound x)))) |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
257 ;; Delete the load-history element for this file. |
cb2dd077ba75
(unload-function-features-list): Rename from `unload-hook-features-list'.
Juanma Barranquero <lekktu@gmail.com>
parents:
85370
diff
changeset
|
258 (setq load-history (delq (assoc file load-history) load-history)))) |
75687
8cf73d911b65
(unload-feature): Silently ignore `load-history' entries of the form `(defface
Juanma Barranquero <lekktu@gmail.com>
parents:
75347
diff
changeset
|
259 ;; Don't return load-history, it is not useful. |
8cf73d911b65
(unload-feature): Silently ignore `load-history' entries of the form `(defface
Juanma Barranquero <lekktu@gmail.com>
parents:
75347
diff
changeset
|
260 nil) |
2543 | 261 |
262 (provide 'loadhist) | |
263 | |
69935
3fc0524ae318
(unload-feature): A bit of sanity check of
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
69165
diff
changeset
|
264 ;; arch-tag: 70bb846a-c413-4f01-bf88-78dba4ac0798 |
2543 | 265 ;;; loadhist.el ends here |