]> git.eshelyaron.com Git - emacs.git/commitdiff
Remove filecache.el
authorEshel Yaron <me@eshelyaron.com>
Fri, 16 Feb 2024 07:19:30 +0000 (08:19 +0100)
committerEshel Yaron <me@eshelyaron.com>
Fri, 16 Feb 2024 07:19:30 +0000 (08:19 +0100)
This library doesn't work well in recent Emacsen, and more modern
workflows generally supersede it.

* doc/emacs/emacs.texi (Top)
* doc/emacs/files.texi (Files): Update menu.
(File Name Cache): Remove section.
* doc/lispref/minibuf.texi (Text from Minibuffer): Remove comment.
* doc/misc/tramp.texi (Frequently Asked Questions): Don't mention it.
* lisp/bindings.el (minibuffer-local-map): Unbind 'C-TAB'.
* lisp/filecache.el: Delete file.
* test/lisp/help-tests.el (help-tests--test-keymap)
(help-tests-substitute-command-keys/keymaps): Adjust.

doc/emacs/emacs.texi
doc/emacs/files.texi
doc/lispref/minibuf.texi
doc/misc/tramp.texi
lisp/bindings.el
lisp/filecache.el [deleted file]
test/lisp/help-tests.el

index 21656c5684361fab4f76dbf41e86d996a854137f..0e020bb1bf6f2998b20184fcc5a4ca1f5a4722d6 100644 (file)
@@ -467,7 +467,6 @@ File Handling
 * File Archives::       Operating on tar, zip, jar etc. archive files.
 * Remote Files::        Accessing files on other machines.
 * Quoted File Names::   Quoting special characters in file names.
-* File Name Cache::     Completion against a list of files you often use.
 * File Conveniences::   Convenience features for finding files.
 * Image Mode::          Viewing image files.
 
index e4bbd2eb29f588edf5fcfa0d9268da807cffa94e..9343501416b79ef1afb6ead75845afdb54310d1a 100644 (file)
@@ -37,7 +37,6 @@ on file directories.
 * File Archives::       Operating on tar, zip, jar etc. archive files.
 * Remote Files::        Accessing files on other machines.
 * Quoted File Names::   Quoting special characters in file names.
-* File Name Cache::     Completion against a list of files you often use.
 * File Conveniences::   Convenience features for finding files.
 * Image Mode::          Viewing image files.
 @end menu
@@ -2202,49 +2201,6 @@ starts with @samp{foo} and ends with @samp{bar} is @file{foo*bar},
 then specifying @file{/tmp/foo*bar} will visit only
 @file{/tmp/foo*bar}.
 
-@node File Name Cache
-@section File Name Cache
-
-@cindex file name caching
-@cindex cache of file names
-@pindex find
-@kindex C-TAB
-@findex file-cache-minibuffer-complete
-  You can use the @dfn{file name cache} to make it easy to locate a
-file by name, without having to remember exactly where it is located.
-When typing a file name in the minibuffer, @kbd{C-@key{TAB}}
-(@code{file-cache-minibuffer-complete}) completes it using the file
-name cache.  If you repeat @kbd{C-@key{TAB}}, that cycles through the
-possible completions of what you had originally typed.  (However, note
-that the @kbd{C-@key{TAB}} character cannot be typed on most text
-terminals.)
-
-  The file name cache does not fill up automatically.  Instead, you
-load file names into the cache using these commands:
-
-@findex file-cache-add-directory
-@table @kbd
-@item M-x file-cache-add-directory @key{RET} @var{directory} @key{RET}
-Add each file name in @var{directory} to the file name cache.
-@item M-x file-cache-add-directory-using-find @key{RET} @var{directory} @key{RET}
-Add each file name in @var{directory} and all of its nested
-subdirectories to the file name cache.
-@item M-x file-cache-add-directory-using-locate @key{RET} @var{directory} @key{RET}
-Add each file name in @var{directory} and all of its nested
-subdirectories to the file name cache, using @command{locate} to find
-them all.
-@item M-x file-cache-add-directory-list @key{RET} @var{variable} @key{RET}
-Add each file name in each directory listed in @var{variable} to the
-file name cache.  @var{variable} should be a Lisp variable whose value
-is a list of directories, like @code{load-path}.
-@item M-x file-cache-clear-cache @key{RET}
-Clear the cache; that is, remove all file names from it.
-@end table
-
-  The file name cache is not persistent: it is kept and maintained
-only for the duration of the Emacs session.  You can view the contents
-of the cache with the @code{file-cache-display} command.
-
 @node File Conveniences
 @section Convenience Features for Finding Files
 
index 2d8d2650cbcebb0c306f8cc49c8196bc946ad601..971acd8a8944b871ac5685b7daa9929497b3ed4c 100644 (file)
@@ -401,12 +401,6 @@ default, it makes the following bindings:
 
 @item @kbd{M-r}
 @code{previous-matching-history-element}
-
-@ignore
-@c Does not seem worth/appropriate mentioning.
-@item @kbd{C-@key{TAB}}
-@code{file-cache-minibuffer-complete}
-@end ignore
 @end table
 
 @noindent
index 90824024c0344f974022fee7ab55edb458214def..600f86e0fc94f12910528b33f581ad382b5a3100 100644 (file)
@@ -5621,22 +5621,6 @@ their accessibility through remote access:
 Reaching recently opened files: @kbd{@key{menu-bar} @key{file}
 @key{Open Recent}}.
 
-@item Use filecache:
-
-Since @file{filecache} remembers visited places, add the remote
-directory to the cache:
-
-@lisp
-@group
-(with-eval-after-load 'filecache
-  (file-cache-add-directory
-    "@trampfn{ssh,news@@news.my.domain,/opt/news/etc/}"))
-@end group
-@end lisp
-
-Then use directory completion in the minibuffer with @kbd{C-x C-f
-C-@key{TAB}}.
-
 @item Use bbdb:
 
 @file{bbdb} has a built-in feature for Ange FTP files, which also
index 4690897fed4eb35527455fe55eacf3576cc372bb..b70b22532bd7cf941e25d9f2104e555f10968ffe 100644 (file)
@@ -1165,8 +1165,7 @@ if `inhibit-field-text-motion' is non-nil."
   ;; Override the global binding (which calls indent-relative via
   ;; indent-for-tab-command).  The alignment that indent-relative tries to
   ;; do doesn't make much sense here since the prompt messes it up.
-  (define-key map "\t"    'self-insert-command)
-  (define-key map [C-tab] 'file-cache-minibuffer-complete))
+  (define-key map "\t"    'self-insert-command))
 
 (define-key global-map "\C-u" 'universal-argument)
 (let ((i ?0))
diff --git a/lisp/filecache.el b/lisp/filecache.el
deleted file mode 100644 (file)
index 86d5e65..0000000
+++ /dev/null
@@ -1,672 +0,0 @@
-;;; filecache.el --- find files using a pre-loaded cache  -*- lexical-binding:t -*-
-
-;; Copyright (C) 1996, 2000-2024 Free Software Foundation, Inc.
-
-;; Author: Peter Breton <pbreton@cs.umb.edu>
-;; Created: Sun Nov 10 1996
-;; Keywords: convenience
-
-;; This file is part of GNU Emacs.
-
-;; GNU Emacs is free software: you can redistribute it and/or modify
-;; it under the terms of the GNU General Public License as published by
-;; the Free Software Foundation, either version 3 of the License, or
-;; (at your option) any later version.
-
-;; GNU Emacs is distributed in the hope that it will be useful,
-;; but WITHOUT ANY WARRANTY; without even the implied warranty of
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-;; GNU General Public License for more details.
-
-;; You should have received a copy of the GNU General Public License
-;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-;;
-;; The file-cache package is an attempt to make it easy to locate files
-;; by name, without having to remember exactly where they are located.
-;; This is very handy when working with source trees.  You can also add
-;; frequently used files to the cache to create a hotlist effect.
-;; The cache can be used with any interactive command which takes a
-;; filename as an argument.
-;;
-;; It is worth noting that this package works best when most of the files
-;; in the cache have unique names, or (if they have the same name) exist in
-;; only a few directories.  The worst case is many files all with
-;; the same name and in different directories, for example a big source tree
-;; with a Makefile in each directory.  In such a case, you should probably
-;; use an alternate strategy to find the files.
-;;
-;; ADDING FILES TO THE CACHE:
-;;
-;; Use the following functions to add items to the file cache:
-;;
-;;   * `file-cache-add-file': Adds a single file to the cache
-;;
-;;   * `file-cache-add-file-list': Adds a list of files to the cache
-;;
-;; The following functions use the regular expressions in
-;; `file-cache-filter-regexps' to eliminate unwanted files:
-;;
-;;   * `file-cache-add-directory': Adds the files in a directory to the
-;;     cache.  You can also specify a regular expression to match the files
-;;     which should be added.
-;;
-;;   * `file-cache-add-directory-list': Same as above, but acts on a list
-;;     of directories.  You can use `load-path', `exec-path' and the like.
-;;
-;;   * `file-cache-add-directory-using-find': Uses the `find' command to
-;;     add a directory tree to the cache.
-;;
-;;   * `file-cache-add-directory-using-locate': Uses the `locate' command to
-;;     add files matching a pattern to the cache.
-;;
-;;   * `file-cache-add-directory-recursively': Uses the find-lisp package to
-;;     add all files matching a pattern to the cache.
-;;
-;; Use the function `file-cache-clear-cache' to remove all items from the
-;; cache.  There are a number of `file-cache-delete' functions provided
-;; as well, but in general it is probably better to not worry too much
-;; about extra files in the cache.
-;;
-;; The most convenient way to initialize the cache is with an
-;; `eval-after-load' function, as noted in the ADDING FILES
-;; AUTOMATICALLY section.
-;;
-;; FINDING FILES USING THE CACHE:
-;;
-;; You can use the file-cache with any function that expects a filename as
-;; an argument.  For example:
-;;
-;; 1) Invoke a function which expects a filename as an argument:
-;;    M-x find-file
-;;
-;; 2) Begin typing a file name.
-;;
-;; 3) Invoke `file-cache-minibuffer-complete' (bound by default to
-;; C-TAB) to complete on the filename using the cache.
-;;
-;; 4) When you have found a unique completion, the minibuffer contents
-;; will change to the full name of that file.
-;;
-;; If there are a number of directories which contain the completion,
-;; invoking `file-cache-minibuffer-complete' repeatedly will cycle through
-;; them.
-;;
-;; 5) You can then edit the minibuffer contents, or press RETURN.
-;;
-;; It is much easier to simply try it than trying to explain it :)
-;;
-;;; ADDING FILES AUTOMATICALLY
-;;
-;; For maximum utility, you should probably define an `eval-after-load'
-;; form which loads your favorite files:
-;;
-;;      (eval-after-load
-;;       "filecache"
-;;       '(progn
-;;         (message "Loading file cache...")
-;;         (file-cache-add-directory-using-find "~/projects")
-;;         (file-cache-add-directory-list load-path)
-;;         (file-cache-add-directory "~/")
-;;         (file-cache-add-file-list (list "~/foo/bar" "~/baz/bar"))
-;;        ))
-;;
-;; If you clear and reload the cache frequently, it is probably easiest
-;; to put your initializations in a function:
-;;
-;;   (eval-after-load
-;;     "filecache"
-;;      '(my-file-cache-initialize))
-;;
-;;   (defun my-file-cache-initialize ()
-;;      (interactive)
-;;     (message "Loading file cache...")
-;;     (file-cache-add-directory-using-find "~/projects")
-;;     (file-cache-add-directory-list load-path)
-;;     (file-cache-add-directory "~/")
-;;     (file-cache-add-file-list (list "~/foo/bar" "~/baz/bar"))
-;;   ))
-;;
-;; Of course, you can still add files to the cache afterwards, via
-;; Lisp functions.
-;;
-;; RELATED WORK:
-;;
-;; This package is a distant relative of Noah Friedman's fff utilities.
-;; Our goal is pretty similar, but the implementation strategies are
-;; different.
-
-;;; Code:
-
-(defgroup file-cache nil
-  "Find files using a pre-loaded cache."
-  :group 'files
-  :group 'convenience
-  :prefix "file-cache-")
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Customization Variables
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-;; User-modifiable variables
-(defcustom file-cache-filter-regexps
-  ;; These are also used in buffers containing lines of file names,
-  ;; so the end-of-name is matched with $ rather than \\'.
-  (list "~$" "\\.o$" "\\.exe$" "\\.a$" "\\.elc$" ",v$" "\\.output$"
-       "\\.$" "#$" "\\.class$" "/\\.#")
-  "List of regular expressions used as filters by the file cache.
-File names which match these expressions will not be added to the cache.
-Note that the functions `file-cache-add-file' and `file-cache-add-file-list'
-do not use this variable."
-  :version "25.1"                       ; added "/\\.#"
-  :type '(repeat regexp))
-
-(defcustom file-cache-find-command "find"
-  "External program used by `file-cache-add-directory-using-find'."
-  :type 'string)
-
-(defcustom file-cache-find-command-posix-flag 'not-defined
-  "Set to t, if `file-cache-find-command' handles wildcards POSIX style.
-This variable is automatically set to nil or non-nil
-if it has the initial value `not-defined' whenever you first
-call the `file-cache-add-directory-using-find'.
-
-Under Windows operating system where Cygwin is available, this value
-should be t."
-  :type  '(choice (const :tag "Yes" t)
-                 (const :tag "No" nil)
-                 (const :tag "Unknown" not-defined)))
-
-(defcustom file-cache-locate-command "locate"
-  "External program used by `file-cache-add-directory-using-locate'."
-  :type 'string)
-
-;; Minibuffer messages
-(defcustom file-cache-no-match-message " [File Cache: No match]"
-  "Message to display when there is no completion."
-  :type 'string)
-
-(defcustom file-cache-sole-match-message " [File Cache: sole completion]"
-  "Message to display when there is only one completion."
-  :type 'string)
-
-(defcustom file-cache-non-unique-message
-  " [File Cache: complete but not unique]"
-  "Message to display when there is a non-unique completion."
-  :type 'string)
-
-(defcustom file-cache-completion-ignore-case
-  (if (memq system-type '(ms-dos windows-nt cygwin))
-      t
-     completion-ignore-case)
-  "If non-nil, file-cache completion should ignore case.
-Defaults to the value of `completion-ignore-case'."
-  :type 'boolean)
-
-(defcustom file-cache-case-fold-search
-  (if (memq system-type '(ms-dos windows-nt cygwin))
-      t
-    case-fold-search)
-  "If non-nil, file-cache completion should ignore case.
-Defaults to the value of `case-fold-search'."
-  :type 'boolean)
-
-(defcustom file-cache-ignore-case
-  (not (not (memq system-type '(ms-dos windows-nt cygwin))))
-  "Non-nil means ignore case when checking completions in the file cache.
-Defaults to nil on DOS and Windows, and t on other systems."
-  :type 'boolean)
-
-(defvar file-cache-multiple-directory-message nil)
-
-;; Internal variables
-;; This should be named *Completions* because that's what the function
-;; switch-to-completions in simple.el expects
-(defcustom file-cache-completions-buffer "*Completions*"
-  "Buffer to display completions when using the file cache."
-  :type 'string)
-
-(defvar file-cache-buffer-default-regexp "^.+$"
-  "Regexp to match files in find and locate's output.")
-
-(defvar file-cache-last-completion nil)
-
-(defvar file-cache-alist nil
-  "Internal data structure to hold cache of file names.
-It is a list of entries of the form (FILENAME DIRNAME1 DIRNAME2 ...)
-where FILENAME is a file name component and the entry represents N
-files of names DIRNAME1/FILENAME, DIRNAME2/FILENAME, ...")
-
-(defvar file-cache-completions-keymap
-  (let ((map (make-sparse-keymap)))
-    (set-keymap-parent map completion-list-mode-map)
-    (define-key map [mouse-2] 'file-cache-choose-completion)
-    (define-key map "\C-m" 'file-cache-choose-completion)
-    map)
-  "Keymap for file cache completions buffer.")
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Functions to add files to the cache
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-(defun file-cache--read-list (file op-prompt)
-  (let* ((fun (if file 'read-file-name 'read-directory-name))
-        (type (if file "file" "directory"))
-        (prompt-1 (concat op-prompt " " type ": "))
-        (prompt-2 (concat op-prompt " another " type "?"))
-        (continue t)
-        result)
-    (while continue
-      (push (funcall fun prompt-1 nil nil t) result)
-      (setq continue (y-or-n-p prompt-2)))
-    (nreverse result)))
-
-;;;###autoload
-(defun file-cache-add-directory (directory &optional regexp)
-  "Add all files in DIRECTORY to the file cache.
-If called from Lisp with a non-nil REGEXP argument is non-nil,
-only add files whose names match REGEXP."
-  (interactive (list (read-directory-name "Add files from directory: "
-                                         nil nil t)
-                    nil))
-  ;; Not an error, because otherwise we can't use load-paths that
-  ;; contain non-existent directories.
-  (when (file-accessible-directory-p directory)
-    (let* ((dir       (expand-file-name directory))
-          (dir-files (directory-files dir t regexp)))
-      ;; Filter out files we don't want to see
-      (dolist (file dir-files)
-       (if (file-directory-p file)
-           (setq dir-files (delq file dir-files))
-         (dolist (regexp file-cache-filter-regexps)
-           (if (string-match regexp file)
-               (setq dir-files (delq file dir-files))))))
-      (file-cache-add-file-list dir-files))))
-
-;;;###autoload
-(defun file-cache-add-directory-list (directories &optional regexp)
-  "Add DIRECTORIES (a list of directory names) to the file cache.
-If called interactively, read the directory names one by one.
-If the optional REGEXP argument is non-nil, only files which match it
-will be added to the cache.  Note that the REGEXP is applied to the
-files in each directory, not to the directory list itself."
-  (interactive (list (file-cache--read-list nil "Add")))
-  (dolist (dir directories)
-    (file-cache-add-directory dir regexp))
-  (let ((n (length directories)))
-    (message "Filecache: cached file names from %d director%s."
-            n (if (= n 1) "y" "ies"))))
-
-(defun file-cache-add-file-list (files)
-  "Add FILES (a list of file names) to the file cache.
-If called interactively, read the file names one by one."
-  (interactive (list (file-cache--read-list t "Add")))
-  (dolist (f files)
-    (file-cache-add-file f))
-  (let ((n (length files)))
-    (message "Filecache: cached %d file name%s."
-            n (if (= n 1) "" "s"))))
-
-;; Workhorse function
-
-;;;###autoload
-(defun file-cache-add-file (file)
-  "Add FILE to the file cache."
-  (interactive "fAdd File: ")
-  (setq file (file-truename file))
-  (unless (file-exists-p file)
-    (error "Filecache: file %s does not exist" file))
-  (let* ((file-name (file-name-nondirectory file))
-        (dir-name  (file-name-directory file))
-        (the-entry (assoc-string file-name file-cache-alist
-                                 file-cache-ignore-case)))
-    (cond ((null the-entry)
-          ;; If the entry wasn't in the cache, add it.
-          (push (list file-name dir-name) file-cache-alist)
-          (if (called-interactively-p 'interactive)
-              (message "Filecache: cached file name %s." file)))
-         ((not (member dir-name (cdr the-entry)))
-          (setcdr the-entry (cons dir-name (cdr the-entry)))
-          (if (called-interactively-p 'interactive)
-              (message "Filecache: cached file name %s." file)))
-         (t
-          (if (called-interactively-p 'interactive)
-              (message "Filecache: %s is already cached." file))))))
-
-;;;###autoload
-(defun file-cache-add-directory-using-find (directory)
-  "Use the `find' command to add files to the file cache.
-Find is run in DIRECTORY."
-  (interactive "DAdd files under directory: ")
-  (let ((dir (expand-file-name directory)))
-    (when (memq system-type '(windows-nt cygwin))
-      (if (eq file-cache-find-command-posix-flag 'not-defined)
-         (setq file-cache-find-command-posix-flag
-               (executable-command-find-posix-p file-cache-find-command))))
-    (with-temp-buffer
-      (call-process file-cache-find-command nil t nil
-                   dir "-name"
-                   (if (memq system-type '(windows-nt cygwin))
-                       (if file-cache-find-command-posix-flag
-                           "\\*"
-                         "'*'")
-                     "*")
-                   "-print")
-      (file-cache--add-from-buffer))))
-
-;;;###autoload
-(defun file-cache-add-directory-using-locate (string)
-  "Use the `locate' command to add files to the file cache.
-STRING is passed as an argument to the locate command."
-  (interactive "sAdd files using locate string: ")
-  (with-temp-buffer
-    (call-process file-cache-locate-command nil t nil string)
-    (file-cache--add-from-buffer)))
-
-(autoload 'find-lisp-find-files "find-lisp")
-
-;;;###autoload
-(defun file-cache-add-directory-recursively  (dir &optional regexp)
-  "Add DIR and any subdirectories to the file-cache.
-This function does not use any external programs.
-If the optional REGEXP argument is non-nil, only files which match it
-will be added to the cache.  Note that the REGEXP is applied to the
-files in each directory, not to the directory list itself."
-  (interactive "DAdd directory: ")
-  (mapcar
-   (lambda (file)
-     (or (file-directory-p file)
-         (let (filtered)
-           (dolist (regexp file-cache-filter-regexps)
-             (and (string-match regexp file)
-                  (setq filtered t)))
-           filtered)
-         (file-cache-add-file file)))
-   (find-lisp-find-files dir (or regexp "^"))))
-
-(defun file-cache--add-from-buffer ()
-  "Add any entries found in the current buffer.
-Each entry matches the regular expression `file-cache-buffer-default-regexp'
-or the optional REGEXP argument."
-  (dolist (elt file-cache-filter-regexps)
-    (goto-char (point-min))
-    (delete-matching-lines elt))
-  (goto-char (point-min))
-  (while (re-search-forward file-cache-buffer-default-regexp nil t)
-    (file-cache-add-file (match-string-no-properties 0))))
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Functions to delete from the cache
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-(defun file-cache-clear-cache ()
-  "Clear the file cache."
-  (interactive)
-  (setq file-cache-alist nil))
-
-;; This clears *all* files with the given name
-(defun file-cache-delete-file (file)
-  "Delete FILE (a relative file name) from the file cache.
-Return nil if FILE was not in the file cache, non-nil otherwise."
-  (interactive
-   (list (completing-read "Delete file from cache: " file-cache-alist)))
-  (let ((elt (assoc-string file file-cache-alist file-cache-ignore-case)))
-    (setq file-cache-alist (delq elt file-cache-alist))
-    elt))
-
-(defun file-cache-delete-file-list (files &optional message)
-  "Delete FILES (a list of files) from the file cache.
-If called interactively, read the file names one by one.
-If MESSAGE is non-nil, or if called interactively, print a
-message reporting the number of file names deleted."
-  (interactive (list (file-cache--read-list t "Uncache") t))
-  (let ((n 0))
-    (dolist (f files)
-      (if (file-cache-delete-file f)
-         (setq n (1+ n))))
-    (when message
-      (message "Filecache: uncached %d file name%s."
-              n (if (= n 1) "" "s")))))
-
-(defun file-cache-delete-file-regexp (regexp)
-  "Delete files matching REGEXP from the file cache."
-  (interactive "sRegexp: ")
-  (let ((delete-list))
-    (dolist (elt file-cache-alist)
-      (and (string-match regexp (car elt))
-           (push (car elt) delete-list)))
-    (file-cache-delete-file-list delete-list)))
-
-(defun file-cache-delete-directory (directory)
-  "Delete DIRECTORY from the file cache."
-  (interactive "DDelete directory from file cache: ")
-  (let ((dir (expand-file-name directory))
-       (n 0))
-    (dolist (entry file-cache-alist)
-      (if (file-cache-do-delete-directory dir entry)
-          (setq n (1+ n))))
-    (message "Filecache: uncached %d file name%s."
-            n (if (= n 1) "" "s"))))
-
-(defun file-cache-do-delete-directory (dir entry)
-  (let ((directory-list (cdr entry))
-       (directory (file-cache-canonical-directory dir)))
-    (and (member directory directory-list)
-        (if (equal 1 (length directory-list))
-            (setq file-cache-alist
-                  (delq entry file-cache-alist))
-          (setcdr entry (delete directory directory-list))))))
-
-(defun file-cache-delete-directory-list (directories)
-  "Delete DIRECTORIES (a list of directory names) from the file cache.
-If called interactively, read the directory names one by one."
-  (interactive (list (file-cache--read-list nil "Uncache")))
-  (dolist (d directories)
-    (file-cache-delete-directory d)))
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Utility functions
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-;; Returns the name of a directory for a file in the cache
-(defun file-cache-directory-name  (file)
-  (let* ((directory-list (cdr (assoc-string
-                              file file-cache-alist
-                              file-cache-ignore-case)))
-        (len            (length directory-list))
-        (directory)
-        (num))
-    (if (not (listp directory-list))
-       (error "Filecache: unknown type in file-cache-alist for key %s" file))
-    (cond
-     ;; Single element
-     ((eq 1 len)
-      (setq directory (elt directory-list 0)))
-     ;; No elements
-     ((eq 0 len)
-      (error "Filecache: no directory found for key %s" file))
-     ;; Multiple elements
-     (t
-      (let* ((minibuffer-dir (file-name-directory (minibuffer-contents)))
-            (dir-list       (member minibuffer-dir directory-list)))
-       (setq directory
-             ;; If the directory is in the list, return the next element
-             ;; Otherwise, return the first element
-             (if dir-list
-                 (or (elt directory-list
-                          (setq num (1+ (- len (length dir-list)))))
-                     (elt directory-list (setq num 0)))
-               (elt directory-list (setq num 0)))))))
-    ;; If there were multiple directories, set up a minibuffer message
-    (setq file-cache-multiple-directory-message
-         (and num (format " [%d of %d]" (1+ num) len)))
-    directory))
-
-;; Returns the name of a file in the cache
-(defun file-cache-file-name  (file)
-  (let ((directory (file-cache-directory-name file)))
-    (concat directory file)))
-
-;; Return a canonical directory for comparison purposes.
-;; Such a directory ends with a forward slash.
-(defun file-cache-canonical-directory (dir)
-  (let ((directory dir))
-    (if (not (char-equal ?/ (string-to-char (substring directory -1))))
-       (concat directory "/")
-      directory)))
-
-(defun file-cache-cycle (name)
-  "Cycle through the directories that NAME is available in."
-  (let ((file-name (file-cache-file-name name)))
-    (if (string= file-name (minibuffer-contents))
-        (minibuffer-message file-cache-sole-match-message)
-      (delete-minibuffer-contents)
-      (insert file-name)
-      (if file-cache-multiple-directory-message
-          (minibuffer-message file-cache-multiple-directory-message)))))
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Minibuffer functions
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-;; The prefix argument works around a bug in the minibuffer completion.
-;; The completion function doesn't distinguish between the states:
-;;
-;;   "Multiple completions of name" (eg, Makefile, Makefile.in)
-;;   "Name available in multiple directories" (/tmp/Makefile, ~me/Makefile)
-;;
-;; The default is to do the former; a prefix arg forces the latter.
-
-;;;###autoload
-(defun file-cache-minibuffer-complete (arg)
-  "Complete a filename in the minibuffer using a preloaded cache.
-Filecache does two kinds of substitution: it completes on names in
-the cache, and, once it has found a unique name, it cycles through
-the directories that the name is available in.  With a prefix argument,
-the name is considered already unique; only the second substitution
-\(directories) is done."
-  (interactive "P")
-  (let* ((completion-ignore-case file-cache-completion-ignore-case)
-         (case-fold-search       file-cache-case-fold-search)
-         (string                 (file-name-nondirectory (minibuffer-contents)))
-         (completion             (completion-try-completion
-                                  string file-cache-alist nil 0)))
-    (cond
-     ;; If it's the only match, replace the original contents
-     ((or arg (eq completion t))
-      (file-cache-cycle string))
-
-     ;; If it's the longest match, insert it
-     ((consp completion)
-      (let ((newstring (car completion))
-            (newpoint  (cdr completion)))
-        ;; If we've already inserted a unique string, see if the user
-        ;; wants to use that one
-        (if (and (string= string newstring)
-                 (assoc-string string file-cache-alist
-                               file-cache-ignore-case))
-            (if (and (eq last-command this-command)
-                     (string= file-cache-last-completion newstring))
-                (file-cache-cycle newstring)
-              (minibuffer-message file-cache-non-unique-message)
-              (setq file-cache-last-completion string))
-          (setq file-cache-last-completion string)
-          (let* ((completion-list (completion-all-completions
-                                   newstring file-cache-alist nil newpoint))
-                 (base-size       (cdr (last completion-list))))
-            (when base-size
-              (setcdr (last completion-list) nil))
-            (if (> (length completion-list) 1)
-                (progn
-                  (delete-region (- (point-max) (length string)) (point-max))
-                  (insert newstring)
-                  (with-output-to-temp-buffer file-cache-completions-buffer
-                    (display-completion-list completion-list)
-                    ;; Add our own setup function to the Completions Buffer
-                    (file-cache-completion-setup-function)))
-              (file-cache-cycle newstring))))))
-
-     ;; No match
-     ((eq completion nil)
-      (minibuffer-message file-cache-no-match-message)))))
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Completion functions
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-(defun file-cache-completion-setup-function  ()
-  (with-current-buffer standard-output ;; i.e. file-cache-completions-buffer
-    (use-local-map file-cache-completions-keymap)))
-
-(defun file-cache-choose-completion (&optional event)
-  "Choose a completion in the `*Completions*' buffer."
-  (interactive (list last-nonmenu-event))
-  (let ((completion-no-auto-exit t))
-    (choose-completion event)
-    (select-window (active-minibuffer-window))
-    (file-cache-minibuffer-complete nil)))
-
-(defun file-cache-complete  ()
-  "Complete the word at point, using the filecache."
-  (interactive)
-  (let ((start
-    (save-excursion
-      (skip-syntax-backward "^\"")
-           (point))))
-    (completion-in-region start (point) file-cache-alist)))
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Show parts of the cache
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-(defun file-cache-files-matching-internal (regexp)
-  "Output a list of files whose names (not including directories)
-match REGEXP."
-  (let ((results))
-    (dolist (cache-element file-cache-alist)
-      (and (string-match regexp (elt cache-element 0))
-           (push (elt cache-element 0) results)))
-    (nreverse results)))
-
-(defun file-cache-files-matching (regexp)
-  "Output a list of files whose names (not including directories)
-match REGEXP."
-  (interactive "sFind files matching regexp: ")
-  (let ((results
-        (file-cache-files-matching-internal regexp))
-       buf)
-    (set-buffer
-     (setq buf (get-buffer-create
-               "*File Cache Files Matching*")))
-    (erase-buffer)
-    (insert
-     (mapconcat #'identity results "\n"))
-    (goto-char (point-min))
-    (display-buffer buf)))
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Debugging functions
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-(defun file-cache-debug-read-from-minibuffer (file)
-  "Debugging function."
-  (interactive
-   (list (completing-read "File Cache: " file-cache-alist)))
-  (message "%s" (assoc-string file file-cache-alist
-                             file-cache-ignore-case)))
-
-(defun file-cache-display  ()
-  "Display the file cache."
-  (interactive)
-  (let ((buf "*File Cache Contents*"))
-    (with-current-buffer
-       (get-buffer-create buf)
-      (erase-buffer)
-      (dolist (item file-cache-alist)
-        (insert (nth 1 item) (nth 0 item) "\n"))
-      (pop-to-buffer buf))))
-
-(provide 'filecache)
-
-;;; filecache.el ends here
index a6b0a3ece813194c8b390fa61412a21ce4fde172..0a4cebbdac74ae3ca18c91e6ae8cf955490d4e67 100644 (file)
   "C-j"           #'minibuffer-complete-and-exit
   "RET"           #'minibuffer-complete-and-exit
   "?"             #'minibuffer-completion-help
-  "C-<tab>"       #'file-cache-minibuffer-complete
   "<XF86Back>"    #'previous-history-element
   "<XF86Forward>" #'next-history-element
   "<backtab>"     #'minibuffer-complete
@@ -158,7 +157,6 @@ TAB         minibuffer-complete
 C-j            minibuffer-complete-and-exit
 RET            minibuffer-complete-and-exit
 \\?            minibuffer-completion-help
-C-<tab>                file-cache-minibuffer-complete
 <XF86Back>     previous-history-element
 <XF86Forward>  next-history-element
 <backtab>      minibuffer-complete