Difference between revisions of "Ido"

Ido
Description	Interactive Do MiniBuffer Enhancement
Author	Kim F. Storm
Maintainer	FSF
Source	http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/ido.el
Part of Emacs	yes

Latest revision as of 15:04, 29 May 2015

Ido - Interactively do things is a very convenient way to find files and switch buffers.

Basic setup

(ido-mode)
(ido-everywhere 1)

Helpful keybindings

[C-s]: Move to next ido suggestion.

[C-r]: Move to previous ido suggestion.

[C-f]: Temporarily revert to the default find-file behavior. Handy if ido won't behave as you'd like.

[C-j]: Accept the provided text as is, instead of selecting the currently proposed completion.

Common Customization

Enable Fuzzy Matching

(setq ido-enable-flex-matching t)

Ignore Case

(setq ido-case-fold t)

Virtual Buffers

If Recentf is enabled, you can use [C-x b] (or M-x ido-switch-buffer) to visit recently closed files by enabling virtual buffers:

(setq ido-use-virtual-buffers t)

Prevent Auto-Merge

Ido's default behavior when there is no matching file in the current directory is to look in recent working directories. If you prefer to limit [C-x C-f] (or M-x ido-find-file) to the current directory you can disable this auto-merge behavior:

(setq ido-auto-merge-work-directories-length -1) ;; disable auto-merge

You can still look in other working directories explicitly with [M-s].

Directory Caching on Windows

On Windows operating systems it can be unreliable to cache directory listings: the directory may not appear to be modified even though files have been added or removed. Ido caches directory listings by default, which may cause confusion on Windows. You can disable caching:

(when (equal system-type 'windows-nt)
  (setq ido-max-dir-file-cache 0)) ; caching unreliable

Specifying sort-order

If you'd like to tweak the default file sorting, like making Org-files appear first, tell ido which files to give a higher sort priority:

(setq ido-file-extensions-order '(".org" ".txt" ".py" ".emacs" ".xml" ".el"
				  ".ini" ".cfg" ".conf"))

Sort by mtime instead of alphabetically

If you prefer to sort ido filelist by mtime instead of alphabetically use the package ido-sort-mtime (available in MELPA), which is more reliable than the script below. Which breaks on TRAMP files or if you enter //, etc:

(add-hook 'ido-make-file-list-hook 'ido-sort-mtime)
(add-hook 'ido-make-dir-list-hook 'ido-sort-mtime)
(defun ido-sort-mtime ()
  (setq ido-temp-list
        (sort ido-temp-list
              (lambda (a b)
                (time-less-p
                 (sixth (file-attributes (concat ido-current-directory b)))
                 (sixth (file-attributes (concat ido-current-directory a)))))))
  (ido-to-end  ;; move . files to end (again)
   (delq nil (mapcar
              (lambda (x) (and (char-equal (string-to-char x) ?.) x))
              ido-temp-list))))

External Links

Introduction to Ido Mode

@@ Line 1: / Line 1: @@
 {{Package
 |name=Ido
+|author = Kim F. Storm
 |description=Interactive Do [[MiniBuffer]] Enhancement
 |source=http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/ido.el
@@ Line 24: / Line 25: @@
 ; {{Keys|C-r}}
 : Move to previous ido suggestion.
+; {{Keys|C-f}}
+: Temporarily revert to the default find-file behavior. Handy if [[ido]] won't behave as you'd like.
+; {{Keys|C-j}}
+: Accept the provided text as is, instead of selecting the currently proposed completion.
 == Common Customization ==
@@ Line 32: / Line 39: @@
 (setq ido-enable-flex-matching t)
 </syntaxhighlight>
+=== Ignore Case ===
+{{Snippet|(setq ido-case-fold t)}}
+=== Virtual Buffers ===
+If [[Recentf]] is enabled, you can use {{CommandKeys|C-x b|ido-switch-buffer}} to visit recently closed files by enabling virtual buffers:
+{{Snippet|(setq ido-use-virtual-buffers t)}}
+=== Prevent Auto-Merge ===
+Ido's default behavior when there is no matching file in the current directory is to look in recent working directories. If you prefer to limit {{CommandKeys|C-x C-f|ido-find-file}} to the current directory you can disable this ''auto-merge'' behavior:
+{{Snippet|(setq ido-auto-merge-work-directories-length -1) ;; disable auto-merge}}
+You can still look in other working directories explicitly with {{Keys|M-s|ido-merge-work-directories}}.
+=== Directory Caching on Windows ===
+On [[Windows]] operating systems it can be unreliable to cache directory listings: the directory may not appear to be modified even though files have been added or removed. Ido caches directory listings by default, which may cause confusion on Windows. You can disable caching:
+<syntaxhighlight lang="lisp">
+(when (equal system-type 'windows-nt)
+  (setq ido-max-dir-file-cache 0)) ; caching unreliable
+</syntaxhighlight>
+=== Specifying sort-order ===
+If you'd like to tweak the default file sorting, like making [[Org]]-files appear first, tell [[ido]] which files to give a higher sort priority:
+<syntaxhighlight lang="lisp">
+(setq ido-file-extensions-order '(".org" ".txt" ".py" ".emacs" ".xml" ".el"
+				  ".ini" ".cfg" ".conf"))
+</syntaxhighlight>
+=== Sort by mtime instead of alphabetically ===
+If you prefer to sort ido filelist by mtime instead of alphabetically use the package [https://github.com/pkkm/ido-sort-mtime ido-sort-mtime] (available in MELPA), which is more reliable than the script below. Which breaks on TRAMP files or if you enter //, etc:
+<syntaxhighlight lang="lisp">
+(add-hook 'ido-make-file-list-hook 'ido-sort-mtime)
+(add-hook 'ido-make-dir-list-hook 'ido-sort-mtime)
+(defun ido-sort-mtime ()
+  (setq ido-temp-list
+        (sort ido-temp-list
+              (lambda (a b)
+                (time-less-p
+                 (sixth (file-attributes (concat ido-current-directory b)))
+                 (sixth (file-attributes (concat ido-current-directory a)))))))
+  (ido-to-end  ;; move . files to end (again)
+   (delq nil (mapcar
+              (lambda (x) (and (char-equal (string-to-char x) ?.) x))
+              ido-temp-list))))
+</syntaxhighlight>
 == See Also ==
 [[Helm]]
+[[Smex]], a M-x enhancement
+== External Links ==
+[http://www.masteringemacs.org/articles/2010/10/10/introduction-to-ido-mode/ Introduction to Ido Mode]
 [[Category:Completion]]
-[[Category:Native Package]]
+[[Category:Built-in Package]]
 [[Category:MiniBuffer]]
 [[Category:Convenience]]
-[[Category:Minor modes]]
+[[Category:Minor Mode]]
+[[Category:Buffer Navigation]]
+[[Category:Popular Package]]