[Emacs-diffs] trunk r113533: * doc/misc/ido.texi: New file.

[Xue Fuqiao]

------------------------------------------------------------
revno: 113533
revision-id: address@hidden
parent: address@hidden
committer: Xue Fuqiao <address@hidden>
branch nick: trunk
timestamp: Thu 2013-07-25 06:32:48 +0800
message:
  * doc/misc/ido.texi: New file.
added:
  doc/misc/ido.texi              ido.texi-20130724222900-50gdum2iefexcdgi-1
modified:
  doc/misc/ChangeLog             changelog-20091113204419-o5vbwnq5f7feedwu-6331
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2013-07-19 14:50:21 +0000
+++ b/doc/misc/ChangeLog        2013-07-24 22:32:48 +0000
@@ -1,3 +1,7 @@
+2013-07-24  Xue Fuqiao  <address@hidden>
+
+       * ido.texi: New file.
+
 2013-07-19  Geoff Kuenning  <address@hidden>  (tiny change)
 
        * gnus.texi (Customizing Articles): Document function predicates.

=== added file 'doc/misc/ido.texi'
--- a/doc/misc/ido.texi 1970-01-01 00:00:00 +0000
+++ b/doc/misc/ido.texi 2013-07-24 22:32:48 +0000
@@ -0,0 +1,712 @@
+\input texinfo    @c -*-texinfo-*-
address@hidden ../../info/ido
address@hidden Interactive Do
address@hidden emacsver.texi
+
address@hidden
+This file documents the Ido package for GNU Emacs.
+
+Copyright @copyright{} 2013 Free Software Foundation, Inc.
+
address@hidden
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with the Front-Cover texts being ``A GNU Manual'',
+and with the Back-Cover Texts as in (a) below.  A copy of the license
+is included in the section entitled ``GNU Free Documentation License''.
+
+(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
+modify this GNU manual.''
address@hidden quotation
address@hidden copying
+
address@hidden Emacs lisp libraries
address@hidden
+* Ido: (ido).                     Interactively do things with buffers and 
files.
address@hidden direntry
+
address@hidden
+
address@hidden
address@hidden 6
address@hidden @titlefont{Interactive Do}
address@hidden 4
address@hidden For GNU Emacs
address@hidden 1
address@hidden as distributed with Emacs @value{EMACSVER}
address@hidden 5
address@hidden Kim F. Storm
address@hidden storm@@cua.dk
address@hidden
address@hidden 0pt plus 1filll
address@hidden
address@hidden titlepage
+
address@hidden
+
address@hidden
address@hidden Top
address@hidden Interactive Do
+
address@hidden
address@hidden ifnottex
+
address@hidden
+* Overview::                       Basics, activation.
+* Matching::                       Interactivity, matching, scrolling.
+* Highlighting::                   Highlighting of matching items.
+* Hidden Buffers and Files::       Hidden buffers, files, and directories.
+* Customization::                  Change the Ido functionality.
+* Misc::                           Various other features.
+
+Appendices
+* GNU Free Documentation License:: The license for this documentation.
+
+Indexes
+* Variable Index::                 An entry for each documented variable.
+
address@hidden
+ --- The Detailed Node Listing ---
+
+Overview
+
+* Activation::                     How to use this package.
+
+Matching
+
+* Interactive Substring Matching:: Interactivity, matching, scrolling.
+* Prefix Matching::                Standard completion.
+* Flexible Matching::              More flexible matching.
+* Regexp Matching::                Matching using regular expression.
+
+Customization
+
+* Changing List Order::            Changing the list of files.
+* Find File At Point::             Make Ido guess the context.
+* Ignoring::                       Ignorance is bliss.
+* Misc Customization::             Miscellaneous customization for Ido.
+
+Miscellaneous
+
+* All Matching::                   Seeing all the matching buffers or files.
+* Replacement::                    Replacement for @code{read-buffer} and 
@code{read-file-name}.
+* Other Packages::                 Don't want to depend on 
@code{ido-everywhere}?
+
address@hidden detailmenu
address@hidden menu
+
address@hidden Overview
address@hidden Overview
address@hidden overview
+
address@hidden
+This document describes a set of features that can interactively do
+things with buffers and files.  All the features are described here
+in detail.
+
+The @dfn{Ido} package can let you switch between buffers and visit
+files and directories with a minimum of keystrokes.  It is a superset
+of Iswitchb, the interactive buffer switching package by Stephen
+Eglen.
+
address@hidden author of Ido
address@hidden Iswitchb
+This package was originally written by Kim F. Storm, based on the
+ @file{iswitchb.el} package by Stephen Eglen.
+
address@hidden
+* Activation::                          How to use this package.
address@hidden menu
+
address@hidden Activation
address@hidden Activation
address@hidden activation
address@hidden installation
+
address@hidden
+This package is distributed with Emacs, so there is no need to install
+any additional files in order to start using it.  To activate, use
address@hidden ido-mode}.
+
address@hidden
+You may wish to add the following expressions to your initialization
+file (@pxref{Init File,,The Emacs Initialization File, emacs, GNU
+Emacs Manual}), if you make frequent use of features from this
+package.
+
address@hidden
+(require 'ido)
+(ido-mode t)
address@hidden example
+
address@hidden @node Working Directories
address@hidden @section Working Directories
address@hidden @cindex working directories
+
address@hidden Matching
address@hidden Matching
address@hidden matching
+
address@hidden
+This section describes features of this package that have to
+do with various kinds of @emph{matching}: among buffers, files, and 
directories.
+
address@hidden
+* Interactive Substring Matching:: Interactivity, matching, scrolling.
+* Prefix Matching::                Standard completion.
+* Flexible Matching::              More flexible matching.
+* Regexp Matching::                Matching using regular expression.
address@hidden menu
+
address@hidden Interactive Substring Matching
address@hidden Interactive Substring Matching
address@hidden interactive substring matching
address@hidden substring, interactive matching
address@hidden matching, using substring
+
address@hidden
+As you type in a substring, the list of buffers or files currently
+matching the substring are displayed as you type.  The list is
+ordered so that the most recent buffers or files visited come at
+the start of the list.
+
+The buffer or file at the start of the list will be the one visited
+when you press @key{RET}.  By typing more of the substring, the list
+is narrowed down so that gradually the buffer or file you want will be
+at the top of the list.  Alternatively, you can use @kbd{C-s} and
address@hidden (or the right and left arrow keys) to rotate buffer or file
+names in the list until the one you want is at the top of the list.
+
+Completion is also available so that you can see what is common to
+all of the matching buffers or files as you type.
+
+For example, if there are two buffers called @file{123456} and
address@hidden, with @file{123456} the most recent, when using
address@hidden, you first of all get presented with the list
+of all the buffers
+
address@hidden
+Buffer: @{123456 | address@hidden
address@hidden example
+
+If you then press @kbd{2}:
+
address@hidden
+Buffer: address@hidden | address@hidden
address@hidden example
+
+The list in @address@hidden are the matching buffers, most recent first
+(buffers visible in the current frame are put at the end of the list
+by default).  At any time you can select the item at the head of the
+list by pressing @key{RET}.  You can also put the first element at the
+end of the list by pressing @kbd{C-s} or @kbd{<right>}, or bring the
+last element to the head of the list by pressing @kbd{C-r} or
address@hidden<left>}.
+
+The item in [...] indicates what can be added to your input by
+pressing @key{TAB} (@code{ido-complete}).  In this case, you will get
+"3" added to your input.
+
+So, press @key{TAB}:
+
address@hidden
+Buffer: address@hidden | address@hidden
address@hidden example
+
+At this point, you still have two matching buffers.  If you want the
+first buffer in the list, you can simply press @key{RET}.  If you want
+the second in the list, you can press @kbd{C-s} to move it to the top
+of the list and then press @kbd{RET} to select it.
+
+However, if you type @kbd{4}, you'll only have one match left:
+
address@hidden
+Buffer: 234[123456]
address@hidden example
+
+Since there is only one matching buffer left, it is given in [] and it
+is shown in the @code{ido-only-match} face (ForestGreen).  You can now
+press @key{TAB} or @key{RET} to go to that buffer.
+
+If you want to create a new buffer named @file{234}, you can press
address@hidden (@code{ido-select-text}) instead of @key{TAB} or @key{RET}.
+
+If instead, you type @kbd{a}:
+
address@hidden
+Buffer: 234a [No match]
address@hidden example
+
+There are no matching buffers.  If you press @key{RET} or @key{TAB},
+you can be prompted to create a new buffer called @file{234a}.
+
+Of course, where this function comes in really useful is when you can
+specify the buffer using only a few keystrokes.  In the above example,
+the quickest way to get to the @file{123456} file would be just to
+type @kbd{4} and then @key{RET} (assuming there isn't any newer buffer
+with @kbd{4} in its name).
+
+Likewise, if you use @kbd{C-x C-f} (@code{ido-find-file}), the list of
+files and directories in the current directory is provided in the same
+fashion as the buffers above.  The files and directories are normally
+sorted in alphabetical order, but the most recently visited directory
+is placed first to speed up navigating to directories that you have
+visited recently.
+
+In addition to scrolling through the list using @kbd{<right>} and
address@hidden<left>}, you can use @kbd{<up>} and @kbd{<down>} to quickly
+scroll the list to the next or previous subdirectory.
+
+To go down into a subdirectory, and continue the file selection on
+the files in that directory, simply move the directory to the head
+of the list and hit @key{RET}.
+
+To go up to the parent directory, delete any partial file name already
+specified (e.g. using @key{DEL}) and hit @key{DEL}.
+
address@hidden @defun ido-delete-backward-updir
+
address@hidden root directory
address@hidden home directory
+To go to the root directory (on the current drive), enter two slashes.
+On MS-DOS or Windows, to select the root of another drive, enter
address@hidden:/} where @samp{X} is the drive letter.  To go to the home
+directory, enter @samp{~/}.  To enter Dired for this directory, use
address@hidden  
+
address@hidden TODO: a new node for ftp hosts
address@hidden ftp hosts
+You can also visit files on other hosts using the ange-ftp
+notations @samp{/host:} and @samp{/user@@host:}.
address@hidden @defvr {User Option} ido-record-ftp-work-directories
address@hidden @defvr {User Option} ido-merge-ftp-work-directories
address@hidden @defvr {User Option} ido-cache-ftp-work-directory-time
address@hidden @defvr {User Option} ido-slow-ftp-hosts
address@hidden @defvr {User Option} ido-slow-ftp-host-regexps
+
+You can type @kbd{M-p} and @kbd{M-n} to change to previous/next
+directories from the history, @kbd{M-s} to search for a file matching
+your input, and @kbd{M-k} to remove the current directory from the history.
+
+If for some reason you cannot specify the proper file using
address@hidden, you can press @kbd{C-f} to enter the normal
address@hidden  You can also press @kbd{C-b} to drop into
address@hidden
+
address@hidden @kindex C-x b
address@hidden @findex ido-switch-buffer
address@hidden @defun ido-switch-buffer
address@hidden This command switch to another buffer interactively.
address@hidden @end defun
+
address@hidden @kindex C-x C-f
address@hidden @findex ido-find-file
address@hidden @defun ido-find-file
address@hidden Edit file with name obtained via minibuffer.
address@hidden @end defun
+
address@hidden @kindex C-x d
address@hidden @findex ido-dired
address@hidden @defun ido-dired
address@hidden Call Dired the Ido way.
address@hidden @end defun
+
address@hidden Prefix Matching
address@hidden Prefix Matching
address@hidden prefix matching
address@hidden matching, using prefix
address@hidden standard way of completion
+
address@hidden
+The standard way of completion with *nix shells and Emacs is to insert
+a @dfn{prefix} and then hitting @key{TAB} (or another completion key).
+Cause of this behavior has become second nature to a lot of Emacs
+users Ido offers in addition to the default substring matching method
+(look above) also the prefix matching method.  The kind of matching is
+the only difference to the description of the substring matching
+above.
+
+You can toggle prefix matching with @kbd{C-p}
+(@code{ido-toggle-prefix}).
+
+For example, if you have two buffers @file{123456} and @file{123} then
+hitting @kbd{2} does not match because @kbd{2} is not a prefix in any
+of the buffer names.
+
address@hidden Flexible Matching
address@hidden Flexible Matching
address@hidden flexible matching
+
address@hidden {User Option} ido-enable-flex-matching
+If address@hidden, Ido will do flexible string matching.  Flexible
+matching means that if the entered string does not match any item, any
+item containing the entered characters in the given sequence will
+match.
address@hidden defvr
+
address@hidden
+If @code{ido-enable-flex-matching} is address@hidden, Ido will do a
+more flexible matching (unless regexp matching is active) to find
+possible matches among the available buffer or file names if no
+matches are found using the normal prefix or substring matching.
+
+The flexible matching implies that any item which simply contains all
+of the entered characters in the specified sequence will match.
+
+For example, if you have four files @file{alpha}, @file{beta},
address@hidden, and @file{delta}, entering @samp{aa} will match
address@hidden and @file{gamma}, while @samp{ea} matches @file{beta} and
address@hidden  If prefix matching is also active, @samp{aa} only
+matches @file{alpha}, while @samp{ea} does not match any files.
+
address@hidden Regexp Matching
address@hidden Regular Expression Matching
address@hidden regexp matching
address@hidden matching, using regular expression
+
address@hidden
+There is limited provision for regexp matching within Ido, enabled
+through @code{ido-enable-regexp} (toggle with @kbd{C-t}).  This allows
+you to type @samp{[ch]$} for example and see all file names ending in
address@hidden or @samp{h}.
+
address@hidden {User Option} ido-enable-regexp
+If the value of this user option is address@hidden, Ido will do regexp
+matching.  The value of this user option can be toggled within
+ido-mode using @code{ido-toggle-regexp}.
address@hidden defvr
+
address@hidden notice:} Ido-style completion is inhibited when you
+enable regexp matching.
+
address@hidden Highlighting
address@hidden Highlighting
address@hidden highlighting
+
address@hidden
+The highlighting of matching items is controlled via
address@hidden  The faces used are @code{ido-first-match},
address@hidden and @code{ido-subdir}.
+
+Coloring of the matching item was suggested by Carsten Dominik.
+
address@hidden Hidden Buffers and Files
address@hidden Hidden Buffers and Files
address@hidden hidden buffers and files
+
+Normally, Ido does not include hidden buffers (whose name starts with
+a space) and hidden files and directories (whose name starts with
address@hidden) in the list of possible completions.  However, if the
+substring you enter does not match any of the visible buffers or
+files, Ido will automatically look for completions among the hidden
+buffers or files.
+
+You can toggle display of the hidden buffers and files with @kbd{C-a}
+(@code{ido-toggle-ignore}).
+
address@hidden @defun ido-toggle-ignore
+
address@hidden Customization
address@hidden Customization
address@hidden customization
+
address@hidden
+You can customize the @code{ido} group to change Ido functionality:
+
address@hidden
+M-x customize-group RET ido RET
address@hidden example
+
address@hidden
+or customize a certain variable:
+
address@hidden
+M-x customize-variable RET ido-xxxxx
address@hidden example
+
+To modify the keybindings, use the @code{ido-setup-hook}.  For example:
+
address@hidden
+(add-hook 'ido-setup-hook 'ido-my-keys)
+
+(defun ido-my-keys ()
+ "Add my keybindings for Ido."
+ (define-key ido-completion-map " " 'ido-next-match))
address@hidden example
+
address@hidden
+* Changing List Order::         Changing the list of files.
+* Find File At Point::          Make Ido guess the context.
+* Ignoring::                    Ignorance is bliss.
+* Misc Customization::          Miscellaneous customization for Ido.
address@hidden menu
+
address@hidden Changing List Order
address@hidden Changing List Order
address@hidden changing order of the list
+
address@hidden
+By default, the list of current files is most recent first,
+oldest last, with the exception that the files visible in the
+current frame are put at the end of the list.  A hook exists to
+allow other functions to order the list.  For example, if you add:
+
address@hidden
+(add-hook 'ido-make-buffer-list-hook 'ido-summary-buffers-to-end)
address@hidden example
+
address@hidden
+then all files matching "Summary" are moved to the end of the list.
+(I find this handy for keeping the INBOX Summary and so on out of the
+way.)  It also moves files matching @samp{output\*$} to the end of the
+list (these are created by AUCTeX when compiling.)  Other functions
+could be made available which alter the list of matching files (either
+deleting or rearranging elements.)
+
address@hidden Find File At Point
address@hidden Find File At Point
address@hidden find file at point
address@hidden ffap
+
address@hidden
+Find File At Point, also known generally as ``ffap'', is an
+intelligent system for opening files, and URLs.
+
+The following expression will make Ido guess the context:
+
address@hidden
+(setq ido-use-filename-at-point 'guess)
address@hidden example
+
address@hidden @defvr {User Option} ido-use-filename-at-point
address@hidden If the value of this user option is address@hidden, ...
address@hidden @end defvr
+
+You can disable URL ffap support by toggling
address@hidden
+
address@hidden {User Option} ido-use-url-at-point
+If the value of this user option is address@hidden, Ido will look for
+a URL at point.  If found, call @code{find-file-at-point} to visit it.
address@hidden defvr
+
address@hidden Ignoring
address@hidden Ignoring Buffers and Files
address@hidden ignoring
address@hidden regexp, ignore buffers and files
+
address@hidden
+Ido is capable of ignoring buffers, directories, files and extensions
+using regular expression.
+
address@hidden {User Option} ido-ignore-buffers
+This variable takes a list of regular expressions for buffers to
+ignore in @code{ido-switch-buffer}.
address@hidden defvr
+
address@hidden {User Option} ido-ignore-directories
+This variable takes a list of regular expressions for (sub)directories
+names to ignore in @code{ido-dired} and @code{ido-find-file}.
address@hidden defvr
+
address@hidden {User Option} ido-ignore-files
+This variable takes a list of regular expressions for files to ignore
+in @code{ido-find-file}.
address@hidden defvr
+
address@hidden {User Option} ido-ignore-unc-host-regexps
+This variable takes a list of regular expressions matching UNC hosts
+to ignore.  The letter case will be ignored if
address@hidden is address@hidden
address@hidden defvr
+
address@hidden @defvr {User Option} ido-work-directory-list-ignore-regexps
+
+To make Ido use @code{completion-ignored-extensions} you need to
+enable it:
+
address@hidden
+(setq ido-ignore-extensions t)
address@hidden example
+
+Now you can customize @code{completion-ignored-extensions} as well.
+Go ahead and add all the useless object files, backup files, shared
+library files and other computing flotsam you don’t want Ido to show.
+
address@hidden notice:} Ido will still complete the ignored elements
+if it would otherwise not show any other matches.  So if you type out
+the name of an ignored file, Ido will still let you open it just fine.
+
address@hidden Misc Customization
address@hidden Miscellaneous Customization
address@hidden miscellaneous customization for Ido
+
address@hidden {User Option} ido-mode
+This user option determines for which functional group (buffer and
+files) Ido behavior should be enabled.
address@hidden defvr
+
address@hidden {User Option} ido-case-fold
+If the value of this user option is address@hidden, searching of
+buffer and file names should ignore case.
address@hidden defvr
+
address@hidden {User Option} ido-show-dot-for-dired
+If the value of this user option is address@hidden , always put
address@hidden  as the first item in file name lists.  This allows the
+current directory to be opened immediately with Dired
address@hidden defvr
+
address@hidden {User Option} ido-enable-dot-prefix
+If the value of this user option is address@hidden, Ido will match
+leading dot as prefix.  I.e., hidden files and buffers will match only
+if you type a dot as first char (even if @code{ido-enable-prefix} is
address@hidden).
address@hidden defvr
+
address@hidden @defvr {User Option} ido-confirm-unique-completion
address@hidden @defvr {User Option} ido-cannot-complete-command
address@hidden @defvr {User Option} ido-record-commands
address@hidden @defvr {User Option} ido-max-file-prompt-width
address@hidden @defvr {User Option} ido-max-window-height
address@hidden @defvr {User Option} ido-enable-last-directory-history
address@hidden @defvr {User Option} ido-max-work-directory-list
address@hidden @defvr {User Option} ido-enable-tramp-completion
address@hidden @defvr {User Option} ido-unc-hosts
address@hidden @defvr {User Option} ido-downcase-unc-hosts
address@hidden @defvr {User Option} ido-cache-unc-host-shares-time
address@hidden @defvr {User Option} ido-max-work-file-list
address@hidden @defvr {User Option} ido-work-directory-match-only
address@hidden @defvr {User Option} ido-auto-merge-work-directories-length
address@hidden @defvr {User Option} ido-auto-merge-delay-time
address@hidden @defvr {User Option} ido-auto-merge-inhibit-characters-regexp
address@hidden @defvr {User Option} ido-merged-indicator
address@hidden @defvr {User Option} ido-max-dir-file-cache
address@hidden @defvr {User Option} ido-max-directory-size
address@hidden @defvr {User Option} ido-rotate-file-list-default
address@hidden @defvr {User Option} ido-enter-matching-directory
address@hidden @defvr {User Option} ido-create-new-buffer
address@hidden @defvr {User Option} ido-setup-hook 
address@hidden @defvr {User Option} ido-separator
address@hidden @defvr {User Option} ido-decorations
address@hidden @defvr {User Option} ido-use-virtual-buffers
address@hidden @defvr {User Option} ido-use-faces
address@hidden @defvr {User Option} ido-make-file-list-hook 
address@hidden @defvr {User Option} ido-make-dir-list-hook 
address@hidden @defvr {User Option} ido-make-buffer-list-hook 
address@hidden @defvr {User Option} ido-rewrite-file-prompt-functions
address@hidden @defvr {User Option} ido-completion-buffer
address@hidden @defvr {User Option} ido-completion-buffer-all-completions
address@hidden @defvr {User Option} ido-all-frames
address@hidden @defvr {User Option} ido-minibuffer-setup-hook
address@hidden @defvr {User Option} ido-save-directory-list-file
address@hidden @defvr {User Option} ido-read-file-name-as-directory-commands
address@hidden @defvr {User Option} ido-read-file-name-non-ido
address@hidden @defvr {User Option} ido-before-fallback-functions
address@hidden @defvr {User Option} ido-buffer-disable-smart-matches
+
address@hidden Misc
address@hidden Miscellaneous
address@hidden miscellaneous
+
address@hidden
+After @kbd{C-x b} (@code{ido-switch-buffer}), the buffer at the head
+of the list can be killed by pressing @kbd{C-k}.  If the buffer needs
+saving, you will be queried before the buffer is killed.
+
+Likewise, after @kbd{C-x C-f}, you can delete (i.e., physically
+remove) the file at the head of the list with @kbd{C-k}.  You will
+always be asked for confirmation before deleting the file.
+
+If you enter @kbd{C-x b} to switch to a buffer visiting a given file,
+and you find that the file you are after is not in any buffer, you can
+press @kbd{C-f} to immediately drop into @code{ido-find-file}.  And
+you can switch back to buffer selection with @kbd{C-b}.
+
address@hidden @defun ido-magic-forward-char
address@hidden @defun ido-magic-backward-char
+
+You can also use Ido in your Emacs Lisp programs:
+
address@hidden
+(setq my-pkgs (list "CEDET" "Gnus" "Rcirc" "Tramp" "Org" "all-of-them"))
+(ido-completing-read "What's your favorite package? " my-pkgs)
address@hidden example
+
address@hidden
+* All Matching::                Seeing all the matching buffers or files.
+* Replacement::                 Replacement for @code{read-buffer} and 
@code{read-file-name}.
+* Other Packages::              Don't want to depend on @code{ido-everywhere}?
address@hidden menu
+
address@hidden All Matching
address@hidden All Matching
address@hidden all matching
address@hidden seeing all the matching buffers or files
+
address@hidden
+If you have many matching files, they may not all fit onto one line of
+the minibuffer.  Normally, the minibuffer window will grow to show you
+more of the matching files (depending on the value of the variables
address@hidden and @code{max-mini-window-height}).  If you
+want Ido to behave differently from the default minibuffer resizing
+behavior, set the variable @code{ido-max-window-height}.
+
+Also, to improve the responsiveness of Ido, the maximum number of
+matching items is limited to 12, but you can increase or removed this
+limit via the @code{ido-max-prospects} user option.
+
address@hidden @defvr {User Option} ido-max-prospects
+
+To see a full list of all matching buffers in a separate buffer, hit
address@hidden or press @key{TAB} when there are no further completions to
+the substring.  Repeated @key{TAB} presses will scroll you through
+this separate buffer.
+
address@hidden Replacement
address@hidden Replacement
+
address@hidden
address@hidden and @code{ido-read-file-name} have been written
+to be drop in replacements for the normal buffer and file name reading
+functions @code{read-buffer} and @code{read-file-name}.
+
+To use ido for all buffer and file selections in Emacs, customize the
+variable @code{ido-everywhere}.
+
address@hidden @defun ido-everywhere
address@hidden @defvr {User Option} ido-everywhere
+
address@hidden Other Packages
address@hidden Other Packages
address@hidden other packages
address@hidden used by other packages
+
address@hidden
+If you don't want to rely on the @code{ido-everywhere} functionality,
address@hidden, @code{ido-read-file-name}, and
address@hidden can be used by other packages to read a
+buffer name, a file name, or a directory name in the @emph{Ido} way.
+
address@hidden @node Cheetsheet
+
address@hidden * History and Acknowledgments::     How Ido came into being
address@hidden @node History and Acknowledgments
address@hidden @appendix History and Acknowledgments
+
address@hidden GNU Free Documentation License
address@hidden GNU Free Documentation License
address@hidden doclicense.texi
+
address@hidden @node Function Index
address@hidden @unnumbered Function Index
+
address@hidden @printindex fn
+
address@hidden Variable Index
address@hidden Variable Index
+
address@hidden vr
+
address@hidden

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2013-07-24 06:21:07 +0000
+++ b/etc/NEWS  2013-07-24 22:32:48 +0000
@@ -180,9 +180,6 @@
 See `remember-data-directory' and `remember-directory-file-name-format'
 for new options related to this function.
 
-** `ido-use-virtual-buffers' takes a new value 'auto.
-** `ido-decorations' has been slightly extended to give a bit more control.
-
 ** More packages look for ~/.emacs.d/<foo> additionally to ~/.<foo>.
 Affected files:
 ~/.emacs.d/timelog     replaces  ~/.timelog
@@ -283,6 +280,11 @@
 *** The icomplete-separator is customizable, and its default has changed.
 *** Removed icomplete-show-key-bindings.
 
+** Ido
+*** Ido has a manual now.
+** `ido-use-virtual-buffers' takes a new value 'auto.
+** `ido-decorations' has been slightly extended to give a bit more control.
+
 ** Image mode
 
 *** New commands `n' (`image-next-file') and `p' (`image-previous-file')