* lisp/ido.el (ido-delete-ignored-files): Remove.
[bpt/emacs.git] / lisp / ido.el
CommitLineData
06b60517 1;;; ido.el --- interactively do things with buffers and files
789d1bf0 2
ab422c4d 3;; Copyright (C) 1996-2013 Free Software Foundation, Inc.
789d1bf0
KS
4
5;; Author: Kim F. Storm <storm@cua.dk>
6;; Based on: iswitchb by Stephen Eglen <stephen@cns.ed.ac.uk>
7;; Keywords: extensions convenience
8
9;; This file is part of GNU Emacs.
10
eb3fa2cf 11;; GNU Emacs is free software: you can redistribute it and/or modify
789d1bf0 12;; it under the terms of the GNU General Public License as published by
eb3fa2cf
GM
13;; the Free Software Foundation, either version 3 of the License, or
14;; (at your option) any later version.
789d1bf0
KS
15
16;; GNU Emacs is distributed in the hope that it will be useful,
17;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19;; GNU General Public License for more details.
20
21;; You should have received a copy of the GNU General Public License
eb3fa2cf 22;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
789d1bf0 23
789d1bf0
KS
24
25;;; Commentary:
26
27;; Ido - interactive do - switches between buffers and opens files and
28;; directories with a minimum of keystrokes. It is a superset of
29;; iswitchb, the interactive buffer switching package by Stephen Eglen.
30
31;; Interactive substring matching
32;; ------------------------------
33;;
34;; As you type in a substring, the list of buffers or files currently
35;; matching the substring are displayed as you type. The list is
36;; ordered so that the most recent buffers or files visited come at
37;; the start of the list.
38;;
39;; The buffer or file at the start of the list will be the one visited
40;; when you press RETURN. By typing more of the substring, the list is
41;; narrowed down so that gradually the buffer or file you want will be
42;; at the top of the list. Alternatively, you can use C-s and C-r (or
43;; the right and left arrow keys) to rotate buffer or file names in the
44;; list until the one you want is at the top of the list.
45;;
46;; Completion is also available so that you can see what is common to
47;; all of the matching buffers or files as you type.
48;;
49;; Example:
50;;
51;; If I have two buffers called "123456" and "123", with "123456" the
52;; most recent, when I use ido-switch-buffer, I first of all get
53;; presented with the list of all the buffers
54;;
04c95147 55;; Buffer: {123456 | 123}
789d1bf0
KS
56;;
57;; If I then press 2:
04c95147 58;; Buffer: 2[3]{123456 | 123}
789d1bf0
KS
59;;
60;; The list in {...} are the matching buffers, most recent first
61;; (buffers visible in the current frame are put at the end of the
62;; list by default). At any time I can select the item at the head of
f2801d2a
KS
63;; the list by pressing RET. I can also put the first element at the
64;; end of the list by pressing C-s or [right], or bring the last
65;; element to the head of the list by pressing C-r or [left].
789d1bf0
KS
66;;
67;; The item in [...] indicates what can be added to my input by
68;; pressing TAB. In this case, I will get "3" added to my input.
69
70;; So, I press TAB:
04c95147 71;; Buffer: 23{123456 | 123}
789d1bf0
KS
72;;
73;; At this point, I still have two matching buffers.
74;; If I want the first buffer in the list, I simply press RET. If I
75;; wanted the second in the list, I could press C-s to move it to the
76;; top of the list and then RET to select it.
77;;
78;; However, if I type 4, I only have one match left:
04c95147
KS
79;; Buffer: 234[123456]
80;;
81;; Since there is only one matching buffer left, it is given in [] and
82;; it is shown in the `ido-only-match' face (ForestGreen). I can now
83;; press TAB or RET to go to that buffer.
789d1bf0 84;;
04c95147
KS
85;; If I want to create a new buffer named "234", I press C-j instead of
86;; TAB or RET.
789d1bf0 87;;
04c95147 88;; If instead, I type "a":
789d1bf0
KS
89;; Buffer: 234a [No match]
90;; There are no matching buffers. If I press RET or TAB, I can be
91;; prompted to create a new buffer called "234a".
92;;
93;; Of course, where this function comes in really useful is when you
94;; can specify the buffer using only a few keystrokes. In the above
95;; example, the quickest way to get to the "123456" file would be
96;; just to type 4 and then RET (assuming there isn't any newer buffer
97;; with 4 in its name).
98
99;; Likewise, if you use C-x C-f (ido-find-file), the list of files and
100;; directories in the current directory is provided in the same
101;; fashion as the buffers above. The files and directories are
102;; normally sorted in alphabetical order, but the most recently
103;; visited directory is placed first to speed up navigating to
104;; directories that you have visited recently.
105;;
106;; In addition to scrolling through the list using [right] and [left],
107;; you can use [up] and [down] to quickly scroll the list to the next
108;; or previous subdirectory.
109;;
110;; To go down into a subdirectory, and continue the file selection on
111;; the files in that directory, simply move the directory to the head
112;; of the list and hit RET.
113;;
114;; To go up to the parent directory, delete any partial file name
115;; already specified (e.g. using [backspace]) and hit [backspace].
116;;
117;; To go to the root directory (on the current drive), enter two
118;; slashes. On MS-DOS or Windows, to select the root of another
119;; drive, enter X:/ where X is the drive letter. You can also visit
120;; files on other hosts using the ange-ftp notations `/host:' and
121;; `/user@host:'. See the variable `ido-slow-ftp-hosts' if you want
71296446 122;; to inhibit the ido substring matching for ftp access.
789d1bf0
KS
123;;
124;; If for some reason you cannot specify the proper file using
125;; ido-find-file, you can press C-f to enter the normal find-file.
126;; You can also press C-b to drop into ido-switch-buffer.
127
128;; See the doc string of ido-switch-buffer and ido-find-file for full
129;; keybindings and features.
130;; (describe-function 'ido-find-file)
131
132;; Hidden buffers and files
133;; ------------------------
134;;
135;; Normally, ido does not include hidden buffers (whose name starts
136;; with a space) and hidden files and directories (whose name starts
137;; with `.') in the list of possible completions. However, if the
138;; substring you enter does not match any of the visible buffers or
139;; files, ido will automatically look for completions among the hidden
140;; buffers or files.
141;;
142;; You can toggle display of the hidden buffers and files with C-a.
143
144;; Additional functionality
145;; ------------------------
146;;
147;; After C-x b, the buffer at the head of the list can be killed by
148;; pressing C-k. If the buffer needs saving, you will be queried
149;; before the buffer is killed.
150;;
151;; Likewise, after C-x C-f, you can delete (i.e. physically remove)
152;; the file at the head of the list with C-k. You will always be
153;; asked for confirmation before the file is deleted.
154;;
155;; If you enter C-x b to switch to a buffer visiting a given file, and
156;; you find that the file you are after is not in any buffer, you can
157;; press C-f to immediately drop into ido-find-file. And you can
158;; switch back to buffer selection with C-b.
159
160;; Prefix matching
161;; ---------------
162;;
163;; The standard way of completion with Unix-shells and Emacs is to insert a
164;; PREFIX and then hitting TAB (or another completion key). Cause of this
165;; behavior has become second nature to a lot of emacs users `ido' offers in
166;; addition to the default substring-matching-method (look above) also the
167;; prefix-matching-method. The kind of matching is the only difference to
168;; the description of the substring-matching above.
169;;
170;; You can toggle prefix matching with C-p.
171;;
172;; Example:
173;;
174;; If you have again two Buffers "123456" and "123" then hitting "2" does
f2801d2a 175;; not match because "2" is not a PREFIX in any of the buffer-names.
789d1bf0
KS
176
177;; Flexible matching
178;; -----------------
179;;
180;; If you set ido-enable-flex-matching, ido will do a more flexible
181;; matching (unless regexp matching is active) to find possible matches
182;; among the available buffer or file names if no matches are found using
183;; the normal prefix or substring matching.
184;;
185;; The flexible matching implies that any item which simply contains all
186;; of the entered characters in the specified sequence will match.
187;;
188;; Example:
189;;
190;; If you have four files "alpha", "beta", "gamma", and "delta",
191;; entering "aa" will match "alpha" and "gamma", while "ea" matches
192;; "beta" and "delta". If prefix matching is also active, "aa" only
193;; matches "alpha", while "ea" does not match any files.
194
195;; Regexp matching
196;; ---------------
197;;
198;; There is limited provision for regexp matching within ido,
199;; enabled through `ido-enable-regexp' (toggle with C-t).
f2801d2a
KS
200;; This allows you to type `[ch]$' for example and see all file names
201;; ending in `c' or `h'.
202;;
203;; Note: ido-style completion is inhibited when you enable regexp matching.
789d1bf0
KS
204
205
206;; Customization
207;; -------------
208;;
209;; Customize the `ido' group to change the `ido' functionality.
210;;
3729cc87
KS
211;; To modify the keybindings, use the ido-setup-hook. For example:
212;;(add-hook 'ido-setup-hook 'ido-my-keys)
789d1bf0
KS
213;;
214;;(defun ido-my-keys ()
215;; "Add my keybindings for ido."
facf67fd 216;; (define-key ido-completion-map " " 'ido-next-match)
789d1bf0
KS
217;; )
218
219;; Seeing all the matching buffers or files
220;; ----------------------------------------
221;;
222;; If you have many matching files, they may not all fit onto one
223;; line of the minibuffer. Normally, the minibuffer window will grow
224;; to show you more of the matching files (depending on the setting
225;; of the variables `resize-mini-windows' and `max-mini-window-height').
226;; If you want ido to behave differently from the default minibuffer
fffa137c 227;; resizing behavior, set the variable `ido-max-window-height'.
789d1bf0
KS
228;;
229;; Also, to improve the responsiveness of ido, the maximum number of
230;; matching items is limited to 12, but you can increase or removed
231;; this limit via the `ido-max-prospects' variable.
232
233;; To see a full list of all matching buffers in a separate buffer,
234;; hit ? or press TAB when there are no further completions to the
235;; substring. Repeated TAB presses will scroll you through this
236;; separate buffer.
237
238;; Changing the list of files
239;; --------------------------
240
241;; By default, the list of current files is most recent first,
242;; oldest last, with the exception that the files visible in the
243;; current frame are put at the end of the list. A hook exists to
244;; allow other functions to order the list. For example, if you add:
245;;
246;; (add-hook 'ido-make-buffer-list-hook 'ido-summary-buffers-to-end)
247;;
248;; then all files matching "Summary" are moved to the end of the
249;; list. (I find this handy for keeping the INBOX Summary and so on
250;; out of the way.) It also moves files matching "output\*$" to the
90a02640 251;; end of the list (these are created by AUCTeX when compiling.)
789d1bf0
KS
252;; Other functions could be made available which alter the list of
253;; matching files (either deleting or rearranging elements.)
254
255;; Highlighting
256;; ------------
257
258;; The highlighting of matching items is controlled via ido-use-faces.
ccba8bb6
KS
259;; The faces used are ido-first-match, ido-only-match and
260;; ido-subdir.
da6062e6 261;; Coloring of the matching item was suggested by
789d1bf0
KS
262;; Carsten Dominik (dominik@strw.leidenuniv.nl).
263
264;; Replacement for read-buffer and read-file-name
265;; ----------------------------------------------
266
267;; ido-read-buffer and ido-read-file-name have been written to be drop
268;; in replacements for the normal buffer and file name reading
269;; functions `read-buffer' and `read-file-name'.
270
271;; To use ido for all buffer and file selections in Emacs, customize the
272;; variable `ido-everywhere'.
273
fffa137c 274;; Using ido-like behavior in other lisp packages
789d1bf0
KS
275;; -----------------------------------------------
276
277;; If you don't want to rely on the `ido-everywhere' functionality,
278;; ido-read-buffer, ido-read-file-name, and ido-read-directory-name
279;; can be used by other packages to read a buffer name, a file name,
280;; or a directory name in the `ido' way.
281
09ae5da1 282;;; Acknowledgments
04c95147
KS
283
284;; Infinite amounts of gratitude goes to Stephen Eglen <stephen@cns.ed.ac.uk>
285;; who wrote iswitch-buffer mode - from which I ripped off 99% of the code
286;; for ido-switch-buffer and found the inspiration for ido-find-file.
287;; The ido package would never have existed without his work.
288
289;; Also thanks to Klaus Berndl, Rohit Namjoshi, Robert Fenk, Alex
290;; Schroeder, Bill Benedetto, Stephen Eglen, and many others for bug
291;; fixes and improvements.
292
293;;; History
294
295;; Since I discovered Stephen Eglen's excellent iswitchb package, I just
296;; couldn't live without it, but once being addicted to switching buffers
297;; with a minimum of keystrokes, I soon found that opening files in the
298;; old-fashioned way was just too slow - so I decided to write a package
299;; which could open files with the same speed and ease as iswitchb could
300;; switch buffers.
301
302;; I originally wrote a separate ifindf.el package based on a copy of
303;; iswitchb.el, which did for opening files what iswitchb did for
304;; switching buffers. Along the way, I corrected a few errors in
305;; ifindf which could have found its way back into iswitchb, but since
306;; most of the functionality of the two package was practically
307;; identical, I decided that the proper thing to do was to merge my
308;; ifindf package back into iswitchb.
309;;
310;; This is basically what ido (interactively do) is all about; but I
a87ef899 311;; found it awkward to merge my changes into the "iswitchb-" namespace,
04c95147
KS
312;; so I invented a common "ido-" namespace for the merged packages.
313;;
314;; This version is based on ido.el version 1.57 released on
315;; gnu.emacs.sources adapted for emacs 22.1 to use command remapping
316;; and optionally hooking the read-buffer and read-file-name functions.
317;;
318;; Prefix matching was added by Klaus Berndl <klaus.berndl@sdm.de> based on
319;; an idea of Yuji Minejima <ggb01164@nifty.ne.jp> and his mcomplete-package.
320
789d1bf0
KS
321
322;;; Code:
323
9caf8a8f 324(defvar recentf-list)
b2ddf2d2 325
789d1bf0
KS
326;;; User Variables
327;;
328;; These are some things you might want to change.
329
330(defun ido-fractionp (n)
331 (and (numberp n) (> n 0.0) (<= n 1.0)))
332
333(defgroup ido nil
334 "Switch between files using substrings."
335 :group 'extensions
336 :group 'convenience
bf247b6e 337 :version "22.1"
789d1bf0
KS
338 :link '(emacs-commentary-link :tag "Commentary" "ido.el")
339 :link '(emacs-library-link :tag "Lisp File" "ido.el"))
340
341;;;###autoload
342(defcustom ido-mode nil
343 "Determines for which functional group \(buffer and files) ido behavior
616e8e5f 344should be enabled. The following values are possible:
337d2b66 345- `buffer': Turn only on ido buffer behavior \(switching, killing,
71296446 346 displaying...)
337d2b66
RS
347- `file': Turn only on ido file behavior \(finding, writing, inserting...)
348- `both': Turn on ido buffer and file behavior.
349- `nil': Turn off any ido switching.
789d1bf0
KS
350
351Setting this variable directly does not take effect;
352use either \\[customize] or the function `ido-mode'."
06b60517 353 :set #'(lambda (_symbol value)
789d1bf0 354 (ido-mode value))
7103fd59 355 :initialize 'custom-initialize-default
789d1bf0
KS
356 :require 'ido
357 :link '(emacs-commentary-link "ido.el")
1b00bc64 358 :set-after '(ido-save-directory-list-file
b97f1994 359 ;; This will clear ido-unc-hosts-cache, so set it
1b00bc64 360 ;; before loading history file.
b97f1994 361 ido-unc-hosts)
71296446 362 :type '(choice (const :tag "Turn on only buffer" buffer)
789d1bf0
KS
363 (const :tag "Turn on only file" file)
364 (const :tag "Turn on both buffer and file" both)
365 (const :tag "Switch off all" nil))
366 :group 'ido)
367
789d1bf0 368(defcustom ido-case-fold case-fold-search
9201cc28 369 "Non-nil if searching of buffer and file names should ignore case."
789d1bf0
KS
370 :type 'boolean
371 :group 'ido)
372
373(defcustom ido-ignore-buffers
374 '("\\` ")
9201cc28 375 "List of regexps or functions matching buffer names to ignore.
789d1bf0
KS
376For example, traditional behavior is not to list buffers whose names begin
377with a space, for which the regexp is `\\` '. See the source file for
79164cf4 378example functions that filter buffer names."
789d1bf0
KS
379 :type '(repeat (choice regexp function))
380 :group 'ido)
381
382(defcustom ido-ignore-files
383 '("\\`CVS/" "\\`#" "\\`.#" "\\`\\.\\./" "\\`\\./")
9201cc28 384 "List of regexps or functions matching file names to ignore.
789d1bf0
KS
385For example, traditional behavior is not to list files whose names begin
386with a #, for which the regexp is `\\`#'. See the source file for
387example functions that filter filenames."
388 :type '(repeat (choice regexp function))
389 :group 'ido)
390
391(defcustom ido-ignore-extensions t
9201cc28 392 "Non-nil means ignore files in `completion-ignored-extensions' list."
789d1bf0
KS
393 :type 'boolean
394 :group 'ido)
395
396(defcustom ido-show-dot-for-dired nil
9201cc28 397 "Non-nil means to always put . as the first item in file name lists.
a09e21bf 398This allows the current directory to be opened immediately with `dired'."
789d1bf0
KS
399 :type 'boolean
400 :group 'ido)
401
1de0ae85 402(defcustom ido-file-extensions-order nil
9201cc28 403 "List of file extensions specifying preferred order of file selections.
1de0ae85
KS
404Each element is either a string with `.' as the first char, an empty
405string matching files without extension, or t which is the default order
616e8e5f 406for files with an unlisted file extension."
1de0ae85
KS
407 :type '(repeat (choice string
408 (const :tag "Default order" t)))
409 :group 'ido)
410
789d1bf0
KS
411(defcustom ido-ignore-directories
412 '("\\`CVS/" "\\`\\.\\./" "\\`\\./")
9201cc28 413 "List of regexps or functions matching sub-directory names to ignore."
789d1bf0
KS
414 :type '(repeat (choice regexp function))
415 :group 'ido)
416
417(defcustom ido-ignore-directories-merge nil
9201cc28 418 "List of regexps or functions matching directory names to ignore during merge.
362cdb61 419Directory names matched by one of the regexps in this list are not inserted
789d1bf0
KS
420in merged file and directory lists."
421 :type '(repeat (choice regexp function))
422 :group 'ido)
423
3da360a7
SM
424;; Examples for setting the value of ido-ignore-buffers
425;;(defun ido-ignore-c-mode (name)
426;; "Ignore all c mode buffers -- example function for ido."
427;; (with-current-buffer name
428;; (derived-mode-p 'c-mode)))
429;;
430;;(setq ido-ignore-buffers '("^ " ido-ignore-c-mode))
789d1bf0 431
3da360a7
SM
432;; Examples for setting the value of ido-ignore-files
433;;(setq ido-ignore-files '("^ " "\\.c\\'" "\\.h\\'"))
789d1bf0 434
a11ad595 435(defcustom ido-default-file-method 'raise-frame
9201cc28 436 "How to visit a new file when using `ido-find-file'.
789d1bf0 437Possible values:
a11ad595
KS
438`selected-window' Show new file in selected window
439`other-window' Show new file in another window (same frame)
440`display' Display file in another window without selecting to it
441`other-frame' Show new file in another frame
442`maybe-frame' If a file is visible in another frame, prompt to ask if you
443 you want to see the file in the same window of the current
444 frame or in the other frame
445`raise-frame' If a file is visible in another frame, raise that
446 frame; otherwise, visit the file in the same window"
447 :type '(choice (const :tag "Visit in selected window" selected-window)
448 (const :tag "Visit in other window" other-window)
449 (const :tag "Display (no select) in other window" display)
450 (const :tag "Visit in other frame" other-frame)
451 (const :tag "Ask to visit in other frame" maybe-frame)
452 (const :tag "Raise frame if already visited" raise-frame))
789d1bf0
KS
453 :group 'ido)
454
a11ad595 455(defcustom ido-default-buffer-method 'raise-frame
9201cc28 456 "How to switch to new buffer when using `ido-switch-buffer'.
616e8e5f 457See `ido-default-file-method' for details."
a11ad595
KS
458 :type '(choice (const :tag "Show in selected window" selected-window)
459 (const :tag "Show in other window" other-window)
460 (const :tag "Display (no select) in other window" display)
461 (const :tag "Show in other frame" other-frame)
462 (const :tag "Ask to show in other frame" maybe-frame)
463 (const :tag "Raise frame if already shown" raise-frame))
789d1bf0
KS
464 :group 'ido)
465
466(defcustom ido-enable-flex-matching nil
9201cc28 467 "Non-nil means that `ido' will do flexible string matching.
789d1bf0
KS
468Flexible matching means that if the entered string does not
469match any item, any item containing the entered characters
470in the given sequence will match."
471 :type 'boolean
472 :group 'ido)
473
474
475(defcustom ido-enable-regexp nil
9201cc28 476 "Non-nil means that `ido' will do regexp matching.
789d1bf0
KS
477Value can be toggled within `ido' using `ido-toggle-regexp'."
478 :type 'boolean
479 :group 'ido)
480
481(defcustom ido-enable-prefix nil
9201cc28 482 "Non-nil means only match if the entered text is a prefix of file name.
79164cf4 483This behavior is like the standard Emacs completion.
29660eb7 484If nil, match if the entered text is an arbitrary substring.
789d1bf0
KS
485Value can be toggled within `ido' using `ido-toggle-prefix'."
486 :type 'boolean
487 :group 'ido)
488
6d8b6cbd 489(defcustom ido-enable-dot-prefix nil
9201cc28 490 "Non-nil means to match leading dot as prefix.
6d8b6cbd
KS
491I.e. hidden files and buffers will match only if you type a dot
492as first char even if `ido-enable-prefix' is nil."
493 :type 'boolean
494 :group 'ido)
495
a8c14da8
LL
496;; See http://debbugs.gnu.org/2042 for more info.
497(defcustom ido-buffer-disable-smart-matches t
498 "Non-nil means not to re-order matches for buffer switching.
735135f9 499By default, ido arranges matches in the following order:
a8c14da8
LL
500
501 full-matches > suffix matches > prefix matches > remaining matches
502
503which can get in the way for buffer switching."
2bc9406c 504 :version "24.3"
a8c14da8
LL
505 :type 'boolean
506 :group 'ido)
507
d81aa76a 508(defcustom ido-confirm-unique-completion nil
9201cc28 509 "Non-nil means that even a unique completion must be confirmed.
d81aa76a
KS
510This means that \\[ido-complete] must always be followed by \\[ido-exit-minibuffer]
511even when there is only one unique completion."
512 :type 'boolean
513 :group 'ido)
514
d1a0acac 515(defcustom ido-cannot-complete-command 'ido-completion-help
9201cc28 516 "Command run when `ido-complete' can't complete any more.
d1a0acac
KS
517The most useful values are `ido-completion-help', which pops up a
518window with completion alternatives, or `ido-next-match' or
519`ido-prev-match', which cycle the buffer list."
520 :type 'function
521 :group 'ido)
522
523
789d1bf0 524(defcustom ido-record-commands t
9201cc28 525 "Non-nil means that `ido' will record commands in command history.
789d1bf0
KS
526Note that the non-ido equivalent command is recorded."
527 :type 'boolean
528 :group 'ido)
529
530(defcustom ido-max-prospects 12
9201cc28 531 "Non-zero means that the prospect list will be limited to that number of items.
789d1bf0 532For a long list of prospects, building the full list for the minibuffer can take a
616e8e5f 533non-negligible amount of time; setting this variable reduces that time."
789d1bf0
KS
534 :type 'integer
535 :group 'ido)
536
a42e9704 537(defcustom ido-max-file-prompt-width 0.35
9201cc28 538 "Non-zero means that the prompt string be limited to that number of characters.
789d1bf0
KS
539If value is a floating point number, it specifies a fraction of the frame width."
540 :type '(choice
541 (integer :tag "Characters" :value 20)
542 (restricted-sexp :tag "Fraction of frame width"
543 :value 0.35
544 :match-alternatives (ido-fractionp)))
545 :group 'ido)
546
547(defcustom ido-max-window-height nil
9201cc28 548 "Non-nil specifies a value to override `max-mini-window-height'."
789d1bf0
KS
549 :type '(choice
550 (const :tag "Don't override" nil)
551 (integer :tag "Number of lines" :value 1)
552 (restricted-sexp
553 :tag "Fraction of window height"
554 :value 0.25
555 :match-alternatives (ido-fractionp)))
556 :group 'ido)
557
558(defcustom ido-enable-last-directory-history t
9201cc28 559 "Non-nil means that `ido' will remember latest selected directory names.
789d1bf0
KS
560See `ido-last-directory-list' and `ido-save-directory-list-file'."
561 :type 'boolean
562 :group 'ido)
563
564(defcustom ido-max-work-directory-list 50
9201cc28 565 "Maximum number of working directories to record.
789d1bf0
KS
566This is the list of directories where files have most recently been opened.
567See `ido-work-directory-list' and `ido-save-directory-list-file'."
568 :type 'integer
569 :group 'ido)
570
571(defcustom ido-work-directory-list-ignore-regexps nil
9201cc28 572 "List of regexps matching directories which should not be recorded.
362cdb61 573Directory names matched by one of the regexps in this list are not inserted in
789d1bf0
KS
574the `ido-work-directory-list' list."
575 :type '(repeat regexp)
576 :group 'ido)
577
bad111c2 578
310682e6 579(defcustom ido-use-filename-at-point nil
9201cc28 580 "Non-nil means that ido shall look for a filename at point.
3c88bdc5 581May use `ffap-guesser' to guess whether text at point is a filename.
310682e6 582If found, use that as the starting point for filename selection."
3c88bdc5
KS
583 :type '(choice
584 (const :tag "Disabled" nil)
585 (const :tag "Guess filename" guess)
586 (other :tag "Use literal filename" t))
310682e6
KS
587 :group 'ido)
588
589
590(defcustom ido-use-url-at-point nil
9201cc28 591 "Non-nil means that ido shall look for a URL at point.
310682e6
KS
592If found, call `find-file-at-point' to visit it."
593 :type 'boolean
594 :group 'ido)
595
596
bad111c2 597(defcustom ido-enable-tramp-completion t
9201cc28 598 "Non-nil means that ido shall perform tramp method and server name completion.
362cdb61 599A tramp file name uses the following syntax: /method:user@host:filename."
bad111c2
KS
600 :type 'boolean
601 :group 'ido)
602
789d1bf0 603(defcustom ido-record-ftp-work-directories t
9201cc28 604 "Non-nil means record ftp file names in the work directory list."
789d1bf0
KS
605 :type 'boolean
606 :group 'ido)
607
608(defcustom ido-merge-ftp-work-directories nil
9201cc28 609 "If nil, merging ignores ftp file names in the work directory list."
789d1bf0
KS
610 :type 'boolean
611 :group 'ido)
612
613(defcustom ido-cache-ftp-work-directory-time 1.0
9201cc28 614 "Maximum time to cache contents of an ftp directory (in hours).
dfebc0ae 615Use C-l in prompt to refresh list.
789d1bf0
KS
616If zero, ftp directories are not cached."
617 :type 'number
618 :group 'ido)
619
620(defcustom ido-slow-ftp-hosts nil
9201cc28 621 "List of slow ftp hosts where ido prompting should not be used.
789d1bf0 622If an ftp host is on this list, ido automatically switches to the non-ido
616e8e5f 623equivalent function, e.g. `find-file' rather than `ido-find-file'."
789d1bf0
KS
624 :type '(repeat string)
625 :group 'ido)
626
627(defcustom ido-slow-ftp-host-regexps nil
9201cc28 628 "List of regexps matching slow ftp hosts (see `ido-slow-ftp-hosts')."
789d1bf0
KS
629 :type '(repeat regexp)
630 :group 'ido)
631
4c2ee078 632(defvar ido-unc-hosts-cache t
d36995c6 633 "Cached value from `ido-unc-hosts' function.")
4c2ee078 634
dfebc0ae 635(defcustom ido-unc-hosts nil
9201cc28 636 "List of known UNC host names to complete after initial //.
4c2ee078
KS
637If value is a function, that function is called to search network for
638hosts on first use of UNC path."
639 :type '(choice (repeat :tag "List of UNC host names" string)
640 (function-item :tag "Use `NET VIEW'"
641 :value ido-unc-hosts-net-view)
642 (function :tag "Your own function"))
643 :set #'(lambda (symbol value)
644 (set symbol value)
645 (setq ido-unc-hosts-cache t))
646 :group 'ido)
647
b97f1994 648(defcustom ido-downcase-unc-hosts t
9201cc28 649 "Non-nil if UNC host names should be downcased."
b97f1994
KS
650 :type 'boolean
651 :group 'ido)
652
4c2ee078 653(defcustom ido-ignore-unc-host-regexps nil
9201cc28 654 "List of regexps matching UNC hosts to ignore.
b97f1994 655Case is ignored if `ido-downcase-unc-hosts' is set."
4c2ee078 656 :type '(repeat regexp)
dfebc0ae
KS
657 :group 'ido)
658
659(defcustom ido-cache-unc-host-shares-time 8.0
9201cc28 660 "Maximum time to cache shares of an UNC host (in hours).
dfebc0ae 661Use C-l in prompt to refresh list.
3903655d 662If zero, UNC host shares are not cached."
dfebc0ae
KS
663 :type 'number
664 :group 'ido)
665
789d1bf0 666(defcustom ido-max-work-file-list 10
9201cc28 667 "Maximum number of names of recently opened files to record.
79164cf4 668This is the list of the file names (sans directory) which have most recently
3903655d 669been opened. See `ido-work-file-list' and `ido-save-directory-list-file'."
789d1bf0
KS
670 :type 'integer
671 :group 'ido)
672
673(defcustom ido-work-directory-match-only t
9201cc28 674 "Non-nil means to skip non-matching directories in the directory history.
789d1bf0
KS
675When some text is already entered at the `ido-find-file' prompt, using
676\\[ido-prev-work-directory] or \\[ido-next-work-directory] will skip directories
677without any matching entries."
678 :type 'boolean
679 :group 'ido)
680
681(defcustom ido-auto-merge-work-directories-length 0
9201cc28 682 "Automatically switch to merged work directories during file name input.
789d1bf0
KS
683The value is number of characters to type before switching to merged mode.
684If zero, the switch happens when no matches are found in the current directory.
685Automatic merging is disabled if the value is negative."
686 :type 'integer
687 :group 'ido)
688
689(defcustom ido-auto-merge-delay-time 0.70
9201cc28 690 "Delay in seconds to wait for more input before doing auto merge."
789d1bf0
KS
691 :type 'number
692 :group 'ido)
693
694(defcustom ido-auto-merge-inhibit-characters-regexp "[][*?~]"
9201cc28 695 "Regexp matching characters which should inhibit automatic merging.
789d1bf0
KS
696When a (partial) file name matches this regexp, merging is inhibited."
697 :type 'regexp
698 :group 'ido)
699
700(defcustom ido-merged-indicator "^"
701 "The string appended to first choice if it has multiple directory choices."
702 :type 'string
703 :group 'ido)
704
705(defcustom ido-max-dir-file-cache 100
9201cc28 706 "Maximum number of working directories to be cached.
a09e21bf 707This is the size of the cache of `file-name-all-completions' results.
789d1bf0
KS
708Each cache entry is time stamped with the modification time of the
709directory. Some systems, like Windows, have unreliable directory
710modification times, so you may choose to disable caching on such
711systems, or explicitly refresh the cache contents using the command
712`ido-reread-directory' command (C-l) in the minibuffer.
713See also `ido-dir-file-cache' and `ido-save-directory-list-file'."
714 :type 'integer
715 :group 'ido)
716
ee41332b 717(defcustom ido-max-directory-size nil
9201cc28 718 "Maximum size (in bytes) for directories to use ido completion.
cb65c373
KS
719If you enter a directory with a size larger than this size, ido will
720not provide the normal completion. To show the completions, use C-a."
721 :type '(choice (const :tag "No limit" nil)
722 (integer :tag "Size in bytes" 30000))
723 :group 'ido)
724
789d1bf0 725(defcustom ido-rotate-file-list-default nil
9201cc28 726 "Non-nil means that `ido' will always rotate file list to get default in front."
789d1bf0
KS
727 :type 'boolean
728 :group 'ido)
729
5702da69 730(defcustom ido-enter-matching-directory 'only
9201cc28 731 "Additional methods to enter sub-directory of first/only matching item.
5702da69
KS
732If value is 'first, enter first matching sub-directory when typing a slash.
733If value is 'only, typing a slash only enters the sub-directory if it is
734the only matching item.
735If value is t, automatically enter a sub-directory when it is the only
736matching item, even without typing a slash."
71296446 737 :type '(choice (const :tag "Never" nil)
5702da69
KS
738 (const :tag "Slash enters first directory" first)
739 (const :tag "Slash enters first and only directory" only)
740 (other :tag "Always enter unique directory" t))
789d1bf0
KS
741 :group 'ido)
742
789d1bf0 743(defcustom ido-create-new-buffer 'prompt
9201cc28 744 "Specify whether a new buffer is created if no buffer matches substring.
789d1bf0
KS
745Choices are 'always to create new buffers unconditionally, 'prompt to
746ask user whether to create buffer, or 'never to never create new buffer."
71296446 747 :type '(choice (const always)
789d1bf0
KS
748 (const prompt)
749 (const never))
750 :group 'ido)
751
3729cc87 752(defcustom ido-setup-hook nil
9201cc28 753 "Hook run after the ido variables and keymap have been setup.
3729cc87 754The dynamic variable `ido-cur-item' contains the current type of item that
79164cf4 755is read by ido; possible values are file, dir, buffer, and list.
facf67fd 756Additional keys can be defined in `ido-completion-map'."
789d1bf0
KS
757 :type 'hook
758 :group 'ido)
759
760(defcustom ido-separator nil
9201cc28 761 "String used by ido to separate the alternatives in the minibuffer.
789d1bf0 762Obsolete. Set 3rd element of `ido-decorations' instead."
610a4f64 763 :type '(choice string (const nil))
789d1bf0
KS
764 :group 'ido)
765
11c238b3 766(defcustom ido-decorations '( "{" "}" " | " " | ..." "[" "]" " [No match]" " [Matched]" " [Not readable]" " [Too big]" " [Confirm]")
9201cc28 767 "List of strings used by ido to display the alternatives in the minibuffer.
632556e4 768There are between 11 and 13 elements in this list:
789d1bf0 7691st and 2nd elements are used as brackets around the prospect list,
a09e21bf 7703rd element is the separator between prospects (ignored if `ido-separator' is set),
789d1bf0
KS
7714th element is the string inserted at the end of a truncated list of prospects,
7725th and 6th elements are used as brackets around the common match string which
773can be completed using TAB,
616e8e5f
JB
7747th element is the string displayed when there are no matches, and
7758th element is displayed if there is a single match (and faces are not used),
7769th element is displayed when the current directory is non-readable,
11c238b3 77710th element is displayed when directory exceeds `ido-max-directory-size',
632556e4
SM
77811th element is displayed to confirm creating new file or buffer.
77912th and 13th elements (if present) are used as brackets around the sole
780remaining completion. If absent, elements 5 and 6 are used instead."
789d1bf0
KS
781 :type '(repeat string)
782 :group 'ido)
783
0523d117
JW
784(defcustom ido-use-virtual-buffers nil
785 "If non-nil, refer to past buffers as well as existing ones.
f9a27d86 786Essentially it works as follows: Say you are visiting a file and
53964682 787the buffer gets cleaned up by midnight.el. Later, you want to
f9a27d86
JW
788switch to that buffer, but find it's no longer open. With
789virtual buffers enabled, the buffer name stays in the buffer
1a140747 790list (using the `ido-virtual' face, and always at the end), and if
f9a27d86
JW
791you select it, it opens the file back up again. This allows you
792to think less about whether recently opened files are still open
793or not. Most of the time you can quit Emacs, restart, and then
794switch to a file buffer that was previously open as if it still
795were.
796 This feature relies upon the `recentf' package, which will be
0523d117 797enabled if this variable is configured to a non-nil value."
f9a27d86 798 :version "24.1"
0523d117
JW
799 :type 'boolean
800 :group 'ido)
801
789d1bf0 802(defcustom ido-use-faces t
9201cc28 803 "Non-nil means use ido faces to highlighting first match, only match and
789d1bf0
KS
804subdirs in the alternatives."
805 :type 'boolean
806 :group 'ido)
807
4b56d0fe 808(defface ido-first-match '((t :weight bold))
9201cc28 809 "Face used by ido for highlighting first match."
789d1bf0
KS
810 :group 'ido)
811
ccba8bb6 812(defface ido-only-match '((((class color))
4b56d0fe
CY
813 :foreground "ForestGreen")
814 (t :slant italic))
9201cc28 815 "Face used by ido for highlighting only match."
789d1bf0
KS
816 :group 'ido)
817
ccba8bb6 818(defface ido-subdir '((((min-colors 88) (class color))
4b56d0fe
CY
819 :foreground "red1")
820 (((class color))
821 :foreground "red")
822 (t :underline t))
9201cc28 823 "Face used by ido for highlighting subdirs in the alternatives."
789d1bf0
KS
824 :group 'ido)
825
4b56d0fe 826(defface ido-virtual '((t :inherit font-lock-builtin-face))
0523d117 827 "Face used by ido for matching virtual buffer names."
f9a27d86 828 :version "24.1"
0523d117
JW
829 :group 'ido)
830
4b56d0fe
CY
831(defface ido-indicator '((((min-colors 88) (class color))
832 :foreground "yellow1" :background "red1" :width condensed)
833 (((class color))
834 :foreground "yellow" :background "red" :width condensed)
835 (t :inverse-video t))
9201cc28 836 "Face used by ido for highlighting its indicators."
789d1bf0
KS
837 :group 'ido)
838
665ed61a 839(defface ido-incomplete-regexp
4b56d0fe 840 '((t :inherit font-lock-warning-face))
665ed61a
KS
841 "Ido face for indicating incomplete regexps."
842 :group 'ido)
843
789d1bf0 844(defcustom ido-make-file-list-hook nil
9201cc28 845 "List of functions to run when the list of matching files is created.
789d1bf0
KS
846Each function on the list may modify the dynamically bound variable
847`ido-temp-list' which contains the current list of matching files."
848 :type 'hook
849 :group 'ido)
850
851(defcustom ido-make-dir-list-hook nil
9201cc28 852 "List of functions to run when the list of matching directories is created.
789d1bf0
KS
853Each function on the list may modify the dynamically bound variable
854`ido-temp-list' which contains the current list of matching directories."
855 :type 'hook
856 :group 'ido)
857
858(defcustom ido-make-buffer-list-hook nil
9201cc28 859 "List of functions to run when the list of matching buffers is created.
789d1bf0
KS
860Each function on the list may modify the dynamically bound variable
861`ido-temp-list' which contains the current list of matching buffer names."
862 :type 'hook
863 :group 'ido)
864
362cdb61 865(defcustom ido-rewrite-file-prompt-functions nil
9201cc28 866 "List of functions to run when the find-file prompt is created.
789d1bf0
KS
867Each function on the list may modify the following dynamically bound
868variables:
337d2b66
RS
869 dirname - the (abbreviated) directory name
870 to be modified by the hook functions
871 max-width - the max width of the resulting dirname; nil means no limit
872 prompt - the basic prompt (e.g. \"Find File: \")
873 literal - the string shown if doing \"literal\" find; set to nil to omit
79164cf4 874 vc-off - the string shown if version control is inhibited; set to nil to omit
337d2b66
RS
875 prefix - either nil or a fixed prefix for the dirname
876
789d1bf0 877The following variables are available, but should not be changed:
a09e21bf 878 `ido-current-directory' - the unabbreviated directory name
337d2b66 879 item - equals `file' or `dir' depending on the current mode."
789d1bf0
KS
880 :type 'hook
881 :group 'ido)
882
362cdb61 883(defvar ido-rewrite-file-prompt-rules nil
fb7ada5f 884 "Alist of rewriting rules for directory names in ido prompts.
362cdb61
KS
885A list of elements of the form (FROM . TO) or (FROM . FUNC), each
886meaning to rewrite the directory name if matched by FROM by either
887substituting the matched string by TO or calling the function FUNC
888with the current directory name as its only argument and using the
889return value as the new directory name. In addition, each FUNC may
890also modify the dynamic variables described for the variable
891`ido-rewrite-file-prompt-functions'.")
789d1bf0
KS
892
893(defcustom ido-completion-buffer "*Ido Completions*"
9201cc28 894 "Name of completion buffer used by ido.
789d1bf0
KS
895Set to nil to disable completion buffers popping up."
896 :type 'string
897 :group 'ido)
898
899(defcustom ido-completion-buffer-all-completions nil
9201cc28 900 "Non-nil means to show all completions in completion buffer.
789d1bf0
KS
901Otherwise, only the current list of matches is shown."
902 :type 'boolean
903 :group 'ido)
904
78f3273a
CY
905(defcustom ido-all-frames 'visible
906 "Argument to pass to `walk-windows' when Ido is finding buffers.
907See documentation of `walk-windows' for useful values."
908 :type '(choice (const :tag "Selected frame only" nil)
909 (const :tag "All existing frames" t)
910 (const :tag "All visible frames" visible)
911 (const :tag "All frames on this terminal" 0))
912 :group 'ido)
789d1bf0
KS
913
914(defcustom ido-minibuffer-setup-hook nil
9201cc28 915 "Ido-specific customization of minibuffer setup.
789d1bf0 916
4837b516 917This hook is run during minibuffer setup if `ido' is active.
789d1bf0
KS
918It is intended for use in customizing ido for interoperation
919with other packages. For instance:
920
71296446 921 \(add-hook 'ido-minibuffer-setup-hook
789d1bf0
KS
922 \(function
923 \(lambda ()
319a586a
JB
924 \(make-local-variable 'max-mini-window-height)
925 \(setq max-mini-window-height 3))))
789d1bf0 926
319a586a 927will constrain Emacs to a maximum minibuffer height of 3 lines when
789d1bf0
KS
928ido is running. Copied from `icomplete-minibuffer-setup-hook'."
929 :type 'hook
930 :group 'ido)
931
940e5099
SM
932(defcustom ido-save-directory-list-file
933 (locate-user-emacs-file "ido.last" ".ido.last")
789d1bf0
KS
934 "File in which the ido state is saved between invocations.
935Variables stored are: `ido-last-directory-list', `ido-work-directory-list',
936`ido-work-file-list', and `ido-dir-file-cache'.
937Must be set before enabling ido mode."
938 :type 'string
939 :group 'ido)
940
941(defcustom ido-read-file-name-as-directory-commands '()
a2cf0212 942 "List of commands which uses `read-file-name' to read a directory name.
789d1bf0 943When `ido-everywhere' is non-nil, the commands in this list will read
616e8e5f 944the directory using `ido-read-directory-name'."
789d1bf0
KS
945 :type '(repeat symbol)
946 :group 'ido)
947
948(defcustom ido-read-file-name-non-ido '()
949 "List of commands which shall not read file names the ido way.
950When `ido-everywhere' is non-nil, the commands in this list will read
616e8e5f 951the file name using normal `read-file-name' style."
789d1bf0
KS
952 :type '(repeat symbol)
953 :group 'ido)
954
b2d4c118
KS
955(defcustom ido-before-fallback-functions '()
956 "List of functions to call before calling a fallback command.
957The fallback command is passed as an argument to the functions."
958 :type 'hook
959 :group 'ido)
960
789d1bf0
KS
961;;; Internal Variables
962
963;; Persistent variables
964
facf67fd 965(defvar ido-completion-map nil
973495ca
KS
966 "Currently active keymap for ido commands.")
967
facf67fd 968(defvar ido-common-completion-map nil
973495ca
KS
969 "Keymap for all ido commands.")
970
facf67fd 971(defvar ido-file-completion-map nil
973495ca
KS
972 "Keymap for ido file commands.")
973
facf67fd 974(defvar ido-file-dir-completion-map nil
973495ca
KS
975 "Keymap for ido file and directory commands.")
976
facf67fd 977(defvar ido-buffer-completion-map nil
973495ca 978 "Keymap for ido buffer commands.")
789d1bf0
KS
979
980(defvar ido-file-history nil
981 "History of files selected using `ido-find-file'.")
982
983(defvar ido-buffer-history nil
984 "History of buffers selected using `ido-switch-buffer'.")
985
789d1bf0 986(defvar ido-last-directory-list nil
362cdb61 987 "List of last selected directory names.
789d1bf0
KS
988See `ido-enable-last-directory-history' for details.")
989
990(defvar ido-work-directory-list nil
362cdb61 991 "List of actual working directory names.
789d1bf0 992The current directory is inserted at the front of this list whenever a
616e8e5f 993file is opened with `ido-find-file' and family.")
789d1bf0
KS
994
995(defvar ido-work-file-list nil
996 "List of actual work file names.
337d2b66
RS
997Opening a file with `ido-find-file' and similar functions
998inserts the current file name (relative to its containing directory)
999at the front of this list.")
789d1bf0
KS
1000
1001(defvar ido-dir-file-cache nil
337d2b66
RS
1002 "List of `file-name-all-completions' results.
1003Each element in the list is of the form (DIR (MTIME) FILE...).")
789d1bf0 1004
69beb26d
KS
1005(defvar ido-ignore-item-temp-list nil
1006 "List of items to ignore in current ido invocation.
616e8e5f 1007Intended to be let-bound by functions which call ido repeatedly.
69beb26d
KS
1008Should never be set permanently.")
1009
789d1bf0
KS
1010;; Temporary storage
1011
1012(defvar ido-eoinput 1
1013 "Point where minibuffer input ends and completion info begins.
1014Copied from `icomplete-eoinput'.")
1015(make-variable-buffer-local 'ido-eoinput)
1016
1017(defvar ido-common-match-string nil
1018 "Stores the string that is common to all matching files.")
1019
1020(defvar ido-rescan nil
1021 "Non-nil means we need to regenerate the list of matching items.")
1022
1023(defvar ido-rotate nil
1024 "Non-nil means we are rotating list of matches.")
1025
1026(defvar ido-text nil
1027 "Stores the users string as it is typed in.")
1028
1029(defvar ido-text-init nil
1030 "The initial string for the users string it is typed in.")
1031
3729cc87
KS
1032(defvar ido-input-stack nil
1033 "Stores the users strings when user hits M-b/M-f.")
1034
789d1bf0
KS
1035(defvar ido-matches nil
1036 "List of files currently matching `ido-text'.")
1037
1038(defvar ido-report-no-match t
a2cf0212 1039 "Report [No Match] when no completions matches `ido-text'.")
789d1bf0 1040
71296446
JB
1041(defvar ido-exit nil
1042 "Flag to monitor how `ido-find-file' exits.
789d1bf0
KS
1043If equal to `takeprompt', we use the prompt as the file name to be
1044selected.")
1045
1046(defvar ido-current-directory nil
616e8e5f 1047 "Current directory for `ido-find-file'.")
789d1bf0
KS
1048
1049(defvar ido-auto-merge-timer nil
1050 "Delay timer for auto merge.")
1051
1052(defvar ido-use-mycompletion-depth 0
71296446 1053 "Non-nil means use `ido' completion feedback.
a09e21bf
JB
1054Is set by ido functions to the current `minibuffer-depth',
1055so that it doesn't interfere with other minibuffer usage.")
789d1bf0 1056
665ed61a
KS
1057(defvar ido-incomplete-regexp nil
1058 "Non-nil if an incomplete regexp is entered.")
789d1bf0 1059
155943b9
KS
1060(defvar ido-initial-position nil
1061 "Non-nil means to explicitly cursor on entry to minibuffer.
1062Value is an integer which is number of chars to right of prompt.")
1063
9caf8a8f
JB
1064(defvar ido-virtual-buffers nil
1065 "List of virtual buffers, that is, past visited files.
1066This is a copy of `recentf-list', pared down and with faces applied.
1067Only used if `ido-use-virtual-buffers' is non-nil.")
1068
789d1bf0
KS
1069;;; Variables with dynamic bindings.
1070;;; Declared here to keep the byte compiler quiet.
1071
db9f395b 1072;; Stores the current ido item type ('file, 'dir, 'buffer, or 'list).
789d1bf0
KS
1073(defvar ido-cur-item)
1074
3d37467b
KS
1075;;; Stores the current default item
1076(defvar ido-default-item)
1077
789d1bf0
KS
1078;; Stores the current list of items that will be searched through.
1079;; The list is ordered, so that the most interesting item comes first,
1080;; although by default, the files visible in the current frame are put
e0143335
LL
1081;; at the end of the list. Created by `ido-make-item-list'.
1082(defvar ido-cur-list)
789d1bf0 1083
db9f395b 1084;; Stores the choice list for ido-completing-read
e0143335 1085(defvar ido-choice-list)
db9f395b 1086
789d1bf0
KS
1087;; Stores the list of items which are ignored when building
1088;; `ido-cur-list'. It is in no specific order.
1089(defvar ido-ignored-list)
1090
a70343bd
KS
1091;; Remember if current directory is non-readable (so we cannot do completion).
1092(defvar ido-directory-nonreadable)
1093
cb65c373
KS
1094;; Remember if current directory is 'huge' (so we don't want to do completion).
1095(defvar ido-directory-too-big)
1096
789d1bf0
KS
1097;; Keep current item list if non-nil.
1098(defvar ido-keep-item-list)
1099
1100;; Process ido-ignore-* lists.
1101(defvar ido-process-ignore-lists)
1102
1103;; Don't process ido-ignore- lists once.
1104(defvar ido-process-ignore-lists-inhibit)
1105
1106;; Buffer from which ido was entered.
1107(defvar ido-entry-buffer)
1108
1109;; Non-nil if matching file must be selected.
1110(defvar ido-require-match)
1111
11c238b3
KS
1112;; Non-nil if we should add [confirm] to prompt
1113(defvar ido-show-confirm-message)
1114
789d1bf0
KS
1115;; Stores a temporary version of the file list being created.
1116(defvar ido-temp-list)
1117
1118;; Non-nil if default list element should be rotated into place.
1119(defvar ido-rotate-temp)
1120
1121;; Stores current index in ido-work-directory-list.
1122(defvar ido-work-directory-index)
1123
1124;; Stores current index in ido-work-file-list.
1125(defvar ido-work-file-index)
1126
1127;; Set when merged work directory list is in use.
1128(defvar ido-use-merged-list)
1129
1130;; Set when merged work directory list not yet built.
1131(defvar ido-try-merged-list)
1132
1133;; Saved state prior to last work directory merge.
1134;; Value is a list (ido-text dir cur-list ignored-list matches).
1135(defvar ido-pre-merge-state)
1136
310682e6
KS
1137;; Original value of vc-handled-backends for use in ido-toggle-vc.
1138(defvar ido-saved-vc-hb)
789d1bf0
KS
1139
1140;; Stores temporary state of literal find file.
1141(defvar ido-find-literal)
1142
db9f395b
KS
1143;; Set to 'ignore to inhibit switching between find-file/switch-buffer.
1144(defvar ido-context-switch-command)
789d1bf0 1145
06b60517
JB
1146;; Dynamically bound in ido-read-internal.
1147(defvar ido-completing-read)
1148
789d1bf0
KS
1149;;; FUNCTIONS
1150
1151(defun ido-active (&optional merge)
1152 (if merge
1153 ido-use-merged-list
cba9a3a5
KS
1154 (and (boundp 'ido-completing-read)
1155 (or (featurep 'xemacs)
1156 (= ido-use-mycompletion-depth (minibuffer-depth))))))
789d1bf0
KS
1157
1158(defvar ido-trace-enable nil)
1159
1160(defun ido-trace (p &optional s retval)
1161 (if ido-trace-enable
1162 (let ((b (get-buffer-create " *IDO Trace*"))
1163 (deactivate-mark deactivate-mark))
1164 (save-excursion
1165 (save-restriction
1166 (set-buffer b)
1167 (insert p ": " (if (stringp s) s (format "%S" s)) "\n")))))
1168 retval)
1169
1170(defun ido-toggle-trace (arg)
1171 (interactive "P")
1172 (setq ido-trace-enable (or arg (not ido-trace-enable)))
bad111c2
KS
1173 (if ido-trace-enable
1174 (message "IDO trace on"))
789d1bf0
KS
1175 (let ((b (get-buffer " *IDO Trace*")))
1176 (if b
1177 (if ido-trace-enable
1178 (kill-buffer b)
bad111c2
KS
1179 (pop-to-buffer b t t)
1180 (setq truncate-lines t)))))
1181
10b19e88
KS
1182(defun ido-local-file-exists-p (file)
1183 "Tell if FILE exists locally."
1184 (let (file-name-handler-alist)
1185 (file-exists-p file)))
1186
4c2ee078
KS
1187(defun ido-unc-hosts (&optional query)
1188 "Return list of UNC host names."
b97f1994
KS
1189 (let ((hosts
1190 (cond
1191 ((listp ido-unc-hosts)
1192 ido-unc-hosts) ;; static list or nil
1193 ((listp ido-unc-hosts-cache)
1194 ido-unc-hosts-cache) ;; result of net search
1195 ((and query (fboundp ido-unc-hosts))
1196 (message (propertize "Searching for UNC hosts..." 'face 'highlight))
1197 (setq ido-unc-hosts-cache (funcall ido-unc-hosts))
1198 (message nil)
1199 ido-unc-hosts-cache)
1200 (query
1201 (setq ido-unc-hosts-cache nil))
1202 (t (fboundp ido-unc-hosts)))))
1203 (when query
1204 (let ((case-fold-search ido-downcase-unc-hosts)
1205 res host re-list re)
1206 (while hosts
1207 (setq host (car hosts)
1208 hosts (cdr hosts)
1209 re-list (and ido-process-ignore-lists
1210 ido-ignore-unc-host-regexps))
1211 (while re-list
1212 (setq re (car re-list)
1213 re-list (cdr re-list))
1214 (if (string-match re host)
1215 (setq re-list nil
1216 host nil)))
1217 (when host
1218 (when ido-downcase-unc-hosts
1219 (setq host (downcase host)))
1220 (setq res (cons host res))))
1221 (setq hosts (sort res #'string<))))
1222 hosts))
4c2ee078
KS
1223
1224(defun ido-unc-hosts-net-view ()
1225 "Query network for list of UNC host names using `NET VIEW'."
1226 (let (hosts)
1227 (with-temp-buffer
1228 (shell-command "net view" t)
1229 (goto-char (point-min))
1230 (while (re-search-forward "^\\\\\\\\\\([[:graph:]]+\\)" nil t)
1231 (setq hosts (cons (match-string 1) hosts))))
1232 hosts))
1233
bad111c2 1234(defun ido-is-tramp-root (&optional dir)
bad111c2 1235 (and ido-enable-tramp-completion
c577a4d2
KS
1236 (string-match "\\`/[^/]+[@:]\\'"
1237 (or dir ido-current-directory))))
789d1bf0 1238
dfebc0ae 1239(defun ido-is-unc-root (&optional dir)
4c2ee078 1240 (and (ido-unc-hosts)
dfebc0ae
KS
1241 (string-equal "//"
1242 (or dir ido-current-directory))))
1243
1244(defun ido-is-unc-host (&optional dir)
4c2ee078 1245 (and (ido-unc-hosts)
dfebc0ae
KS
1246 (string-match "\\`//[^/]+/\\'"
1247 (or dir ido-current-directory))))
1248
789d1bf0
KS
1249(defun ido-is-root-directory (&optional dir)
1250 (setq dir (or dir ido-current-directory))
bad111c2
KS
1251 (or
1252 (string-equal "/" dir)
1253 (and (memq system-type '(windows-nt ms-dos))
1254 (string-match "\\`[a-zA-Z]:[/\\]\\'" dir))
1255 (if ido-enable-tramp-completion
1256 (ido-is-tramp-root dir)
1257 (string-match "\\`/[^:/][^:/]+:\\'" dir))))
789d1bf0
KS
1258
1259(defun ido-is-ftp-directory (&optional dir)
71296446 1260 (string-match
bad111c2
KS
1261 (if ido-enable-tramp-completion
1262 "\\`/[^/:][^/:]+:" ;; like tramp-file-name-regexp-unified, but doesn't match single drive letters
1263 "\\`/[^/:][^/:]+:/")
1264 (or dir ido-current-directory)))
789d1bf0
KS
1265
1266(defun ido-is-slow-ftp-host (&optional dir)
1267 (and (or ido-slow-ftp-hosts ido-slow-ftp-host-regexps)
1268 (setq dir (or dir ido-current-directory))
1269 ;; (featurep 'ange-ftp)
1270 ;; (ange-ftp-ftp-name dir)
71296446 1271 (string-match
bad111c2
KS
1272 (if ido-enable-tramp-completion
1273 "\\`/\\([^/]+[@:]\\)*\\([^@/:][^@/:]+\\):"
1274 "\\`/\\([^/:]*@\\)?\\([^@/:][^@/:]+\\):/")
1275 dir)
789d1bf0
KS
1276 (let ((host (substring dir (match-beginning 2) (match-end 2))))
1277 (or (member host ido-slow-ftp-hosts)
1278 (let ((re ido-slow-ftp-host-regexps))
1279 (while (and re (not (string-match (car re) host)))
1280 (setq re (cdr re)))
1281 re)))))
1282
1283(defun ido-time-stamp (&optional time)
1284 ;; Time is a floating point number (fractions of 1 hour)
1285 (setq time (or time (current-time)))
1286 (/ (+ (* (car time) 65536.0) (car (cdr time))) 3600.0))
1287
1288(defun ido-cache-ftp-valid (&optional time)
1289 (and (numberp ido-cache-ftp-work-directory-time)
1290 (> ido-cache-ftp-work-directory-time 0)
1291 (or (not time)
1292 (< (- (ido-time-stamp) time) ido-cache-ftp-work-directory-time))))
1293
dfebc0ae
KS
1294(defun ido-cache-unc-valid (&optional time)
1295 (and (numberp ido-cache-unc-host-shares-time)
1296 (> ido-cache-unc-host-shares-time 0)
1297 (or (not time)
1298 (< (- (ido-time-stamp) time) ido-cache-unc-host-shares-time))))
1299
789d1bf0
KS
1300(defun ido-may-cache-directory (&optional dir)
1301 (setq dir (or dir ido-current-directory))
bad111c2
KS
1302 (cond
1303 ((and (ido-is-root-directory dir)
1304 (or ido-enable-tramp-completion
1305 (memq system-type '(windows-nt ms-dos))))
1306 nil)
dfebc0ae
KS
1307 ((ido-is-unc-host dir)
1308 (ido-cache-unc-valid))
1309 ((ido-is-ftp-directory dir)
1310 (ido-cache-ftp-valid))
821f936d
KS
1311 ((ido-directory-too-big-p dir)
1312 nil)
dfebc0ae 1313 (t t)))
789d1bf0
KS
1314
1315(defun ido-pp (list &optional sep)
1316 (let ((print-level nil) (eval-expression-print-level nil)
1317 (print-length nil) (eval-expression-print-length nil))
1318 (insert "\n;; ----- " (symbol-name list) " -----\n(\n ")
1319 (setq list (symbol-value list))
1320 (while list
1321 (let* ((elt (car list))
1322 (s (if (consp elt) (car elt) elt)))
1323 (if (and (stringp s) (= (length s) 0))
1324 (setq s nil))
1325 (if s
1326 (prin1 elt (current-buffer)))
1327 (if (and (setq list (cdr list)) s)
1328 (insert (or sep "\n ")))))
1329 (insert "\n)\n")))
1330
1331(defun ido-save-history ()
1332 "Save ido history and cache information between sessions."
1333 (interactive)
782ea71a
KS
1334 (when (and ido-last-directory-list ido-save-directory-list-file)
1335 (let ((buf (get-buffer-create " *ido session*"))
d725608c 1336 (version-control 'never))
782ea71a
KS
1337 (unwind-protect
1338 (with-current-buffer buf
1339 (erase-buffer)
efccebb5 1340 (insert ";;; -*- coding: utf-8 -*-\n")
d725608c 1341 (setq buffer-file-coding-system 'utf-8)
782ea71a
KS
1342 (ido-pp 'ido-last-directory-list)
1343 (ido-pp 'ido-work-directory-list)
1344 (ido-pp 'ido-work-file-list)
1345 (ido-pp 'ido-dir-file-cache "\n\n ")
1b00bc64
KS
1346 (if (listp ido-unc-hosts-cache)
1347 (ido-pp 'ido-unc-hosts-cache)
1348 (insert "\n;; ----- ido-unc-hosts-cache -----\nt\n"))
789d1bf0 1349 (write-file ido-save-directory-list-file nil))
782ea71a 1350 (kill-buffer buf)))))
789d1bf0
KS
1351
1352(defun ido-load-history (&optional arg)
1353 "Load ido history and cache information from previous session.
1354With prefix argument, reload history unconditionally."
1355 (interactive "P")
1356 (if (or arg (and ido-save-directory-list-file (not ido-last-directory-list)))
1357 (let ((file (expand-file-name ido-save-directory-list-file))
1358 buf)
1359 (when (file-readable-p file)
782ea71a
KS
1360 (setq buf (get-buffer-create " *ido session*"))
1361 (unwind-protect
1362 (with-current-buffer buf
1363 (erase-buffer)
1364 (insert-file-contents file)
1365 (condition-case nil
1366 (setq ido-last-directory-list (read (current-buffer))
1367 ido-work-directory-list (read (current-buffer))
1368 ido-work-file-list (read (current-buffer))
1b00bc64
KS
1369 ido-dir-file-cache (read (current-buffer))
1370 ido-unc-hosts-cache (read (current-buffer)))
782ea71a
KS
1371 (error nil)))
1372 (kill-buffer buf)))))
789d1bf0
KS
1373 (ido-wash-history))
1374
1375(defun ido-wash-history ()
1376 "Clean-up ido history and cache information.
1377Removes badly formatted data and ignored directories."
1378 (interactive)
1379 ;; Check format of each of our lists, discard bogus elements
1380 (setq ido-last-directory-list
1381 (and (listp ido-last-directory-list)
1382 (let ((l ido-last-directory-list) r)
1383 (while l
1384 (if (and (consp (car l))
1385 (stringp (car (car l)))
1386 (stringp (cdr (car l))))
1387 (setq r (cons (car l) r)))
1388 (setq l (cdr l)))
1389 (nreverse r))))
71296446 1390 (setq ido-work-directory-list
789d1bf0
KS
1391 (and (listp ido-work-directory-list)
1392 (let ((l ido-work-directory-list) r)
1393 (while l
1394 (if (and (stringp (car l))
1395 (or ido-record-ftp-work-directories
1396 (not (ido-is-ftp-directory (car l)))))
1397 (setq r (cons (car l) r)))
1398 (setq l (cdr l)))
1399 (nreverse r))))
71296446 1400 (setq ido-work-file-list
789d1bf0
KS
1401 (and (listp ido-work-file-list)
1402 (let ((l ido-work-file-list) r)
1403 (while l
1404 (if (stringp (car l))
1405 (setq r (cons (car l) r)))
1406 (setq l (cdr l)))
1407 (nreverse r))))
71296446 1408 (setq ido-dir-file-cache
789d1bf0
KS
1409 (and (listp ido-dir-file-cache)
1410 (let ((l ido-dir-file-cache) r)
1411 (while l
1412 (if (and (listp (car l))
1413 (> (length (car l)) 2)
1414 (let ((dir (car (car l)))
1415 (time (car (cdr (car l))))
1416 (files (cdr (cdr (car l)))))
1417 (and
1418 (stringp dir)
1419 (consp time)
dfebc0ae
KS
1420 (cond
1421 ((integerp (car time))
1422 (and (/= (car time) 0)
1423 (integerp (car (cdr time)))
1424 (/= (car (cdr time)) 0)
1425 (ido-may-cache-directory dir)))
1426 ((eq (car time) 'ftp)
1427 (and (numberp (cdr time))
789d1bf0
KS
1428 (ido-is-ftp-directory dir)
1429 (ido-cache-ftp-valid (cdr time))))
dfebc0ae
KS
1430 ((eq (car time) 'unc)
1431 (and (numberp (cdr time))
1432 (ido-is-unc-host dir)
1433 (ido-cache-unc-valid (cdr time))))
1434 (t nil))
789d1bf0
KS
1435 (let ((s files) (ok t))
1436 (while s
1437 (if (stringp (car s))
1438 (setq s (cdr s))
1439 (setq s nil ok nil)))
1440 ok))))
1441 (setq r (cons (car l) r)))
1442 (setq l (cdr l)))
1443 (nreverse r))))
1444
1445 ;; Remove ignored directories from work directory list
1446 ;; according to ido-work-directory-list-ignore-regexps
1447 (if ido-work-directory-list
1448 (let ((dirs (reverse ido-work-directory-list)))
1449 (setq ido-work-directory-list nil)
1450 (while dirs
1451 (ido-record-work-directory (car dirs))
1452 (setq dirs (cdr dirs)))))
1453 ;; Get rid of text properties
1454 (let ((l ido-last-directory-list) e)
1455 (while l
1456 (setq e (car l) l (cdr l))
1457 (set-text-properties 0 (length (car e)) nil (car e))
1458 (set-text-properties 0 (length (cdr e)) nil (cdr e))))
1459 (let ((l ido-work-directory-list) e)
1460 (while l
1461 (setq e (car l) l (cdr l))
1462 (set-text-properties 0 (length e) nil e)))
1463 (let ((l ido-work-file-list) e)
1464 (while l
1465 (setq e (car l) l (cdr l))
1466 (set-text-properties 0 (length e) nil e)))
1467 (let ((l ido-dir-file-cache) e d)
1468 (while l
1469 (setq e (car l) l (cdr l))
1470 (if (listp e)
1471 (while e
1472 (setq d (car e) e (cdr e))
1473 (if (not (consp d))
973495ca 1474 (set-text-properties 0 (length d) nil d)))))))
789d1bf0
KS
1475
1476
1477(defun ido-kill-emacs-hook ()
1478 ;; ido kill emacs hook
1479 (ido-save-history))
1480
0fdd1db7 1481(defun ido-common-initialization ()
bd794450
LL
1482 (ido-init-completion-maps)
1483 (add-hook 'minibuffer-setup-hook 'ido-minibuffer-setup)
1484 (add-hook 'choose-completion-string-functions 'ido-choose-completion-string))
1485
e78e280d 1486(define-minor-mode ido-everywhere
06e21633
CY
1487 "Toggle use of Ido for all buffer/file reading.
1488With a prefix argument ARG, enable this feature if ARG is
1489positive, and disable it otherwise. If called from Lisp, enable
1490the mode if ARG is omitted or nil."
e78e280d
SM
1491 :global t
1492 :group 'ido
1493 (when (get 'ido-everywhere 'file)
1494 (setq read-file-name-function (car (get 'ido-everywhere 'file)))
1495 (put 'ido-everywhere 'file nil))
1496 (when (get 'ido-everywhere 'buffer)
1497 (setq read-buffer-function (car (get 'ido-everywhere 'buffer)))
1498 (put 'ido-everywhere 'buffer nil))
1499 (when ido-everywhere
1500 (when (memq ido-mode '(both file))
1501 (put 'ido-everywhere 'file (cons read-file-name-function nil))
1502 (setq read-file-name-function 'ido-read-file-name))
1503 (when (memq ido-mode '(both buffer))
1504 (put 'ido-everywhere 'buffer (cons read-buffer-function nil))
1505 (setq read-buffer-function 'ido-read-buffer))))
1506
789d1bf0
KS
1507(defvar ido-minor-mode-map-entry nil)
1508
1509;;;###autoload
b0df3884 1510(defun ido-mode (&optional arg)
cead857b
CS
1511 "Toggle ido mode on or off.
1512With ARG, turn ido-mode on if arg is positive, off otherwise.
b0df3884
KS
1513Turning on ido-mode will remap (via a minor-mode keymap) the default
1514keybindings for the `find-file' and `switch-to-buffer' families of
1515commands to the ido versions of these functions.
1516However, if ARG arg equals 'files, remap only commands for files, or
1517if it equals 'buffers, remap only commands for buffer switching.
789d1bf0
KS
1518This function also adds a hook to the minibuffer."
1519 (interactive "P")
1520 (setq ido-mode
71296446 1521 (cond
789d1bf0
KS
1522 ((null arg) (if ido-mode nil 'both))
1523 ((eq arg t) 'both)
1524 ((eq arg 'files) 'file)
1525 ((eq arg 'buffers) 'buffer)
1526 ((memq arg '(file buffer both)) arg)
1527 ((> (prefix-numeric-value arg) 0) 'both)
1528 (t nil)))
1529
1530 (ido-everywhere (if ido-everywhere 1 -1))
1531
1532 (when ido-mode
0fdd1db7 1533 (ido-common-initialization)
789d1bf0
KS
1534 (ido-load-history)
1535
1536 (add-hook 'kill-emacs-hook 'ido-kill-emacs-hook)
1537
facf67fd 1538 (let ((map (make-sparse-keymap)))
789d1bf0
KS
1539 (when (memq ido-mode '(file both))
1540 (define-key map [remap find-file] 'ido-find-file)
1541 (define-key map [remap find-file-read-only] 'ido-find-file-read-only)
1542 (define-key map [remap find-alternate-file] 'ido-find-alternate-file)
1543 (define-key map [remap write-file] 'ido-write-file)
1544 (define-key map [remap insert-file] 'ido-insert-file)
1545 (define-key map [remap list-directory] 'ido-list-directory)
1546 (define-key map [remap dired] 'ido-dired)
e78e280d
SM
1547 (define-key map [remap find-file-other-window]
1548 'ido-find-file-other-window)
1549 (define-key map [remap find-file-read-only-other-window]
1550 'ido-find-file-read-only-other-window)
1551 (define-key map [remap find-file-other-frame]
1552 'ido-find-file-other-frame)
1553 (define-key map [remap find-file-read-only-other-frame]
1554 'ido-find-file-read-only-other-frame))
789d1bf0
KS
1555
1556 (when (memq ido-mode '(buffer both))
1557 (define-key map [remap switch-to-buffer] 'ido-switch-buffer)
e78e280d
SM
1558 (define-key map [remap switch-to-buffer-other-window]
1559 'ido-switch-buffer-other-window)
1560 (define-key map [remap switch-to-buffer-other-frame]
1561 'ido-switch-buffer-other-frame)
789d1bf0
KS
1562 (define-key map [remap insert-buffer] 'ido-insert-buffer)
1563 (define-key map [remap kill-buffer] 'ido-kill-buffer)
facf67fd
KS
1564 (define-key map [remap display-buffer] 'ido-display-buffer))
1565
1566 (if ido-minor-mode-map-entry
1567 (setcdr ido-minor-mode-map-entry map)
1568 (setq ido-minor-mode-map-entry (cons 'ido-mode map))
7ff90407
CY
1569 (add-to-list 'minor-mode-map-alist ido-minor-mode-map-entry))))
1570
92f2affc
LMI
1571 (when (called-interactively-p 'any)
1572 (message "Ido mode %s" (if ido-mode "enabled" "disabled"))))
facf67fd 1573
789d1bf0 1574
71296446 1575;;; IDO KEYMAP
facf67fd
KS
1576(defun ido-init-completion-maps ()
1577 "Set up the completion keymaps used by `ido'."
789d1bf0 1578
973495ca
KS
1579 ;; Common map
1580 (let ((map (make-sparse-keymap)))
789d1bf0
KS
1581 (define-key map "\C-a" 'ido-toggle-ignore)
1582 (define-key map "\C-c" 'ido-toggle-case)
1583 (define-key map "\C-e" 'ido-edit-input)
1584 (define-key map "\t" 'ido-complete)
030fa15b 1585 (define-key map " " 'ido-complete-space)
789d1bf0
KS
1586 (define-key map "\C-j" 'ido-select-text)
1587 (define-key map "\C-m" 'ido-exit-minibuffer)
1588 (define-key map "\C-p" 'ido-toggle-prefix)
1589 (define-key map "\C-r" 'ido-prev-match)
1590 (define-key map "\C-s" 'ido-next-match)
d7e76a89
J
1591 (define-key map [?\C-.] 'ido-next-match)
1592 (define-key map [?\C-,] 'ido-prev-match)
789d1bf0
KS
1593 (define-key map "\C-t" 'ido-toggle-regexp)
1594 (define-key map "\C-z" 'ido-undo-merge-work-directory)
bf67f27b 1595 (define-key map [(control ?\s)] 'ido-restrict-to-matches)
a3f4d4d4 1596 (define-key map [(meta ?\s)] 'ido-take-first-match)
08bfde76 1597 (define-key map [(control ?@)] 'ido-restrict-to-matches)
789d1bf0
KS
1598 (define-key map [right] 'ido-next-match)
1599 (define-key map [left] 'ido-prev-match)
1600 (define-key map "?" 'ido-completion-help)
ae9d279d
KS
1601 ;; Magic commands.
1602 (define-key map "\C-b" 'ido-magic-backward-char)
1603 (define-key map "\C-f" 'ido-magic-forward-char)
1604 (define-key map "\C-d" 'ido-magic-delete-char)
973495ca 1605 (set-keymap-parent map minibuffer-local-map)
facf67fd 1606 (setq ido-common-completion-map map))
973495ca
KS
1607
1608 ;; File and directory map
1609 (let ((map (make-sparse-keymap)))
1610 (define-key map "\C-x\C-b" 'ido-enter-switch-buffer)
1611 (define-key map "\C-x\C-f" 'ido-fallback-command)
1612 (define-key map "\C-x\C-d" 'ido-enter-dired)
1613 (define-key map [down] 'ido-next-match-dir)
1614 (define-key map [up] 'ido-prev-match-dir)
1615 (define-key map [(meta up)] 'ido-prev-work-directory)
1616 (define-key map [(meta down)] 'ido-next-work-directory)
1617 (define-key map [backspace] 'ido-delete-backward-updir)
1618 (define-key map "\d" 'ido-delete-backward-updir)
87498551 1619 (define-key map [remap delete-backward-char] 'ido-delete-backward-updir) ; BS
542b315f
KS
1620 (define-key map [remap backward-kill-word] 'ido-delete-backward-word-updir) ; M-DEL
1621
973495ca
KS
1622 (define-key map [(control backspace)] 'ido-up-directory)
1623 (define-key map "\C-l" 'ido-reread-directory)
1624 (define-key map [(meta ?d)] 'ido-wide-find-dir-or-delete-dir)
1625 (define-key map [(meta ?b)] 'ido-push-dir)
a3f4d4d4 1626 (define-key map [(meta ?v)] 'ido-push-dir-first)
973495ca
KS
1627 (define-key map [(meta ?f)] 'ido-wide-find-file-or-pop-dir)
1628 (define-key map [(meta ?k)] 'ido-forget-work-directory)
1629 (define-key map [(meta ?m)] 'ido-make-directory)
1630 (define-key map [(meta ?n)] 'ido-next-work-directory)
1631 (define-key map [(meta ?o)] 'ido-prev-work-file)
1632 (define-key map [(meta control ?o)] 'ido-next-work-file)
1633 (define-key map [(meta ?p)] 'ido-prev-work-directory)
1634 (define-key map [(meta ?s)] 'ido-merge-work-directories)
facf67fd
KS
1635 (set-keymap-parent map ido-common-completion-map)
1636 (setq ido-file-dir-completion-map map))
973495ca
KS
1637
1638 ;; File only map
1639 (let ((map (make-sparse-keymap)))
1640 (define-key map "\C-k" 'ido-delete-file-at-head)
1641 (define-key map "\C-o" 'ido-copy-current-word)
1642 (define-key map "\C-w" 'ido-copy-current-file-name)
1643 (define-key map [(meta ?l)] 'ido-toggle-literal)
facf67fd
KS
1644 (set-keymap-parent map ido-file-dir-completion-map)
1645 (setq ido-file-completion-map map))
973495ca
KS
1646
1647 ;; Buffer map
1648 (let ((map (make-sparse-keymap)))
1649 (define-key map "\C-x\C-f" 'ido-enter-find-file)
1650 (define-key map "\C-x\C-b" 'ido-fallback-command)
1651 (define-key map "\C-k" 'ido-kill-buffer-at-head)
c5cbeb12 1652 (define-key map "\C-o" 'ido-toggle-virtual-buffers)
facf67fd
KS
1653 (set-keymap-parent map ido-common-completion-map)
1654 (setq ido-buffer-completion-map map)))
ae9d279d 1655
789d1bf0 1656
facf67fd 1657(defun ido-setup-completion-map ()
973495ca 1658 "Set up the keymap for `ido'."
789d1bf0 1659
973495ca
KS
1660 ;; generated every time so that it can inherit new functions.
1661 (let ((map (make-sparse-keymap))
1662 (viper-p (if (boundp 'viper-mode) viper-mode)))
789d1bf0 1663
973495ca
KS
1664 (when viper-p
1665 (define-key map [remap viper-intercept-ESC-key] 'ignore))
1666
1667 (cond
1668 ((memq ido-cur-item '(file dir))
1669 (when ido-context-switch-command
1670 (define-key map "\C-x\C-b" ido-context-switch-command)
1671 (define-key map "\C-x\C-d" 'ignore))
1672 (when viper-p
9f781d7e
KS
1673 (define-key map [remap viper-backward-char] 'ido-delete-backward-updir)
1674 (define-key map [remap viper-del-backward-char-in-insert] 'ido-delete-backward-updir)
973495ca
KS
1675 (define-key map [remap viper-delete-backward-word] 'ido-delete-backward-word-updir))
1676 (set-keymap-parent map
1677 (if (eq ido-cur-item 'file)
facf67fd
KS
1678 ido-file-completion-map
1679 ido-file-dir-completion-map)))
973495ca
KS
1680
1681 ((eq ido-cur-item 'buffer)
1682 (when ido-context-switch-command
1683 (define-key map "\C-x\C-f" ido-context-switch-command))
facf67fd 1684 (set-keymap-parent map ido-buffer-completion-map))
973495ca
KS
1685
1686 (t
facf67fd 1687 (set-keymap-parent map ido-common-completion-map)))
f0a73ccc 1688
facf67fd 1689 (setq ido-completion-map map)))
789d1bf0
KS
1690
1691(defun ido-final-slash (dir &optional fix-it)
1692 ;; return DIR if DIR has final slash.
1693 ;; else if FIX-IT is non-nil, return DIR/
1694 ;; else return nil.
1695 (setq dir (ido-name dir))
1696 (cond
1697 ((string-match "/\\'" dir) dir)
bad111c2 1698 ((ido-is-tramp-root dir) dir)
789d1bf0
KS
1699 (fix-it (concat dir "/"))
1700 (t nil)))
1701
310682e6
KS
1702(defun ido-no-final-slash (s)
1703 ;; Remove optional final slash from string S
1704 (let ((l (1- (length s))))
1705 (if (and (> l 0) (eq (aref s l) ?/))
1706 (substring s 0 l)
1707 s)))
1708
866f2239
KS
1709(defun ido-nonreadable-directory-p (dir)
1710 ;; Return t if dir is a directory, but not readable
1711 ;; Do not check for non-readable directories via tramp, as this causes a premature
e4769531 1712 ;; connect on incomplete tramp paths (after entering just method:).
866f2239
KS
1713 (let ((ido-enable-tramp-completion nil))
1714 (and (ido-final-slash dir)
dfebc0ae 1715 (not (ido-is-unc-host dir))
866f2239
KS
1716 (file-directory-p dir)
1717 (not (file-readable-p dir)))))
1718
cb65c373
KS
1719(defun ido-directory-too-big-p (dir)
1720 ;; Return t if dir is a directory, but too big to show
1721 ;; Do not check for non-readable directories via tramp, as this causes a premature
e4769531 1722 ;; connect on incomplete tramp paths (after entering just method:).
cb65c373
KS
1723 (let ((ido-enable-tramp-completion nil))
1724 (and (numberp ido-max-directory-size)
1725 (ido-final-slash dir)
dfebc0ae 1726 (not (ido-is-unc-host dir))
cb65c373 1727 (file-directory-p dir)
ea9a3563 1728 (> (nth 7 (file-attributes (file-truename dir))) ido-max-directory-size))))
cb65c373 1729
789d1bf0
KS
1730(defun ido-set-current-directory (dir &optional subdir no-merge)
1731 ;; Set ido's current directory to DIR or DIR/SUBDIR
c577a4d2
KS
1732 (unless (and ido-enable-tramp-completion
1733 (string-match "\\`/[^/]*@\\'" dir))
1734 (setq dir (ido-final-slash dir t)))
789d1bf0
KS
1735 (setq ido-use-merged-list nil
1736 ido-try-merged-list (not no-merge))
c577a4d2
KS
1737 (when subdir
1738 (setq dir (concat dir subdir))
1739 (unless (and ido-enable-tramp-completion
1740 (string-match "\\`/[^/]*@\\'" dir))
1741 (setq dir (ido-final-slash dir t))))
99fc91fe
AK
1742 (and ido-completion-buffer
1743 (get-buffer ido-completion-buffer)
1744 (kill-buffer ido-completion-buffer))
dfebc0ae
KS
1745 (cond
1746 ((equal dir ido-current-directory)
1747 nil)
1748 ((ido-is-unc-root dir)
1749 (ido-trace "unc" dir)
1750 (setq ido-current-directory dir)
1751 (setq ido-directory-nonreadable nil)
1752 (setq ido-directory-too-big nil)
1753 t)
1754 (t
789d1bf0
KS
1755 (ido-trace "cd" dir)
1756 (setq ido-current-directory dir)
99fc91fe
AK
1757 (and ido-completion-buffer
1758 (get-buffer ido-completion-buffer)
1759 (kill-buffer ido-completion-buffer))
866f2239 1760 (setq ido-directory-nonreadable (ido-nonreadable-directory-p dir))
cb65c373
KS
1761 (setq ido-directory-too-big (and (not ido-directory-nonreadable)
1762 (ido-directory-too-big-p dir)))
dfebc0ae 1763 t)))
789d1bf0
KS
1764
1765(defun ido-set-current-home (&optional dir)
1766 ;; Set ido's current directory to user's home directory
1767 (ido-set-current-directory (expand-file-name (or dir "~/"))))
1768
1769(defun ido-record-command (command arg)
1770 ;; Add (command arg) to command-history if ido-record-commands is t
1771 (if ido-record-commands
1772 (let ((cmd (list command arg)))
1773 (if (or (not command-history)
1774 (not (equal cmd (car command-history))))
1775 (setq command-history (cons cmd command-history))))))
1776
1777(defun ido-make-prompt (item prompt)
1778 ;; Make the prompt for ido-read-internal
1779 (cond
1780 ((and (memq item '(file dir)) ido-current-directory)
362cdb61 1781 (let ((dirname (abbreviate-file-name ido-current-directory))
a42e9704
KS
1782 (max-width (if (and ido-max-file-prompt-width (floatp ido-max-file-prompt-width))
1783 (floor (* (frame-width) ido-max-file-prompt-width))
1784 ido-max-file-prompt-width))
789d1bf0 1785 (literal (and (boundp 'ido-find-literal) ido-find-literal "(literal) "))
310682e6 1786 (vc-off (and ido-saved-vc-hb (not vc-handled-backends) "[-VC] "))
789d1bf0 1787 (prefix nil)
362cdb61 1788 (rule ido-rewrite-file-prompt-rules))
789d1bf0
KS
1789 (let ((case-fold-search nil))
1790 (while rule
1791 (if (and (consp (car rule))
362cdb61
KS
1792 (string-match (car (car rule)) dirname))
1793 (setq dirname
789d1bf0 1794 (if (stringp (cdr (car rule)))
362cdb61
KS
1795 (replace-match (cdr (car rule)) t nil dirname)
1796 (funcall (cdr (car rule)) dirname))))
789d1bf0 1797 (setq rule (cdr rule))))
362cdb61 1798 (run-hooks 'ido-rewrite-file-prompt-functions)
71296446 1799 (concat prompt
789d1bf0
KS
1800 ; (if ido-process-ignore-lists "" "&")
1801 (or literal "")
1802 (or vc-off "")
1803 (or prefix "")
362cdb61 1804 (let ((l (length dirname)))
789d1bf0 1805 (if (and max-width (> max-width 0) (> l max-width))
71296446 1806 (let* ((s (substring dirname (- max-width)))
789d1bf0
KS
1807 (i (string-match "/" s)))
1808 (concat "..." (if i (substring s i) s)))
362cdb61 1809 dirname)))))
789d1bf0
KS
1810 (t prompt)))
1811
1812;; Here is very briefly how ido-find-file works:
1813;;
1814;; (ido-find-file)
1815;; (ido-file-internal method)
1816;; set ido-current-directory
1817;; (ido-read-internal 'file ...)
1818;; (while ...
1819;; (ido-make-item-list ...)
1820;; (ido-set-matches)
1821;; (completing-read ... ido-text-init ...)
1822;;
1823;; ... here user is allowed to type characters and commands
1824;; a command may set ido-exit and call (exit-minibuffer)
1825;; to make ido-read-internal do advanced tasks (or return)
1826;;
1827;; ... ido-tidy and ido-exhibit are pre- and post-hooks
1828;; which are run before and after each user command.
1829;;
1830;; return value from completing-read is stored in ido-final-text
1831;; - ido-exit may cause further actions to be taken:
1832;; 'refresh - repeat loop (make-item-list, set-matches)
1833;; 'edit - edit the prompt string, then repeat loop
1834;; 'keep - repeat loop but don't (re)make-item-list
1835;; 'updir - go up one directory, repeat loop
1836;; else set ido-selected based on ido-final-text,
1837;; optionally update ido-current-directory and repeat loop, or
1838;; exit with the return value of ido-selected (file name)
1839;; selected file name is returned from ido-read-internal,
1840;; ido-exit and method determines what action is taken
1841;; e.g. the file name may be ignored or joined with ido-current-directory, and
1842;; the relevant function is called (find-file, write-file, etc).
1843
7690bdea 1844(defun ido-read-internal (item prompt hist &optional default require-match initial)
a2cf0212 1845 "Perform the `ido-read-buffer' and `ido-read-file-name' functions.
71296446 1846Return the name of a buffer or file selected.
789d1bf0 1847PROMPT is the prompt to give to the user.
2d38f869 1848DEFAULT if given is the default item to start with.
789d1bf0
KS
1849If REQUIRE-MATCH is non-nil, an existing file must be selected.
1850If INITIAL is non-nil, it specifies the initial input string."
1851 (let
1852 ((ido-cur-item item)
1853 (ido-entry-buffer (current-buffer))
1854 (ido-process-ignore-lists t)
1855 (ido-process-ignore-lists-inhibit nil)
1856 (ido-set-default-item t)
1857 ido-default-item
1858 ido-selected
1859 ido-final-text
1860 (done nil)
1861 (icomplete-mode nil) ;; prevent icomplete starting up
1862 ;; Exported dynamic variables:
1863 ido-cur-list
1864 ido-ignored-list
1865 (ido-rotate-temp nil)
1866 (ido-keep-item-list nil)
1867 (ido-use-merged-list nil)
1868 (ido-try-merged-list t)
1869 (ido-pre-merge-state nil)
1870 (ido-case-fold ido-case-fold)
1871 (ido-enable-prefix ido-enable-prefix)
1872 (ido-enable-regexp ido-enable-regexp)
11c238b3 1873 (ido-show-confirm-message nil)
789d1bf0
KS
1874 )
1875
facf67fd 1876 (ido-setup-completion-map)
789d1bf0 1877 (setq ido-text-init initial)
3729cc87
KS
1878 (setq ido-input-stack nil)
1879
1880 (run-hooks 'ido-setup-hook)
1881
789d1bf0 1882 (while (not done)
bad111c2 1883 (ido-trace "\n_LOOP_" ido-text-init)
789d1bf0
KS
1884 (setq ido-exit nil)
1885 (setq ido-rescan t)
1886 (setq ido-rotate nil)
1887 (setq ido-text "")
69beb26d
KS
1888 (when ido-set-default-item
1889 (setq ido-default-item
1890 (cond
1891 ((eq item 'buffer)
1892 (if (bufferp default) (buffer-name default) default))
2d38f869
KS
1893 ((stringp default)
1894 (if (memq item '(file dir))
1895 (file-name-nondirectory default)
1896 default))
69beb26d 1897 ((eq item 'file)
71296446 1898 (and ido-enable-last-directory-history
69beb26d
KS
1899 (let ((d (assoc ido-current-directory ido-last-directory-list)))
1900 (and d (cdr d)))))))
1901 (if (member ido-default-item ido-ignore-item-temp-list)
1902 (setq ido-default-item nil))
5444f278 1903 (ido-trace "new default" ido-default-item)
155943b9
KS
1904 (if ido-default-item
1905 (setq ido-initial-position 0))
69beb26d 1906 (setq ido-set-default-item nil))
789d1bf0
KS
1907
1908 (if ido-process-ignore-lists-inhibit
1909 (setq ido-process-ignore-lists nil))
1910
1911 (if (and ido-use-merged-list (memq ido-try-merged-list '(t wide)) (not ido-keep-item-list))
1912 (let ((olist ido-cur-list)
1913 (oign ido-ignored-list)
1914 (omat ido-matches)
1915 (l (ido-make-merged-file-list ido-text-init
1916 (eq ido-use-merged-list 'auto)
1917 (eq ido-try-merged-list 'wide))))
ec441ab5 1918 (ido-trace "merged" l)
789d1bf0
KS
1919 (cond
1920 ((not l)
1921 (if (eq ido-try-merged-list 'wide)
1922 (setq ido-pre-merge-state
1923 (list "" ido-current-directory olist oign omat)
1924 ido-cur-list nil
1925 ido-ignored-list nil
1926 ido-matches nil
1927 ido-keep-item-list t
1928 ido-try-merged-list (if (eq ido-use-merged-list 'auto) 'auto nil)
1929 ido-use-merged-list nil)
1930 (setq ido-cur-list olist
1931 ido-ignored-list oign
1932 ido-matches omat
1933 ido-keep-item-list t
1934 ido-try-merged-list (if (eq ido-use-merged-list 'auto) 'auto nil)
1935 ido-use-merged-list nil)))
1936 ((eq l t)
1937 (setq ido-use-merged-list nil))
ec441ab5
KS
1938 ((eq l 'input-pending-p)
1939 (setq ido-try-merged-list t
1940 ido-use-merged-list nil))
789d1bf0
KS
1941 (t
1942 (setq ido-pre-merge-state
1943 (list ido-text-init ido-current-directory olist oign omat))
1944 (ido-set-current-directory (car (cdr (car l))))
1945 (if (ido-final-slash ido-text-init)
1946 (setq ido-text-init ""))
1947 (setq ido-cur-list l
1948 ido-ignored-list nil
1949 ido-matches l
1950 ido-rescan nil
1951 ido-keep-item-list t
1952 ido-use-merged-list t)
1953 (ido-trace "Merged" t)
1954 ))))
71296446 1955
789d1bf0
KS
1956 (cond
1957 (ido-keep-item-list
1958 (setq ido-keep-item-list nil
1959 ido-rescan nil))
1960 ((eq ido-cur-item 'file)
1961 (setq ido-ignored-list nil
cb65c373
KS
1962 ido-cur-list (and (not ido-directory-nonreadable)
1963 (not ido-directory-too-big)
1964 (ido-make-file-list ido-default-item))))
789d1bf0
KS
1965 ((eq ido-cur-item 'dir)
1966 (setq ido-ignored-list nil
cb65c373
KS
1967 ido-cur-list (and (not ido-directory-nonreadable)
1968 (not ido-directory-too-big)
1969 (ido-make-dir-list ido-default-item))))
789d1bf0
KS
1970 ((eq ido-cur-item 'buffer)
1971 (setq ido-ignored-list nil
1972 ido-cur-list (ido-make-buffer-list ido-default-item)))
db9f395b
KS
1973 ((eq ido-cur-item 'list)
1974 (setq ido-ignored-list nil
1975 ido-cur-list (ido-make-choice-list ido-default-item)))
789d1bf0
KS
1976 (t nil))
1977 (setq ido-rotate-temp nil)
1978
1979 (if ido-process-ignore-lists-inhibit
1980 (setq ido-process-ignore-lists t
1981 ido-process-ignore-lists-inhibit nil))
1982
1983 (ido-set-matches)
1984 (if (and ido-matches (eq ido-try-merged-list 'auto))
1985 (setq ido-try-merged-list t))
c5b40130
LL
1986 (let ((max-mini-window-height (or ido-max-window-height
1987 (and (boundp 'max-mini-window-height)
1988 max-mini-window-height)))
789d1bf0
KS
1989 (ido-completing-read t)
1990 (ido-require-match require-match)
1991 (ido-use-mycompletion-depth (1+ (minibuffer-depth)))
af896da6
LL
1992 (show-paren-mode nil)
1993 ;; Postpone history adding till later
1994 (history-add-new-input nil))
789d1bf0
KS
1995 ;; prompt the user for the file name
1996 (setq ido-exit nil)
1997 (setq ido-final-text
1998 (catch 'ido
c5b40130
LL
1999 (read-from-minibuffer (ido-make-prompt item prompt)
2000 (prog1 ido-text-init
2001 (setq ido-text-init nil))
7690bdea 2002 ido-completion-map nil hist))))
c5b40130 2003 (ido-trace "read-from-minibuffer" ido-final-text)
99fc91fe
AK
2004 (and ido-completion-buffer
2005 (get-buffer ido-completion-buffer)
2006 (kill-buffer ido-completion-buffer))
789d1bf0
KS
2007
2008 (ido-trace "\n_EXIT_" ido-exit)
2009
2010 (cond
2011 ((eq ido-exit 'refresh)
71296446 2012 (if (and (eq ido-use-merged-list 'auto)
789d1bf0
KS
2013 (or (input-pending-p)))
2014 (setq ido-use-merged-list nil
2015 ido-keep-item-list t))
2016 nil)
2017
2018 ((eq ido-exit 'done)
2019 (setq done t
2020 ido-selected ido-text
2021 ido-exit nil))
2022
2023 ((memq ido-exit '(edit chdir))
71296446 2024 (cond
789d1bf0 2025 ((memq ido-cur-item '(file dir))
3f2b52ad 2026 (let* ((read-file-name-function nil)
789d1bf0
KS
2027 (edit (eq ido-exit 'edit))
2028 (d ido-current-directory)
2029 (f ido-text-init)
84f6c6d0 2030 (new t))
789d1bf0 2031 (setq ido-text-init "")
84f6c6d0
KS
2032 (while new
2033 (setq new (if edit
3729cc87
KS
2034 (condition-case nil
2035 (read-file-name (concat prompt "[EDIT] ")
2036 (expand-file-name d)
2037 (concat d f) nil f)
2038 (quit (concat d f)))
789d1bf0 2039 f)
84f6c6d0
KS
2040 d (or (file-name-directory new) "/")
2041 f (file-name-nondirectory new)
789d1bf0 2042 edit t)
71296446 2043 (if (or
789d1bf0
KS
2044 (file-directory-p d)
2045 (and (yes-or-no-p (format "Create directory %s? " d))
71296446 2046 (condition-case nil
789d1bf0
KS
2047 (progn (make-directory d t) t)
2048 (error
2049 (message "Could not create directory")
2050 (sit-for 1)
2051 nil))))
2052 (progn
2053 (ido-set-current-directory d nil (eq ido-exit 'chdir))
2054 (setq ido-text-init f
84f6c6d0 2055 new nil))))))
789d1bf0 2056 (t
3729cc87
KS
2057 (setq ido-text-init
2058 (condition-case nil
2059 (read-string (concat prompt "[EDIT] ") ido-final-text)
2060 (quit ido-final-text)))))
2061
789d1bf0
KS
2062 nil)
2063
2064 ((eq ido-exit 'keep)
2065 (setq ido-keep-item-list t))
2066
db9f395b 2067 ((memq ido-exit '(dired fallback find-file switch-to-buffer insert-buffer insert-file))
789d1bf0
KS
2068 (setq done t))
2069
3729cc87 2070 ((memq ido-exit '(updir push))
789d1bf0
KS
2071 ;; cannot go up if already at the root-dir (Unix) or at the
2072 ;; root-dir of a certain drive (Windows or MS-DOS).
bad111c2
KS
2073 (if (ido-is-tramp-root)
2074 (when (string-match "\\`\\(/\\([^/]+[:@]\\)*\\)\\([^/]+\\)[:@]\\'" ido-current-directory)
2075 (setq ido-text-init (match-string 3 ido-current-directory))
2076 (ido-set-current-directory (match-string 1 ido-current-directory))
2077 (setq ido-set-default-item t))
2078 (unless (ido-is-root-directory)
3729cc87
KS
2079 (when (eq ido-exit 'push)
2080 (setq ido-input-stack (cons (cons ido-cur-item ido-text) ido-input-stack))
2081 (setq ido-cur-item 'dir)
2082 (setq ido-text-init (file-name-nondirectory (substring ido-current-directory 0 -1)))
2083 (ido-trace "push" ido-input-stack))
bad111c2
KS
2084 (ido-set-current-directory (file-name-directory (substring ido-current-directory 0 -1)))
2085 (setq ido-set-default-item t))))
789d1bf0 2086
3729cc87
KS
2087 ((eq ido-exit 'pop)
2088 (ido-trace "pop" ido-input-stack)
2089 (let ((elt (car ido-input-stack)))
2090 (setq ido-input-stack (cdr ido-input-stack))
2091 (ido-set-current-directory (concat ido-current-directory ido-text))
2092 (setq ido-cur-item (car elt))
2093 (setq ido-text-init (cdr elt))))
2094
2095 ((eq ido-exit 'pop-all)
2096 (ido-trace "pop-all" ido-input-stack)
2097 (while ido-input-stack
2098 (let ((elt (car ido-input-stack)))
2099 (setq ido-input-stack (cdr ido-input-stack))
2100 (ido-set-current-directory (concat ido-current-directory ido-text))
2101 (setq ido-cur-item (car elt))
2102 (setq ido-text-init (cdr elt)))))
2103
789d1bf0 2104 ;; Handling the require-match must be done in a better way.
b3da0db5 2105 ((and require-match
11c238b3 2106 (not (memq require-match '(confirm confirm-after-completion)))
b3da0db5
KS
2107 (not (if ido-directory-too-big
2108 (file-exists-p (concat ido-current-directory ido-final-text))
2109 (ido-existing-item-p))))
a09e21bf 2110 (error "Must specify valid item"))
789d1bf0
KS
2111
2112 (t
2113 (setq ido-selected
69beb26d
KS
2114 (if (or (eq ido-exit 'takeprompt)
2115 (null ido-matches))
2116 ido-final-text
2117 ;; else take head of list
2118 (ido-name (car ido-matches))))
789d1bf0
KS
2119
2120 (cond
2a5095fb 2121 ((memq item '(buffer list))
789d1bf0
KS
2122 (setq done t))
2123
2124 ((string-equal "./" ido-selected)
2125 nil)
2126
2127 ((string-equal "../" ido-selected)
2128 ;; cannot go up if already at the root-dir (Unix) or at the
2129 ;; root-dir of a certain drive (Windows or MS-DOS).
2130 (or (ido-is-root-directory)
2131 (ido-set-current-directory (file-name-directory (substring ido-current-directory 0 -1))))
2132 (setq ido-set-default-item t))
bad111c2 2133
10b19e88
KS
2134 ((and (string-match (if ido-enable-tramp-completion ".[:@]\\'" ".:\\'") ido-selected)
2135 (ido-is-root-directory) ;; Ange-ftp or Tramp
2136 (not (ido-local-file-exists-p ido-selected)))
bad111c2
KS
2137 (ido-set-current-directory ido-current-directory ido-selected)
2138 (ido-trace "tramp prefix" ido-selected)
789d1bf0
KS
2139 (if (ido-is-slow-ftp-host)
2140 (setq ido-exit 'fallback
2141 done t)
2142 (setq ido-set-default-item t)))
dfebc0ae 2143
789d1bf0
KS
2144 ((or (string-match "[/\\][^/\\]" ido-selected)
2145 (and (memq system-type '(windows-nt ms-dos))
10b19e88 2146 (string-match "\\`[a-zA-Z]:" ido-selected)))
789d1bf0
KS
2147 (ido-set-current-directory (file-name-directory ido-selected))
2148 (setq ido-set-default-item t))
2149
2150 ((string-match "\\`~" ido-selected)
2151 (ido-set-current-home ido-selected))
2152
2153 ((ido-final-slash ido-selected)
2154 (if ido-enable-last-directory-history
2155 (let ((x (assoc ido-current-directory ido-last-directory-list)))
2156 (if x
2157 (setcdr x ido-selected)
2158 (setq ido-last-directory-list
2159 (cons (cons ido-current-directory ido-selected) ido-last-directory-list)))))
2160 (ido-set-current-directory ido-current-directory ido-selected)
3729cc87 2161 (if ido-input-stack
11ae5e81
KS
2162 ; automatically pop stack elements which match existing files or directories
2163 (let (elt)
2164 (while (and (setq elt (car ido-input-stack))
2165 (file-exists-p (concat ido-current-directory (cdr elt))))
3729cc87
KS
2166 (if (setq ido-input-stack (cdr ido-input-stack))
2167 (ido-set-current-directory ido-current-directory (cdr elt))
2168 (setq ido-text-init (cdr elt)))
2169 (setq ido-cur-item (car elt))))
2170 (setq ido-set-default-item t)))
789d1bf0
KS
2171
2172 (t
2173 (setq done t))))))
7690bdea
LL
2174 (add-to-history (cond
2175 ((consp hist)
2176 (or (car hist) 'minibuffer-history))
2177 (hist hist)
2178 (t 'minibuffer-history))
2179 ido-selected)
789d1bf0
KS
2180 ido-selected))
2181
2182(defun ido-edit-input ()
155943b9
KS
2183 "Edit absolute file name entered so far with ido; terminate by RET.
2184If cursor is not at the end of the user input, move to end of input."
789d1bf0 2185 (interactive)
155943b9
KS
2186 (if (not (eobp))
2187 (end-of-line)
2188 (setq ido-text-init (if ido-matches (ido-name (car ido-matches)) ido-text))
2189 (setq ido-exit 'edit)
2190 (exit-minibuffer)))
789d1bf0
KS
2191
2192;;; MAIN FUNCTIONS
db9f395b 2193(defun ido-buffer-internal (method &optional fallback prompt default initial switch-cmd)
789d1bf0
KS
2194 ;; Internal function for ido-switch-buffer and friends
2195 (if (not ido-mode)
b2d4c118
KS
2196 (progn
2197 (run-hook-with-args 'ido-before-fallback-functions
2198 (or fallback 'switch-to-buffer))
2199 (call-interactively (or fallback 'switch-to-buffer)))
db9f395b 2200 (let* ((ido-context-switch-command switch-cmd)
cb65c373
KS
2201 (ido-current-directory nil)
2202 (ido-directory-nonreadable nil)
2203 (ido-directory-too-big nil)
5c90fde0 2204 (ido-use-virtual-buffers ido-use-virtual-buffers)
11c238b3
KS
2205 (require-match (confirm-nonexistent-file-or-buffer))
2206 (buf (ido-read-internal 'buffer (or prompt "Buffer: ") 'ido-buffer-history default
0523d117
JW
2207 require-match initial))
2208 filename)
789d1bf0
KS
2209
2210 ;; Choose the buffer name: either the text typed in, or the head
2211 ;; of the list of matches
2212
71296446 2213 (cond
db9f395b 2214 ((eq ido-exit 'find-file)
7d046dbb
KS
2215 (ido-file-internal
2216 (if (memq method '(other-window other-frame)) method ido-default-file-method)
2217 nil nil nil nil ido-text))
789d1bf0 2218
db9f395b
KS
2219 ((eq ido-exit 'insert-file)
2220 (ido-file-internal 'insert 'insert-file nil "Insert file: " nil ido-text 'ido-enter-insert-buffer))
2221
789d1bf0
KS
2222 ((eq ido-exit 'fallback)
2223 (let ((read-buffer-function nil))
16f462c5
KS
2224 (setq this-command (or fallback 'switch-to-buffer))
2225 (run-hook-with-args 'ido-before-fallback-functions this-command)
2226 (call-interactively this-command)))
789d1bf0
KS
2227
2228 ;; Check buf is non-nil.
2229 ((not buf) nil)
69beb26d 2230 ((= (length buf) 0) nil)
789d1bf0
KS
2231
2232 ;; View buffer if it exists
2233 ((get-buffer buf)
16f462c5 2234 (add-to-history 'buffer-name-history buf)
789d1bf0
KS
2235 (if (eq method 'insert)
2236 (progn
2237 (ido-record-command 'insert-buffer buf)
2d13e588
KS
2238 (push-mark
2239 (save-excursion
2240 (insert-buffer-substring (get-buffer buf))
2241 (point))))
789d1bf0
KS
2242 (ido-visit-buffer buf method t)))
2243
0523d117
JW
2244 ;; check for a virtual buffer reference
2245 ((and ido-use-virtual-buffers ido-virtual-buffers
2246 (setq filename (assoc buf ido-virtual-buffers)))
2247 (ido-visit-buffer (find-file-noselect (cdr filename)) method t))
2248
2249 ((and (eq ido-create-new-buffer 'prompt)
2250 (null require-match)
2251 (not (y-or-n-p (format "No buffer matching `%s', create one? " buf))))
2252 nil)
2253
789d1bf0 2254 ;; buffer doesn't exist
11c238b3
KS
2255 ((and (eq ido-create-new-buffer 'never)
2256 (null require-match))
a09e21bf 2257 (message "No buffer matching `%s'" buf))
789d1bf0
KS
2258
2259 ((and (eq ido-create-new-buffer 'prompt)
11c238b3 2260 (null require-match)
789d1bf0
KS
2261 (not (y-or-n-p (format "No buffer matching `%s', create one? " buf))))
2262 nil)
2263
2264 ;; create a new buffer
2265 (t
16f462c5 2266 (add-to-history 'buffer-name-history buf)
789d1bf0
KS
2267 (setq buf (get-buffer-create buf))
2268 (if (fboundp 'set-buffer-major-mode)
2269 (set-buffer-major-mode buf))
2270 (ido-visit-buffer buf method t))))))
2271
789d1bf0
KS
2272(defun ido-record-work-directory (&optional dir)
2273 (when (and (numberp ido-max-work-directory-list) (> ido-max-work-directory-list 0))
2274 (if (and (setq dir (or dir ido-current-directory)) (> (length dir) 0))
2275 (let ((items ido-work-directory-list-ignore-regexps)
2276 (case-fold-search nil))
2277 (while (and items dir)
2278 (if (string-match (car items) dir)
2279 (setq dir nil))
2280 (setq items (cdr items)))
2281 (if dir
2282 (setq ido-work-directory-list (cons dir (delete dir ido-work-directory-list))))))
2283 (if (> (length ido-work-directory-list) ido-max-work-directory-list)
2284 (setcdr (nthcdr (1- ido-max-work-directory-list) ido-work-directory-list) nil))))
2285
2286(defun ido-forget-work-directory ()
2287 (interactive)
2288 (when (and ido-current-directory ido-work-directory-list)
2289 (setq ido-work-directory-list (delete ido-current-directory ido-work-directory-list))
2290 (when ido-use-merged-list
2291 (ido-undo-merge-work-directory)
2292 (setq ido-exit 'refresh
2293 ido-try-merged-list t
2294 ido-use-merged-list t
2295 ido-text-init ido-text
2296 ido-rotate-temp t)
2297 (exit-minibuffer))))
71296446 2298
789d1bf0
KS
2299(defun ido-record-work-file (name)
2300 ;; Save NAME in ido-work-file-list
2301 (when (and (numberp ido-max-work-file-list) (> ido-max-work-file-list 0))
2302 (or
2303 (and ido-work-file-list (equal (car ido-work-file-list) name))
2304 (setq ido-work-file-list (cons name (delete name ido-work-file-list))))
2305 (if (> (length ido-work-file-list) ido-max-work-file-list)
2306 (setcdr (nthcdr (1- ido-max-work-file-list) ido-work-file-list) nil))))
2307
a70343bd
KS
2308(defun ido-expand-directory (dir)
2309 ;; Expand DIR or use DEFAULT-DIRECTORY if nil.
2310 ;; Add final slash to result in case it was missing from DEFAULT-DIRECTORY.
2311 (ido-final-slash (expand-file-name (or dir default-directory)) t))
2312
db9f395b 2313(defun ido-file-internal (method &optional fallback default prompt item initial switch-cmd)
789d1bf0 2314 ;; Internal function for ido-find-file and friends
310682e6
KS
2315 (unless item
2316 (setq item 'file))
94da3cf1
KS
2317 (let ((ido-current-directory (ido-expand-directory default))
2318 (ido-context-switch-command switch-cmd)
83a12f3a 2319 ido-directory-nonreadable ido-directory-too-big
94da3cf1
KS
2320 filename)
2321
2322 (if (or (not ido-mode) (ido-is-slow-ftp-host))
2323 (setq filename t
2324 ido-exit 'fallback)
2325 (setq ido-directory-nonreadable
2326 (ido-nonreadable-directory-p ido-current-directory)
2327 ido-directory-too-big
2328 (and (not ido-directory-nonreadable)
2329 (ido-directory-too-big-p ido-current-directory))))
2330
2331 (when (and (eq item 'file)
310682e6
KS
2332 (or ido-use-url-at-point ido-use-filename-at-point))
2333 (let (fn d)
2334 (require 'ffap)
3808c51f
CY
2335 ;; Duplicate code from ffap-guesser as we want different
2336 ;; behavior for files and URLs.
310682e6 2337 (cond
3729cc87
KS
2338 ((with-no-warnings
2339 (and ido-use-url-at-point
2340 ffap-url-regexp
2341 (ffap-fixup-url (or (ffap-url-at-point)
2342 (ffap-gopher-at-point)))))
310682e6
KS
2343 (setq ido-exit 'ffap
2344 filename t))
2345
2346 ((and ido-use-filename-at-point
004a00f4
DN
2347 (setq fn (with-no-warnings
2348 (if (eq ido-use-filename-at-point 'guess)
2349 (ffap-guesser)
2350 (ffap-string-at-point))))
d81aa76a 2351 (not (string-match "^http:/" fn))
3808c51f
CY
2352 (let ((absolute-fn (expand-file-name fn)))
2353 (setq d (if (file-directory-p absolute-fn)
2354 (file-name-as-directory absolute-fn)
2355 (file-name-directory absolute-fn))))
310682e6
KS
2356 (file-directory-p d))
2357 (setq ido-current-directory d)
94da3cf1 2358 (setq initial (file-name-nondirectory fn))))))
310682e6
KS
2359
2360 (let (ido-saved-vc-hb
2361 (vc-handled-backends (and (boundp 'vc-handled-backends) vc-handled-backends))
789d1bf0
KS
2362 (ido-work-directory-index -1)
2363 (ido-work-file-index -1)
2364 (ido-find-literal nil))
2365
2366 (unless filename
310682e6 2367 (setq ido-saved-vc-hb vc-handled-backends)
d471b4fe
KS
2368 (let ((minibuffer-completing-file-name t))
2369 (setq filename (ido-read-internal item
2370 (or prompt "Find file: ")
033ecf78
KS
2371 'ido-file-history
2372 (and (eq method 'alt-file) buffer-file-name)
11c238b3 2373 (confirm-nonexistent-file-or-buffer) initial))))
789d1bf0
KS
2374
2375 ;; Choose the file name: either the text typed in, or the head
2376 ;; of the list of matches
2377
2378 (cond
2379 ((eq ido-exit 'fallback)
2380 ;; Need to guard setting of default-directory here, since
2381 ;; we don't want to change directory of current buffer.
2382 (let ((default-directory ido-current-directory)
2383 (read-file-name-function nil))
16f462c5
KS
2384 (setq this-command (or fallback 'find-file))
2385 (run-hook-with-args 'ido-before-fallback-functions this-command)
2386 (call-interactively this-command)))
789d1bf0 2387
db9f395b 2388 ((eq ido-exit 'switch-to-buffer)
7d046dbb
KS
2389 (ido-buffer-internal
2390 (if (memq method '(other-window other-frame)) method ido-default-buffer-method)
2391 nil nil nil ido-text))
789d1bf0 2392
db9f395b
KS
2393 ((eq ido-exit 'insert-buffer)
2394 (ido-buffer-internal 'insert 'insert-buffer "Insert buffer: " nil ido-text 'ido-enter-insert-file))
2395
789d1bf0 2396 ((eq ido-exit 'dired)
a9400458
GM
2397 (funcall (cond ((eq method 'other-window) 'dired-other-window)
2398 ((eq method 'other-frame) 'dired-other-frame)
2399 (t 'dired))
2400 (concat ido-current-directory (or ido-text ""))))
789d1bf0 2401
310682e6
KS
2402 ((eq ido-exit 'ffap)
2403 (find-file-at-point))
2404
789d1bf0
KS
2405 ((eq method 'alt-file)
2406 (ido-record-work-file filename)
2407 (setq default-directory ido-current-directory)
2408 (ido-record-work-directory)
2409 (find-alternate-file filename))
2410
2411 ((memq method '(dired list-directory))
2412 (if (equal filename ".")
2413 (setq filename ""))
84f6c6d0
KS
2414 (let* ((dirname (ido-final-slash (concat ido-current-directory filename) t))
2415 (file (substring dirname 0 -1)))
789d1bf0 2416 (cond
84f6c6d0
KS
2417 ((file-directory-p dirname)
2418 (ido-record-command method dirname)
2419 (ido-record-work-directory dirname)
2420 (funcall method dirname))
789d1bf0
KS
2421 ((file-directory-p ido-current-directory)
2422 (cond
2423 ((file-exists-p file)
2424 (ido-record-command method ido-current-directory)
2425 (ido-record-work-directory)
2426 (funcall method ido-current-directory)
2427 (if (eq method 'dired)
3729cc87
KS
2428 (with-no-warnings
2429 (dired-goto-file (expand-file-name file)))))
789d1bf0 2430 ((string-match "[[*?]" filename)
84f6c6d0
KS
2431 (setq dirname (concat ido-current-directory filename))
2432 (ido-record-command method dirname)
789d1bf0 2433 (ido-record-work-directory)
84f6c6d0 2434 (funcall method dirname))
79164cf4 2435 ((y-or-n-p (format "Directory %s does not exist. Create it? " filename))
84f6c6d0
KS
2436 (ido-record-command method dirname)
2437 (ido-record-work-directory dirname)
2438 (make-directory-internal dirname)
2439 (funcall method dirname))
789d1bf0
KS
2440 (t
2441 ;; put make-directory command on history
84f6c6d0 2442 (ido-record-command 'make-directory dirname))))
789d1bf0
KS
2443 (t (error "No such directory")))))
2444
2445 ((eq method 'write)
2446 (ido-record-work-file filename)
2447 (setq default-directory ido-current-directory)
16f462c5
KS
2448 (setq filename (concat ido-current-directory filename))
2449 (ido-record-command 'write-file filename)
2450 (add-to-history 'file-name-history filename)
789d1bf0 2451 (ido-record-work-directory)
395542c6 2452 (write-file filename t))
789d1bf0
KS
2453
2454 ((eq method 'read-only)
2455 (ido-record-work-file filename)
2456 (setq filename (concat ido-current-directory filename))
2457 (ido-record-command fallback filename)
2458 (ido-record-work-directory)
b2d4c118 2459 (run-hook-with-args 'ido-before-fallback-functions fallback)
789d1bf0
KS
2460 (funcall fallback filename))
2461
2462 ((eq method 'insert)
2463 (ido-record-work-file filename)
2464 (setq filename (concat ido-current-directory filename))
71296446 2465 (ido-record-command
789d1bf0
KS
2466 (if ido-find-literal 'insert-file-literally 'insert-file)
2467 filename)
16f462c5 2468 (add-to-history 'file-name-history filename)
789d1bf0 2469 (ido-record-work-directory)
2d13e588
KS
2470 (insert-file-1 filename
2471 (if ido-find-literal
2472 #'insert-file-contents-literally
2473 #'insert-file-contents)))
789d1bf0
KS
2474
2475 (filename
2476 (ido-record-work-file filename)
2477 (setq filename (concat ido-current-directory filename))
2478 (ido-record-command 'find-file filename)
16f462c5 2479 (add-to-history 'file-name-history filename)
789d1bf0
KS
2480 (ido-record-work-directory)
2481 (ido-visit-buffer (find-file-noselect filename nil ido-find-literal) method))))))
2482
2483(defun ido-existing-item-p ()
2484 ;; Return non-nil if there is a matching item
2485 (not (null ido-matches)))
2486
2487;;; COMPLETION CODE
2488
2489(defun ido-set-common-completion ()
2490 ;; Find common completion of `ido-text' in `ido-matches'
2491 ;; The result is stored in `ido-common-match-string'
ccaa42ed
JB
2492 (let (val)
2493 (setq ido-common-match-string nil)
789d1bf0
KS
2494 (if (and ido-matches
2495 (not ido-enable-regexp) ;; testing
2496 (stringp ido-text)
2497 (> (length ido-text) 0))
2498 (if (setq val (ido-find-common-substring ido-matches ido-text))
2499 (setq ido-common-match-string val)))
2500 val))
2501
2502(defun ido-complete ()
2503 "Try and complete the current pattern amongst the file names."
2504 (interactive)
2505 (let (res)
71296446 2506 (cond
665ed61a
KS
2507 (ido-incomplete-regexp
2508 ;; Do nothing
2509 )
789d1bf0
KS
2510 ((and (memq ido-cur-item '(file dir))
2511 (string-match "[$]" ido-text))
2512 (let ((evar (substitute-in-file-name (concat ido-current-directory ido-text))))
2513 (if (not (file-exists-p (file-name-directory evar)))
337d2b66 2514 (message "Expansion generates non-existing directory name")
789d1bf0
KS
2515 (if (file-directory-p evar)
2516 (ido-set-current-directory evar)
2517 (let ((d (or (file-name-directory evar) "/"))
2518 (f (file-name-nondirectory evar)))
2519 (when (file-directory-p d)
2520 (ido-set-current-directory d)
2521 (setq ido-text-init f))))
2522 (setq ido-exit 'refresh)
2523 (exit-minibuffer))))
2524
cb65c373
KS
2525 (ido-directory-too-big
2526 (setq ido-directory-too-big nil)
2527 (setq ido-text-init ido-text)
2528 (setq ido-exit 'refresh)
2529 (exit-minibuffer))
2530
789d1bf0
KS
2531 ((not ido-matches)
2532 (when ido-completion-buffer
d1a0acac 2533 (call-interactively (setq this-command ido-cannot-complete-command))))
71296446 2534
bad111c2
KS
2535 ((and (= 1 (length ido-matches))
2536 (not (and ido-enable-tramp-completion
2537 (string-equal ido-current-directory "/")
10b19e88
KS
2538 (string-match ".[@:]\\'" (ido-name (car ido-matches)))))
2539 (not (ido-local-file-exists-p (ido-name (car ido-matches)))))
789d1bf0 2540 ;; only one choice, so select it.
d81aa76a
KS
2541 (if (not ido-confirm-unique-completion)
2542 (exit-minibuffer)
2543 (setq ido-rescan (not ido-enable-prefix))
2544 (delete-region (minibuffer-prompt-end) (point))
5a1b28a4 2545 (insert (ido-name (car ido-matches)))))
71296446 2546
789d1bf0
KS
2547 (t ;; else there could be some completions
2548 (setq res ido-common-match-string)
2549 (if (and (not (memq res '(t nil)))
2550 (not (equal res ido-text)))
2551 ;; found something to complete, so put it in the minibuffer.
2552 (progn
2553 ;; move exact match to front if not in prefix mode
2554 (setq ido-rescan (not ido-enable-prefix))
2555 (delete-region (minibuffer-prompt-end) (point))
2556 (insert res))
2557 ;; else nothing to complete
d1a0acac 2558 (call-interactively (setq this-command ido-cannot-complete-command))
789d1bf0
KS
2559 )))))
2560
030fa15b
KS
2561(defun ido-complete-space ()
2562 "Try completion unless inserting the space makes sense."
2563 (interactive)
2564 (if (and (stringp ido-common-match-string)
2565 (stringp ido-text)
2566 (cond
2567 ((> (length ido-common-match-string) (length ido-text))
2568 (= (aref ido-common-match-string (length ido-text)) ? ))
2569 (ido-matches
2570 (let (insert-space
2571 (re (concat (regexp-quote ido-text) " "))
2572 (comp ido-matches))
2573 (while comp
2574 (if (string-match re (ido-name (car comp)))
2575 (setq comp nil insert-space t)
2576 (setq comp (cdr comp))))
2577 insert-space))
2578 (t nil)))
2579 (insert " ")
2580 (ido-complete)))
2581
789d1bf0
KS
2582(defun ido-undo-merge-work-directory (&optional text try refresh)
2583 "Undo or redo last ido directory merge operation.
2584If no merge has yet taken place, toggle automatic merging option."
2585 (interactive)
2586 (cond
2587 (ido-pre-merge-state
2588 (ido-set-current-directory (nth 1 ido-pre-merge-state))
2589 (setq ido-text-init (or text (car ido-pre-merge-state))
2590 ido-cur-list (nth 2 ido-pre-merge-state)
2591 ido-ignored-list (nth 3 ido-pre-merge-state)
2592 ido-matches (nth 4 ido-pre-merge-state)
2593 ido-use-merged-list nil
2594 ido-try-merged-list try
2595 ido-keep-item-list (not refresh)
2596 ido-rescan nil
2597 ido-exit 'refresh
2598 ido-pre-merge-state nil)
2599 (exit-minibuffer))
2600 (text
2601 nil)
2602 (ido-try-merged-list
2603 (setq ido-try-merged-list nil))
2604 (ido-matches
2605 (setq ido-try-merged-list t))
2606 ((not ido-use-merged-list)
2607 (ido-merge-work-directories))))
71296446 2608
ae9d279d
KS
2609;;; Magic C-f
2610
a9dbdece 2611(defun ido-magic-forward-char (arg)
ae9d279d 2612 "Move forward in user input or perform magic action.
616e8e5f 2613If no user input is present, or at end of input, perform magic actions:
79164cf4
JB
2614C-x C-b ... C-f switch to `ido-find-file'.
2615C-x C-f ... C-f fallback to non-ido `find-file'.
2616C-x C-d ... C-f fallback to non-ido brief `dired'.
2617C-x d ... C-f fallback to non-ido `dired'."
a9dbdece 2618 (interactive "P")
ae9d279d 2619 (cond
a9dbdece
KS
2620 ((or arg (not (eobp)))
2621 (forward-char (min (prefix-numeric-value arg)
2622 (- (point-max) (point)))))
cc2691b7
KS
2623 ((memq ido-cur-item '(file dir))
2624 (ido-fallback-command))
2625 (ido-context-switch-command
2626 (call-interactively ido-context-switch-command))
2627 ((eq ido-cur-item 'buffer)
2628 (ido-enter-find-file))))
ae9d279d
KS
2629
2630;;; Magic C-b
2631
a9dbdece 2632(defun ido-magic-backward-char (arg)
ae9d279d 2633 "Move backward in user input or perform magic action.
cc2691b7 2634If no user input is present, or at start of input, perform magic actions:
a09e21bf
JB
2635C-x C-f C-b switch to `ido-switch-buffer'.
2636C-x C-d C-b switch to `ido-switch-buffer'.
2637C-x d C-b switch to `ido-switch-buffer'.
2638C-x C-b C-b fallback to non-ido `switch-to-buffer'."
a9dbdece 2639 (interactive "P")
ae9d279d 2640 (cond
a9dbdece
KS
2641 ((or arg (> (point) (minibuffer-prompt-end)))
2642 (forward-char
2643 (- (min (prefix-numeric-value arg)
2644 (- (point) (minibuffer-prompt-end))))))
155943b9
KS
2645 ((eq last-command this-command)
2646 (when (and (memq ido-cur-item '(file dir))
2647 (not (bobp)))
2648 (ido-push-dir))) ; else do nothing
ae9d279d 2649 ((eq ido-cur-item 'buffer)
cc2691b7
KS
2650 (ido-fallback-command))
2651 (ido-context-switch-command
2652 (call-interactively ido-context-switch-command))
2653 (t
2654 (ido-enter-switch-buffer))))
ae9d279d
KS
2655
2656;;; Magic C-d
2657
a9dbdece 2658(defun ido-magic-delete-char (arg)
ae9d279d
KS
2659 "Delete following char in user input or perform magic action.
2660If at end of user input, perform magic actions:
79164cf4 2661C-x C-f ... C-d enter `dired' on current directory."
a9dbdece 2662 (interactive "P")
ae9d279d 2663 (cond
a9dbdece
KS
2664 ((or arg (not (eobp)))
2665 (delete-char (min (prefix-numeric-value arg)
2666 (- (point-max) (point)))))
ae9d279d
KS
2667 (ido-context-switch-command
2668 nil)
2669 ((memq ido-cur-item '(file dir))
2670 (ido-enter-dired))))
2671
2672
789d1bf0
KS
2673;;; TOGGLE FUNCTIONS
2674
2675(defun ido-toggle-case ()
2676 "Toggle the value of `ido-case-fold'."
2677 (interactive)
2678 (setq ido-case-fold (not ido-case-fold))
2679 ;; ask for list to be regenerated.
2680 (setq ido-rescan t))
2681
2682(defun ido-toggle-regexp ()
2683 "Toggle the value of `ido-enable-regexp'."
2684 (interactive)
2685 (setq ido-enable-regexp (not ido-enable-regexp))
2686 ;; ask for list to be regenerated.
2687 (setq ido-rescan t))
2688
2689(defun ido-toggle-prefix ()
2690 "Toggle the value of `ido-enable-prefix'."
2691 (interactive)
2692 (setq ido-enable-prefix (not ido-enable-prefix))
2693 ;; ask for list to be regenerated.
2694 (setq ido-rescan t))
2695
2696(defun ido-toggle-ignore ()
2697 "Toggle ignoring files specified with `ido-ignore-files'."
2698 (interactive)
155943b9
KS
2699 (if (and (not (eobp)) (> (point) (minibuffer-prompt-end)))
2700 (goto-char (minibuffer-prompt-end))
2701 (if ido-directory-too-big
2702 (progn
2703 (message "Reading directory...")
2704 (setq ido-directory-too-big nil))
2705 (setq ido-process-ignore-lists (not ido-process-ignore-lists)))
2706 (setq ido-text-init ido-text)
2707 (setq ido-exit 'refresh)
2708 (exit-minibuffer)))
789d1bf0
KS
2709
2710(defun ido-toggle-vc ()
2711 "Disable version control for this file."
2712 (interactive)
2713 (if (and ido-mode (eq ido-cur-item 'file))
2714 (progn
310682e6
KS
2715 (setq vc-handled-backends
2716 (if vc-handled-backends nil ido-saved-vc-hb))
789d1bf0
KS
2717 (setq ido-text-init ido-text)
2718 (setq ido-exit 'keep)
2719 (exit-minibuffer))))
2720
2721(defun ido-toggle-literal ()
2722 "Toggle literal reading of this file."
2723 (interactive)
2724 (if (and ido-mode (eq ido-cur-item 'file))
2725 (progn
2726 (setq ido-find-literal (not ido-find-literal))
2727 (setq ido-text-init ido-text)
2728 (setq ido-exit 'keep)
2729 (exit-minibuffer))))
2730
c5cbeb12
LL
2731(defun ido-toggle-virtual-buffers ()
2732 "Toggle the use of virtual buffers.
2733See `ido-use-virtual-buffers' for explanation of virtual buffer."
2734 (interactive)
2735 (when (and ido-mode (eq ido-cur-item 'buffer))
2736 (setq ido-use-virtual-buffers (not ido-use-virtual-buffers))
2737 (setq ido-text-init ido-text)
2738 (setq ido-exit 'refresh)
2739 (exit-minibuffer)))
2740
789d1bf0
KS
2741(defun ido-reread-directory ()
2742 "Read current directory again.
2743May be useful if cached version is no longer valid, but directory
2744timestamp has not changed (e.g. with ftp or on Windows)."
2745 (interactive)
ff07e0ac 2746 (if (and ido-mode (memq ido-cur-item '(file dir)))
789d1bf0 2747 (progn
1b00bc64
KS
2748 (if (ido-is-unc-root)
2749 (setq ido-unc-hosts-cache t)
2750 (ido-remove-cached-dir ido-current-directory))
789d1bf0
KS
2751 (setq ido-text-init ido-text)
2752 (setq ido-rotate-temp t)
2753 (setq ido-exit 'refresh)
2754 (exit-minibuffer))))
2755
2756(defun ido-exit-minibuffer ()
2757 "Exit minibuffer, but make sure we have a match if one is needed."
2758 (interactive)
665ed61a 2759 (if (and (or (not ido-require-match)
11c238b3
KS
2760 (if (memq ido-require-match '(confirm confirm-after-completion))
2761 (if (or (eq ido-cur-item 'dir)
2762 (eq last-command this-command))
2763 t
2764 (setq ido-show-confirm-message t)
2765 nil))
665ed61a
KS
2766 (ido-existing-item-p))
2767 (not ido-incomplete-regexp))
3729cc87 2768 (exit-minibuffer)))
789d1bf0
KS
2769
2770(defun ido-select-text ()
2771 "Select the buffer or file named by the prompt.
2772If no buffer or file exactly matching the prompt exists, maybe create a new one."
2773 (interactive)
2774 (setq ido-exit 'takeprompt)
2775 (exit-minibuffer))
2776
2777(defun ido-fallback-command ()
2778 "Fallback to non-ido version of current command."
2779 (interactive)
4260eddd
KS
2780 (let ((i (length ido-text)))
2781 (while (> i 0)
2782 (push (aref ido-text (setq i (1- i))) unread-command-events)))
789d1bf0
KS
2783 (setq ido-exit 'fallback)
2784 (exit-minibuffer))
2785
2786(defun ido-enter-find-file ()
616e8e5f 2787 "Drop into `find-file' from buffer switching."
789d1bf0 2788 (interactive)
db9f395b 2789 (setq ido-exit 'find-file)
789d1bf0
KS
2790 (exit-minibuffer))
2791
2792(defun ido-enter-switch-buffer ()
616e8e5f 2793 "Drop into `ido-switch-buffer' from file switching."
789d1bf0 2794 (interactive)
db9f395b 2795 (setq ido-exit 'switch-to-buffer)
789d1bf0
KS
2796 (exit-minibuffer))
2797
2798(defun ido-enter-dired ()
a09e21bf 2799 "Drop into `dired' from file switching."
789d1bf0
KS
2800 (interactive)
2801 (setq ido-exit 'dired)
2802 (exit-minibuffer))
2803
db9f395b 2804(defun ido-enter-insert-buffer ()
a09e21bf 2805 "Drop into `insert-buffer' from insert file."
db9f395b
KS
2806 (interactive)
2807 (setq ido-exit 'insert-buffer)
2808 (exit-minibuffer))
2809
2810(defun ido-enter-insert-file ()
a09e21bf 2811 "Drop into `insert-file' from insert buffer."
db9f395b
KS
2812 (interactive)
2813 (setq ido-exit 'insert-file)
2814 (exit-minibuffer))
2815
789d1bf0
KS
2816
2817(defun ido-up-directory (&optional clear)
2818 "Go up one directory level."
2819 (interactive "P")
2820 (setq ido-text-init (if clear nil ido-text))
2821 (setq ido-exit 'updir)
2822 (setq ido-rotate-temp t)
2823 (exit-minibuffer))
2824
2825(defun ido-delete-backward-updir (count)
2826 "Delete char backwards, or at beginning of buffer, go up one level."
2827 (interactive "P")
2828 (cond
2829 ((= (minibuffer-prompt-end) (point))
2830 (if (not count)
2831 (ido-up-directory t)))
2832 ((and ido-pre-merge-state (string-equal (car ido-pre-merge-state) ido-text))
2833 (ido-undo-merge-work-directory (substring ido-text 0 -1) t t))
f0a73ccc
KS
2834 ((eq this-original-command 'viper-backward-char)
2835 (funcall this-original-command (prefix-numeric-value count)))
2836 ((eq this-original-command 'viper-del-backward-char-in-insert)
2837 (funcall this-original-command))
789d1bf0 2838 (t
d355a0b7 2839 (delete-char (- (prefix-numeric-value count))))))
789d1bf0
KS
2840
2841(defun ido-delete-backward-word-updir (count)
2842 "Delete all chars backwards, or at beginning of buffer, go up one level."
2843 (interactive "P")
2844 (if (= (minibuffer-prompt-end) (point))
2845 (if (not count)
2846 (ido-up-directory t))
f0a73ccc
KS
2847 (if (eq this-original-command 'viper-delete-backward-word)
2848 (funcall this-original-command (prefix-numeric-value count))
2849 (backward-kill-word (prefix-numeric-value count)))))
789d1bf0
KS
2850
2851(defun ido-get-work-directory (&optional incr must-match)
2852 (let ((n (length ido-work-directory-list))
2853 (i ido-work-directory-index)
2854 (j 0)
2855 dir)
2856 (if (or (not ido-text) (= (length ido-text) 0))
2857 (setq must-match nil))
2858 (while (< j n)
2859 (setq i (+ i incr)
2860 j (1+ j))
2861 (if (> incr 0)
2862 (if (>= i n) (setq i 0))
2863 (if (< i 0) (setq i (1- n))))
2864 (setq dir (nth i ido-work-directory-list))
2865 (if (and dir
2866 (not (equal dir ido-current-directory))
2867 (file-directory-p dir)
2868 (or (not must-match)
cb65c373 2869 ;; TODO. check for nonreadable and too-big.
ec441ab5 2870 (ido-set-matches-1
789d1bf0 2871 (if (eq ido-cur-item 'file)
ec441ab5
KS
2872 (ido-make-file-list-1 dir)
2873 (ido-make-dir-list-1 dir)))))
789d1bf0
KS
2874 (setq j n)
2875 (setq dir nil)))
2876 (if dir
2877 (setq ido-work-directory-index i))
2878 dir))
2879
2880(defun ido-prev-work-directory ()
2881 "Change to next working directory in list."
2882 (interactive)
2883 (let ((dir (ido-get-work-directory 1 ido-work-directory-match-only)))
2884 (when dir
2885 (ido-set-current-directory dir)
2886 (setq ido-exit 'refresh)
2887 (setq ido-text-init ido-text)
2888 (setq ido-rotate-temp t)
2889 (exit-minibuffer))))
2890
2891(defun ido-next-work-directory ()
2892 "Change to previous working directory in list."
2893 (interactive)
2894 (let ((dir (ido-get-work-directory -1 ido-work-directory-match-only)))
2895 (when dir
2896 (ido-set-current-directory dir)
2897 (setq ido-exit 'refresh)
2898 (setq ido-text-init ido-text)
2899 (setq ido-rotate-temp t)
2900 (exit-minibuffer))))
2901
2902(defun ido-merge-work-directories ()
2903 "Search (and merge) work directories for files matching the current input string."
2904 (interactive)
2905 (setq ido-use-merged-list t ido-try-merged-list t)
2906 (setq ido-exit 'refresh)
2907 (setq ido-text-init ido-text)
2908 (setq ido-rotate-temp t)
2909 (exit-minibuffer))
2910
2911(defun ido-wide-find-file (&optional file)
2912 "Prompt for FILE to search for using find, starting from current directory."
2913 (interactive)
2914 (unless file
b0df3884
KS
2915 (let ((enable-recursive-minibuffers t))
2916 (setq file
3729cc87
KS
2917 (condition-case nil
2918 (read-string (concat "Wide find file: " ido-current-directory) ido-text)
2919 (quit "")))))
789d1bf0
KS
2920 (when (> (length file) 0)
2921 (setq ido-use-merged-list t ido-try-merged-list 'wide)
2922 (setq ido-exit 'refresh)
2923 (setq ido-text-init file)
2924 (setq ido-rotate-temp t)
2925 (exit-minibuffer)))
2926
2927(defun ido-wide-find-dir (&optional dir)
2928 "Prompt for DIR to search for using find, starting from current directory."
2929 (interactive)
2930 (unless dir
b0df3884
KS
2931 (let ((enable-recursive-minibuffers t))
2932 (setq dir
3729cc87
KS
2933 (condition-case nil
2934 (read-string (concat "Wide find directory: " ido-current-directory) ido-text)
2935 (quit "")))))
789d1bf0
KS
2936 (when (> (length dir) 0)
2937 (setq ido-use-merged-list t ido-try-merged-list 'wide)
2938 (setq ido-exit 'refresh)
2939 (setq ido-text-init (ido-final-slash dir t))
2940 (setq ido-rotate-temp t)
2941 (exit-minibuffer)))
2942
06b60517 2943(defun ido-wide-find-dir-or-delete-dir (&optional _dir)
ae9d279d
KS
2944 "Prompt for DIR to search for using find, starting from current directory.
2945If input stack is non-empty, delete current directory component."
2946 (interactive)
2947 (if ido-input-stack
2948 (ido-delete-backward-word-updir 1)
2949 (ido-wide-find-dir)))
2950
a3f4d4d4
KS
2951(defun ido-take-first-match ()
2952 "Use first matching item as input text."
2953 (interactive)
2954 (when ido-matches
5a1b28a4 2955 (setq ido-text-init (ido-name (car ido-matches)))
a3f4d4d4
KS
2956 (setq ido-exit 'refresh)
2957 (exit-minibuffer)))
2958
3729cc87
KS
2959(defun ido-push-dir ()
2960 "Move to previous directory in file name, push current input on stack."
2961 (interactive)
2962 (setq ido-exit 'push)
2963 (exit-minibuffer))
2964
a3f4d4d4
KS
2965(defun ido-push-dir-first ()
2966 "Move to previous directory in file name, push first match on stack."
2967 (interactive)
2968 (if ido-matches
5a1b28a4 2969 (setq ido-text (ido-name (car ido-matches))))
a3f4d4d4
KS
2970 (setq ido-exit 'push)
2971 (exit-minibuffer))
2972
3729cc87
KS
2973(defun ido-pop-dir (arg)
2974 "Pop directory from input stack back to input.
79164cf4 2975With \\[universal-argument], pop all elements."
3729cc87
KS
2976 (interactive "P")
2977 (when ido-input-stack
2978 (setq ido-exit (if arg 'pop-all 'pop))
2979 (exit-minibuffer)))
2980
2981(defun ido-wide-find-file-or-pop-dir (arg)
2982 (interactive "P")
2983 (if ido-input-stack
2984 (ido-pop-dir arg)
2985 (ido-wide-find-file)))
2986
789d1bf0
KS
2987(defun ido-make-directory (&optional dir)
2988 "Prompt for DIR to create in current directory."
2989 (interactive)
2990 (unless dir
b0df3884
KS
2991 (let ((enable-recursive-minibuffers t))
2992 (setq dir
2993 (read-string (concat "Make directory: " ido-current-directory) ido-text))))
789d1bf0
KS
2994 (when (> (length dir) 0)
2995 (setq dir (concat ido-current-directory dir))
2996 (unless (file-exists-p dir)
2997 (make-directory dir t)
2998 (ido-set-current-directory dir)
2999 (setq ido-exit 'refresh)
3000 (setq ido-text-init nil)
3001 (setq ido-rotate-temp t)
3002 (exit-minibuffer))))
3003
3004(defun ido-get-work-file (incr)
3005 (let ((n (length ido-work-file-list))
3006 (i (+ ido-work-file-index incr))
3007 name)
3008 (if (> incr 0)
3009 (if (>= i n) (setq i 0))
3010 (if (< i 0) (setq i (1- n))))
3011 (setq name (nth i ido-work-file-list))
3012 (setq ido-work-file-index i)
3013 name))
3014
3015(defun ido-prev-work-file ()
3016 "Change to next working file name in list."
3017 (interactive)
3018 (let ((name (ido-get-work-file 1)))
3019 (when name
3020 (setq ido-text-init name)
3021 (setq ido-exit 'refresh)
3022 (exit-minibuffer))))
3023
3024(defun ido-next-work-file ()
3025 "Change to previous working file name in list."
3026 (interactive)
3027 (let ((name (ido-get-work-file -1)))
3028 (when name
3029 (setq ido-text-init name)
3030 (setq ido-exit 'refresh)
3031 (exit-minibuffer))))
3032
3033(defun ido-copy-current-file-name (all)
3034 "Insert file name of current buffer.
3035If repeated, insert text from buffer instead."
3036 (interactive "P")
bac4dbd1
KS
3037 (let* ((bfname (or (buffer-file-name ido-entry-buffer)
3038 (buffer-name ido-entry-buffer)))
84f6c6d0 3039 (name (and bfname (file-name-nondirectory bfname))))
789d1bf0 3040 (when name
71296446
JB
3041 (setq ido-text-init
3042 (if (or all
2490c740 3043 (eq last-command this-command)
84f6c6d0 3044 (not (equal (file-name-directory bfname) ido-current-directory))
789d1bf0
KS
3045 (not (string-match "\\.[^.]*\\'" name)))
3046 name
3047 (substring name 0 (1+ (match-beginning 0)))))
3048 (setq ido-exit 'refresh
3049 ido-try-merged-list nil)
3050 (exit-minibuffer))))
71296446 3051
06b60517 3052(defun ido-copy-current-word (_all)
362cdb61 3053 "Insert current word (file or directory name) from current buffer."
789d1bf0 3054 (interactive "P")
7fdbcd83 3055 (let ((word (with-current-buffer ido-entry-buffer
06b60517 3056 (let ((p (point)) start-line end-line start-name)
1b5929b9
KS
3057 (if (and mark-active (/= p (mark)))
3058 (setq start-name (mark))
3059 (beginning-of-line)
3060 (setq start-line (point))
3061 (end-of-line)
3062 (setq end-line (point))
3063 (goto-char p)
3064 (if (re-search-backward "[^-_a-zA-Z0-9:./\\~@]" start-line 1)
3065 (forward-char 1))
3066 (setq start-name (point))
3067 (re-search-forward "[-_a-zA-Z0-9:./\\~@]*" end-line 1)
3068 (if (= start-name (point))
3069 (setq start-name nil)))
3070 (and start-name
3071 (buffer-substring-no-properties start-name (point)))))))
789d1bf0
KS
3072 (if (cond
3073 ((not word) nil)
3074 ((string-match "\\`[~/]" word)
3075 (setq ido-text-init word
3076 ido-try-merged-list nil
3077 ido-exit 'chdir))
3078 ((string-match "/" word)
3079 (setq ido-text-init (concat ido-current-directory word)
3080 ido-try-merged-list nil
3081 ido-exit 'chdir))
3082 (t
3083 (setq ido-text-init word
3084 ido-try-merged-list nil
3085 ido-exit 'refresh)))
3086 (exit-minibuffer))))
3087
71296446 3088(defun ido-next-match ()
789d1bf0
KS
3089 "Put first element of `ido-matches' at the end of the list."
3090 (interactive)
3091 (if ido-matches
3092 (let ((next (cadr ido-matches)))
3093 (setq ido-cur-list (ido-chop ido-cur-list next))
821f936d
KS
3094 (setq ido-matches (ido-chop ido-matches next))
3095 (setq ido-rescan nil))))
789d1bf0 3096
71296446 3097(defun ido-prev-match ()
789d1bf0
KS
3098 "Put last element of `ido-matches' at the front of the list."
3099 (interactive)
3100 (if ido-matches
3101 (let ((prev (car (last ido-matches))))
3102 (setq ido-cur-list (ido-chop ido-cur-list prev))
821f936d
KS
3103 (setq ido-matches (ido-chop ido-matches prev))
3104 (setq ido-rescan nil))))
789d1bf0 3105
71296446 3106(defun ido-next-match-dir ()
789d1bf0
KS
3107 "Find next directory in match list.
3108If work directories have been merged, cycle through directories for
3109first matching file."
3110 (interactive)
3111 (if ido-use-merged-list
3112 (if ido-matches
3113 (let* ((elt (car ido-matches))
3114 (dirs (cdr elt)))
3115 (when (> (length dirs) 1)
3116 (setcdr elt (ido-chop dirs (cadr dirs))))
3117 (setq ido-rescan nil)))
3118 (let ((cnt (length ido-matches))
3119 (i 1))
3120 (while (and (< i cnt) (not (ido-final-slash (nth i ido-matches))))
3121 (setq i (1+ i)))
3122 (if (< i cnt)
3123 (setq ido-cur-list (ido-chop ido-cur-list (nth i ido-matches)))))))
3124
71296446 3125(defun ido-prev-match-dir ()
789d1bf0
KS
3126 "Find previous directory in match list.
3127If work directories have been merged, cycle through directories
3128for first matching file."
3129 (interactive)
3130 (if ido-use-merged-list
3131 (if ido-matches
3132 (let* ((elt (car ido-matches))
3133 (dirs (cdr elt)))
3134 (when (> (length dirs) 1)
3135 (setcdr elt (ido-chop dirs (car (last dirs)))))
3136 (setq ido-rescan nil)))
3137 (let* ((cnt (length ido-matches))
3138 (i (1- cnt)))
3139 (while (and (> i 0) (not (ido-final-slash (nth i ido-matches))))
3140 (setq i (1- i)))
3141 (if (> i 0)
3142 (setq ido-cur-list (ido-chop ido-cur-list (nth i ido-matches)))))))
3143
71296446 3144(defun ido-restrict-to-matches ()
08bfde76
KS
3145 "Set current item list to the currently matched items."
3146 (interactive)
3147 (when ido-matches
3148 (setq ido-cur-list ido-matches
3149 ido-text-init ""
3150 ido-rescan nil
3151 ido-exit 'keep)
3152 (exit-minibuffer)))
3153
789d1bf0 3154(defun ido-chop (items elem)
ea78b95b 3155 "Remove all elements before ELEM and put them at the end of ITEMS."
789d1bf0
KS
3156 (let ((ret nil)
3157 (next nil)
3158 (sofar nil))
3159 (while (not ret)
3160 (setq next (car items))
ea78b95b 3161 (if (equal next elem)
789d1bf0
KS
3162 (setq ret (append items (nreverse sofar)))
3163 ;; else
3164 (progn
3165 (setq items (cdr items))
3166 (setq sofar (cons next sofar)))))
3167 ret))
3168
3169(defun ido-name (item)
3170 ;; Return file name for current item, whether in a normal list
3171 ;; or a merged work directory list.
3172 (if (consp item) (car item) item))
3173
3174
3175;;; CREATE LIST OF ALL CURRENT FILES
3176
3177(defun ido-all-completions ()
da6062e6 3178 ;; Return unsorted list of all completions.
cb65c373
KS
3179 (let ((ido-process-ignore-lists nil)
3180 (ido-directory-too-big nil))
789d1bf0
KS
3181 (cond
3182 ((eq ido-cur-item 'file)
ec441ab5 3183 (ido-make-file-list-1 ido-current-directory))
789d1bf0 3184 ((eq ido-cur-item 'dir)
ec441ab5 3185 (ido-make-dir-list-1 ido-current-directory))
789d1bf0 3186 ((eq ido-cur-item 'buffer)
ec441ab5 3187 (ido-make-buffer-list-1))
db9f395b
KS
3188 ((eq ido-cur-item 'list)
3189 ido-choice-list)
789d1bf0
KS
3190 (t nil))))
3191
3192
1de0ae85
KS
3193;; File list sorting
3194
3195(defun ido-file-lessp (a b)
3196 ;; Simple compare two file names.
3197 (string-lessp (ido-no-final-slash a) (ido-no-final-slash b)))
3198
3199
3200(defun ido-file-extension-lessp (a b)
3201 ;; Compare file names according to ido-file-extensions-order list.
3202 (let ((n (compare-strings a 0 nil b 0 nil nil))
3203 lessp p)
3204 (if (eq n t)
3205 nil
3206 (if (< n 0)
3207 (setq n (1- (- n))
3208 p a a b b p
3209 lessp t)
3210 (setq n (1- n)))
3211 (cond
3212 ((= n 0)
3213 lessp)
3214 ((= (aref a n) ?.)
3215 (ido-file-extension-aux a b n lessp))
3216 (t
3217 (while (and (> n 2) (/= (aref a n) ?.))
3218 (setq n (1- n)))
3219 (if (> n 1)
3220 (ido-file-extension-aux a b n lessp)
3221 lessp))))))
3222
3223(defun ido-file-extension-aux (a b n lessp)
3224 (let ((oa (ido-file-extension-order a n))
3225 (ob (ido-file-extension-order b n)))
3226 (cond
1de0ae85 3227 ((and oa ob)
76a63a6e
KS
3228 (cond
3229 ((= oa ob)
3230 lessp)
3231 (lessp
3232 (> oa ob))
3233 (t
3234 (< oa ob))))
1de0ae85
KS
3235 (oa
3236 (not lessp))
3237 (ob
3238 lessp)
3239 (t
3240 lessp))))
3241
3242(defun ido-file-extension-order (s n)
3243 (let ((l ido-file-extensions-order)
3244 (i 0) o do)
3245 (while l
3246 (cond
3247 ((eq (car l) t)
3248 (setq do i
3249 l (cdr l)))
3250 ((eq (compare-strings s n nil (car l) 0 nil nil) t)
3251 (setq o i
3252 l nil))
3253 (t
3254 (setq l (cdr l))))
3255 (setq i (1+ i)))
3256 (or o do)))
3257
789d1bf0
KS
3258
3259(defun ido-sort-merged-list (items promote)
3260 ;; Input is list of ("file" . "dir") cons cells.
3261 ;; Output is sorted list of ("file "dir" ...) lists
3262 (let ((l (sort items (lambda (a b) (string-lessp (car b) (car a)))))
06b60517 3263 res a cur)
789d1bf0
KS
3264 (while l
3265 (setq a (car l)
3266 l (cdr l))
3267 (if (and res (string-equal (car (car res)) (car a)))
3268 (progn
3269 (setcdr (car (if cur (cdr res) res)) (cons (cdr a) (cdr (car res))))
3270 (if (and promote (string-equal ido-current-directory (cdr a)))
3271 (setq cur t)))
3272 (setq res (cons (list (car a) (cdr a)) res)
3273 cur nil)))
3274 res))
3275
3276(defun ido-wide-find-dirs-or-files (dir file &optional prefix finddir)
3277 ;; As ido-run-find-command, but returns a list of cons pairs ("file" . "dir")
71296446 3278 (let ((filenames
001809f6
GM
3279 (delq nil
3280 (mapcar (lambda (name)
3281 (unless (ido-ignore-item-p name ido-ignore-files t)
3282 name))
3283 (split-string
3284 (shell-command-to-string
3285 (concat "find "
3286 (shell-quote-argument dir)
3287 (if ido-case-fold " -iname " " -name ")
3288 (shell-quote-argument
3289 (concat (if prefix "" "*") file "*"))
3290 " -type " (if finddir "d" "f") " -print"))))))
84f6c6d0 3291 filename d f
789d1bf0 3292 res)
84f6c6d0
KS
3293 (while filenames
3294 (setq filename (car filenames)
3295 filenames (cdr filenames))
b4243e22 3296 (if (and (file-name-absolute-p filename)
84f6c6d0
KS
3297 (file-exists-p filename))
3298 (setq d (file-name-directory filename)
3299 f (file-name-nondirectory filename)
789d1bf0
KS
3300 res (cons (cons (if finddir (ido-final-slash f t) f) d) res))))
3301 res))
3302
3303(defun ido-flatten-merged-list (items)
362cdb61 3304 ;; Create a list of directory names based on a merged directory list.
789d1bf0
KS
3305 (let (res)
3306 (while items
3307 (let* ((item (car items))
3308 (file (car item))
3309 (dirs (cdr item)))
3310 (while dirs
3311 (setq res (cons (concat (car dirs) file) res)
3312 dirs (cdr dirs))))
3313 (setq items (cdr items)))
3314 res))
3315
ec441ab5
KS
3316
3317(defun ido-make-merged-file-list-1 (text auto wide)
789d1bf0 3318 (let (res)
ec441ab5
KS
3319 (if (and (ido-final-slash text) ido-dir-file-cache)
3320 (if wide
3321 (setq res (ido-wide-find-dirs-or-files
3322 ido-current-directory (substring text 0 -1) ido-enable-prefix t))
3323 ;; Use list of cached directories
3324 (let ((re (concat (regexp-quote (substring text 0 -1)) "[^/:]*/\\'"))
3325 (dirs ido-dir-file-cache)
3326 dir b d f)
3327 (if nil ;; simple
3328 (while dirs
3329 (setq dir (car (car dirs))
3330 dirs (cdr dirs))
3331 (when (and (string-match re dir)
3332 (not (ido-ignore-item-p dir ido-ignore-directories-merge))
3333 (file-directory-p dir))
3334 (setq b (substring dir 0 -1)
3335 f (concat (file-name-nondirectory b) "/")
3336 d (file-name-directory b)
3337 res (cons (cons f d) res))))
789d1bf0
KS
3338 (while dirs
3339 (setq dir (car dirs)
ec441ab5 3340 d (car dir)
789d1bf0 3341 dirs (cdr dirs))
ec441ab5
KS
3342 (when (not (ido-ignore-item-p d ido-ignore-directories-merge))
3343 (setq dir (cdr (cdr dir)))
3344 (while dir
3345 (setq f (car dir)
3346 dir (cdr dir))
3347 (if (and (string-match re f)
3348 (not (ido-ignore-item-p f ido-ignore-directories)))
3349 (setq res (cons (cons f d) res)))))
789d1bf0
KS
3350 (if (and auto (input-pending-p))
3351 (setq dirs nil
3352 res t))))))
ec441ab5
KS
3353 (if wide
3354 (setq res (ido-wide-find-dirs-or-files
3355 ido-current-directory text ido-enable-prefix nil))
3356 (let ((ido-text text)
3357 (dirs ido-work-directory-list)
3358 (must-match (and text (> (length text) 0)))
3359 dir fl)
3360 (if (and auto (not (member ido-current-directory dirs)))
3361 (setq dirs (cons ido-current-directory dirs)))
3362 (while dirs
3363 (setq dir (car dirs)
3364 dirs (cdr dirs))
3365 (when (and dir (stringp dir)
3366 (or ido-merge-ftp-work-directories
3367 (not (ido-is-ftp-directory dir)))
3368 (file-directory-p dir)
3369 ;; TODO. check for nonreadable and too-big.
3370 (setq fl (if (eq ido-cur-item 'file)
3371 (ido-make-file-list-1 dir t)
3372 (ido-make-dir-list-1 dir t))))
3373 (if must-match
3374 (setq fl (ido-set-matches-1 fl)))
3375 (if fl
3376 (setq res (nconc fl res))))
3377 (if (and auto (input-pending-p))
3378 (setq dirs nil
3379 res t))))))
3380 res))
3381
3382(defun ido-make-merged-file-list (text auto wide)
3383 (let (res)
3384 (message "Searching for `%s'...." text)
3385 (condition-case nil
edc42f56
KS
3386 (if (eq t (setq res
3387 (while-no-input
3388 (ido-make-merged-file-list-1 text auto wide))))
3389 (setq res 'input-pending-p))
ec441ab5
KS
3390 (quit
3391 (setq res t
3392 ido-try-merged-list nil
3393 ido-use-merged-list nil)))
3394 (when (and res (listp res))
3395 (setq res (ido-sort-merged-list res auto)))
9a08196a 3396 (when (and (or ido-rotate-temp ido-rotate-file-list-default)
e20b3173 3397 (listp res)
9a08196a
KS
3398 (> (length text) 0))
3399 (let ((elt (assoc text res)))
4e85a733 3400 (when (and elt (not (eq elt (car res))))
9a08196a
KS
3401 (setq res (delq elt res))
3402 (setq res (cons elt res)))))
789d1bf0
KS
3403 (message nil)
3404 res))
3405
ec441ab5 3406(defun ido-make-buffer-list-1 (&optional frame visible)
789d1bf0 3407 ;; Return list of non-ignored buffer names
71296446 3408 (delq nil
789d1bf0
KS
3409 (mapcar
3410 (lambda (x)
3411 (let ((name (buffer-name x)))
69beb26d 3412 (if (not (or (ido-ignore-item-p name ido-ignore-buffers) (member name visible)))
789d1bf0
KS
3413 name)))
3414 (buffer-list frame))))
3415
3416(defun ido-make-buffer-list (default)
3417 ;; Return the current list of buffers.
3418 ;; Currently visible buffers are put at the end of the list.
616e8e5f 3419 ;; The hook `ido-make-buffer-list-hook' is run after the list has been
789d1bf0
KS
3420 ;; created to allow the user to further modify the order of the buffer names
3421 ;; in this list. If DEFAULT is non-nil, and corresponds to an existing buffer,
3422 ;; it is put to the start of the list.
3423 (let* ((ido-current-buffers (ido-get-buffers-in-frames 'current))
ec441ab5 3424 (ido-temp-list (ido-make-buffer-list-1 (selected-frame) ido-current-buffers)))
789d1bf0
KS
3425 (if ido-temp-list
3426 (nconc ido-temp-list ido-current-buffers)
3427 (setq ido-temp-list ido-current-buffers))
e0143335
LL
3428 (if default
3429 (setq ido-temp-list
3430 (cons default (delete default ido-temp-list))))
dff0fdc3
CY
3431 (if ido-use-virtual-buffers
3432 (ido-add-virtual-buffers-to-list))
789d1bf0
KS
3433 (run-hooks 'ido-make-buffer-list-hook)
3434 ido-temp-list))
3435
0523d117
JW
3436(defun ido-add-virtual-buffers-to-list ()
3437 "Add recently visited files, and bookmark files, to the buffer list.
3438This is to make them appear as if they were \"virtual buffers\"."
3439 ;; If no buffers matched, and virtual buffers are being used, then
3440 ;; consult the list of past visited files, to see if we can find
3441 ;; the file which the user might thought was still open.
9caf8a8f 3442 (unless recentf-mode (recentf-mode 1))
0523d117 3443 (setq ido-virtual-buffers nil)
9caf8a8f
JB
3444 (let (name)
3445 (dolist (head recentf-list)
3446 (and (setq name (file-name-nondirectory head))
3447 (null (get-file-buffer head))
3448 (not (assoc name ido-virtual-buffers))
2a07afc5 3449 (not (member name ido-temp-list))
9caf8a8f
JB
3450 (not (ido-ignore-item-p name ido-ignore-buffers))
3451 ;;(file-exists-p head)
3452 (push (cons name head) ido-virtual-buffers))))
0523d117
JW
3453 (when ido-virtual-buffers
3454 (if ido-use-faces
3455 (dolist (comp ido-virtual-buffers)
3456 (put-text-property 0 (length (car comp))
3457 'face 'ido-virtual
3458 (car comp))))
3459 (setq ido-temp-list
3460 (nconc ido-temp-list
3461 (nreverse (mapcar #'car ido-virtual-buffers))))))
3462
db9f395b
KS
3463(defun ido-make-choice-list (default)
3464 ;; Return the current list of choices.
3465 ;; If DEFAULT is non-nil, and corresponds to an element of choices,
3466 ;; it is put to the start of the list.
3467 (let ((ido-temp-list ido-choice-list))
3468 (if default
3469 (progn
3470 (setq ido-temp-list
3471 (delete default ido-temp-list))
3472 (setq ido-temp-list
3473 (cons default ido-temp-list))))
3474 ; (run-hooks 'ido-make-choice-list-hook)
3475 ido-temp-list))
3476
789d1bf0
KS
3477(defun ido-to-end (items)
3478 ;; Move the elements from ITEMS to the end of `ido-temp-list'
db99576a 3479 (mapc
71296446 3480 (lambda (elem)
789d1bf0
KS
3481 (setq ido-temp-list (delq elem ido-temp-list)))
3482 items)
3483 (if ido-temp-list
3484 (nconc ido-temp-list items)
3485 (setq ido-temp-list items)))
3486
ec441ab5 3487(defun ido-file-name-all-completions-1 (dir)
a70343bd 3488 (cond
866f2239 3489 ((ido-nonreadable-directory-p dir) '())
cb65c373
KS
3490 ;; do not check (ido-directory-too-big-p dir) here.
3491 ;; Caller must have done that if necessary.
c577a4d2 3492
a70343bd 3493 ((and ido-enable-tramp-completion
c577a4d2
KS
3494 (string-match "\\`/[^/]+[:@]\\'" dir))
3495 ;; Strip method:user@host: part of tramp completions.
3496 ;; Tramp completions do not include leading slash.
d9e43b70 3497 (let* ((len (1- (length dir)))
5f2b693f 3498 (non-essential t)
d9e43b70
MA
3499 (compl
3500 (or (file-name-all-completions "" dir)
3501 ;; work around bug in ange-ftp.
3502 ;; /ftp:user@host: => nil
3503 ;; /ftp:user@host:./ => ok
3504 (and
3505 (not (string= "/ftp:" dir))
ad74a69e
MA
3506 (file-remote-p dir)
3507 ;; tramp-ftp-file-name-p is available only when tramp
3508 ;; has been loaded.
d9e43b70
MA
3509 (fboundp 'tramp-ftp-file-name-p)
3510 (funcall 'tramp-ftp-file-name-p dir)
3511 (string-match ":\\'" dir)
3512 (file-name-all-completions "" (concat dir "./"))))))
c577a4d2
KS
3513 (if (and compl
3514 (> (length (car compl)) len)
3515 (string= (substring (car compl) 0 len) (substring dir 1)))
a70343bd
KS
3516 (mapcar (lambda (c) (substring c len)) compl)
3517 compl)))
3518 (t
3519 (file-name-all-completions "" dir))))
bad111c2 3520
789d1bf0
KS
3521(defun ido-file-name-all-completions (dir)
3522 ;; Return name of all files in DIR
3523 ;; Uses and updates ido-dir-file-cache
dfebc0ae
KS
3524 (cond
3525 ((ido-is-unc-root dir)
3526 (mapcar
3527 (lambda (host)
3528 (if (string-match "/\\'" host) host (concat host "/")))
4c2ee078 3529 (ido-unc-hosts t)))
dfebc0ae
KS
3530 ((and (numberp ido-max-dir-file-cache) (> ido-max-dir-file-cache 0)
3531 (stringp dir) (> (length dir) 0)
3532 (ido-may-cache-directory dir))
3533 (let* ((cached (assoc dir ido-dir-file-cache))
71296446 3534 (ctime (nth 1 cached))
789d1bf0 3535 (ftp (ido-is-ftp-directory dir))
dfebc0ae
KS
3536 (unc (ido-is-unc-host dir))
3537 (attr (if (or ftp unc) nil (file-attributes dir)))
789d1bf0
KS
3538 (mtime (nth 5 attr))
3539 valid)
3540 (when cached ; should we use the cached entry ?
dfebc0ae
KS
3541 (cond
3542 (ftp
3543 (setq valid (and (eq (car ctime) 'ftp)
3544 (ido-cache-ftp-valid (cdr ctime)))))
3545 (unc
3546 (setq valid (and (eq (car ctime) 'unc)
3547 (ido-cache-unc-valid (cdr ctime)))))
3548 (t
789d1bf0
KS
3549 (if attr
3550 (setq valid (and (= (car ctime) (car mtime))
dfebc0ae
KS
3551 (= (car (cdr ctime)) (car (cdr mtime))))))))
3552 (unless valid
3553 (setq ido-dir-file-cache (delq cached ido-dir-file-cache)
3554 cached nil)))
789d1bf0 3555 (unless cached
dfebc0ae
KS
3556 (cond
3557 (unc
3558 (setq mtime (cons 'unc (ido-time-stamp))))
3559 ((and ftp (file-readable-p dir))
3560 (setq mtime (cons 'ftp (ido-time-stamp)))))
789d1bf0 3561 (if mtime
ec441ab5 3562 (setq cached (cons dir (cons mtime (ido-file-name-all-completions-1 dir)))
789d1bf0
KS
3563 ido-dir-file-cache (cons cached ido-dir-file-cache)))
3564 (if (> (length ido-dir-file-cache) ido-max-dir-file-cache)
3565 (setcdr (nthcdr (1- ido-max-dir-file-cache) ido-dir-file-cache) nil)))
3566 (and cached
dfebc0ae
KS
3567 (cdr (cdr cached)))))
3568 (t
3569 (ido-file-name-all-completions-1 dir))))
789d1bf0
KS
3570
3571(defun ido-remove-cached-dir (dir)
3572 ;; Remove dir from ido-dir-file-cache
3573 (if (and ido-dir-file-cache
3574 (stringp dir) (> (length dir) 0))
3575 (let ((cached (assoc dir ido-dir-file-cache)))
3576 (if cached
3577 (setq ido-dir-file-cache (delq cached ido-dir-file-cache))))))
3578
3579
ec441ab5 3580(defun ido-make-file-list-1 (dir &optional merged)
789d1bf0
KS
3581 ;; Return list of non-ignored files in DIR
3582 ;; If MERGED is non-nil, each file is cons'ed with DIR
dfebc0ae
KS
3583 (and (or (ido-is-tramp-root dir) (ido-is-unc-root dir)
3584 (file-directory-p dir))
001809f6
GM
3585 (delq nil
3586 (mapcar
3587 (lambda (name)
3588 (if (not (ido-ignore-item-p name ido-ignore-files t))
3589 (if merged (cons name dir) name)))
3590 (ido-file-name-all-completions dir)))))
789d1bf0
KS
3591
3592(defun ido-make-file-list (default)
3593 ;; Return the current list of files.
3594 ;; Currently visible files are put at the end of the list.
71296446 3595 ;; The hook `ido-make-file-list-hook' is run after the list has been
789d1bf0
KS
3596 ;; created to allow the user to further modify the order of the file names
3597 ;; in this list.
ec441ab5 3598 (let ((ido-temp-list (ido-make-file-list-1 ido-current-directory)))
1de0ae85
KS
3599 (setq ido-temp-list (sort ido-temp-list
3600 (if ido-file-extensions-order
3601 #'ido-file-extension-lessp
3602 #'ido-file-lessp)))
c577a4d2
KS
3603 (unless (ido-is-tramp-root ido-current-directory)
3604 (let ((default-directory ido-current-directory))
3605 (ido-to-end ;; move ftp hosts and visited files to end
3606 (delq nil (mapcar
10b19e88
KS
3607 (lambda (x) (if (or (and (string-match ".:\\'" x)
3608 (not (ido-local-file-exists-p x)))
c577a4d2 3609 (and (not (ido-final-slash x))
10b19e88
KS
3610 (let (file-name-handler-alist)
3611 (get-file-buffer x)))) x))
c577a4d2 3612 ido-temp-list)))))
789d1bf0 3613 (ido-to-end ;; move . files to end
71296446 3614 (delq nil (mapcar
789d1bf0
KS
3615 (lambda (x) (if (string-equal (substring x 0 1) ".") x))
3616 ido-temp-list)))
3617 (if (and default (member default ido-temp-list))
3618 (if (or ido-rotate-temp ido-rotate-file-list-default)
3619 (unless (equal default (car ido-temp-list))
3620 (let ((l ido-temp-list) k)
3621 (while (and l (cdr l) (not (equal default (car (cdr l)))))
3622 (setq l (cdr l)))
3623 (setq k (cdr l))
3624 (setcdr l nil)
3625 (nconc k ido-temp-list)
3626 (setq ido-temp-list k)))
71296446 3627 (setq ido-temp-list
789d1bf0 3628 (delete default ido-temp-list))
71296446 3629 (setq ido-temp-list
789d1bf0
KS
3630 (cons default ido-temp-list))))
3631 (when ido-show-dot-for-dired
3632 (setq ido-temp-list (delete "." ido-temp-list))
3633 (setq ido-temp-list (cons "." ido-temp-list)))
3634 (run-hooks 'ido-make-file-list-hook)
3635 ido-temp-list))
3636
ec441ab5 3637(defun ido-make-dir-list-1 (dir &optional merged)
789d1bf0
KS
3638 ;; Return list of non-ignored subdirs in DIR
3639 ;; If MERGED is non-nil, each subdir is cons'ed with DIR
bad111c2 3640 (and (or (ido-is-tramp-root dir) (file-directory-p dir))
71296446 3641 (delq nil
789d1bf0
KS
3642 (mapcar
3643 (lambda (name)
3644 (and (ido-final-slash name) (not (ido-ignore-item-p name ido-ignore-directories))
3645 (if merged (cons name dir) name)))
3646 (ido-file-name-all-completions dir)))))
3647
3648(defun ido-make-dir-list (default)
3649 ;; Return the current list of directories.
71296446 3650 ;; The hook `ido-make-dir-list-hook' is run after the list has been
789d1bf0
KS
3651 ;; created to allow the user to further modify the order of the
3652 ;; directory names in this list.
ec441ab5 3653 (let ((ido-temp-list (ido-make-dir-list-1 ido-current-directory)))
1de0ae85 3654 (setq ido-temp-list (sort ido-temp-list #'ido-file-lessp))
789d1bf0 3655 (ido-to-end ;; move . files to end
71296446 3656 (delq nil (mapcar
789d1bf0
KS
3657 (lambda (x) (if (string-equal (substring x 0 1) ".") x))
3658 ido-temp-list)))
3659 (if (and default (member default ido-temp-list))
3660 (if (or ido-rotate-temp ido-rotate-file-list-default)
3661 (unless (equal default (car ido-temp-list))
3662 (let ((l ido-temp-list) k)
3663 (while (and l (cdr l) (not (equal default (car (cdr l)))))
3664 (setq l (cdr l)))
3665 (setq k (cdr l))
3666 (setcdr l nil)
3667 (nconc k ido-temp-list)
3668 (setq ido-temp-list k)))
71296446 3669 (setq ido-temp-list
789d1bf0 3670 (delete default ido-temp-list))
71296446 3671 (setq ido-temp-list
789d1bf0
KS
3672 (cons default ido-temp-list))))
3673 (setq ido-temp-list (delete "." ido-temp-list))
3729cc87
KS
3674 (unless ido-input-stack
3675 (setq ido-temp-list (cons "." ido-temp-list)))
789d1bf0
KS
3676 (run-hooks 'ido-make-dir-list-hook)
3677 ido-temp-list))
3678
3679;; List of the files visible in the current frame.
3680(defvar ido-bufs-in-frame)
3681
3682(defun ido-get-buffers-in-frames (&optional current)
3683 ;; Return the list of buffers that are visible in the current frame.
3684 ;; If optional argument `current' is given, restrict searching to the
3685 ;; current frame, rather than all frames, regardless of value of
3686 ;; `ido-all-frames'.
3687 (let ((ido-bufs-in-frame nil))
3688 (walk-windows 'ido-get-bufname nil
71296446 3689 (if current
789d1bf0
KS
3690 nil
3691 ido-all-frames))
3692 ido-bufs-in-frame))
3693
3694(defun ido-get-bufname (win)
3695 ;; Used by `ido-get-buffers-in-frames' to walk through all windows
3696 (let ((buf (buffer-name (window-buffer win))))
69beb26d
KS
3697 (unless (or (member buf ido-bufs-in-frame)
3698 (member buf ido-ignore-item-temp-list))
3699 ;; Only add buf if it is not already in list.
3700 ;; This prevents same buf in two different windows being
3701 ;; put into the list twice.
3702 (setq ido-bufs-in-frame
3703 (cons buf ido-bufs-in-frame)))))
789d1bf0
KS
3704
3705;;; FIND MATCHING ITEMS
3706
ec441ab5 3707(defun ido-set-matches-1 (items &optional do-full)
789d1bf0
KS
3708 ;; Return list of matches in items
3709 (let* ((case-fold-search ido-case-fold)
bad111c2
KS
3710 (slash (and (not ido-enable-prefix) (ido-final-slash ido-text)))
3711 (text (if slash (substring ido-text 0 -1) ido-text))
5444f278
KS
3712 (rex0 (if ido-enable-regexp text (regexp-quote text)))
3713 (rexq (concat rex0 (if slash ".*/" "")))
789d1bf0 3714 (re (if ido-enable-prefix (concat "\\`" rexq) rexq))
a8c14da8 3715 (full-re (and do-full
9c1228c3
LL
3716 (not (and (eq ido-cur-item 'buffer)
3717 ido-buffer-disable-smart-matches))
a8c14da8
LL
3718 (not ido-enable-regexp)
3719 (not (string-match "\$\\'" rex0))
5444f278
KS
3720 (concat "\\`" rex0 (if slash "/" "") "\\'")))
3721 (suffix-re (and do-full slash
9c1228c3
LL
3722 (not (and (eq ido-cur-item 'buffer)
3723 ido-buffer-disable-smart-matches))
a8c14da8
LL
3724 (not ido-enable-regexp)
3725 (not (string-match "\$\\'" rex0))
5444f278 3726 (concat rex0 "/\\'")))
789d1bf0
KS
3727 (prefix-re (and full-re (not ido-enable-prefix)
3728 (concat "\\`" rexq)))
6d8b6cbd
KS
3729 (non-prefix-dot (or (not ido-enable-dot-prefix)
3730 (not ido-process-ignore-lists)
3731 ido-enable-prefix
3732 (= (length ido-text) 0)))
5444f278 3733 full-matches suffix-matches prefix-matches matches)
665ed61a
KS
3734 (setq ido-incomplete-regexp nil)
3735 (condition-case error
db99576a 3736 (mapc
665ed61a
KS
3737 (lambda (item)
3738 (let ((name (ido-name item)))
5444f278
KS
3739 (if (and (or non-prefix-dot
3740 (if (= (aref ido-text 0) ?.)
3741 (= (aref name 0) ?.)
3742 (/= (aref name 0) ?.)))
3743 (string-match re name))
3744 (cond
39449da0 3745 ((and (eq ido-cur-item 'buffer)
3d37467b
KS
3746 (or (not (stringp ido-default-item))
3747 (not (string= name ido-default-item)))
39449da0
KS
3748 (string= name (buffer-name ido-entry-buffer)))
3749 (setq matches (cons item matches)))
5444f278
KS
3750 ((and full-re (string-match full-re name))
3751 (setq full-matches (cons item full-matches)))
3752 ((and suffix-re (string-match suffix-re name))
3753 (setq suffix-matches (cons item suffix-matches)))
3754 ((and prefix-re (string-match prefix-re name))
3755 (setq prefix-matches (cons item prefix-matches)))
3756 (t (setq matches (cons item matches))))))
3757 t)
665ed61a
KS
3758 items)
3759 (invalid-regexp
3760 (setq ido-incomplete-regexp t
3761 ;; Consider the invalid regexp message internally as a
3762 ;; special-case single match, and handle appropriately
3763 ;; elsewhere.
3764 matches (cdr error))))
5444f278
KS
3765 (when prefix-matches
3766 (ido-trace "prefix match" prefix-matches)
9940702b 3767 ;; Bug#2042.
5444f278
KS
3768 (setq matches (nconc prefix-matches matches)))
3769 (when suffix-matches
3770 (ido-trace "suffix match" (list text suffix-re suffix-matches))
3771 (setq matches (nconc suffix-matches matches)))
3772 (when full-matches
3773 (ido-trace "full match" (list text full-re full-matches))
3774 (setq matches (nconc full-matches matches)))
789d1bf0
KS
3775 (when (and (null matches)
3776 ido-enable-flex-matching
3777 (> (length ido-text) 1)
3778 (not ido-enable-regexp))
05a859c1
LL
3779 (setq re (concat (regexp-quote (string (aref ido-text 0)))
3780 (mapconcat (lambda (c)
3781 (concat "[^" (string c) "]*"
3782 (regexp-quote (string c))))
3783 (substring ido-text 1) "")))
789d1bf0
KS
3784 (if ido-enable-prefix
3785 (setq re (concat "\\`" re)))
db99576a 3786 (mapc
789d1bf0
KS
3787 (lambda (item)
3788 (let ((name (ido-name item)))
3789 (if (string-match re name)
3790 (setq matches (cons item matches)))))
3791 items))
c7a8fcac 3792 (delete-consecutive-dups matches t)))
71296446 3793
789d1bf0
KS
3794
3795(defun ido-set-matches ()
3796 ;; Set `ido-matches' to the list of items matching prompt
3797 (when ido-rescan
ec441ab5 3798 (setq ido-matches (ido-set-matches-1 (reverse ido-cur-list) (not ido-rotate))
789d1bf0 3799 ido-rotate nil)))
71296446 3800
789d1bf0
KS
3801(defun ido-ignore-item-p (name re-list &optional ignore-ext)
3802 ;; Return t if the buffer or file NAME should be ignored.
69beb26d
KS
3803 (or (member name ido-ignore-item-temp-list)
3804 (and
3805 ido-process-ignore-lists re-list
d6049c78
KS
3806 (save-match-data
3807 (let ((ext-list (and ignore-ext ido-ignore-extensions
789d1bf0 3808 completion-ignored-extensions))
d6049c78
KS
3809 (case-fold-search ido-case-fold)
3810 ignorep nextstr
3811 (flen (length name)) slen)
3812 (while ext-list
3813 (setq nextstr (car ext-list))
3814 (if (cond
3815 ((stringp nextstr)
3816 (and (>= flen (setq slen (length nextstr)))
3817 (string-equal (substring name (- flen slen)) nextstr)))
bf8b0f8b 3818 ((functionp nextstr) (funcall nextstr name))
d6049c78
KS
3819 (t nil))
3820 (setq ignorep t
3821 ext-list nil
3822 re-list nil)
3823 (setq ext-list (cdr ext-list))))
3824 (while re-list
3825 (setq nextstr (car re-list))
3826 (if (cond
3827 ((stringp nextstr) (string-match nextstr name))
bf8b0f8b 3828 ((functionp nextstr) (funcall nextstr name))
d6049c78
KS
3829 (t nil))
3830 (setq ignorep t
3831 re-list nil)
3832 (setq re-list (cdr re-list))))
3833 ;; return the result
3834 (if ignorep
3835 (setq ido-ignored-list (cons name ido-ignored-list)))
3836 ignorep)))))
789d1bf0
KS
3837
3838;; Private variable used by `ido-word-matching-substring'.
3839(defvar ido-change-word-sub)
3840
3841(defun ido-find-common-substring (items subs)
3842 ;; Return common string following SUBS in each element of ITEMS.
3843 (let (res
3844 alist
3845 ido-change-word-sub)
3846 (setq ido-change-word-sub
3847 (if ido-enable-regexp
3848 subs
3849 (regexp-quote subs)))
9066a4d0 3850 (setq res (mapcar #'ido-word-matching-substring items))
789d1bf0 3851 (setq res (delq nil res)) ;; remove any nil elements (shouldn't happen)
9066a4d0 3852 (setq alist (mapcar #'ido-makealist res)) ;; could use an OBARRAY
789d1bf0
KS
3853
3854 ;; try-completion returns t if there is an exact match.
9066a4d0
KS
3855 (let* ((completion-ignore-case ido-case-fold)
3856 (comp (try-completion subs alist)))
3857 (if (eq comp t)
3858 subs
3859 comp))))
789d1bf0
KS
3860
3861(defun ido-word-matching-substring (word)
3862 ;; Return part of WORD before 1st match to `ido-change-word-sub'.
3863 ;; If `ido-change-word-sub' cannot be found in WORD, return nil.
71296446 3864 (let ((case-fold-search ido-case-fold))
789d1bf0
KS
3865 (let ((m (string-match ido-change-word-sub (ido-name word))))
3866 (if m
3867 (substring (ido-name word) m)
3868 ;; else no match
3869 nil))))
3870
3871(defun ido-makealist (res)
3872 ;; Return dotted pair (RES . 1).
3873 (cons res 1))
3874
d5e63715 3875(defun ido-choose-completion-string (choice &rest ignored)
789d1bf0
KS
3876 (when (ido-active)
3877 ;; Insert the completion into the buffer where completion was requested.
99fc91fe
AK
3878 (and ido-completion-buffer
3879 (get-buffer ido-completion-buffer)
3880 (kill-buffer ido-completion-buffer))
789d1bf0
KS
3881 (cond
3882 ((ido-active t) ;; ido-use-merged-list
3883 (setq ido-current-directory ""
3884 ido-text choice
3885 ido-exit 'done))
3886 ((not (ido-final-slash choice))
3887 (setq ido-text choice
3888 ido-exit 'done))
3889 (t
3890 (ido-set-current-directory ido-current-directory choice)
3891 (setq ido-exit 'refresh)))
3892 (exit-minibuffer)
3893 t))
3894
3895(defun ido-completion-help ()
3896 "Show possible completions in a *File Completions* buffer."
3897 (interactive)
3898 (setq ido-rescan nil)
99fc91fe
AK
3899 (let ((temp-buf (and ido-completion-buffer
3900 (get-buffer ido-completion-buffer)))
789d1bf0
KS
3901 display-it full-list)
3902 (if (and (eq last-command this-command) temp-buf)
3903 ;; scroll buffer
3904 (let (win (buf (current-buffer)))
3905 (display-buffer temp-buf nil nil)
3906 (set-buffer temp-buf)
3907 (setq win (get-buffer-window temp-buf))
3908 (if (pos-visible-in-window-p (point-max) win)
c05b0612
KS
3909 (if (or ido-completion-buffer-all-completions
3910 (boundp 'ido-completion-buffer-full))
789d1bf0 3911 (set-window-start win (point-min))
3729cc87
KS
3912 (with-no-warnings
3913 (set (make-local-variable 'ido-completion-buffer-full) t))
789d1bf0
KS
3914 (setq full-list t
3915 display-it t))
3916 (scroll-other-window))
3917 (set-buffer buf))
3918 (setq display-it t))
99fc91fe 3919 (if (and ido-completion-buffer display-it)
789d1bf0 3920 (with-output-to-temp-buffer ido-completion-buffer
1de0ae85 3921 (let ((completion-list (sort
789d1bf0 3922 (cond
c05b0612 3923 (ido-directory-too-big
1fd1a9f2 3924 (message "Reading directory...")
c05b0612
KS
3925 (setq ido-directory-too-big nil
3926 ido-ignored-list nil
3927 ido-cur-list (ido-all-completions)
3928 ido-rescan t)
3929 (ido-set-matches)
3930 (or ido-matches ido-cur-list))
789d1bf0
KS
3931 (ido-use-merged-list
3932 (ido-flatten-merged-list (or ido-matches ido-cur-list)))
3933 ((or full-list ido-completion-buffer-all-completions)
3934 (ido-all-completions))
3935 (t
1de0ae85
KS
3936 (copy-sequence (or ido-matches ido-cur-list))))
3937 #'ido-file-lessp)))
1518d6e3 3938 (if (featurep 'xemacs)
789d1bf0
KS
3939 ;; XEmacs extents are put on by default, doesn't seem to be
3940 ;; any way of switching them off.
0fe826e9 3941 ;; This obscure code avoids a byte compiler warning in Emacs.
6c1bc246
KS
3942 (let ((f 'display-completion-list))
3943 (funcall f completion-list
3944 :help-string "ido "
71296446 3945 :activate-callback
4f91a816 3946 (lambda (x y z) (message "Doesn't work yet, sorry!"))))
789d1bf0
KS
3947 ;; else running Emacs
3948 ;;(add-hook 'completion-setup-hook 'completion-setup-function)
3949 (display-completion-list completion-list)))))))
3950
3951;;; KILL CURRENT BUFFER
3952(defun ido-kill-buffer-at-head ()
155943b9
KS
3953 "Kill the buffer at the head of `ido-matches'.
3954If cursor is not at the end of the user input, delete to end of input."
789d1bf0 3955 (interactive)
155943b9 3956 (if (not (eobp))
79ef5763 3957 (delete-region (point) (line-end-position))
155943b9 3958 (let ((enable-recursive-minibuffers t)
e0143335
LL
3959 (buf (ido-name (car ido-matches)))
3960 (nextbuf (cadr ido-matches)))
5c90fde0
LL
3961 (cond
3962 ((get-buffer buf)
e0143335 3963 ;; If next match names a buffer use the buffer object; buffer
5c90fde0 3964 ;; name may be changed by packages such as uniquify.
e0143335
LL
3965 (when (and nextbuf (get-buffer nextbuf))
3966 (setq nextbuf (get-buffer nextbuf)))
3967 (if (null (kill-buffer buf))
3968 ;; Buffer couldn't be killed.
155943b9 3969 (setq ido-rescan t)
e0143335
LL
3970 ;; Else `kill-buffer' succeeds so re-make the buffer list
3971 ;; taking into account packages like uniquify may rename
3972 ;; buffers.
3973 (if (bufferp nextbuf)
3974 (setq nextbuf (buffer-name nextbuf)))
3975 (setq ido-default-item nextbuf
3976 ido-text-init ido-text
3977 ido-exit 'refresh)
5c90fde0
LL
3978 (exit-minibuffer)))
3979 ;; Handle virtual buffers
3980 ((assoc buf ido-virtual-buffers)
3981 (setq recentf-list
3982 (delete (cdr (assoc buf ido-virtual-buffers)) recentf-list))
3983 (setq ido-cur-list (delete buf ido-cur-list))
3984 (setq ido-rescan t))))))
789d1bf0
KS
3985
3986;;; DELETE CURRENT FILE
3987(defun ido-delete-file-at-head ()
155943b9
KS
3988 "Delete the file at the head of `ido-matches'.
3989If cursor is not at the end of the user input, delete to end of input."
789d1bf0 3990 (interactive)
155943b9 3991 (if (not (eobp))
79ef5763 3992 (delete-region (point) (line-end-position))
155943b9
KS
3993 (let ((enable-recursive-minibuffers t)
3994 (file (ido-name (car ido-matches))))
3995 (if file
3996 (setq file (concat ido-current-directory file)))
3997 (when (and file
3998 (file-exists-p file)
3999 (not (file-directory-p file))
4000 (file-writable-p ido-current-directory)
4001 (yes-or-no-p (concat "Delete " file "? ")))
4002 (delete-file file)
4003 ;; Check if file still exists.
4004 (if (file-exists-p file)
4005 ;; file could not be deleted
4006 (setq ido-rescan t)
4007 ;; else file was killed so remove name from list.
4008 (setq ido-cur-list (delq (car ido-matches) ido-cur-list)))))))
789d1bf0
KS
4009
4010
4011;;; VISIT CHOSEN BUFFER
4012(defun ido-visit-buffer (buffer method &optional record)
a11ad595 4013 "Switch to BUFFER according to METHOD.
616e8e5f 4014Record command in `command-history' if optional RECORD is non-nil."
930f852e
KS
4015 (if (bufferp buffer)
4016 (setq buffer (buffer-name buffer)))
789d1bf0
KS
4017 (let (win newframe)
4018 (cond
4019 ((eq method 'kill)
4020 (if record
4021 (ido-record-command 'kill-buffer buffer))
e0143335 4022 (kill-buffer buffer))
789d1bf0 4023
a11ad595 4024 ((eq method 'other-window)
789d1bf0
KS
4025 (if record
4026 (ido-record-command 'switch-to-buffer buffer))
4027 (switch-to-buffer-other-window buffer))
4028
4029 ((eq method 'display)
4030 (display-buffer buffer))
4031
a11ad595 4032 ((eq method 'other-frame)
1518d6e3 4033 (switch-to-buffer-other-frame buffer)
a11ad595
KS
4034 (select-frame-set-input-focus (selected-frame)))
4035
4036 ((and (memq method '(raise-frame maybe-frame))
4037 window-system
4038 (setq win (ido-buffer-window-other-frame buffer))
4039 (or (eq method 'raise-frame)
4040 (y-or-n-p "Jump to frame? ")))
4041 (setq newframe (window-frame win))
4042 (select-frame-set-input-focus newframe)
4043 (select-window win))
4044
4045 ;; (eq method 'selected-window)
4046 (t
4047 ;; No buffer in other frames...
4048 (if record
4049 (ido-record-command 'switch-to-buffer buffer))
4050 (switch-to-buffer buffer)
1518d6e3 4051 ))))
789d1bf0
KS
4052
4053
a11ad595 4054(defun ido-buffer-window-other-frame (buffer)
789d1bf0
KS
4055 ;; Return window pointer if BUFFER is visible in another frame.
4056 ;; If BUFFER is visible in the current frame, return nil.
4057 (let ((blist (ido-get-buffers-in-frames 'current)))
4058 ;;If the buffer is visible in current frame, return nil
69beb26d 4059 (if (member buffer blist)
789d1bf0
KS
4060 nil
4061 ;; maybe in other frame or icon
4062 (get-buffer-window buffer 0) ; better than 'visible
4063 )))
4064
4065
4066;;; ----------- IDONIZED FUNCTIONS ------------
4067
4068;;;###autoload
4069(defun ido-switch-buffer ()
4070 "Switch to another buffer.
4071The buffer is displayed according to `ido-default-buffer-method' -- the
4072default is to show it in the same window, unless it is already visible
4073in another frame.
4074
4075As you type in a string, all of the buffers matching the string are
3903655d 4076displayed if substring-matching is used \(default). Look at
616e8e5f
JB
4077`ido-enable-prefix' and `ido-toggle-prefix'. When you have found the
4078buffer you want, it can then be selected. As you type, most keys have
facf67fd 4079their normal keybindings, except for the following: \\<ido-buffer-completion-map>
789d1bf0
KS
4080
4081RET Select the buffer at the front of the list of matches. If the
4082list is empty, possibly prompt to create new buffer.
4083
d34c18b1 4084\\[ido-select-text] Use the current input string verbatim.
789d1bf0
KS
4085
4086\\[ido-next-match] Put the first element at the end of the list.
4087\\[ido-prev-match] Put the last element at the start of the list.
71296446 4088\\[ido-complete] Complete a common suffix to the current string that
789d1bf0
KS
4089matches all buffers. If there is only one match, select that buffer.
4090If there is no common suffix, show a list of all matching buffers
4091in a separate window.
4092\\[ido-edit-input] Edit input string.
4093\\[ido-fallback-command] Fallback to non-ido version of current command.
4094\\[ido-toggle-regexp] Toggle regexp searching.
4095\\[ido-toggle-prefix] Toggle between substring and prefix matching.
4096\\[ido-toggle-case] Toggle case-sensitive searching of buffer names.
4097\\[ido-completion-help] Show list of matching buffers in separate window.
a2cf0212 4098\\[ido-enter-find-file] Drop into `ido-find-file'.
789d1bf0
KS
4099\\[ido-kill-buffer-at-head] Kill buffer at head of buffer list.
4100\\[ido-toggle-ignore] Toggle ignoring buffers listed in `ido-ignore-buffers'."
4101 (interactive)
4102 (ido-buffer-internal ido-default-buffer-method))
4103
4104;;;###autoload
4105(defun ido-switch-buffer-other-window ()
4106 "Switch to another buffer and show it in another window.
4107The buffer name is selected interactively by typing a substring.
74a5d578 4108For details of keybindings, see `ido-switch-buffer'."
789d1bf0 4109 (interactive)
a11ad595 4110 (ido-buffer-internal 'other-window 'switch-to-buffer-other-window))
789d1bf0
KS
4111
4112;;;###autoload
4113(defun ido-display-buffer ()
4114 "Display a buffer in another window but don't select it.
4115The buffer name is selected interactively by typing a substring.
74a5d578 4116For details of keybindings, see `ido-switch-buffer'."
789d1bf0 4117 (interactive)
db9f395b 4118 (ido-buffer-internal 'display 'display-buffer nil nil nil 'ignore))
789d1bf0
KS
4119
4120;;;###autoload
4121(defun ido-kill-buffer ()
4122 "Kill a buffer.
4123The buffer name is selected interactively by typing a substring.
74a5d578 4124For details of keybindings, see `ido-switch-buffer'."
789d1bf0 4125 (interactive)
db9f395b 4126 (ido-buffer-internal 'kill 'kill-buffer "Kill buffer: " (buffer-name (current-buffer)) nil 'ignore))
789d1bf0
KS
4127
4128;;;###autoload
4129(defun ido-insert-buffer ()
4130 "Insert contents of a buffer in current buffer after point.
4131The buffer name is selected interactively by typing a substring.
74a5d578 4132For details of keybindings, see `ido-switch-buffer'."
789d1bf0 4133 (interactive)
db9f395b 4134 (ido-buffer-internal 'insert 'insert-buffer "Insert buffer: " nil nil 'ido-enter-insert-file))
789d1bf0
KS
4135
4136;;;###autoload
4137(defun ido-switch-buffer-other-frame ()
4138 "Switch to another buffer and show it in another frame.
4139The buffer name is selected interactively by typing a substring.
74a5d578 4140For details of keybindings, see `ido-switch-buffer'."
789d1bf0
KS
4141 (interactive)
4142 (if ido-mode
a11ad595 4143 (ido-buffer-internal 'other-frame)
789d1bf0
KS
4144 (call-interactively 'switch-to-buffer-other-frame)))
4145
4146;;;###autoload
4147(defun ido-find-file-in-dir (dir)
4148 "Switch to another file starting from DIR."
4149 (interactive "DDir: ")
72a75b41 4150 (setq dir (file-name-as-directory dir))
db9f395b 4151 (ido-file-internal ido-default-file-method nil dir nil nil nil 'ignore))
789d1bf0
KS
4152
4153;;;###autoload
4154(defun ido-find-file ()
4155 "Edit file with name obtained via minibuffer.
4156The file is displayed according to `ido-default-file-method' -- the
4157default is to show it in the same window, unless it is already
4158visible in another frame.
4159
616e8e5f
JB
4160The file name is selected interactively by typing a substring. As you
4161type in a string, all of the filenames matching the string are displayed
4162if substring-matching is used \(default). Look at `ido-enable-prefix' and
4163`ido-toggle-prefix'. When you have found the filename you want, it can
4164then be selected. As you type, most keys have their normal keybindings,
facf67fd 4165except for the following: \\<ido-file-completion-map>
789d1bf0
KS
4166
4167RET Select the file at the front of the list of matches. If the
4168list is empty, possibly prompt to create new file.
4169
d34c18b1 4170\\[ido-select-text] Use the current input string verbatim.
789d1bf0
KS
4171
4172\\[ido-next-match] Put the first element at the end of the list.
4173\\[ido-prev-match] Put the last element at the start of the list.
71296446 4174\\[ido-complete] Complete a common suffix to the current string that
789d1bf0
KS
4175matches all files. If there is only one match, select that file.
4176If there is no common suffix, show a list of all matching files
4177in a separate window.
3f06ecf4 4178\\[ido-magic-delete-char] Open the specified directory in Dired mode.
362cdb61 4179\\[ido-edit-input] Edit input string (including directory).
789d1bf0
KS
4180\\[ido-prev-work-directory] or \\[ido-next-work-directory] go to previous/next directory in work directory history.
4181\\[ido-merge-work-directories] search for file in the work directory history.
4182\\[ido-forget-work-directory] removes current directory from the work directory history.
4183\\[ido-prev-work-file] or \\[ido-next-work-file] cycle through the work file history.
973495ca 4184\\[ido-wide-find-file-or-pop-dir] and \\[ido-wide-find-dir-or-delete-dir] prompts and uses find to locate files or directories.
789d1bf0
KS
4185\\[ido-make-directory] prompts for a directory to create in current directory.
4186\\[ido-fallback-command] Fallback to non-ido version of current command.
4187\\[ido-toggle-regexp] Toggle regexp searching.
4188\\[ido-toggle-prefix] Toggle between substring and prefix matching.
4189\\[ido-toggle-case] Toggle case-sensitive searching of file names.
789d1bf0
KS
4190\\[ido-toggle-literal] Toggle literal reading of this file.
4191\\[ido-completion-help] Show list of matching files in separate window.
4192\\[ido-toggle-ignore] Toggle ignoring files listed in `ido-ignore-files'."
4193
4194 (interactive)
4195 (ido-file-internal ido-default-file-method))
4196
4197;;;###autoload
4198(defun ido-find-file-other-window ()
4199 "Switch to another file and show it in another window.
4200The file name is selected interactively by typing a substring.
74a5d578 4201For details of keybindings, see `ido-find-file'."
789d1bf0 4202 (interactive)
a11ad595 4203 (ido-file-internal 'other-window 'find-file-other-window))
789d1bf0
KS
4204
4205;;;###autoload
4206(defun ido-find-alternate-file ()
4207 "Switch to another file and show it in another window.
4208The file name is selected interactively by typing a substring.
74a5d578 4209For details of keybindings, see `ido-find-file'."
789d1bf0
KS
4210 (interactive)
4211 (ido-file-internal 'alt-file 'find-alternate-file nil "Find alternate file: "))
4212
4213;;;###autoload
4214(defun ido-find-file-read-only ()
4215 "Edit file read-only with name obtained via minibuffer.
4216The file name is selected interactively by typing a substring.
74a5d578 4217For details of keybindings, see `ido-find-file'."
789d1bf0
KS
4218 (interactive)
4219 (ido-file-internal 'read-only 'find-file-read-only nil "Find file read-only: "))
4220
4221;;;###autoload
4222(defun ido-find-file-read-only-other-window ()
4223 "Edit file read-only in other window with name obtained via minibuffer.
4224The file name is selected interactively by typing a substring.
74a5d578 4225For details of keybindings, see `ido-find-file'."
789d1bf0
KS
4226 (interactive)
4227 (ido-file-internal 'read-only 'find-file-read-only-other-window nil "Find file read-only other window: "))
4228
4229;;;###autoload
4230(defun ido-find-file-read-only-other-frame ()
4231 "Edit file read-only in other frame with name obtained via minibuffer.
4232The file name is selected interactively by typing a substring.
74a5d578 4233For details of keybindings, see `ido-find-file'."
789d1bf0
KS
4234 (interactive)
4235 (ido-file-internal 'read-only 'find-file-read-only-other-frame nil "Find file read-only other frame: "))
4236
4237;;;###autoload
4238(defun ido-display-file ()
4239 "Display a file in another window but don't select it.
4240The file name is selected interactively by typing a substring.
74a5d578 4241For details of keybindings, see `ido-find-file'."
789d1bf0 4242 (interactive)
db9f395b 4243 (ido-file-internal 'display nil nil nil nil nil 'ignore))
789d1bf0
KS
4244
4245;;;###autoload
4246(defun ido-find-file-other-frame ()
4247 "Switch to another file and show it in another frame.
4248The file name is selected interactively by typing a substring.
74a5d578 4249For details of keybindings, see `ido-find-file'."
789d1bf0 4250 (interactive)
a11ad595 4251 (ido-file-internal 'other-frame 'find-file-other-frame))
789d1bf0
KS
4252
4253;;;###autoload
4254(defun ido-write-file ()
4255 "Write current buffer to a file.
4256The file name is selected interactively by typing a substring.
74a5d578 4257For details of keybindings, see `ido-find-file'."
789d1bf0
KS
4258 (interactive)
4259 (let ((ido-process-ignore-lists t)
4260 (ido-work-directory-match-only nil)
4261 (ido-ignore-files (cons "[^/]\\'" ido-ignore-files))
4262 (ido-report-no-match nil)
d81aa76a 4263 (ido-confirm-unique-completion t)
789d1bf0 4264 (ido-auto-merge-work-directories-length -1))
db9f395b 4265 (ido-file-internal 'write 'write-file nil "Write file: " nil nil 'ignore)))
789d1bf0
KS
4266
4267;;;###autoload
4268(defun ido-insert-file ()
4269 "Insert contents of file in current buffer.
4270The file name is selected interactively by typing a substring.
74a5d578 4271For details of keybindings, see `ido-find-file'."
789d1bf0 4272 (interactive)
db9f395b 4273 (ido-file-internal 'insert 'insert-file nil "Insert file: " nil nil 'ido-enter-insert-buffer))
789d1bf0
KS
4274
4275;;;###autoload
4276(defun ido-dired ()
a09e21bf 4277 "Call `dired' the ido way.
789d1bf0 4278The directory is selected interactively by typing a substring.
74a5d578 4279For details of keybindings, see `ido-find-file'."
789d1bf0
KS
4280 (interactive)
4281 (let ((ido-report-no-match nil)
4282 (ido-auto-merge-work-directories-length -1))
4283 (ido-file-internal 'dired 'dired nil "Dired: " 'dir)))
4284
4285(defun ido-list-directory ()
a09e21bf 4286 "Call `list-directory' the ido way.
789d1bf0 4287The directory is selected interactively by typing a substring.
74a5d578 4288For details of keybindings, see `ido-find-file'."
789d1bf0
KS
4289 (interactive)
4290 (let ((ido-report-no-match nil)
4291 (ido-auto-merge-work-directories-length -1))
4292 (ido-file-internal 'list-directory 'list-directory nil "List directory: " 'dir)))
4293
4294;;; XEmacs hack for showing default buffer
4295
4296;; The first time we enter the minibuffer, Emacs puts up the default
4297;; buffer to switch to, but XEmacs doesn't -- presumably there is a
4298;; subtle difference in the two versions of post-command-hook. The
4299;; default is shown for both whenever we delete all of our text
4300;; though, indicating its just a problem the first time we enter the
4301;; function. To solve this, we use another entry hook for emacs to
4302;; show the default the first time we enter the minibuffer.
4303
4304
4305;;; ICOMPLETE TYPE CODE
4306
4307(defun ido-initiate-auto-merge (buffer)
4308 (ido-trace "\n*merge timeout*" buffer)
4309 (setq ido-auto-merge-timer nil)
4310 (when (and (buffer-live-p buffer)
cba9a3a5 4311 (ido-active)
789d1bf0
KS
4312 (boundp 'ido-eoinput) ido-eoinput)
4313 (let ((contents (buffer-substring-no-properties (minibuffer-prompt-end) ido-eoinput)))
4314 (ido-trace "request merge")
4315 (setq ido-use-merged-list 'auto
4316 ido-text-init contents
4317 ido-rotate-temp t
4318 ido-exit 'refresh)
7fdbcd83 4319 (with-current-buffer buffer
789d1bf0
KS
4320 (ido-tidy))
4321 (throw 'ido contents))))
4322
4323(defun ido-exhibit ()
4324 "Post command hook for `ido'."
4325 ;; Find matching files and display a list in the minibuffer.
4326 ;; Copied from `icomplete-exhibit' with two changes:
4327 ;; 1. It prints a default file name when there is no text yet entered.
4328 ;; 2. It calls my completion routine rather than the standard completion.
4329
cba9a3a5 4330 (when (ido-active)
bad111c2
KS
4331 (let ((contents (buffer-substring-no-properties (minibuffer-prompt-end) (point-max)))
4332 (buffer-undo-list t)
4333 try-single-dir-match
4334 refresh)
789d1bf0 4335
5444f278
KS
4336 (when ido-trace-enable
4337 (ido-trace "\nexhibit" this-command)
4338 (ido-trace "dir" ido-current-directory)
4339 (ido-trace "contents" contents)
4340 (ido-trace "list" ido-cur-list)
4341 (ido-trace "matches" ido-matches)
4342 (ido-trace "rescan" ido-rescan))
789d1bf0 4343
bad111c2
KS
4344 (save-excursion
4345 (goto-char (point-max))
4346 ;; Register the end of input, so we know where the extra stuff (match-status info) begins:
4347 (unless (boundp 'ido-eoinput)
4348 ;; In case it got wiped out by major mode business:
4349 (make-local-variable 'ido-eoinput))
4350 (setq ido-eoinput (point))
4351
4352 ;; Handle explicit directory changes
4353 (cond
db9f395b 4354 ((memq ido-cur-item '(buffer list))
bad111c2
KS
4355 )
4356
4357 ((= (length contents) 0)
4358 )
4359
4360 ((= (length contents) 1)
dfebc0ae
KS
4361 (cond
4362 ((and (ido-is-tramp-root) (string-equal contents "/"))
bad111c2
KS
4363 (ido-set-current-directory ido-current-directory contents)
4364 (setq refresh t))
4c2ee078 4365 ((and (ido-unc-hosts) (string-equal contents "/")
dfebc0ae
KS
4366 (let ((ido-enable-tramp-completion nil))
4367 (ido-is-root-directory)))
4368 (ido-set-current-directory "//")
4369 (setq refresh t))
4370 ))
bad111c2 4371
10b19e88
KS
4372 ((and (string-match (if ido-enable-tramp-completion ".[:@]\\'" ".:\\'") contents)
4373 (ido-is-root-directory) ;; Ange-ftp or tramp
4374 (not (ido-local-file-exists-p contents)))
bad111c2
KS
4375 (ido-set-current-directory ido-current-directory contents)
4376 (when (ido-is-slow-ftp-host)
4377 (setq ido-exit 'fallback)
4378 (exit-minibuffer))
4379 (setq refresh t))
4380
4381 ((ido-final-slash contents) ;; xxx/
4382 (ido-trace "final slash" contents)
71296446 4383 (cond
bad111c2
KS
4384 ((string-equal contents "~/")
4385 (ido-set-current-home)
4386 (setq refresh t))
4387 ((string-equal contents "../")
4388 (ido-up-directory t)
4389 (setq refresh t))
4390 ((string-equal contents "./")
4391 (setq refresh t))
1c36d72a 4392 ((string-match "\\`~[-_a-zA-Z0-9]+[$]?/\\'" contents)
bad111c2
KS
4393 (ido-trace "new home" contents)
4394 (ido-set-current-home contents)
4395 (setq refresh t))
4396 ((string-match "[$][A-Za-z0-9_]+/\\'" contents)
4397 (let ((exp (condition-case ()
4398 (expand-file-name
4399 (substitute-in-file-name (substring contents 0 -1))
4400 ido-current-directory)
4401 (error nil))))
4402 (ido-trace contents exp)
4403 (when (and exp (file-directory-p exp))
4404 (ido-set-current-directory (file-name-directory exp))
4405 (setq ido-text-init (file-name-nondirectory exp))
4406 (setq refresh t))))
4407 ((and (memq system-type '(windows-nt ms-dos))
4408 (string-equal (substring contents 1) ":/"))
4409 (ido-set-current-directory (file-name-directory contents))
4410 (setq refresh t))
4411 ((string-equal (substring contents -2 -1) "/")
71296446 4412 (ido-set-current-directory
bad111c2
KS
4413 (if (memq system-type '(windows-nt ms-dos))
4414 (expand-file-name "/" ido-current-directory)
4415 "/"))
4416 (setq refresh t))
cb65c373 4417 ((and (or ido-directory-nonreadable ido-directory-too-big)
a70343bd 4418 (file-directory-p (concat ido-current-directory (file-name-directory contents))))
d81aa76a 4419 (ido-set-current-directory
a70343bd
KS
4420 (concat ido-current-directory (file-name-directory contents)))
4421 (setq refresh t))
bad111c2
KS
4422 (t
4423 (ido-trace "try single dir")
4424 (setq try-single-dir-match t))))
4425
4426 ((and (string-equal (substring contents -2 -1) "/")
4427 (not (string-match "[$]" contents)))
4428 (ido-set-current-directory
4429 (cond
4430 ((= (length contents) 2)
4431 "/")
4432 (ido-matches
5a1b28a4 4433 (concat ido-current-directory (ido-name (car ido-matches))))
bad111c2
KS
4434 (t
4435 (concat ido-current-directory (substring contents 0 -1)))))
4436 (setq ido-text-init (substring contents -1))
4437 (setq refresh t))
4438
4439 ((and (not ido-use-merged-list)
4440 (not (ido-final-slash contents))
4441 (eq ido-try-merged-list t)
4442 (numberp ido-auto-merge-work-directories-length)
4443 (> ido-auto-merge-work-directories-length 0)
4444 (= (length contents) ido-auto-merge-work-directories-length)
4445 (not (and ido-auto-merge-inhibit-characters-regexp
4446 (string-match ido-auto-merge-inhibit-characters-regexp contents)))
4447 (not (input-pending-p)))
4448 (setq ido-use-merged-list 'auto
4449 ido-text-init contents
4450 ido-rotate-temp t)
4451 (setq refresh t))
4452
4453 (t nil))
4454
4455 (when refresh
4456 (ido-trace "refresh on /" ido-text-init)
4457 (setq ido-exit 'refresh)
4458 (exit-minibuffer))
789d1bf0 4459
bad111c2
KS
4460 ;; Update the list of matches
4461 (setq ido-text contents)
4462 (ido-set-matches)
4463 (ido-trace "new " ido-matches)
4464
5702da69 4465 (when (and ido-enter-matching-directory
bad111c2 4466 ido-matches
5702da69
KS
4467 (or (eq ido-enter-matching-directory 'first)
4468 (null (cdr ido-matches)))
5a1b28a4 4469 (ido-final-slash (ido-name (car ido-matches)))
bad111c2 4470 (or try-single-dir-match
5702da69 4471 (eq ido-enter-matching-directory t)))
bad111c2 4472 (ido-trace "single match" (car ido-matches))
71296446 4473 (ido-set-current-directory
5a1b28a4 4474 (concat ido-current-directory (ido-name (car ido-matches))))
bad111c2
KS
4475 (setq ido-exit 'refresh)
4476 (exit-minibuffer))
4477
4478 (when (and (not ido-matches)
a70343bd 4479 (not ido-directory-nonreadable)
cb65c373 4480 (not ido-directory-too-big)
bad111c2 4481 ;; ido-rescan ?
789d1bf0
KS
4482 ido-process-ignore-lists
4483 ido-ignored-list)
bad111c2
KS
4484 (let ((ido-process-ignore-lists nil)
4485 (ido-rotate ido-rotate)
4486 (ido-cur-list ido-ignored-list))
4487 (ido-trace "try all" ido-ignored-list)
4488 (ido-set-matches))
4489 (when ido-matches
4490 (ido-trace "found " ido-matches)
4491 (setq ido-rescan t)
4492 (setq ido-process-ignore-lists-inhibit t)
4493 (setq ido-text-init ido-text)
4494 (setq ido-exit 'refresh)
4495 (exit-minibuffer)))
4496
4497 (when (and
4498 ido-rescan
4499 (not ido-matches)
4500 (memq ido-cur-item '(file dir))
4501 (not (ido-is-root-directory))
4502 (> (length contents) 1)
a70343bd 4503 (not (string-match "[$]" contents))
cb65c373
KS
4504 (not ido-directory-nonreadable)
4505 (not ido-directory-too-big))
bad111c2
KS
4506 (ido-trace "merge?")
4507 (if ido-use-merged-list
4508 (ido-undo-merge-work-directory contents nil)
4509 (when (and (eq ido-try-merged-list t)
4510 (numberp ido-auto-merge-work-directories-length)
4511 (= ido-auto-merge-work-directories-length 0)
4512 (not (and ido-auto-merge-inhibit-characters-regexp
4513 (string-match ido-auto-merge-inhibit-characters-regexp contents)))
4514 (not (input-pending-p)))
4515 (ido-trace "\n*start timer*")
4516 (setq ido-auto-merge-timer
4517 (run-with-timer ido-auto-merge-delay-time nil 'ido-initiate-auto-merge (current-buffer))))))
71296446 4518
bad111c2 4519 (setq ido-rescan t)
789d1bf0 4520
71296446 4521 (if (and ido-use-merged-list
bad111c2
KS
4522 ido-matches
4523 (not (string-equal (car (cdr (car ido-matches))) ido-current-directory)))
4524 (progn
4525 (ido-set-current-directory (car (cdr (car ido-matches))))
4526 (setq ido-use-merged-list t
4527 ido-exit 'keep
4528 ido-text-init ido-text)
4529 (exit-minibuffer)))
4530
4531 ;; Insert the match-status information:
4532 (ido-set-common-completion)
c5b40130 4533 (let ((inf (ido-completions contents)))
11c238b3 4534 (setq ido-show-confirm-message nil)
bad111c2
KS
4535 (ido-trace "inf" inf)
4536 (insert inf))
4537 ))))
789d1bf0 4538
c5b40130 4539(defun ido-completions (name)
789d1bf0
KS
4540 ;; Return the string that is displayed after the user's text.
4541 ;; Modified from `icomplete-completions'.
71296446 4542
789d1bf0
KS
4543 (let* ((comps ido-matches)
4544 (ind (and (consp (car comps)) (> (length (cdr (car comps))) 1)
4545 ido-merged-indicator))
4546 first)
4547
4548 (if (and ind ido-use-faces)
ccba8bb6 4549 (put-text-property 0 1 'face 'ido-indicator ind))
71296446 4550
789d1bf0
KS
4551 (if (and ido-use-faces comps)
4552 (let* ((fn (ido-name (car comps)))
4553 (ln (length fn)))
4554 (setq first (format "%s" fn))
4555 (put-text-property 0 ln 'face
4556 (if (= (length comps) 1)
665ed61a
KS
4557 (if ido-incomplete-regexp
4558 'ido-incomplete-regexp
4559 'ido-only-match)
ccba8bb6 4560 'ido-first-match)
789d1bf0
KS
4561 first)
4562 (if ind (setq first (concat first ind)))
4563 (setq comps (cons first (cdr comps)))))
4564
4565 (cond ((null comps)
a70343bd 4566 (cond
11c238b3 4567 (ido-show-confirm-message
5b54c385 4568 (or (nth 10 ido-decorations) " [Confirm]"))
a70343bd
KS
4569 (ido-directory-nonreadable
4570 (or (nth 8 ido-decorations) " [Not readable]"))
cb65c373
KS
4571 (ido-directory-too-big
4572 (or (nth 9 ido-decorations) " [Too big]"))
a70343bd
KS
4573 (ido-report-no-match
4574 (nth 6 ido-decorations)) ;; [No match]
4575 (t "")))
665ed61a
KS
4576 (ido-incomplete-regexp
4577 (concat " " (car comps)))
789d1bf0 4578 ((null (cdr comps)) ;one match
665ed61a
KS
4579 (concat (if (if (not ido-enable-regexp)
4580 (= (length (ido-name (car comps))) (length name))
4581 ;; We can't rely on the length of the input
4582 ;; for regexps, so explicitly check for a
4583 ;; complete match
4584 (string-match name (ido-name (car comps)))
4585 (string-equal (match-string 0 (ido-name (car comps)))
4586 (ido-name (car comps))))
4587 ""
632556e4
SM
4588 ;; When there is only one match, show the matching file
4589 ;; name in full, wrapped in [ ... ].
4590 (concat
4591 (or (nth 11 ido-decorations) (nth 4 ido-decorations))
4592 (ido-name (car comps))
4593 (or (nth 12 ido-decorations) (nth 5 ido-decorations))))
789d1bf0
KS
4594 (if (not ido-use-faces) (nth 7 ido-decorations)))) ;; [Matched]
4595 (t ;multiple matches
4596 (let* ((items (if (> ido-max-prospects 0) (1+ ido-max-prospects) 999))
4597 (alternatives
4598 (apply
71296446 4599 #'concat
789d1bf0 4600 (cdr (apply
9066a4d0
KS
4601 #'nconc
4602 (mapcar
4603 (lambda (com)
4604 (setq com (ido-name com))
4605 (setq items (1- items))
4606 (cond
4607 ((< items 0) ())
4608 ((= items 0) (list (nth 3 ido-decorations))) ; " | ..."
4609 (t
4610 (list (or ido-separator (nth 2 ido-decorations)) ; " | "
4611 (let ((str (substring com 0)))
4612 (if (and ido-use-faces
4613 (not (string= str first))
4614 (ido-final-slash str))
ccba8bb6 4615 (put-text-property 0 (length str) 'face 'ido-subdir str))
9066a4d0
KS
4616 str)))))
4617 comps))))))
789d1bf0
KS
4618
4619 (concat
4620 ;; put in common completion item -- what you get by pressing tab
9066a4d0
KS
4621 (if (and (stringp ido-common-match-string)
4622 (> (length ido-common-match-string) (length name)))
789d1bf0
KS
4623 (concat (nth 4 ido-decorations) ;; [ ... ]
4624 (substring ido-common-match-string (length name))
4625 (nth 5 ido-decorations)))
4626 ;; list all alternatives
4627 (nth 0 ido-decorations) ;; { ... }
4628 alternatives
4629 (nth 1 ido-decorations)))))))
4630
4631(defun ido-minibuffer-setup ()
4632 "Minibuffer setup hook for `ido'."
4633 ;; Copied from `icomplete-minibuffer-setup-hook'.
cba9a3a5 4634 (when (ido-active)
789d1bf0
KS
4635 (add-hook 'pre-command-hook 'ido-tidy nil t)
4636 (add-hook 'post-command-hook 'ido-exhibit nil t)
1518d6e3 4637 (when (featurep 'xemacs)
789d1bf0
KS
4638 (ido-exhibit)
4639 (goto-char (point-min)))
155943b9
KS
4640 (run-hooks 'ido-minibuffer-setup-hook)
4641 (when ido-initial-position
4642 (goto-char (+ (minibuffer-prompt-end) ido-initial-position))
4643 (setq ido-initial-position nil))))
789d1bf0
KS
4644
4645(defun ido-tidy ()
4646 "Pre command hook for `ido'."
4647 ;; Remove completions display, if any, prior to new user input.
4648 ;; Copied from `icomplete-tidy'."
4649
4650 (when ido-auto-merge-timer
4651 (ido-trace "\n*cancel timer*" this-command)
4652 (cancel-timer ido-auto-merge-timer)
4653 (setq ido-auto-merge-timer nil))
4654
cba9a3a5 4655 (if (ido-active)
789d1bf0
KS
4656 (if (and (boundp 'ido-eoinput)
4657 ido-eoinput)
71296446 4658
789d1bf0
KS
4659 (if (> ido-eoinput (point-max))
4660 ;; Oops, got rug pulled out from under us - reinit:
4661 (setq ido-eoinput (point-max))
4662 (let ((buffer-undo-list t))
4663 (delete-region ido-eoinput (point-max))))
71296446 4664
789d1bf0
KS
4665 ;; Reestablish the local variable 'cause minibuffer-setup is weird:
4666 (make-local-variable 'ido-eoinput)
4667 (setq ido-eoinput 1))))
4668
4669(defun ido-summary-buffers-to-end ()
4670 ;; Move the summaries to the end of the buffer list.
4671 ;; This is an example function which can be hooked on to
4672 ;; `ido-make-buffer-list-hook'. Any buffer matching the regexps
4673 ;; `Summary' or `output\*$'are put to the end of the list.
71296446
JB
4674 (let ((summaries (delq nil (mapcar
4675 (lambda (x)
4676 (if (or
789d1bf0
KS
4677 (string-match "Summary" x)
4678 (string-match "output\\*\\'" x))
4679 x))
4680 ido-temp-list))))
4681 (ido-to-end summaries)))
4682
4683;;; Helper functions for other programs
4684
84263efb 4685(put 'dired-do-rename 'ido 'ignore)
ae9d279d 4686(put 'ibuffer-find-file 'ido 'find-file)
76ce3ae6 4687(put 'dired-other-window 'ido 'dir)
84263efb 4688
cb65c373
KS
4689;;;###autoload
4690(defun ido-read-buffer (prompt &optional default require-match)
4691 "Ido replacement for the built-in `read-buffer'.
4692Return the name of a buffer selected.
4693PROMPT is the prompt to give to the user. DEFAULT if given is the default
4694buffer to be selected, which will go to the front of the list.
616e8e5f 4695If REQUIRE-MATCH is non-nil, an existing buffer must be selected."
cb65c373
KS
4696 (let* ((ido-current-directory nil)
4697 (ido-directory-nonreadable nil)
4698 (ido-directory-too-big nil)
4699 (ido-context-switch-command 'ignore)
4700 (buf (ido-read-internal 'buffer prompt 'ido-buffer-history default require-match)))
4701 (if (eq ido-exit 'fallback)
4702 (let ((read-buffer-function nil))
b2d4c118 4703 (run-hook-with-args 'ido-before-fallback-functions 'read-buffer)
cb65c373
KS
4704 (read-buffer prompt default require-match))
4705 buf)))
4706
789d1bf0
KS
4707;;;###autoload
4708(defun ido-read-file-name (prompt &optional dir default-filename mustmatch initial predicate)
cb65c373
KS
4709 "Ido replacement for the built-in `read-file-name'.
4710Read file name, prompting with PROMPT and completing in directory DIR.
789d1bf0 4711See `read-file-name' for additional parameters."
db9f395b
KS
4712 (let (filename)
4713 (cond
4714 ((or (eq predicate 'file-directory-p)
4715 (eq (get this-command 'ido) 'dir)
4716 (memq this-command ido-read-file-name-as-directory-commands))
4717 (setq filename
89a28f0b
KS
4718 (ido-read-directory-name prompt dir default-filename mustmatch initial))
4719 (if (eq ido-exit 'fallback)
4720 (setq filename 'fallback)))
db9f395b
KS
4721 ((and (not (eq (get this-command 'ido) 'ignore))
4722 (not (memq this-command ido-read-file-name-non-ido))
4723 (or (null predicate) (eq predicate 'file-exists-p)))
4724 (let* (ido-saved-vc-hb
ae9d279d
KS
4725 (ido-context-switch-command
4726 (if (eq (get this-command 'ido) 'find-file) nil 'ignore))
db9f395b 4727 (vc-handled-backends (and (boundp 'vc-handled-backends) vc-handled-backends))
83a12f3a 4728 (minibuffer-completing-file-name t)
db9f395b
KS
4729 (ido-current-directory (ido-expand-directory dir))
4730 (ido-directory-nonreadable (not (file-readable-p ido-current-directory)))
cb65c373
KS
4731 (ido-directory-too-big (and (not ido-directory-nonreadable)
4732 (ido-directory-too-big-p ido-current-directory)))
db9f395b 4733 (ido-work-directory-index -1)
fcbc95a9
KS
4734 (ido-show-dot-for-dired (and ido-show-dot-for-dired
4735 (not default-filename)))
db9f395b
KS
4736 (ido-work-file-index -1)
4737 (ido-find-literal nil))
4738 (setq ido-exit nil)
4739 (setq filename
4740 (ido-read-internal 'file prompt 'ido-file-history default-filename mustmatch initial))
4741 (cond
4742 ((eq ido-exit 'fallback)
4743 (setq filename 'fallback))
ae9d279d
KS
4744 ((eq ido-exit 'dired)
4745 (setq filename ido-current-directory))
db9f395b
KS
4746 (filename
4747 (setq filename
4748 (concat ido-current-directory filename))))))
4749 (t
4750 (setq filename 'fallback)))
4751 (if (eq filename 'fallback)
4752 (let ((read-file-name-function nil))
b2d4c118 4753 (run-hook-with-args 'ido-before-fallback-functions 'read-file-name)
db9f395b
KS
4754 (read-file-name prompt dir default-filename mustmatch initial predicate))
4755 filename)))
789d1bf0
KS
4756
4757;;;###autoload
4758(defun ido-read-directory-name (prompt &optional dir default-dirname mustmatch initial)
cb65c373
KS
4759 "Ido replacement for the built-in `read-directory-name'.
4760Read directory name, prompting with PROMPT and completing in directory DIR.
4761See `read-directory-name' for additional parameters."
a70343bd 4762 (let* (filename
83a12f3a 4763 (minibuffer-completing-file-name t)
db9f395b 4764 (ido-context-switch-command 'ignore)
a70343bd
KS
4765 ido-saved-vc-hb
4766 (ido-current-directory (ido-expand-directory dir))
4767 (ido-directory-nonreadable (not (file-readable-p ido-current-directory)))
cb65c373
KS
4768 (ido-directory-too-big (and (not ido-directory-nonreadable)
4769 (ido-directory-too-big-p ido-current-directory)))
a70343bd
KS
4770 (ido-work-directory-index -1)
4771 (ido-work-file-index -1))
789d1bf0
KS
4772 (setq filename
4773 (ido-read-internal 'dir prompt 'ido-file-history default-dirname mustmatch initial))
4774 (if filename
4775 (if (and (stringp filename) (string-equal filename "."))
4776 ido-current-directory
4777 (concat ido-current-directory filename)))))
4778
db9f395b 4779;;;###autoload
06b60517
JB
4780(defun ido-completing-read (prompt choices &optional _predicate require-match
4781 initial-input hist def _inherit-input-method)
cb65c373
KS
4782 "Ido replacement for the built-in `completing-read'.
4783Read a string in the minibuffer with ido-style completion.
db9f395b
KS
4784PROMPT is a string to prompt with; normally it ends in a colon and a space.
4785CHOICES is a list of strings which are the possible completions.
3ec03f7e
LL
4786PREDICATE and INHERIT-INPUT-METHOD is currently ignored; it is included
4787 to be compatible with `completing-read'.
db9f395b
KS
4788If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless
4789 the input is (or completes to) an element of CHOICES or is null.
4790 If the input is null, `ido-completing-read' returns DEF, or an empty
4791 string if DEF is nil, regardless of the value of REQUIRE-MATCH.
4792If INITIAL-INPUT is non-nil, insert it in the minibuffer initially,
4793 with point positioned at the end.
4794HIST, if non-nil, specifies a history list.
4795DEF, if non-nil, is the default value."
4796 (let ((ido-current-directory nil)
4797 (ido-directory-nonreadable nil)
cb65c373 4798 (ido-directory-too-big nil)
db9f395b 4799 (ido-context-switch-command 'ignore)
c7a8fcac 4800 (ido-choice-list choices))
bd794450 4801 ;; Initialize ido before invoking ido-read-internal
0fdd1db7 4802 (ido-common-initialization)
db9f395b
KS
4803 (ido-read-internal 'list prompt hist def require-match initial-input)))
4804
4e3e159b
JB
4805(defun ido-unload-function ()
4806 "Unload the Ido library."
4807 (ido-mode -1)
4808 (setq minor-mode-map-alist (assq-delete-all 'ido-mode minor-mode-map-alist))
4809 ;; continue standard unloading
4810 nil)
4811
403dae9d 4812(provide 'ido)
db9f395b 4813
789d1bf0 4814;;; ido.el ends here