Commit | Line | Data |
---|---|---|
6c56c80b | 1 | ;;; iswitchb.el --- switch between buffers using substrings |
962a4216 | 2 | |
ceba0dac | 3 | ;; Copyright (C) 1996, 1997, 2000, 2001 Free Software Foundation, Inc. |
962a4216 | 4 | |
183040ff SE |
5 | ;; Author: Stephen Eglen <stephen@anc.ed.ac.uk> |
6 | ;; Maintainer: Stephen Eglen <stephen@anc.ed.ac.uk> | |
19db4308 | 7 | ;; Keywords: completion convenience |
183040ff | 8 | ;; location: http://www.anc.ed.ac.uk/~stephen/emacs/ |
962a4216 | 9 | |
6c56c80b RS |
10 | ;; This file is part of GNU Emacs. |
11 | ||
12 | ;; GNU Emacs is free software; you can redistribute it and/or modify | |
962a4216 RS |
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 | ||
6c56c80b | 17 | ;; GNU Emacs is distributed in the hope that it will be useful, |
962a4216 RS |
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 | |
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. | |
26 | ||
c6e5b93f | 27 | ;;; Commentary: |
962a4216 | 28 | |
c6e5b93f | 29 | ;; Installation: |
19db4308 DL |
30 | ;; To get the functions in this package bound to keys, use |
31 | ;; M-x iswitchb-mode or customize the option `iswitchb-mode'. | |
962a4216 | 32 | |
962a4216 | 33 | ;; As you type in a substring, the list of buffers currently matching |
19db4308 | 34 | ;; the substring is displayed as you type. The list is ordered so |
962a4216 RS |
35 | ;; that the most recent buffers visited come at the start of the list. |
36 | ;; The buffer at the start of the list will be the one visited when | |
37 | ;; you press return. By typing more of the substring, the list is | |
38 | ;; narrowed down so that gradually the buffer you want will be at the | |
19db4308 | 39 | ;; top of the list. Alternatively, you can use C-s and C-r to rotate |
962a4216 RS |
40 | ;; buffer names in the list until the one you want is at the top of |
41 | ;; the list. Completion is also available so that you can see what is | |
42 | ;; common to all of the matching buffers as you type. | |
43 | ||
44 | ;; This code is similar to a couple of other packages. Michael R Cook | |
8097dd15 | 45 | ;; <cook@sightpath.com> wrote a similar buffer switching package, but |
962a4216 RS |
46 | ;; does exact matching rather than substring matching on buffer names. |
47 | ;; I also modified a couple of functions from icomplete.el to provide | |
48 | ;; the completion feedback in the minibuffer. | |
49 | ||
19db4308 | 50 | ;;; Example |
962a4216 RS |
51 | |
52 | ;;If I have two buffers called "123456" and "123", with "123456" the | |
53 | ;;most recent, when I use iswitchb, I first of all get presented with | |
36a3b01c | 54 | ;;the list of all the buffers |
962a4216 | 55 | ;; |
19db4308 | 56 | ;; iswitch {123456,123} |
962a4216 RS |
57 | ;; |
58 | ;; If I then press 2: | |
59 | ;; iswitch 2[3]{123456,123} | |
60 | ;; | |
61 | ;; The list in {} are the matching buffers, most recent first (buffers | |
62 | ;; visible in the current frame are put at the end of the list by | |
63 | ;; default). At any time I can select the item at the head of the | |
64 | ;; list by pressing RET. I can also bring the put the first element | |
65 | ;; at the end of the list by pressing C-s, or put the last element at | |
66 | ;; the head of the list by pressing C-r. The item in [] indicates | |
67 | ;; what can be added to my input by pressing TAB. In this case, I | |
19db4308 | 68 | ;; will get "3" added to my input. So, press TAB: |
962a4216 RS |
69 | ;; iswitch 23{123456,123} |
70 | ;; | |
71 | ;; At this point, I still have two matching buffers. | |
72 | ;; If I want the first buffer in the list, I simply press RET. If I | |
73 | ;; wanted the second in the list, I could press C-s to move it to the | |
74 | ;; top of the list and then RET to select it. | |
75 | ;; | |
76 | ;;However, If I type 4, I only have one match left: | |
77 | ;; iswitch 234[123456] [Matched] | |
78 | ;; | |
79 | ;;Since there is only one matching buffer left, it is given in [] and we | |
80 | ;;see the text [Matched] afterwards. I can now press TAB or RET to go | |
81 | ;;to that buffer. | |
82 | ;; | |
83 | ;; If however, I now type "a": | |
84 | ;; iswitch 234a [No match] | |
85 | ;; There are no matching buffers. If I press RET or TAB, I can be | |
86 | ;; prompted to create a new buffer called "234a". | |
87 | ;; | |
88 | ;; Of course, where this function comes in really useful is when you | |
89 | ;; can specify the buffer using only a few keystrokes. In the above | |
90 | ;; example, the quickest way to get to the "123456" buffer would be | |
ccd2f997 | 91 | ;; just to type 4 and then RET (assuming there isn't any newer buffer |
962a4216 RS |
92 | ;; with 4 in its name). |
93 | ||
94 | ;; To see a full list of all matching buffers in a separate buffer, | |
95 | ;; hit ? or press TAB when there are no further completions to the | |
ccd2f997 KH |
96 | ;; substring. Repeated TAB presses will scroll you through this |
97 | ;; separate buffer. | |
962a4216 | 98 | |
36a3b01c RS |
99 | ;; The buffer at the head of the list can be killed by pressing C-k. |
100 | ;; If the buffer needs saving, you will be queried before the buffer | |
101 | ;; is killed. | |
102 | ||
103 | ;; If you find that the file you are after is not in a buffer, you can | |
104 | ;; press C-x C-f to immediately drop into find-file. | |
105 | ||
962a4216 RS |
106 | ;; |
107 | ;; See the doc string of iswitchb for full keybindings and features. | |
108 | ;; (describe-function 'iswitchb) | |
109 | ||
8097dd15 GM |
110 | ;; Case matching: The case of strings when matching can be ignored or |
111 | ;; used depending on the value of iswitchb-case (default is the same | |
112 | ;; as case-fold-search, normally t). Imagine you have the following | |
19db4308 | 113 | ;; buffers: |
8097dd15 GM |
114 | ;; |
115 | ;; INBOX *info* *scratch* | |
116 | ;; | |
117 | ;; Then these will be the matching buffers, depending on how you type | |
118 | ;; the two letters `in' and the value of iswitchb-case: | |
119 | ;; | |
120 | ;; iswitchb-case user input | matching buffers | |
121 | ;; ---------------------------------------------- | |
19db4308 DL |
122 | ;; nil in | *info* |
123 | ;; t in | INBOX, *info* | |
124 | ;; t IN | INBOX | |
125 | ;; t In | [No match] | |
8097dd15 | 126 | |
962a4216 RS |
127 | ;;; Customisation |
128 | ||
129 | ;; See the User Variables section below for easy ways to change the | |
36a3b01c RS |
130 | ;; functionality of the program. These are accessible using the |
131 | ;; custom package. | |
962a4216 RS |
132 | ;; To modify the keybindings, use the hook provided. For example: |
133 | ;;(add-hook 'iswitchb-define-mode-map-hook | |
134 | ;; 'iswitchb-my-keys) | |
135 | ;; | |
136 | ;;(defun iswitchb-my-keys () | |
ccd2f997 | 137 | ;; "Add my keybindings for iswitchb." |
962a4216 RS |
138 | ;; (define-key iswitchb-mode-map " " 'iswitchb-next-match) |
139 | ;; ) | |
140 | ;; | |
6b0cc1b5 | 141 | ;; Seeing all the matching buffers |
36a3b01c | 142 | ;; |
962a4216 | 143 | ;; If you have many matching buffers, they may not all fit onto one |
f05b502e GM |
144 | ;; line of the minibuffer. In Emacs 21, the variable |
145 | ;; `resize-mini-windows' controls how many lines of the minibuffer can | |
146 | ;; be seen. For older versions of emacs, you can use | |
147 | ;; `resize-minibuffer-mode'. You can also limit iswitchb so that it | |
962a4216 RS |
148 | ;; only shows a certain number of lines -- see the documentation for |
149 | ;; `iswitchb-minibuffer-setup-hook'. | |
150 | ||
6b0cc1b5 | 151 | ;; Changing the list of buffers |
962a4216 RS |
152 | |
153 | ;; By default, the list of current buffers is most recent first, | |
154 | ;; oldest last, with the exception that the buffers visible in the | |
155 | ;; current frame are put at the end of the list. A hook exists to | |
156 | ;; allow other functions to order the list. For example, if you add: | |
157 | ;; | |
158 | ;; (add-hook 'iswitchb-make-buflist-hook 'iswitchb-summaries-to-end) | |
159 | ;; | |
160 | ;; then all buffers matching "Summary" are moved to the end of the | |
161 | ;; list. (I find this handy for keeping the INBOX Summary and so on | |
162 | ;; out of the way.) It also moves buffers matching "output\*$" to the | |
163 | ;; end of the list (these are created by AUC TeX when compiling.) | |
164 | ;; Other functions could be made available which alter the list of | |
165 | ;; matching buffers (either deleting or rearranging elements.) | |
166 | ||
167 | ;; Font-Lock | |
168 | ||
169 | ;; If you have font-lock loaded, the first matching buffer is | |
170 | ;; highlighted. To switch this off, set (setq iswitchb-use-fonts nil) | |
171 | ;; I don't use font-lock that much, so I've hardcoded the faces. If | |
172 | ;; this is too harsh, let me know. Colouring of the matching buffer | |
173 | ;; name was suggested by Carsten Dominik (dominik@strw.leidenuniv.nl) | |
174 | ||
6b0cc1b5 | 175 | ;; Replacement for read-buffer |
962a4216 | 176 | |
ccd2f997 KH |
177 | ;; iswitchb-read-buffer has been written to be a drop in replacement |
178 | ;; for the normal buffer selection routine `read-buffer'. To use | |
c6e5b93f | 179 | ;; iswitch for all buffer selections in Emacs, add: |
ccd2f997 | 180 | ;; (setq read-buffer-function 'iswitchb-read-buffer) |
c6e5b93f SE |
181 | ;; (This variable should be present in Emacs 20.3+) |
182 | ;; XEmacs users can get the same behaviour by doing: | |
19db4308 | 183 | ;; (defalias 'read-buffer 'iswitchb-read-buffer) |
c6e5b93f | 184 | ;; since `read-buffer' is defined in lisp. |
36a3b01c | 185 | |
6b0cc1b5 SE |
186 | ;; Regexp matching |
187 | ||
188 | ;; There is limited provision for regexp matching within iswitchb, | |
189 | ;; enabled through `iswitchb-regexp'. This allows you to type `c$' | |
190 | ;; for example and see all buffer names ending in `c'. This facility | |
191 | ;; is quite limited though in two respects. First, you can't | |
192 | ;; currently type in expressions like `[0-9]' directly -- you have to | |
193 | ;; type them in when iswitchb-regexp is nil and then toggle on the | |
194 | ;; regexp functionality. Likewise, don't enter an expression | |
195 | ;; containing `\' in regexp mode. If you try, iswitchb gets confused, | |
196 | ;; so just hit C-g and try again. Secondly, no completion mechanism | |
197 | ;; is currently offered when regexp searching. | |
198 | ||
ccd2f997 | 199 | ;;; TODO |
36a3b01c | 200 | |
962a4216 RS |
201 | ;;; Acknowledgements |
202 | ||
203 | ;; Thanks to Jari Aalto <jari.aalto@poboxes.com> for help with the | |
204 | ;; first version of this package, iswitch-buffer. Thanks also to many | |
205 | ;; others for testing earlier versions. | |
206 | ||
207 | ;;; Code: | |
208 | ||
c6e5b93f | 209 | ;; CL needed for cadr and last |
181688f2 SE |
210 | (if (not (and (fboundp 'cadr) |
211 | (fboundp 'last))) | |
212 | (require 'cl)) | |
c6e5b93f | 213 | |
36a3b01c RS |
214 | ;; Set up the custom library. |
215 | ;; taken from http://www.dina.kvl.dk/~abraham/custom/ | |
216 | (eval-and-compile | |
217 | (condition-case () | |
218 | (require 'custom) | |
219 | (error nil)) | |
220 | (if (and (featurep 'custom) (fboundp 'custom-declare-variable)) | |
221 | nil ;; We've got what we needed | |
222 | ;; We have the old custom-library, hack around it! | |
223 | (defmacro defgroup (&rest args) | |
224 | nil) | |
19db4308 | 225 | (defmacro defcustom (var value doc &rest args) |
b787fc05 | 226 | `(defvar ,var ,value ,doc)))) |
36a3b01c | 227 | |
962a4216 RS |
228 | ;;; User Variables |
229 | ;; | |
230 | ;; These are some things you might want to change. | |
231 | ||
36a3b01c | 232 | (defgroup iswitchb nil |
c6e5b93f | 233 | "Switch between buffers using substrings." |
f5f727f8 | 234 | :group 'convenience |
19db4308 | 235 | :group 'completion |
36a3b01c | 236 | :link '(emacs-commentary-link :tag "Commentary" "iswitchb.el") |
19db4308 | 237 | :link '(url-link "http://www.anc.ed.ac.uk/~stephen/emacs/") |
181688f2 | 238 | :link '(emacs-library-link :tag "Lisp File" "iswitchb.el")) |
36a3b01c | 239 | |
19db4308 DL |
240 | ;;;###autoload |
241 | (defcustom iswitchb-mode nil | |
242 | "Toggle Iswitchb mode. | |
243 | Setting this variable directly does not take effect; | |
244 | use either \\[customize] or the function `iswitchb-mode'." | |
245 | :set (lambda (symbol value) | |
246 | (iswitchb-mode (or value 0))) | |
247 | :initialize 'custom-initialize-default | |
248 | :group 'iswitchb | |
660e161f | 249 | :require 'iswitchb |
19db4308 DL |
250 | :version "21.1" |
251 | :type 'boolean) | |
252 | ||
253 | (defcustom iswitchb-mode-hook nil | |
254 | "Hook run at the end of function `iswitchb-mode'." | |
255 | :group 'iswitchb | |
256 | :type 'hook) | |
257 | ||
36a3b01c | 258 | (defcustom iswitchb-case case-fold-search |
8097dd15 GM |
259 | "*Non-nil if searching of buffer names should ignore case. |
260 | If this is non-nil but the user input has any upper case letters, matching | |
261 | is temporarily case sensitive." | |
36a3b01c RS |
262 | :type 'boolean |
263 | :group 'iswitchb) | |
962a4216 | 264 | |
36a3b01c | 265 | (defcustom iswitchb-buffer-ignore |
962a4216 | 266 | '("^ ") |
6c56c80b RS |
267 | "*List of regexps or functions matching buffer names to ignore. |
268 | For example, traditional behavior is not to list buffers whose names begin | |
269 | with a space, for which the regexp is `^ '. See the source file for | |
36a3b01c RS |
270 | example functions that filter buffernames." |
271 | :type '(repeat regexp) | |
272 | :group 'iswitchb) | |
273 | ||
962a4216 | 274 | ;;; Examples for setting the value of iswitchb-buffer-ignore |
6b0cc1b5 | 275 | ;(defun iswitchb-ignore-c-mode (name) |
962a4216 RS |
276 | ; "Ignore all c mode buffers -- example function for iswitchb." |
277 | ; (save-excursion | |
278 | ; (set-buffer name) | |
279 | ; (string-match "^C$" mode-name))) | |
280 | ||
6b0cc1b5 | 281 | ;(setq iswitchb-buffer-ignore '("^ " iswitchb-ignore-c-mode)) |
962a4216 RS |
282 | ;(setq iswitchb-buffer-ignore '("^ " "\\.c$" "\\.h$")) |
283 | ||
36a3b01c | 284 | (defcustom iswitchb-default-method 'always-frame |
6c56c80b | 285 | "*How to switch to new buffer when using `iswitchb-buffer'. |
962a4216 RS |
286 | Possible values: |
287 | `samewindow' Show new buffer in same window | |
288 | `otherwindow' Show new buffer in another window (same frame) | |
888472e0 | 289 | `display' Display buffer in another window without switching to it |
962a4216 RS |
290 | `otherframe' Show new buffer in another frame |
291 | `maybe-frame' If a buffer is visible in another frame, prompt to ask if you | |
292 | you want to see the buffer in the same window of the current | |
293 | frame or in the other frame. | |
c6e5b93f | 294 | `always-frame' If a buffer is visible in another frame, raise that |
36a3b01c | 295 | frame. Otherwise, visit the buffer in the same window." |
19db4308 | 296 | :type '(choice (const samewindow) |
c6e5b93f SE |
297 | (const otherwindow) |
298 | (const display) | |
19db4308 | 299 | (const otherframe) |
c6e5b93f SE |
300 | (const maybe-frame) |
301 | (const always-frame)) | |
36a3b01c | 302 | :group 'iswitchb) |
962a4216 | 303 | |
36a3b01c | 304 | (defcustom iswitchb-regexp nil |
6c56c80b | 305 | "*Non-nil means that `iswitchb' will do regexp matching. |
6b0cc1b5 | 306 | Value can be toggled within `iswitchb' using `iswitchb-toggle-regexp'." |
36a3b01c RS |
307 | :type 'boolean |
308 | :group 'iswitchb) | |
309 | ||
36a3b01c | 310 | (defcustom iswitchb-newbuffer t |
962a4216 | 311 | "*Non-nil means create new buffer if no buffer matches substring. |
36a3b01c RS |
312 | See also `iswitchb-prompt-newbuffer'." |
313 | :type 'boolean | |
314 | :group 'iswitchb) | |
962a4216 | 315 | |
36a3b01c | 316 | (defcustom iswitchb-prompt-newbuffer t |
962a4216 | 317 | "*Non-nil means prompt user to confirm before creating new buffer. |
36a3b01c RS |
318 | See also `iswitchb-newbuffer'." |
319 | :type 'boolean | |
320 | :group 'iswitchb) | |
321 | ||
36a3b01c | 322 | (defcustom iswitchb-define-mode-map-hook nil |
19db4308 | 323 | "Hook to define keys in `iswitchb-mode-map' for extra keybindings." |
36a3b01c RS |
324 | :type 'hook |
325 | :group 'iswitchb) | |
326 | ||
36a3b01c | 327 | (defcustom iswitchb-use-fonts t |
6b0cc1b5 | 328 | "*Non-nil means use font-lock fonts for showing first match." |
36a3b01c RS |
329 | :type 'boolean |
330 | :group 'iswitchb) | |
962a4216 | 331 | |
f5bd1691 GM |
332 | (defcustom iswitchb-use-frame-buffer-list nil |
333 | "*Non-nil means use the currently selected frame's buffer list." | |
334 | :type 'boolean | |
335 | :group 'iswitchb) | |
336 | ||
36a3b01c | 337 | (defcustom iswitchb-make-buflist-hook nil |
19db4308 | 338 | "Hook to run when list of matching buffers is created." |
36a3b01c RS |
339 | :type 'hook |
340 | :group 'iswitchb) | |
341 | ||
962a4216 RS |
342 | (defvar iswitchb-all-frames 'visible |
343 | "*Argument to pass to `walk-windows' when finding visible buffers. | |
344 | See documentation of `walk-windows' for useful values.") | |
345 | ||
6b0cc1b5 | 346 | (defcustom iswitchb-minibuffer-setup-hook nil |
19db4308 | 347 | "Iswitchb-specific customization of minibuffer setup. |
962a4216 | 348 | |
6c56c80b | 349 | This hook is run during minibuffer setup iff `iswitchb' will be active. |
962a4216 | 350 | It is intended for use in customizing iswitchb for interoperation |
19db4308 DL |
351 | with other packages." |
352 | ;;; For instance: | |
962a4216 | 353 | |
19db4308 DL |
354 | ;;; \(add-hook 'iswitchb-minibuffer-setup-hook |
355 | ;;; \(function | |
356 | ;;; \(lambda () | |
357 | ;;; \(make-local-variable 'resize-minibuffer-window-max-height) | |
358 | ;;; \(setq resize-minibuffer-window-max-height 3)))) | |
962a4216 | 359 | |
19db4308 DL |
360 | ;;; will constrain rsz-mini to a maximum minibuffer height of 3 lines when |
361 | ;;; iswitchb is running. Copied from `icomplete-minibuffer-setup-hook'." | |
6b0cc1b5 SE |
362 | :type 'hook |
363 | :group 'iswitchb) | |
364 | ||
365 | ;; Do we need the variable iswitchb-use-mycompletion? | |
366 | ||
6b0cc1b5 SE |
367 | ;;; Internal Variables |
368 | ||
369 | (defvar iswitchb-method nil | |
19db4308 | 370 | "Stores the method for viewing the selected buffer. |
6b0cc1b5 SE |
371 | Its value is one of `samewindow', `otherwindow', `display', `otherframe', |
372 | `maybe-frame' or `always-frame'. See `iswitchb-default-method' for | |
373 | details of values.") | |
962a4216 RS |
374 | |
375 | (defvar iswitchb-eoinput 1 | |
376 | "Point where minibuffer input ends and completion info begins. | |
6c56c80b | 377 | Copied from `icomplete-eoinput'.") |
962a4216 RS |
378 | (make-variable-buffer-local 'iswitchb-eoinput) |
379 | ||
962a4216 RS |
380 | (defvar iswitchb-buflist nil |
381 | "Stores the current list of buffers that will be searched through. | |
382 | The list is ordered, so that the most recent buffers come first, | |
383 | although by default, the buffers visible in the current frame are put | |
384 | at the end of the list. Created by `iswitchb-make-buflist'.") | |
385 | ||
386 | ;; todo -- is this necessary? | |
387 | ||
388 | (defvar iswitchb-use-mycompletion nil | |
19db4308 | 389 | "Non-nil means use `iswitchb-buffer' completion feedback. |
6c56c80b RS |
390 | Should only be set to t by iswitchb functions, so that it doesn't |
391 | interfere with other minibuffer usage.") | |
962a4216 | 392 | |
19db4308 | 393 | (defvar iswitchb-change-word-sub nil |
962a4216 RS |
394 | "Private variable used by `iswitchb-word-matching-substring'.") |
395 | ||
962a4216 RS |
396 | (defvar iswitchb-common-match-string nil |
397 | "Stores the string that is common to all matching buffers.") | |
398 | ||
962a4216 RS |
399 | (defvar iswitchb-rescan nil |
400 | "Non-nil means we need to regenerate the list of matching buffers.") | |
401 | ||
402 | (defvar iswitchb-text nil | |
403 | "Stores the users string as it is typed in.") | |
404 | ||
405 | (defvar iswitchb-matches nil | |
ccd2f997 | 406 | "List of buffers currently matching `iswitchb-text'.") |
962a4216 | 407 | |
19db4308 DL |
408 | (defvar iswitchb-mode-map |
409 | (let ((map (make-sparse-keymap))) | |
410 | (set-keymap-parent map minibuffer-local-map) | |
411 | (define-key map "?" 'iswitchb-completion-help) | |
412 | (define-key map "\C-s" 'iswitchb-next-match) | |
413 | (define-key map "\C-r" 'iswitchb-prev-match) | |
414 | (define-key map "\t" 'iswitchb-complete) | |
415 | (define-key map "\C-j" 'iswitchb-select-buffer-text) | |
416 | (define-key map "\C-t" 'iswitchb-toggle-regexp) | |
417 | (define-key map "\C-x\C-f" 'iswitchb-find-file) | |
418 | (define-key map "\C-c" 'iswitchb-toggle-case) | |
419 | (define-key map "\C-k" 'iswitchb-kill-buffer) | |
420 | (define-key map "\C-m" 'iswitchb-exit-minibuffer) | |
421 | map) | |
422 | "Minibuffer keymap for `iswitchb-buffer'.") | |
423 | ||
424 | (defvar iswitchb-global-map | |
425 | (let ((map (make-sparse-keymap))) | |
426 | (substitute-key-definition 'switch-to-buffer ; normally C-x b | |
427 | 'iswitchb-buffer map global-map) | |
428 | (substitute-key-definition 'switch-to-buffer-other-window ; C-x 4 b | |
429 | 'iswitchb-buffer-other-window map global-map) | |
430 | (substitute-key-definition 'switch-to-buffer-other-frame ; C-x 5 b | |
431 | 'iswitchb-buffer-other-frame map global-map) | |
432 | (substitute-key-definition 'display-buffer ; C-x 4 C-o | |
433 | 'iswitchb-display-buffer map global-map) | |
434 | map) | |
435 | "Global keymap for `iswtichb-mode'.") | |
436 | ||
437 | (defvar iswitchb-history nil | |
6c56c80b | 438 | "History of buffers selected using `iswitchb-buffer'.") |
962a4216 | 439 | |
19db4308 DL |
440 | (defvar iswitchb-exit nil |
441 | "Flag to monitor how `iswitchb-buffer' exits. | |
6c56c80b RS |
442 | If equal to `takeprompt', we use the prompt as the buffer name to be |
443 | selected.") | |
962a4216 RS |
444 | |
445 | (defvar iswitchb-buffer-ignore-orig nil | |
446 | "Stores original value of `iswitchb-buffer-ignore'.") | |
447 | ||
448 | (defvar iswitchb-xemacs (string-match "XEmacs" (emacs-version)) | |
449 | "Non-nil if we are running XEmacs. Otherwise, assume we are running Emacs.") | |
450 | ||
6b0cc1b5 SE |
451 | (defvar iswitchb-default nil |
452 | "Default buffer for iswitchb.") | |
962a4216 | 453 | |
02e526ad SE |
454 | ;; The following variables are needed to keep the byte compiler quiet. |
455 | (defvar iswitchb-require-match nil | |
456 | "Non-nil if matching buffer must be selected.") | |
457 | ||
458 | (defvar iswitchb-temp-buflist nil | |
459 | "Stores a temporary version of the buffer list being created.") | |
460 | ||
461 | (defvar iswitchb-bufs-in-frame nil | |
462 | "List of the buffers visible in the current frame.") | |
463 | ||
c7b89861 EZ |
464 | (defvar iswitchb-minibuf-depth nil |
465 | "Value we expect to be returned by `minibuffer-depth' in the minibuffer.") | |
466 | ||
962a4216 RS |
467 | ;;; FUNCTIONS |
468 | ||
19db4308 | 469 | ;;; ISWITCHB KEYMAP |
962a4216 | 470 | (defun iswitchb-define-mode-map () |
19db4308 DL |
471 | "Set up the keymap for `iswitchb-buffer'. |
472 | This is obsolete. Use \\[iswitchb-mode] or customize the | |
473 | variable `iswitchb-mode'." | |
962a4216 RS |
474 | (interactive) |
475 | (let (map) | |
ccd2f997 | 476 | ;; generated every time so that it can inherit new functions. |
962a4216 RS |
477 | ;;(or iswitchb-mode-map |
478 | ||
479 | (setq map (copy-keymap minibuffer-local-map)) | |
480 | (define-key map "?" 'iswitchb-completion-help) | |
481 | (define-key map "\C-s" 'iswitchb-next-match) | |
482 | (define-key map "\C-r" 'iswitchb-prev-match) | |
483 | (define-key map "\t" 'iswitchb-complete) | |
484 | (define-key map "\C-j" 'iswitchb-select-buffer-text) | |
485 | (define-key map "\C-t" 'iswitchb-toggle-regexp) | |
36a3b01c | 486 | (define-key map "\C-x\C-f" 'iswitchb-find-file) |
962a4216 RS |
487 | ;;(define-key map "\C-a" 'iswitchb-toggle-ignore) |
488 | (define-key map "\C-c" 'iswitchb-toggle-case) | |
36a3b01c | 489 | (define-key map "\C-k" 'iswitchb-kill-buffer) |
ccd2f997 | 490 | (define-key map "\C-m" 'iswitchb-exit-minibuffer) |
962a4216 | 491 | (setq iswitchb-mode-map map) |
181688f2 | 492 | (run-hooks 'iswitchb-define-mode-map-hook))) |
962a4216 | 493 | |
962a4216 RS |
494 | ;;; MAIN FUNCTION |
495 | (defun iswitchb () | |
496 | "Switch to buffer matching a substring. | |
497 | As you type in a string, all of the buffers matching the string are | |
498 | displayed. When you have found the buffer you want, it can then be | |
499 | selected. As you type, most keys have their normal keybindings, | |
500 | except for the following: | |
501 | \\<iswitchb-mode-map> | |
502 | ||
503 | RET Select the buffer at the front of the list of matches. If the | |
6c56c80b | 504 | list is empty, possibly prompt to create new buffer. |
962a4216 RS |
505 | |
506 | \\[iswitchb-select-buffer-text] Select the current prompt as the buffer. | |
507 | If no buffer is found, prompt for a new one. | |
508 | ||
509 | \\[iswitchb-next-match] Put the first element at the end of the list. | |
510 | \\[iswitchb-prev-match] Put the last element at the start of the list. | |
19db4308 | 511 | \\[iswitchb-complete] Complete a common suffix to the current string that |
962a4216 RS |
512 | matches all buffers. If there is only one match, select that buffer. |
513 | If there is no common suffix, show a list of all matching buffers | |
514 | in a separate window. | |
ccd2f997 | 515 | \\[iswitchb-toggle-regexp] Toggle regexp searching. |
962a4216 | 516 | \\[iswitchb-toggle-case] Toggle case-sensitive searching of buffer names. |
36a3b01c | 517 | \\[iswitchb-completion-help] Show list of matching buffers in separate window. |
19db4308 | 518 | \\[iswitchb-find-file] Exit iswitchb and drop into `find-file'. |
36a3b01c | 519 | \\[iswitchb-kill-buffer] Kill buffer at head of buffer list." |
962a4216 RS |
520 | ;;\\[iswitchb-toggle-ignore] Toggle ignoring certain buffers (see \ |
521 | ;;`iswitchb-buffer-ignore') | |
522 | ||
ccd2f997 KH |
523 | (let |
524 | (prompt buf) | |
525 | ||
526 | (setq prompt (format "iswitch ")) | |
527 | ||
528 | (setq buf (iswitchb-read-buffer prompt)) | |
529 | ||
ccd2f997 KH |
530 | ;;(message "chosen text %s" iswitchb-final-text) |
531 | ;; Choose the buffer name: either the text typed in, or the head | |
532 | ;; of the list of matches | |
533 | ||
534 | (cond ( (eq iswitchb-exit 'findfile) | |
535 | (call-interactively 'find-file)) | |
536 | ||
537 | (t | |
538 | ;; View the buffer | |
c6e5b93f | 539 | ;;(message "go to buf %s" buf) |
ccd2f997 KH |
540 | ;; Check buf is non-nil. |
541 | (if buf | |
542 | (if (get-buffer buf) | |
543 | ;; buffer exists, so view it and then exit | |
544 | (iswitchb-visit-buffer buf) | |
545 | ;; else buffer doesn't exist | |
546 | (iswitchb-possible-new-buffer buf))) | |
181688f2 | 547 | )))) |
ccd2f997 | 548 | |
abc8b974 | 549 | ;;;###autoload |
ccd2f997 KH |
550 | (defun iswitchb-read-buffer (prompt &optional default require-match) |
551 | "Replacement for the built-in `read-buffer'. | |
19db4308 | 552 | Return the name of a buffer selected. |
ccd2f997 KH |
553 | PROMPT is the prompt to give to the user. DEFAULT if given is the default |
554 | buffer to be selected, which will go to the front of the list. | |
555 | If REQUIRE-MATCH is non-nil, an existing-buffer must be selected." | |
962a4216 RS |
556 | (let |
557 | ( | |
962a4216 RS |
558 | buf-sel |
559 | iswitchb-final-text | |
962a4216 | 560 | (icomplete-mode nil) ;; prevent icomplete starting up |
962a4216 RS |
561 | ;; can only use fonts if they have been bound. |
562 | (iswitchb-use-fonts (and iswitchb-use-fonts | |
563 | (boundp 'font-lock-comment-face) | |
ccd2f997 KH |
564 | (boundp 'font-lock-function-name-face)))) |
565 | ||
962a4216 | 566 | (iswitchb-define-mode-map) |
962a4216 RS |
567 | (setq iswitchb-exit nil) |
568 | (setq iswitchb-rescan t) | |
569 | (setq iswitchb-text "") | |
6b0cc1b5 SE |
570 | (setq iswitchb-default |
571 | (if (bufferp default) | |
572 | (buffer-name default) | |
573 | default)) | |
574 | (iswitchb-make-buflist iswitchb-default) | |
36a3b01c | 575 | (iswitchb-set-matches) |
19db4308 | 576 | (let |
ccd2f997 KH |
577 | ((minibuffer-local-completion-map iswitchb-mode-map) |
578 | (iswitchb-prepost-hooks t) | |
c7b89861 EZ |
579 | ;; Record the minibuffer depth that we expect to find once |
580 | ;; the minibuffer is set up and iswitchb-entryfn-p is called. | |
581 | (iswitchb-minibuf-depth (1+ (minibuffer-depth))) | |
181688f2 | 582 | (iswitchb-require-match require-match)) |
36a3b01c | 583 | ;; prompt the user for the buffer name |
19db4308 | 584 | (setq iswitchb-final-text (completing-read |
ccd2f997 | 585 | prompt ;the prompt |
660e161f | 586 | '(("dummy" . 1)) ;table |
ccd2f997 KH |
587 | nil ;predicate |
588 | nil ;require-match [handled elsewhere] | |
589 | nil ;initial-contents | |
590 | 'iswitchb-history))) | |
591 | ;; Handling the require-match must be done in a better way. | |
592 | (if (and require-match (not (iswitchb-existing-buffer-p))) | |
19db4308 | 593 | (error "Must specify valid buffer")) |
ccd2f997 | 594 | |
19db4308 | 595 | (if (or |
ccd2f997 KH |
596 | (eq iswitchb-exit 'takeprompt) |
597 | (null iswitchb-matches)) | |
598 | (setq buf-sel iswitchb-final-text) | |
599 | ;; else take head of list | |
600 | (setq buf-sel (car iswitchb-matches))) | |
601 | ||
602 | ;; Or possibly choose the default buffer | |
19db4308 DL |
603 | (if (equal iswitchb-final-text "") |
604 | (setq buf-sel | |
ccd2f997 | 605 | (car iswitchb-matches))) |
36a3b01c | 606 | |
ccd2f997 | 607 | buf-sel)) |
36a3b01c | 608 | |
ccd2f997 KH |
609 | (defun iswitchb-existing-buffer-p () |
610 | "Return non-nil if there is a matching buffer." | |
611 | (not (null iswitchb-matches))) | |
962a4216 RS |
612 | |
613 | ;;; COMPLETION CODE | |
614 | ||
615 | (defun iswitchb-set-common-completion () | |
6c56c80b RS |
616 | "Find common completion of `iswitchb-text' in `iswitchb-matches'. |
617 | The result is stored in `iswitchb-common-match-string'." | |
962a4216 RS |
618 | |
619 | (let* (val) | |
620 | (setq iswitchb-common-match-string nil) | |
621 | (if (and iswitchb-matches | |
6b0cc1b5 | 622 | (not iswitchb-regexp) ;; testing |
962a4216 RS |
623 | (stringp iswitchb-text) |
624 | (> (length iswitchb-text) 0)) | |
625 | (if (setq val (iswitchb-find-common-substring | |
626 | iswitchb-matches iswitchb-text)) | |
627 | (setq iswitchb-common-match-string val))) | |
181688f2 | 628 | val)) |
962a4216 RS |
629 | |
630 | (defun iswitchb-complete () | |
631 | "Try and complete the current pattern amongst the buffer names." | |
632 | (interactive) | |
633 | (let (res) | |
634 | (cond ((not iswitchb-matches) | |
181688f2 | 635 | (iswitchb-completion-help)) |
962a4216 | 636 | |
ccd2f997 | 637 | ((= 1 (length iswitchb-matches)) |
962a4216 RS |
638 | ;; only one choice, so select it. |
639 | (exit-minibuffer)) | |
640 | ||
641 | (t | |
642 | ;; else there could be some completions | |
6b0cc1b5 | 643 | (setq res iswitchb-common-match-string) |
962a4216 | 644 | (if (and (not (memq res '(t nil))) |
36a3b01c | 645 | (not (equal res iswitchb-text))) |
ccd2f997 | 646 | ;; found something to complete, so put it in the minibuffer. |
962a4216 RS |
647 | (progn |
648 | (setq iswitchb-rescan nil) | |
53811b42 | 649 | (delete-region (minibuffer-prompt-end) (point)) |
962a4216 RS |
650 | (insert res)) |
651 | ;; else nothing to complete | |
652 | (iswitchb-completion-help) | |
181688f2 | 653 | ))))) |
962a4216 RS |
654 | |
655 | ;;; TOGGLE FUNCTIONS | |
656 | ||
657 | (defun iswitchb-toggle-case () | |
19db4308 | 658 | "Toggle the value of variable `iswitchb-case'." |
962a4216 RS |
659 | (interactive) |
660 | (setq iswitchb-case (not iswitchb-case)) | |
661 | ;; ask for list to be regenerated. | |
181688f2 | 662 | (setq iswitchb-rescan t)) |
962a4216 RS |
663 | |
664 | (defun iswitchb-toggle-regexp () | |
665 | "Toggle the value of `iswitchb-regexp'." | |
666 | (interactive) | |
667 | (setq iswitchb-regexp (not iswitchb-regexp)) | |
668 | ;; ask for list to be regenerated. | |
181688f2 | 669 | (setq iswitchb-rescan t)) |
962a4216 RS |
670 | |
671 | (defun iswitchb-toggle-ignore () | |
672 | "Toggle ignoring buffers specified with `iswitchb-buffer-ignore'." | |
673 | (interactive) | |
674 | (if iswitchb-buffer-ignore | |
675 | (progn | |
676 | (setq iswitchb-buffer-ignore-orig iswitchb-buffer-ignore) | |
181688f2 | 677 | (setq iswitchb-buffer-ignore nil)) |
962a4216 | 678 | ;; else |
181688f2 | 679 | (setq iswitchb-buffer-ignore iswitchb-buffer-ignore-orig)) |
6b0cc1b5 | 680 | (iswitchb-make-buflist iswitchb-default) |
962a4216 | 681 | ;; ask for list to be regenerated. |
181688f2 | 682 | (setq iswitchb-rescan t)) |
962a4216 | 683 | |
ccd2f997 KH |
684 | (defun iswitchb-exit-minibuffer () |
685 | "Exit minibuffer, but make sure we have a match if one is needed." | |
686 | (interactive) | |
687 | (if (or (not iswitchb-require-match) | |
688 | (iswitchb-existing-buffer-p)) | |
181688f2 | 689 | (throw 'exit nil))) |
962a4216 RS |
690 | |
691 | (defun iswitchb-select-buffer-text () | |
6c56c80b RS |
692 | "Select the buffer named by the prompt. |
693 | If no buffer exactly matching the prompt exists, maybe create a new one." | |
962a4216 RS |
694 | (interactive) |
695 | (setq iswitchb-exit 'takeprompt) | |
696 | (exit-minibuffer)) | |
697 | ||
36a3b01c | 698 | (defun iswitchb-find-file () |
19db4308 | 699 | "Drop into `find-file' from buffer switching." |
36a3b01c RS |
700 | (interactive) |
701 | (setq iswitchb-exit 'findfile) | |
702 | (exit-minibuffer)) | |
703 | ||
19db4308 | 704 | (defun iswitchb-next-match () |
962a4216 RS |
705 | "Put first element of `iswitchb-matches' at the end of the list." |
706 | (interactive) | |
36a3b01c RS |
707 | (let ((next (cadr iswitchb-matches))) |
708 | (setq iswitchb-buflist (iswitchb-chop iswitchb-buflist next)) | |
181688f2 | 709 | (setq iswitchb-rescan t))) |
962a4216 | 710 | |
19db4308 | 711 | (defun iswitchb-prev-match () |
962a4216 RS |
712 | "Put last element of `iswitchb-matches' at the front of the list." |
713 | (interactive) | |
36a3b01c RS |
714 | (let ((prev (car (last iswitchb-matches)))) |
715 | (setq iswitchb-buflist (iswitchb-chop iswitchb-buflist prev)) | |
181688f2 | 716 | (setq iswitchb-rescan t))) |
36a3b01c RS |
717 | |
718 | (defun iswitchb-chop (list elem) | |
719 | "Remove all elements before ELEM and put them at the end of LIST." | |
720 | (let ((ret nil) | |
721 | (next nil) | |
722 | (sofar nil)) | |
723 | (while (not ret) | |
724 | (setq next (car list)) | |
725 | (if (equal next elem) | |
726 | (setq ret (append list (nreverse sofar))) | |
727 | ;; else | |
728 | (progn | |
729 | (setq list (cdr list)) | |
730 | (setq sofar (cons next sofar))))) | |
731 | ret)) | |
962a4216 | 732 | |
962a4216 RS |
733 | ;;; CREATE LIST OF ALL CURRENT BUFFERS |
734 | ||
ccd2f997 | 735 | (defun iswitchb-make-buflist (default) |
6c56c80b | 736 | "Set `iswitchb-buflist' to the current list of buffers. |
36a3b01c | 737 | Currently visible buffers are put at the end of the list. |
19db4308 | 738 | The hook `iswitchb-make-buflist-hook' is run after the list has been |
36a3b01c | 739 | created to allow the user to further modify the order of the buffer names |
ccd2f997 KH |
740 | in this list. If DEFAULT is non-nil, and corresponds to an existing buffer, |
741 | it is put to the start of the list." | |
19db4308 | 742 | (setq iswitchb-buflist |
36a3b01c | 743 | (let* ((iswitchb-current-buffers (iswitchb-get-buffers-in-frames)) |
ceba0dac GM |
744 | (iswitchb-temp-buflist |
745 | (delq nil | |
746 | (mapcar | |
747 | (lambda (x) | |
748 | (let ((b-name (buffer-name x))) | |
749 | (if (not | |
750 | (or | |
751 | (iswitchb-ignore-buffername-p b-name) | |
752 | (memq b-name iswitchb-current-buffers))) | |
753 | b-name))) | |
754 | (buffer-list (and iswitchb-use-frame-buffer-list | |
755 | (selected-frame))))))) | |
756 | (setq iswitchb-temp-buflist | |
757 | (nconc iswitchb-temp-buflist iswitchb-current-buffers)) | |
962a4216 | 758 | (run-hooks 'iswitchb-make-buflist-hook) |
ceba0dac | 759 | ;; Should this be after the hooks, or should the hooks be the |
ccd2f997 KH |
760 | ;; final thing to be run? |
761 | (if default | |
762 | (progn | |
19db4308 | 763 | (setq iswitchb-temp-buflist |
02e526ad | 764 | (delete default iswitchb-temp-buflist)) |
19db4308 | 765 | (setq iswitchb-temp-buflist |
02e526ad SE |
766 | (cons default iswitchb-temp-buflist)))) |
767 | iswitchb-temp-buflist))) | |
962a4216 | 768 | |
36a3b01c | 769 | (defun iswitchb-to-end (lst) |
02e526ad | 770 | "Move the elements from LST to the end of `iswitchb-temp-buflist'." |
19db4308 DL |
771 | (mapcar |
772 | (lambda (elem) | |
02e526ad | 773 | (setq iswitchb-temp-buflist (delq elem iswitchb-temp-buflist))) |
36a3b01c | 774 | lst) |
ceba0dac | 775 | (setq iswitchb-temp-buflist (nconc iswitchb-temp-buflist lst))) |
962a4216 | 776 | |
962a4216 | 777 | (defun iswitchb-get-buffers-in-frames (&optional current) |
962a4216 | 778 | "Return the list of buffers that are visible in the current frame. |
19db4308 | 779 | If optional argument CURRENT is given, restrict searching to the |
962a4216 RS |
780 | current frame, rather than all frames, regardless of value of |
781 | `iswitchb-all-frames'." | |
962a4216 | 782 | (let ((iswitchb-bufs-in-frame nil)) |
962a4216 | 783 | (walk-windows 'iswitchb-get-bufname nil |
19db4308 | 784 | (if current |
962a4216 RS |
785 | nil |
786 | iswitchb-all-frames)) | |
787 | iswitchb-bufs-in-frame)) | |
788 | ||
962a4216 RS |
789 | (defun iswitchb-get-bufname (win) |
790 | "Used by `iswitchb-get-buffers-in-frames' to walk through all windows." | |
ae5ac7d0 RS |
791 | (let ((buf (buffer-name (window-buffer win)))) |
792 | (if (not (member buf iswitchb-bufs-in-frame)) | |
793 | ;; Only add buf if it is not already in list. | |
794 | ;; This prevents same buf in two different windows being | |
795 | ;; put into the list twice. | |
796 | (setq iswitchb-bufs-in-frame | |
797 | (cons buf iswitchb-bufs-in-frame))))) | |
962a4216 | 798 | |
962a4216 RS |
799 | ;;; FIND MATCHING BUFFERS |
800 | ||
801 | (defun iswitchb-set-matches () | |
802 | "Set `iswitchb-matches' to the list of buffers matching prompt." | |
962a4216 RS |
803 | (if iswitchb-rescan |
804 | (setq iswitchb-matches | |
181688f2 | 805 | (let* ((buflist iswitchb-buflist)) |
36a3b01c | 806 | (iswitchb-get-matched-buffers iswitchb-text iswitchb-regexp |
6b0cc1b5 | 807 | buflist))))) |
36a3b01c RS |
808 | |
809 | (defun iswitchb-get-matched-buffers (regexp | |
810 | &optional string-format buffer-list) | |
6b0cc1b5 SE |
811 | "Return buffers matching REGEXP. |
812 | If STRING-FORMAT is nil, consider REGEXP as just a string. | |
6c56c80b | 813 | BUFFER-LIST can be list of buffers or list of strings." |
8097dd15 | 814 | (let* ((case-fold-search (iswitchb-case)) |
962a4216 RS |
815 | ;; need reverse since we are building up list backwards |
816 | (list (reverse buffer-list)) | |
6b0cc1b5 | 817 | (do-string (stringp (car list))) |
962a4216 | 818 | name |
181688f2 | 819 | ret) |
962a4216 | 820 | (mapcar |
36a3b01c RS |
821 | (lambda (x) |
822 | ||
823 | (if do-string | |
824 | (setq name x) ;We already have the name | |
825 | (setq name (buffer-name x))) | |
826 | ||
827 | (cond | |
828 | ((and (or (and string-format (string-match regexp name)) | |
829 | (and (null string-format) | |
830 | (string-match (regexp-quote regexp) name))) | |
831 | ||
181688f2 | 832 | (not (iswitchb-ignore-buffername-p name))) |
36a3b01c RS |
833 | (setq ret (cons name ret)) |
834 | ))) | |
962a4216 | 835 | list) |
181688f2 | 836 | ret)) |
962a4216 RS |
837 | |
838 | (defun iswitchb-ignore-buffername-p (bufname) | |
839 | "Return t if the buffer BUFNAME should be ignored." | |
840 | (let ((data (match-data)) | |
841 | (re-list iswitchb-buffer-ignore) | |
842 | ignorep | |
181688f2 | 843 | nextstr) |
962a4216 RS |
844 | (while re-list |
845 | (setq nextstr (car re-list)) | |
846 | (cond | |
847 | ((stringp nextstr) | |
848 | (if (string-match nextstr bufname) | |
849 | (progn | |
850 | (setq ignorep t) | |
851 | (setq re-list nil)))) | |
852 | ((fboundp nextstr) | |
853 | (if (funcall nextstr bufname) | |
854 | (progn | |
855 | (setq ignorep t) | |
181688f2 | 856 | (setq re-list nil))))) |
962a4216 | 857 | (setq re-list (cdr re-list))) |
25c80f5c | 858 | (set-match-data data) |
962a4216 RS |
859 | |
860 | ;; return the result | |
181688f2 | 861 | ignorep)) |
962a4216 | 862 | |
962a4216 RS |
863 | (defun iswitchb-word-matching-substring (word) |
864 | "Return part of WORD before 1st match to `iswitchb-change-word-sub'. | |
865 | If `iswitchb-change-word-sub' cannot be found in WORD, return nil." | |
8097dd15 | 866 | (let ((case-fold-search (iswitchb-case))) |
962a4216 RS |
867 | (let ((m (string-match iswitchb-change-word-sub word))) |
868 | (if m | |
869 | (substring word m) | |
870 | ;; else no match | |
871 | nil)))) | |
872 | ||
962a4216 RS |
873 | (defun iswitchb-find-common-substring (lis subs) |
874 | "Return common string following SUBS in each element of LIS." | |
875 | (let (res | |
876 | alist | |
181688f2 | 877 | iswitchb-change-word-sub) |
962a4216 RS |
878 | (setq iswitchb-change-word-sub |
879 | (if iswitchb-regexp | |
880 | subs | |
881 | (regexp-quote subs))) | |
882 | (setq res (mapcar 'iswitchb-word-matching-substring lis)) | |
ccd2f997 | 883 | (setq res (delq nil res)) ;; remove any nil elements (shouldn't happen) |
962a4216 RS |
884 | (setq alist (mapcar 'iswitchb-makealist res)) ;; could use an OBARRAY |
885 | ||
886 | ;; try-completion returns t if there is an exact match. | |
8097dd15 | 887 | (let ((completion-ignore-case (iswitchb-case))) |
962a4216 | 888 | |
181688f2 | 889 | (try-completion subs alist)))) |
962a4216 RS |
890 | |
891 | (defun iswitchb-makealist (res) | |
892 | "Return dotted pair (RES . 1)." | |
893 | (cons res 1)) | |
894 | ||
895 | ;; from Wayne Mesard <wmesard@esd.sgi.com> | |
896 | (defun iswitchb-rotate-list (lis) | |
19db4308 | 897 | "Destructively remove the last element from LIS. |
962a4216 RS |
898 | Return the modified list with the last element prepended to it." |
899 | (if (<= (length lis) 1) | |
900 | lis | |
901 | (let ((las lis) | |
902 | (prev lis)) | |
903 | (while (consp (cdr las)) | |
904 | (setq prev las | |
905 | las (cdr las))) | |
906 | (setcdr prev nil) | |
181688f2 | 907 | (cons (car las) lis)))) |
962a4216 RS |
908 | |
909 | (defun iswitchb-completion-help () | |
910 | "Show possible completions in a *Buffer Completions* buffer." | |
911 | ;; we could allow this buffer to be used to select match, but I think | |
36a3b01c | 912 | ;; choose-completion-string will need redefining, so it just inserts |
19db4308 | 913 | ;; choice with out any previous input. |
962a4216 | 914 | (interactive) |
36a3b01c | 915 | (setq iswitchb-rescan nil) |
962a4216 | 916 | (let ((completion-setup-hook nil) ;disable fancy highlight/selection. |
ccd2f997 KH |
917 | (buf (current-buffer)) |
918 | (temp-buf "*Buffer Completions*") | |
919 | (win) | |
920 | (again (eq last-command this-command))) | |
921 | ||
922 | (if again | |
923 | ;; scroll buffer | |
924 | (progn | |
925 | (set-buffer temp-buf) | |
926 | (setq win (get-buffer-window temp-buf)) | |
927 | (if (pos-visible-in-window-p (point-max) win) | |
928 | (set-window-start win (point-min)) | |
929 | (scroll-other-window)) | |
181688f2 | 930 | (set-buffer buf)) |
ccd2f997 KH |
931 | |
932 | (with-output-to-temp-buffer temp-buf | |
19db4308 | 933 | (if iswitchb-xemacs |
ccd2f997 KH |
934 | |
935 | ;; XEmacs extents are put on by default, doesn't seem to be | |
936 | ;; any way of switching them off. | |
937 | (display-completion-list (if iswitchb-matches | |
938 | iswitchb-matches | |
939 | iswitchb-buflist) | |
940 | :help-string "iswitchb " | |
19db4308 DL |
941 | :activate-callback |
942 | (lambda (x y z) | |
943 | (message "doesn't work yet, sorry!"))) | |
ccd2f997 | 944 | ;; else running Emacs |
19db4308 DL |
945 | (with-current-buffer standard-output |
946 | (fundamental-mode)) | |
ccd2f997 | 947 | (display-completion-list (if iswitchb-matches |
19db4308 | 948 | iswitchb-matches |
ccd2f997 KH |
949 | iswitchb-buflist)) |
950 | ))))) | |
951 | ||
36a3b01c RS |
952 | ;;; KILL CURRENT BUFFER |
953 | ||
954 | (defun iswitchb-kill-buffer () | |
ccd2f997 | 955 | "Kill the buffer at the head of `iswitchb-matches'." |
36a3b01c RS |
956 | (interactive) |
957 | (let ( (enable-recursive-minibuffers t) | |
958 | buf) | |
959 | ||
960 | (setq buf (car iswitchb-matches)) | |
961 | ;; check to see if buf is non-nil. | |
962 | (if buf | |
963 | (progn | |
964 | (kill-buffer buf) | |
965 | ||
966 | ;; Check if buffer exists. XEmacs gnuserv.el makes alias | |
967 | ;; for kill-buffer which does not return t if buffer is | |
968 | ;; killed, so we can't rely on kill-buffer return value. | |
969 | (if (get-buffer buf) | |
970 | ;; buffer couldn't be killed. | |
19db4308 | 971 | (setq iswitchb-rescan t) |
36a3b01c RS |
972 | ;; else buffer was killed so remove name from list. |
973 | (setq iswitchb-buflist (delq buf iswitchb-buflist))))))) | |
974 | ||
962a4216 RS |
975 | ;;; VISIT CHOSEN BUFFER |
976 | (defun iswitchb-visit-buffer (buffer) | |
977 | "Visit buffer named BUFFER according to `iswitchb-method'." | |
978 | (let* (win newframe) | |
979 | (cond | |
980 | ((eq iswitchb-method 'samewindow) | |
981 | (switch-to-buffer buffer)) | |
982 | ||
983 | ((memq iswitchb-method '(always-frame maybe-frame)) | |
984 | (cond | |
985 | ((and (setq win (iswitchb-window-buffer-p buffer)) | |
986 | (or (eq iswitchb-method 'always-frame) | |
987 | (y-or-n-p "Jump to frame? "))) | |
988 | (setq newframe (window-frame win)) | |
989 | (raise-frame newframe) | |
990 | (select-frame newframe) | |
991 | (select-window win) | |
992 | (if (not iswitchb-xemacs) | |
993 | ;; reposition mouse to make frame active. not needed in XEmacs | |
994 | ;; This line came from the other-frame defun in Emacs. | |
181688f2 | 995 | (set-mouse-position (selected-frame) (1- (frame-width)) 0))) |
962a4216 RS |
996 | (t |
997 | ;; No buffer in other frames... | |
998 | (switch-to-buffer buffer) | |
999 | ))) | |
1000 | ||
962a4216 RS |
1001 | ((eq iswitchb-method 'otherwindow) |
1002 | (switch-to-buffer-other-window buffer)) | |
1003 | ||
888472e0 RS |
1004 | ((eq iswitchb-method 'display) |
1005 | (display-buffer buffer)) | |
1006 | ||
962a4216 RS |
1007 | ((eq iswitchb-method 'otherframe) |
1008 | (progn | |
1009 | (switch-to-buffer-other-frame buffer) | |
1010 | (if (not iswitchb-xemacs) | |
1011 | (set-mouse-position (selected-frame) (1- (frame-width)) 0)) | |
181688f2 | 1012 | ))))) |
962a4216 RS |
1013 | |
1014 | (defun iswitchb-possible-new-buffer (buf) | |
1015 | "Possibly create and visit a new buffer called BUF." | |
1016 | ||
1017 | (let ((newbufcreated)) | |
1018 | (if (and iswitchb-newbuffer | |
1019 | (or | |
1020 | (not iswitchb-prompt-newbuffer) | |
1021 | ||
1022 | (and iswitchb-prompt-newbuffer | |
1023 | (y-or-n-p | |
1024 | (format | |
1025 | "No buffer matching `%s', create one? " | |
1026 | buf))))) | |
1027 | ;; then create a new buffer | |
1028 | (progn | |
1029 | (setq newbufcreated (get-buffer-create buf)) | |
1030 | (if (fboundp 'set-buffer-major-mode) | |
1031 | (set-buffer-major-mode newbufcreated)) | |
1032 | (iswitchb-visit-buffer newbufcreated)) | |
1033 | ;; else wont create new buffer | |
181688f2 | 1034 | (message (format "no buffer matching `%s'" buf))))) |
962a4216 RS |
1035 | |
1036 | (defun iswitchb-window-buffer-p (buffer) | |
6c56c80b RS |
1037 | "Return window pointer if BUFFER is visible in another frame. |
1038 | If BUFFER is visible in the current frame, return nil." | |
962a4216 | 1039 | (interactive) |
962a4216 RS |
1040 | (let ((blist (iswitchb-get-buffers-in-frames 'current))) |
1041 | ;;If the buffer is visible in current frame, return nil | |
1042 | (if (memq buffer blist) | |
1043 | nil | |
ccd2f997 KH |
1044 | ;; maybe in other frame or icon |
1045 | (get-buffer-window buffer 0) ; better than 'visible | |
962a4216 RS |
1046 | ))) |
1047 | ||
6c56c80b | 1048 | ;;;###autoload |
962a4216 | 1049 | (defun iswitchb-default-keybindings () |
6c56c80b | 1050 | "Set up default keybindings for `iswitchb-buffer'. |
ee5897a4 | 1051 | Call this function to override the normal bindings. This function also |
19db4308 DL |
1052 | adds a hook to the minibuffer. |
1053 | ||
1054 | Obsolescent. Use `iswitchb-mode'." | |
962a4216 | 1055 | (interactive) |
ee5897a4 | 1056 | (add-hook 'minibuffer-setup-hook 'iswitchb-minibuffer-setup) |
322524b2 SE |
1057 | (global-set-key "\C-xb" 'iswitchb-buffer) |
1058 | (global-set-key "\C-x4b" 'iswitchb-buffer-other-window) | |
1059 | (global-set-key "\C-x4\C-o" 'iswitchb-display-buffer) | |
1060 | (global-set-key "\C-x5b" 'iswitchb-buffer-other-frame)) | |
962a4216 | 1061 | |
962a4216 RS |
1062 | ;;;###autoload |
1063 | (defun iswitchb-buffer () | |
1064 | "Switch to another buffer. | |
1065 | ||
1066 | The buffer name is selected interactively by typing a substring. The | |
1067 | buffer is displayed according to `iswitchb-default-method' -- the | |
1068 | default is to show it in the same window, unless it is already visible | |
6c56c80b RS |
1069 | in another frame. |
1070 | For details of keybindings, do `\\[describe-function] iswitchb'." | |
962a4216 RS |
1071 | (interactive) |
1072 | (setq iswitchb-method iswitchb-default-method) | |
ccd2f997 | 1073 | (iswitchb)) |
962a4216 | 1074 | |
962a4216 RS |
1075 | ;;;###autoload |
1076 | (defun iswitchb-buffer-other-window () | |
1077 | "Switch to another buffer and show it in another window. | |
1078 | The buffer name is selected interactively by typing a substring. | |
6c56c80b | 1079 | For details of keybindings, do `\\[describe-function] iswitchb'." |
962a4216 RS |
1080 | (interactive) |
1081 | (setq iswitchb-method 'otherwindow) | |
ccd2f997 | 1082 | (iswitchb)) |
962a4216 | 1083 | |
888472e0 RS |
1084 | ;;;###autoload |
1085 | (defun iswitchb-display-buffer () | |
1086 | "Display a buffer in another window but don't select it. | |
1087 | The buffer name is selected interactively by typing a substring. | |
1088 | For details of keybindings, do `\\[describe-function] iswitchb'." | |
1089 | (interactive) | |
1090 | (setq iswitchb-method 'display) | |
ccd2f997 | 1091 | (iswitchb)) |
888472e0 | 1092 | |
962a4216 RS |
1093 | ;;;###autoload |
1094 | (defun iswitchb-buffer-other-frame () | |
1095 | "Switch to another buffer and show it in another frame. | |
1096 | The buffer name is selected interactively by typing a substring. | |
6c56c80b | 1097 | For details of keybindings, do `\\[describe-function] iswitchb'." |
962a4216 RS |
1098 | (interactive) |
1099 | (setq iswitchb-method 'otherframe) | |
962a4216 RS |
1100 | (iswitchb)) |
1101 | ||
36a3b01c | 1102 | ;;; XEmacs hack for showing default buffer |
962a4216 RS |
1103 | |
1104 | ;; The first time we enter the minibuffer, Emacs puts up the default | |
ccd2f997 | 1105 | ;; buffer to switch to, but XEmacs doesn't -- presumably there is a |
36a3b01c RS |
1106 | ;; subtle difference in the two versions of post-command-hook. The |
1107 | ;; default is shown for both whenever we delete all of our text | |
1108 | ;; though, indicating its just a problem the first time we enter the | |
1109 | ;; function. To solve this, we use another entry hook for emacs to | |
1110 | ;; show the default the first time we enter the minibuffer. | |
962a4216 | 1111 | |
6b0cc1b5 | 1112 | (defun iswitchb-init-XEmacs-trick () |
6c56c80b RS |
1113 | "Display default buffer when first entering minibuffer. |
1114 | This is a hack for XEmacs, and should really be handled by `iswitchb-exhibit'." | |
962a4216 RS |
1115 | (if (iswitchb-entryfn-p) |
1116 | (progn | |
36a3b01c | 1117 | (iswitchb-exhibit) |
962a4216 RS |
1118 | (goto-char (point-min))))) |
1119 | ||
36a3b01c | 1120 | ;; add this hook for XEmacs only. |
962a4216 | 1121 | (if iswitchb-xemacs |
19db4308 | 1122 | (add-hook 'iswitchb-minibuffer-setup-hook |
6b0cc1b5 | 1123 | 'iswitchb-init-XEmacs-trick)) |
962a4216 | 1124 | |
36a3b01c | 1125 | ;;; XEmacs / backspace key |
ccd2f997 | 1126 | ;; For some reason, if the backspace key is pressed in XEmacs, the |
962a4216 | 1127 | ;; line gets confused, so I've added a simple key definition to make |
19db4308 | 1128 | ;; backspace act like the normal delete key. |
962a4216 RS |
1129 | |
1130 | (defun iswitchb-xemacs-backspacekey () | |
1131 | "Bind backspace to `backward-delete-char'." | |
1132 | (define-key iswitchb-mode-map '[backspace] 'backward-delete-char) | |
181688f2 | 1133 | (define-key iswitchb-mode-map '[(meta backspace)] 'backward-kill-word)) |
962a4216 RS |
1134 | |
1135 | (if iswitchb-xemacs | |
19db4308 | 1136 | (add-hook 'iswitchb-define-mode-map-hook |
962a4216 RS |
1137 | 'iswitchb-xemacs-backspacekey)) |
1138 | ||
962a4216 RS |
1139 | ;;; ICOMPLETE TYPE CODE |
1140 | ||
1141 | (defun iswitchb-exhibit () | |
6c56c80b | 1142 | "Find matching buffers and display a list in the minibuffer. |
962a4216 RS |
1143 | Copied from `icomplete-exhibit' with two changes: |
1144 | 1. It prints a default buffer name when there is no text yet entered. | |
1145 | 2. It calls my completion routine rather than the standard completion." | |
962a4216 | 1146 | (if iswitchb-use-mycompletion |
600f9d03 | 1147 | (let ((contents (buffer-substring (minibuffer-prompt-end) (point-max))) |
962a4216 RS |
1148 | (buffer-undo-list t)) |
1149 | (save-excursion | |
1150 | (goto-char (point-max)) | |
1151 | ; Register the end of input, so we | |
1152 | ; know where the extra stuff | |
1153 | ; (match-status info) begins: | |
1154 | (if (not (boundp 'iswitchb-eoinput)) | |
1155 | ;; In case it got wiped out by major mode business: | |
1156 | (make-local-variable 'iswitchb-eoinput)) | |
1157 | (setq iswitchb-eoinput (point)) | |
1158 | ;; Update the list of matches | |
1159 | (setq iswitchb-text contents) | |
1160 | (iswitchb-set-matches) | |
1161 | (setq iswitchb-rescan t) | |
1162 | (iswitchb-set-common-completion) | |
1163 | ||
1164 | ;; Insert the match-status information: | |
26119624 GM |
1165 | (insert-string (iswitchb-completions |
1166 | contents | |
1167 | minibuffer-completion-table | |
1168 | minibuffer-completion-predicate | |
1169 | (not minibuffer-completion-confirm))))))) | |
1170 | ||
1171 | (defun iswitchb-completions (name candidates predicate require-match) | |
962a4216 RS |
1172 | "Return the string that is displayed after the user's text. |
1173 | Modified from `icomplete-completions'." | |
1174 | ||
1175 | (let ((comps iswitchb-matches) | |
1176 | ; "-determined" - only one candidate | |
1177 | (open-bracket-determined (if require-match "(" "[")) | |
1178 | (close-bracket-determined (if require-match ")" "]")) | |
1179 | ;"-prospects" - more than one candidate | |
1180 | (open-bracket-prospects "{") | |
1181 | (close-bracket-prospects "}") | |
181688f2 | 1182 | first) |
962a4216 RS |
1183 | |
1184 | (if (and iswitchb-use-fonts comps) | |
1185 | (progn | |
1186 | (setq first (car comps)) | |
1187 | (setq first (format "%s" first)) | |
1188 | (put-text-property 0 (length first) 'face | |
19db4308 | 1189 | (if (= (length comps) 1) |
962a4216 RS |
1190 | 'font-lock-comment-face |
1191 | 'font-lock-function-name-face) | |
19db4308 | 1192 | first) |
181688f2 | 1193 | (setq comps (cons first (cdr comps))))) |
962a4216 RS |
1194 | |
1195 | (cond ((null comps) (format " %sNo match%s" | |
1196 | open-bracket-determined | |
1197 | close-bracket-determined)) | |
1198 | ||
1199 | ((null (cdr comps)) ;one match | |
1200 | (concat (if (and (> (length (car comps)) | |
1201 | (length name))) | |
1202 | (concat open-bracket-determined | |
19db4308 | 1203 | ;; when there is one match, show the |
962a4216 RS |
1204 | ;; matching buffer name in full |
1205 | (car comps) | |
1206 | close-bracket-determined) | |
1207 | "") | |
181688f2 | 1208 | (if (not iswitchb-use-fonts) " [Matched]"))) |
962a4216 RS |
1209 | (t ;multiple matches |
1210 | (let* ( | |
1211 | ;;(most (try-completion name candidates predicate)) | |
1212 | (most nil) | |
1213 | (most-len (length most)) | |
1214 | most-is-exact | |
1215 | first | |
1216 | (alternatives | |
1217 | (apply | |
1218 | (function concat) | |
1219 | (cdr (apply | |
1220 | (function nconc) | |
1221 | (mapcar '(lambda (com) | |
1222 | (if (= (length com) most-len) | |
1223 | ;; Most is one exact match, | |
1224 | ;; note that and leave out | |
1225 | ;; for later indication: | |
1226 | (progn | |
1227 | (setq most-is-exact t) | |
1228 | ()) | |
1229 | (list "," | |
1230 | (substring com | |
1231 | most-len)))) | |
1232 | comps)))))) | |
1233 | ||
1234 | (concat | |
1235 | ||
1236 | ;; put in common completion item -- what you get by | |
1237 | ;; pressing tab | |
1238 | (if (> (length iswitchb-common-match-string) (length name)) | |
1239 | (concat open-bracket-determined | |
19db4308 | 1240 | (substring iswitchb-common-match-string |
962a4216 | 1241 | (length name)) |
181688f2 | 1242 | close-bracket-determined)) |
962a4216 RS |
1243 | ;; end of partial matches... |
1244 | ||
1245 | ;; think this bit can be ignored. | |
1246 | (and (> most-len (length name)) | |
1247 | (concat open-bracket-determined | |
1248 | (substring most (length name)) | |
1249 | close-bracket-determined)) | |
1250 | ||
1251 | ;; list all alternatives | |
1252 | open-bracket-prospects | |
1253 | (if most-is-exact | |
1254 | (concat "," alternatives) | |
1255 | alternatives) | |
181688f2 | 1256 | close-bracket-prospects)))))) |
962a4216 RS |
1257 | |
1258 | (defun iswitchb-minibuffer-setup () | |
6c56c80b RS |
1259 | "Set up minibuffer for `iswitchb-buffer'. |
1260 | Copied from `icomplete-minibuffer-setup-hook'." | |
962a4216 RS |
1261 | (if (iswitchb-entryfn-p) |
1262 | (progn | |
1263 | ||
1264 | (make-local-variable 'iswitchb-use-mycompletion) | |
1265 | (setq iswitchb-use-mycompletion t) | |
1266 | (make-local-hook 'pre-command-hook) | |
1267 | (add-hook 'pre-command-hook | |
1268 | 'iswitchb-pre-command | |
1269 | nil t) | |
1270 | (make-local-hook 'post-command-hook) | |
1271 | (add-hook 'post-command-hook | |
1272 | 'iswitchb-post-command | |
1273 | nil t) | |
1274 | ||
181688f2 | 1275 | (run-hooks 'iswitchb-minibuffer-setup-hook)))) |
962a4216 RS |
1276 | |
1277 | (defun iswitchb-pre-command () | |
6c56c80b | 1278 | "Run before command in `iswitchb-buffer'." |
962a4216 RS |
1279 | (iswitchb-tidy)) |
1280 | ||
962a4216 | 1281 | (defun iswitchb-post-command () |
6c56c80b | 1282 | "Run after command in `iswitchb-buffer'." |
181688f2 | 1283 | (iswitchb-exhibit)) |
962a4216 RS |
1284 | |
1285 | (defun iswitchb-tidy () | |
1286 | "Remove completions display, if any, prior to new user input. | |
1287 | Copied from `icomplete-tidy'." | |
1288 | ||
1289 | (if (and (boundp 'iswitchb-eoinput) | |
1290 | iswitchb-eoinput) | |
1291 | ||
1292 | (if (> iswitchb-eoinput (point-max)) | |
1293 | ;; Oops, got rug pulled out from under us - reinit: | |
1294 | (setq iswitchb-eoinput (point-max)) | |
1295 | (let ((buffer-undo-list buffer-undo-list )) ; prevent entry | |
1296 | (delete-region iswitchb-eoinput (point-max)))) | |
1297 | ||
1298 | ;; Reestablish the local variable 'cause minibuffer-setup is weird: | |
1299 | (make-local-variable 'iswitchb-eoinput) | |
1300 | (setq iswitchb-eoinput 1))) | |
1301 | ||
962a4216 | 1302 | (defun iswitchb-entryfn-p () |
26119624 | 1303 | "Return non-nil if we are using `iswitchb-buffer'." |
c7b89861 | 1304 | (eq iswitchb-minibuf-depth (minibuffer-depth))) |
ccd2f997 | 1305 | |
962a4216 | 1306 | (defun iswitchb-summaries-to-end () |
6c56c80b RS |
1307 | "Move the summaries to the end of the list. |
1308 | This is an example function which can be hooked on to | |
1309 | `iswitchb-make-buflist-hook'. Any buffer matching the regexps | |
1310 | `Summary' or `output\*$'are put to the end of the list." | |
19db4308 DL |
1311 | (let ((summaries (delq nil |
1312 | (mapcar | |
1313 | (lambda (x) | |
1314 | (if (string-match "Summary\\|output\\*$" x) | |
1315 | x)) | |
1316 | iswitchb-temp-buflist)))) | |
36a3b01c | 1317 | (iswitchb-to-end summaries))) |
962a4216 | 1318 | |
8097dd15 GM |
1319 | (defun iswitchb-case () |
1320 | "Return non-nil iff we should ignore case when matching. | |
1321 | See the variable `iswitchb-case' for details." | |
1322 | (if iswitchb-case | |
1323 | (if iswitchb-xemacs | |
1324 | (isearch-no-upper-case-p iswitchb-text) | |
1325 | (isearch-no-upper-case-p iswitchb-text t)))) | |
1326 | ||
19db4308 DL |
1327 | ;;;###autoload |
1328 | (defun iswitchb-mode (&optional arg) | |
1329 | "Toggle Iswitchb global minor mode. | |
1330 | With arg, turn Iswitchb mode on if and only iff ARG is positive. | |
1331 | This mode enables switching between buffers using substrings. See | |
1332 | `iswitchb' for details." | |
1333 | (interactive "P") | |
1334 | (setq iswitchb-mode | |
1335 | (if arg | |
1336 | (> (prefix-numeric-value arg) 0) | |
1337 | (not iswitchb-mode))) | |
1338 | (if iswitchb-mode | |
1339 | (add-hook 'minibuffer-setup-hook 'iswitchb-minibuffer-setup) | |
1340 | (remove-hook 'minibuffer-setup-hook 'iswitchb-minibuffer-setup)) | |
1341 | (run-hooks 'iswitchb-mode-hook) | |
1342 | (if (interactive-p) | |
1343 | (message "Iswitchb mode %sabled" | |
1344 | (if iswitchb-mode "en" "dis")))) | |
1345 | ||
1346 | (unless (assq 'iswitchb-mode minor-mode-map-alist) | |
1347 | (push (cons 'iswitchb-mode iswitchb-global-map) | |
1348 | minor-mode-map-alist)) | |
1349 | ||
962a4216 RS |
1350 | (provide 'iswitchb) |
1351 | ||
6c56c80b | 1352 | ;;; iswitchb.el ends here |