|
502
|
1 ;;; behavior.el --- consistent interface onto behaviors
|
|
|
2
|
|
|
3 ;; Copyright (C) 2000, 2001 Ben Wing.
|
|
|
4
|
|
|
5 ;; Author: Ben Wing
|
|
|
6 ;; Maintainer: XEmacs Development Team
|
|
|
7 ;; Keywords: internal, dumped
|
|
|
8
|
|
|
9 ;; This file is part of XEmacs.
|
|
|
10
|
|
|
11 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
12 ;; under the terms of the GNU General Public License as published by
|
|
|
13 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
14 ;; any later version.
|
|
|
15
|
|
|
16 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
17 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
19 ;; General Public License for more details.
|
|
|
20
|
|
|
21 ;; You should have received a copy of the GNU General Public License
|
|
|
22 ;; along with XEmacs; see the file COPYING. If not, write to the
|
|
|
23 ;; Free Software Foundation, 59 Temple Place - Suite 330,
|
|
|
24 ;; Boston, MA 02111-1307, USA.
|
|
|
25
|
|
|
26 ;;; Synched up with: Not in FSF.
|
|
|
27
|
|
|
28 ;;; Authorship:
|
|
|
29
|
|
|
30 ;; Created July 2000 by Ben Wing.
|
|
|
31
|
|
|
32 ;;; Commentary:
|
|
|
33
|
|
|
34 ;; This file will be dumped with XEmacs.
|
|
|
35
|
|
|
36 ;;; Code:
|
|
|
37
|
|
|
38 (defvar behavior-hash-table (make-hash-table))
|
|
|
39
|
|
|
40 (defvar behavior-history nil
|
|
|
41 "History of entered behaviors.")
|
|
|
42
|
|
|
43 (defun define-behavior (name doc-string &rest cl-keys)
|
|
|
44 "Define a behavior named NAME.
|
|
|
45 DOC-STRING must be specified, a description of what the behavior does
|
|
|
46 when it's enabled and how to further control it (typically through
|
|
|
47 custom variables). Accepted keywords are
|
|
|
48
|
|
|
49 :title A \"pretty\" version of the name, for use in menus. If omitted
|
|
|
50 a prettified name will be generated.
|
|
|
51 :require A single symbol or a list of such symbols, which need to be
|
|
|
52 present at enable time, or will be loaded using `require'.
|
|
|
53 :enable A function of no variables, which turns the behavior on.
|
|
|
54 :disable A function of no variables, which turns the behavior off.
|
|
|
55
|
|
|
56 Behaviors are assumed to be global, and to take effect immediately; if
|
|
|
57 the underlying package is per-buffer, it may have to scan all existing
|
|
|
58 buffers and frob them. When a behavior is disabled, it should completely
|
|
|
59 go away *everywhere*, as if it were never invoked at all.
|
|
|
60
|
|
|
61 The :disable keywords can be missing, although this is considered bad
|
|
|
62 practice. In such a case, attempting to disable the behavior will signal
|
|
|
63 an error unless you use the `force' option."
|
|
|
64 (cl-parsing-keywords
|
|
|
65 ((:title (capitalize-string-as-title (replace-in-string
|
|
|
66 (symbol-name name) "-" " ")))
|
|
|
67 :require
|
|
|
68 :enable
|
|
|
69 :disable)
|
|
|
70 ()
|
|
|
71 (let ((entry (list :title cl-title :require cl-require
|
|
|
72 :enable cl-enable :disable cl-disable)))
|
|
|
73 (puthash name entry behavior-hash-table))))
|
|
|
74
|
|
|
75 (defun read-behavior (prompt &optional must-match initial-contents history
|
|
|
76 default-value)
|
|
|
77 "Return a behavior symbol from the minibuffer, prompting with string PROMPT.
|
|
|
78 If non-nil, optional second arg INITIAL-CONTENTS is a string to insert
|
|
|
79 in the minibuffer before reading.
|
|
|
80 Third arg HISTORY, if non-nil, specifies a history list. (It defaults to
|
|
|
81 `behavior-history'.)
|
|
|
82 Fourth arg DEFAULT-VALUE is the default value. If non-nil, it is used
|
|
|
83 for history command, and as the value to return if the user enters the
|
|
|
84 empty string."
|
|
|
85 (let ((result
|
|
|
86 (completing-read
|
|
|
87 prompt
|
|
|
88 (let ((table (let (lis)
|
|
|
89 (maphash #'(lambda (key val)
|
|
|
90 (push (cons key val) lis))
|
|
|
91 behavior-hash-table)
|
|
|
92 (nreverse lis))))
|
|
|
93 (mapc #'(lambda (aentry)
|
|
|
94 (setcar aentry (symbol-name
|
|
|
95 (car aentry))))
|
|
|
96 table)
|
|
|
97 table)
|
|
|
98 nil must-match initial-contents
|
|
|
99 (or history 'behavior-history)
|
|
|
100 default-value)))
|
|
|
101 (if (and result (stringp result))
|
|
|
102 (intern result)
|
|
|
103 result)))
|
|
|
104
|
|
|
105 (defun behavior-enabled-p (name))
|
|
|
106
|
|
|
107 (defun enable-behavior (behavior &optional force)
|
|
|
108 "Enable the specified behavior."
|
|
|
109 (interactive (list (read-behavior "Enable Behavior: " t) current-prefix-arg))
|
|
|
110 (let ((plist (gethash behavior behavior-hash-table)))
|
|
|
111 (or plist (error 'invalid-argument "Not a behavior" behavior))
|
|
|
112 (let ((require (getf plist :require))
|
|
|
113 (enable (getf plist :enable)))
|
|
|
114 (cond ((listp require)
|
|
|
115 (mapc #'(lambda (sym) (require sym)) require))
|
|
|
116 ((symbolp require)
|
|
|
117 (require require))
|
|
|
118 ((null require))
|
|
|
119 (t (error 'invalid-argument "Invalid :require spec" require)))
|
|
|
120 (if enable (funcall enable)))))
|
|
|
121
|
|
|
122 (defun disable-behavior (behavior &optional force)
|
|
|
123 "Disable the specified behavior."
|
|
|
124 (interactive (list (read-behavior "Disable Behavior: " t)
|
|
|
125 current-prefix-arg))
|
|
|
126 (let ((plist (gethash behavior behavior-hash-table)))
|
|
|
127 (or plist (error 'invalid-argument "Not a behavior" behavior))
|
|
|
128 (let ((require (getf plist :require))
|
|
|
129 (disable (getf plist :disable)))
|
|
|
130 (cond ((listp require)
|
|
|
131 (mapc #'(lambda (sym) (require sym)) require))
|
|
|
132 ((symbolp require)
|
|
|
133 (require require))
|
|
|
134 ((null require))
|
|
|
135 (t (error 'invalid-argument "Invalid :require spec" require)))
|
|
|
136 (if disable (funcall disable)))))
|
|
|
137
|
|
|
138 (provide 'behavior)
|
|
|
139
|
|
|
140 ;;; finder-inf.el ends here
|
