[Emacs-diffs] trunk r113756: Add documentation for working directory in Ido.

[Xue Fuqiao]

------------------------------------------------------------
revno: 113756
revision-id: address@hidden
parent: address@hidden
committer: Xue Fuqiao <address@hidden>
branch nick: trunk
timestamp: Thu 2013-08-08 20:31:38 +0800
message:
  Add documentation for working directory in Ido.
  
  * doc/misc/ido.texi (Top): Insert node "Working Directories" in menu.
  (Working Directories): New node.
  
  
  doc/misc/sc.texi: (What Supercite Does): Typo fix.
modified:
  doc/misc/ChangeLog             changelog-20091113204419-o5vbwnq5f7feedwu-6331
  doc/misc/ido.texi              ido.texi-20130724222900-50gdum2iefexcdgi-1
  doc/misc/sc.texi               sc.texi-20091113204419-o5vbwnq5f7feedwu-6318

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2013-08-07 14:15:23 +0000
+++ b/doc/misc/ChangeLog        2013-08-08 12:31:38 +0000
@@ -1,3 +1,8 @@
+2013-08-08  Xue Fuqiao  <address@hidden>
+
+       * ido.texi (Top): Insert node "Working Directories" in menu.
+       (Working Directories): New node.
+
 2013-08-07  Eli Zaretskii  <address@hidden>
 
        * todo-mode.texi: Update @dircategory.
@@ -21,6 +26,7 @@
        (Mail Field Commands)
        (Hints to MUA Authors, Thanks and History): Change from one space
        between sentences to two.
+       (What Supercite Does): Typo fix.
 
        * newsticker.texi (Usage): Use @key for RET.
 

=== modified file 'doc/misc/ido.texi'
--- a/doc/misc/ido.texi 2013-07-27 22:14:07 +0000
+++ b/doc/misc/ido.texi 2013-08-08 12:31:38 +0000
@@ -53,45 +53,46 @@
 @end ifnottex
 
 @menu
-* 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.
+* 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.
+* GNU Free Documentation License::  The license for this documentation.
 
 Indexes
-* Variable Index::                 An entry for each documented variable.
+* Variable Index::              An entry for each documented variable.
 
 @detailmenu
  --- The Detailed Node Listing ---
 
 Overview
 
-* Activation::                     How to use this package.
+* Activation::                  How to use this package.
+* Working Directories::         Where files have most recently been opened.
 
 Matching
 
-* Interactive Substring Matching:: Interactivity, matching, scrolling.
-* Prefix Matching::                Standard completion.
-* Flexible Matching::              More flexible matching.
-* Regexp Matching::                Matching using regular expression.
+* 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.
+* 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}?
+* 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}?
 
 @end detailmenu
 @end menu
@@ -116,7 +117,8 @@
  @file{iswitchb.el} package by Stephen Eglen.
 
 @menu
-* Activation::                          How to use this package.
+* Activation::                  How to use this package.
+* Working Directories::         Where files have most recently been opened.
 @end menu
 
 @node Activation
@@ -140,9 +142,56 @@
 (ido-mode t)
 @end example
 
address@hidden @node Working Directories
address@hidden @section Working Directories
address@hidden @cindex working directories
address@hidden Working Directories
address@hidden Working Directories
address@hidden working directories
+
address@hidden ido-work-directory-list
address@hidden
address@hidden directories} are directories where files have most
+recently been opened.  The current directory is inserted at the front
+of this @code{ido-work-directory-list} whenever a file is opened with
address@hidden and other file-related functions.
+
address@hidden @cindex merge
address@hidden or maybe a new node for ``merge''
+
address@hidden @findex ido-merge-work-directories
address@hidden @defun ido-merge-work-directories
address@hidden @end defun
+
address@hidden @findex ido-prev-work-directory
address@hidden @defun ido-prev-work-directory
address@hidden @end defun
+
address@hidden @findex ido-next-work-directory
address@hidden @defun ido-next-work-directory
address@hidden @end defun
+
address@hidden @findex ido-forget-work-directory
address@hidden @defun ido-forget-work-directory
address@hidden @end defun
+
address@hidden @vindex ido-use-merged-list
address@hidden @vindex ido-try-merged-list
address@hidden @vindex ido-pre-merge-state
+
address@hidden {User Option} ido-max-work-directory-list
+This user option specifies maximum number of working directories to
+record.
address@hidden defvr
+
address@hidden see (info "(elisp) File Name Completion")
address@hidden {User Option} 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
address@hidden results.  Each cache entry is time
+stamped with the modification time of the directory.  Some systems,
+like MS-Windows, have unreliable directory modification times, so you
+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
 
 @node Matching
 @chapter Matching
@@ -153,10 +202,10 @@
 do with various kinds of @emph{matching}: among buffers, files, and 
directories.
 
 @menu
-* Interactive Substring Matching:: Interactivity, matching, scrolling.
-* Prefix Matching::                Standard completion.
-* Flexible Matching::              More flexible matching.
-* Regexp Matching::                Matching using regular expression.
+* Interactive Substring Matching::  Interactivity, matching, scrolling.
+* Prefix Matching::             Standard completion.
+* Flexible Matching::           More flexible matching.
+* Regexp Matching::             Matching using regular expression.
 @end menu
 
 @node Interactive Substring Matching
@@ -521,6 +570,7 @@
 @code{ido-downcase-unc-hosts} is address@hidden
 @end defvr
 
address@hidden FIXME: Where to add this variable?  This node or ``working 
directory''?
 @c @defvr {User Option} ido-work-directory-list-ignore-regexps
 
 To make Ido use @code{completion-ignored-extensions} you need to
@@ -571,7 +621,6 @@
 @c @defvr {User Option} ido-max-file-prompt-width
 @c @defvr {User Option} ido-max-window-height
 @c @defvr {User Option} ido-enable-last-directory-history
address@hidden @defvr {User Option} ido-max-work-directory-list
 @c @defvr {User Option} ido-enable-tramp-completion
 @c @defvr {User Option} ido-unc-hosts
 @c @defvr {User Option} ido-downcase-unc-hosts
@@ -582,7 +631,6 @@
 @c @defvr {User Option} ido-auto-merge-delay-time
 @c @defvr {User Option} ido-auto-merge-inhibit-characters-regexp
 @c @defvr {User Option} ido-merged-indicator
address@hidden @defvr {User Option} ido-max-dir-file-cache
 @c @defvr {User Option} ido-max-directory-size
 @c @defvr {User Option} ido-rotate-file-list-default
 @c @defvr {User Option} ido-enter-matching-directory

=== modified file 'doc/misc/sc.texi'
--- a/doc/misc/sc.texi  2013-08-07 13:19:48 +0000
+++ b/doc/misc/sc.texi  2013-08-08 12:31:38 +0000
@@ -186,7 +186,7 @@
 
 @cindex modeline
 Next, Supercite visits each line in the reply, transforming the line
-according to a customizable ``script.''  Lines which were not previously
+according to a customizable ``script''.  Lines which were not previously
 cited in the original message are given a citation, while already cited
 lines remain untouched, or are coerced to your preferred style.
 Finally, Supercite installs a keymap into the reply buffer so that you