[Emacs-diffs] trunk r113783: * doc/misc/ido.texi (Working Directories):

[Xue Fuqiao]

------------------------------------------------------------
revno: 113783
revision-id: address@hidden
parent: address@hidden
committer: Xue Fuqiao <address@hidden>
branch nick: trunk
timestamp: Sat 2013-08-10 12:58:31 +0800
message:
  * doc/misc/ido.texi (Working Directories):
  (Flexible Matching, Regexp Matching, Find File At Point)
  (Ignoring, Misc Customization): Use @defopt for user options.
modified:
  doc/lispref/frames.texi        
frames.texi-20091113204419-o5vbwnq5f7feedwu-6180
  doc/misc/ChangeLog             changelog-20091113204419-o5vbwnq5f7feedwu-6331
  doc/misc/ido.texi              ido.texi-20130724222900-50gdum2iefexcdgi-1

=== modified file 'doc/lispref/frames.texi'
--- a/doc/lispref/frames.texi   2013-03-23 09:33:00 +0000
+++ b/doc/lispref/frames.texi   2013-08-10 04:58:31 +0000
@@ -446,7 +446,7 @@
 If you invoke Emacs with command-line options that specify frame
 appearance, those options take effect by adding elements to either
 @code{initial-frame-alist} or @code{default-frame-alist}.  Options
-which affect just the initial frame, such as @samp{-geometry} and
+which affect just the initial frame, such as @samp{--geometry} and
 @samp{--maximized}, add to @code{initial-frame-alist}; the others add
 to @code{default-frame-alist}.  @pxref{Emacs Invocation,, Command Line
 Arguments for Emacs Invocation, emacs, The GNU Emacs Manual}.

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2013-08-09 00:51:03 +0000
+++ b/doc/misc/ChangeLog        2013-08-10 04:58:31 +0000
@@ -1,3 +1,9 @@
+2013-08-10  Xue Fuqiao  <address@hidden>
+
+       * ido.texi (Working Directories):
+       (Flexible Matching, Regexp Matching, Find File At Point)
+       (Ignoring, Misc Customization): Use @defopt for user options.
+
 2013-08-09  Xue Fuqiao  <address@hidden>
 
        * htmlfontify.texi (Customization): Remove documentation of

=== modified file 'doc/misc/ido.texi'
--- a/doc/misc/ido.texi 2013-08-08 23:56:25 +0000
+++ b/doc/misc/ido.texi 2013-08-10 04:58:31 +0000
@@ -168,13 +168,13 @@
 @c @defvar ido-try-merged-list
 @c @defvar ido-pre-merge-state
 
address@hidden {User Option} ido-max-work-directory-list
address@hidden ido-max-work-directory-list
 This user option specifies maximum number of working directories to
 record.
address@hidden defvr
address@hidden defopt
 
 @c see (info "(elisp) File Name Completion")
address@hidden {User Option} ido-max-dir-file-cache
address@hidden ido-max-dir-file-cache
 This user option specifies maximum number of working directories to be
 cached.  This is the size of the cache of
 @code{file-name-all-completions} results.  Each cache entry is time
@@ -183,7 +183,7 @@
 may choose to disable caching on such systems, or explicitly refresh
 the cache contents using the command @code{ido-reread-directory}
 (usually @kbd{C-l}) in the minibuffer.
address@hidden defvr
address@hidden defopt
 
 @node Matching
 @chapter Matching
@@ -320,11 +320,11 @@
 @cindex 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
address@hidden @defopt ido-record-ftp-work-directories
address@hidden @defopt ido-merge-ftp-work-directories
address@hidden @defopt ido-cache-ftp-work-directory-time
address@hidden @defopt ido-slow-ftp-hosts
address@hidden @defopt 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
@@ -377,12 +377,12 @@
 @section Flexible Matching
 @cindex flexible matching
 
address@hidden {User Option} ido-enable-flex-matching
address@hidden 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 defopt
 
 @noindent
 If @code{ido-enable-flex-matching} is address@hidden, Ido will do a
@@ -410,11 +410,11 @@
 you to type @samp{[ch]$} for example and see all file names ending in
 @samp{c} or @samp{h}.
 
address@hidden {User Option} ido-enable-regexp
address@hidden 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 defopt
 
 @strong{Please notice:} Ido-style completion is inhibited when you
 enable regexp matching.
@@ -474,7 +474,7 @@
  (define-key ido-completion-map " " 'ido-next-match))
 @end example
 
address@hidden @defvr {User Option} ido-setup-hook
address@hidden @defopt ido-setup-hook
 @c a new node for Ido hooks?
 
 @menu
@@ -521,17 +521,17 @@
 (setq ido-use-filename-at-point 'guess)
 @end example
 
address@hidden @defvr {User Option} ido-use-filename-at-point
address@hidden @defopt ido-use-filename-at-point
 @c If the value of this user option is address@hidden, ...
address@hidden @end defvr
address@hidden @end defopt
 
 You can disable URL ffap support by toggling
 @code{ido-use-url-at-point}.
 
address@hidden {User Option} ido-use-url-at-point
address@hidden 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 defopt
 
 @node Ignoring
 @section Ignoring Buffers and Files
@@ -542,29 +542,29 @@
 Ido is capable of ignoring buffers, directories, files and extensions
 using regular expression.
 
address@hidden {User Option} ido-ignore-buffers
address@hidden 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 defopt
 
address@hidden {User Option} ido-ignore-directories
address@hidden 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 defopt
 
address@hidden {User Option} ido-ignore-files
address@hidden 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 defopt
 
address@hidden {User Option} ido-ignore-unc-host-regexps
address@hidden 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
 @code{ido-downcase-unc-hosts} is address@hidden
address@hidden defvr
address@hidden defopt
 
 @c FIXME: Where to add this variable?  This node or ``working directory''?
address@hidden @defvr {User Option} ido-work-directory-list-ignore-regexps
address@hidden @defopt ido-work-directory-list-ignore-regexps
 
 To make Ido use @code{completion-ignored-extensions} you need to
 enable it:
@@ -588,114 +588,114 @@
 @c Variables described in this sections may be moved to new nodes in
 @c the future.
 
address@hidden {User Option} ido-mode
address@hidden ido-mode
 This user option determines for which functional group (buffer and
 files) Ido behavior should be enabled.
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-case-fold
address@hidden 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 defopt
 
address@hidden {User Option} ido-show-dot-for-dired
address@hidden ido-show-dot-for-dired
 If the value of this user option is address@hidden, always put
 @samp{.}  as the first item in file name lists.  This allows the
 current directory to be opened immediately with Dired
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-enable-dot-prefix
address@hidden 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
 @code{nil}).
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-confirm-unique-completion
address@hidden ido-confirm-unique-completion
 If the value of this user option is address@hidden, even a unique
 completion must be confirmed.  This means that @code{ido-complete}
 (@key{TAB}) must always be followed by @code{ido-exit-minibuffer}
 (@key{RET}) even when there is only one unique completion.
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-cannot-complete-command
address@hidden ido-cannot-complete-command
 When @code{ido-complete} can't complete any more, it will run the
 command specified by this user option.  The most useful values are
 @code{ido-completion-help}, which pops up a window with completion
 alternatives, or @code{ido-next-match} or @code{ido-prev-match}, which
 cycle the buffer list.
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-max-file-prompt-width
address@hidden ido-max-file-prompt-width
 This user option specifies the upper limit of the prompt string.  If
 its value is an integer, it specifies the number of characters of the
 string.  If its value is a floating point number, it specifies a
 fraction of the frame width.
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-max-window-height
address@hidden ido-max-window-height
 If the value of this user option is address@hidden, its value will
 override the variable @code{max-mini-window-height}, which is the
 maximum height for resizing mini-windows (the minibuffer and the echo
 area).  If it's a floating point number, it specifies a fraction of
 the mini-window frame's height.  If it's an integer, it specifies the
 number of lines.
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-record-commands
address@hidden ido-record-commands
 If the value of this user option is address@hidden, Ido will record
 commands in the variable @code{command-history}.  Note that non-Ido
 equivalent is recorded.
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-all-frames
address@hidden ido-all-frames
 This user option will be passed to @code{walk-windows} as its
 @var{all-frames} argument when Ido is finding buffers.  @xref{Cyclic
 Window Ordering, , Cyclic Ordering of Windows, elisp, GNU Emacs Lisp
 Reference Manual}.
address@hidden defvr
address@hidden defopt
 
address@hidden {User Option} ido-minibuffer-setup-hook
address@hidden ido-minibuffer-setup-hook
 This hook variable contains Ido-specific customization of minibuffer
 setup.  It is run during minibuffer setup if Ido is active, and is
 intended for use in customizing ido for interoperation with other
 packages.
address@hidden defvr
address@hidden defopt
 
address@hidden @defvr {User Option} ido-enable-tramp-completion
address@hidden @defopt ido-enable-tramp-completion
 @c cross-reference to tramp.texi
 
 @c @cindex UNC host names, 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 @defopt ido-unc-hosts
address@hidden @defopt ido-downcase-unc-hosts
address@hidden @defopt ido-cache-unc-host-shares-time
 
address@hidden @defvr {User Option} ido-enable-last-directory-history
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-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-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-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 @defopt ido-enable-last-directory-history
address@hidden @defopt ido-max-work-file-list
address@hidden @defopt ido-work-directory-match-only
address@hidden @defopt ido-auto-merge-work-directories-length
address@hidden @defopt ido-auto-merge-delay-time
address@hidden @defopt ido-auto-merge-inhibit-characters-regexp
address@hidden @defopt ido-merged-indicator
address@hidden @defopt ido-max-directory-size
address@hidden @defopt ido-rotate-file-list-default
address@hidden @defopt ido-enter-matching-directory
address@hidden @defopt ido-create-new-buffer
address@hidden @defopt ido-separator
address@hidden @defopt ido-decorations
address@hidden @defopt ido-use-virtual-buffers
address@hidden @defopt ido-use-faces
address@hidden @defopt ido-make-file-list-hook
address@hidden @defopt ido-make-dir-list-hook
address@hidden @defopt ido-make-buffer-list-hook
address@hidden @defopt ido-rewrite-file-prompt-functions
address@hidden @defopt ido-completion-buffer
address@hidden @defopt ido-completion-buffer-all-completions
address@hidden @defopt ido-save-directory-list-file
address@hidden @defopt ido-read-file-name-as-directory-commands
address@hidden @defopt ido-read-file-name-non-ido
address@hidden @defopt ido-before-fallback-functions
address@hidden @defopt ido-buffer-disable-smart-matches
 
 @node Misc
 @chapter Miscellaneous
@@ -748,7 +748,7 @@
 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
address@hidden @defopt ido-max-prospects
 
 To see a full list of all matching buffers in a separate buffer, hit
 @kbd{?} or press @key{TAB} when there are no further completions to
@@ -767,7 +767,7 @@
 variable @code{ido-everywhere}.
 
 @c @deffn Command ido-everywhere
address@hidden @defvr {User Option} ido-everywhere
address@hidden @defopt ido-everywhere
 
 @node Other Packages
 @section Other Packages