Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
;;;_. icomplete.el - minibuffer completion incremental feedback
|
1994-09-18 08:27:12 +00:00
|
|
|
|
|
1997-05-31 04:09:04 +00:00
|
|
|
|
;; Copyright (C) 1992, 1993, 1994, 1997 Free Software Foundation, Inc.
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
;; Author: Ken Manheimer <klm@python.org>
|
|
|
|
|
;; Maintainer: Ken Manheimer <klm@python.org>
|
1995-10-30 17:35:01 +00:00
|
|
|
|
;; Created: Mar 1993 klm@nist.gov - first release to usenet
|
|
|
|
|
;; Keywords: help, abbrev
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;; This file is part of GNU Emacs.
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;; 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 2, or (at your option)
|
|
|
|
|
;; any later version.
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;; 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.
|
1993-12-30 11:56:19 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;; You should have received a copy of the GNU General Public License
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; along with GNU Emacs; see the file COPYING. If not, write to the
|
|
|
|
|
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
|
;; Boston, MA 02111-1307, USA.
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;; Commentary:
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; Loading this package implements a more fine-grained minibuffer
|
|
|
|
|
;; completion feedback scheme. Prospective completions are concisely
|
|
|
|
|
;; indicated within the minibuffer itself, with each successive
|
|
|
|
|
;; keystroke.
|
|
|
|
|
|
|
|
|
|
;; See 'icomplete-completions' docstring for a description of the
|
|
|
|
|
;; icomplete display format.
|
|
|
|
|
|
|
|
|
|
;; See the `icomplete-minibuffer-setup-hook' docstring for a means to
|
|
|
|
|
;; customize icomplete setup for interoperation with other
|
|
|
|
|
;; minibuffer-oriented packages.
|
|
|
|
|
|
|
|
|
|
;; To activate icomplete mode, simply load the package. You can
|
|
|
|
|
;; subsequently deactivate it by invoking the function icomplete-mode
|
|
|
|
|
;; with a negative prefix-arg (C-U -1 ESC-x icomplete-mode). Also,
|
|
|
|
|
;; you can prevent activation of the mode during package load by
|
|
|
|
|
;; first setting the variable `icomplete-mode' to nil. Icompletion
|
|
|
|
|
;; can be enabled any time after the package is loaded by invoking
|
|
|
|
|
;; icomplete-mode without a prefix arg.
|
|
|
|
|
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
;; This version of icomplete runs on Emacs 19.18 and later. (It
|
|
|
|
|
;; depends on the incorporation of minibuffer-setup-hook.) The elisp
|
|
|
|
|
;; archives, ftp://archive.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive,
|
|
|
|
|
;; probably still has a version that works in GNU Emacs v18.
|
|
|
|
|
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; Thanks to everyone for their suggestions for refinements of this
|
|
|
|
|
;; package. I particularly have to credit Michael Cook, who
|
|
|
|
|
;; implemented an incremental completion style in his 'iswitch'
|
|
|
|
|
;; functions that served as a model for icomplete. Some other
|
|
|
|
|
;; contributors: Noah Freidman (restructuring as minor mode), Colin
|
1997-06-15 02:37:58 +00:00
|
|
|
|
;; Rafferty (lemacs reconciliation), Lars Lindberg, RMS, and others.
|
1996-01-14 07:34:30 +00:00
|
|
|
|
|
|
|
|
|
;; klm.
|
1993-12-30 11:56:19 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;; Code:
|
|
|
|
|
|
|
|
|
|
;;;_* Provide
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(provide 'icomplete)
|
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_* User Customization variables
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
(defvar icomplete-compute-delay .3
|
|
|
|
|
"*Completions-computation stall, used only with large-number
|
|
|
|
|
completions - see `icomplete-delay-completions-threshold'.")
|
|
|
|
|
(defvar icomplete-delay-completions-threshold 400
|
|
|
|
|
"*Pending-completions number over which to apply icomplete-compute-delay.")
|
|
|
|
|
(defvar icomplete-max-delay-chars 3
|
|
|
|
|
"*Maximum number of initial chars to apply icomplete compute delay.")
|
1994-09-18 08:27:12 +00:00
|
|
|
|
|
|
|
|
|
;;;_* Initialization
|
|
|
|
|
;;;_ = icomplete-minibuffer-setup-hook
|
|
|
|
|
(defvar icomplete-minibuffer-setup-hook nil
|
|
|
|
|
"*Icomplete-specific customization of minibuffer setup.
|
|
|
|
|
|
|
|
|
|
This hook is run during minibuffer setup iff icomplete will be active.
|
|
|
|
|
It is intended for use in customizing icomplete for interoperation
|
|
|
|
|
with other packages. For instance:
|
|
|
|
|
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
\(add-hook 'icomplete-minibuffer-setup-hook
|
1994-09-18 08:27:12 +00:00
|
|
|
|
\(function
|
|
|
|
|
\(lambda ()
|
|
|
|
|
\(make-local-variable 'resize-minibuffer-window-max-height)
|
|
|
|
|
\(setq resize-minibuffer-window-max-height 3))))
|
|
|
|
|
|
|
|
|
|
will constrain rsz-mini to a maximum minibuffer height of 3 lines when
|
|
|
|
|
icompletion is occurring.")
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
1993-12-30 11:56:19 +00:00
|
|
|
|
;;;_ + Internal Variables
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_ = icomplete-mode
|
|
|
|
|
(defvar icomplete-mode t
|
1997-06-15 02:37:58 +00:00
|
|
|
|
"*Non-nil enables incremental minibuffer completion (see \\[icomplete-mode].")
|
1993-12-30 11:56:19 +00:00
|
|
|
|
;;;_ = icomplete-eoinput 1
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(defvar icomplete-eoinput 1
|
|
|
|
|
"Point where minibuffer input ends and completion info begins.")
|
|
|
|
|
(make-variable-buffer-local 'icomplete-eoinput)
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_ = icomplete-pre-command-hook
|
|
|
|
|
(defvar icomplete-pre-command-hook nil
|
|
|
|
|
"Incremental-minibuffer-completion pre-command-hook.
|
|
|
|
|
|
|
|
|
|
Is run in minibuffer before user input when `icomplete-mode' is non-nil.
|
|
|
|
|
Use `icomplete-mode' function to set it up properly for incremental
|
|
|
|
|
minibuffer completion.")
|
|
|
|
|
(add-hook 'icomplete-pre-command-hook 'icomplete-tidy)
|
|
|
|
|
;;;_ = icomplete-post-command-hook
|
|
|
|
|
(defvar icomplete-post-command-hook nil
|
|
|
|
|
"Incremental-minibuffer-completion post-command-hook.
|
|
|
|
|
|
|
|
|
|
Is run in minibuffer after user input when `icomplete-mode' is non-nil.
|
|
|
|
|
Use `icomplete-mode' function to set it up properly for incremental
|
|
|
|
|
minibuffer completion.")
|
|
|
|
|
(add-hook 'icomplete-post-command-hook 'icomplete-exhibit)
|
|
|
|
|
|
1997-06-15 02:37:58 +00:00
|
|
|
|
(defvar icomplete-show-key-bindings t
|
|
|
|
|
"*When non-nil, show key bindings as well as completion for sole matches.")
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
|
|
|
|
|
(defun icomplete-get-keys (func-name)
|
1997-06-15 02:37:58 +00:00
|
|
|
|
"Return strings naming keys bound to `func-name', or nil if none.
|
|
|
|
|
Examines the prior, not current, buffer, presuming that current buffer
|
|
|
|
|
is minibuffer."
|
|
|
|
|
(if (commandp func-name)
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
(save-excursion
|
|
|
|
|
(let* ((sym (intern func-name))
|
1997-06-15 02:37:58 +00:00
|
|
|
|
(buf (other-buffer))
|
|
|
|
|
(map (save-excursion (set-buffer buf) (current-local-map)))
|
|
|
|
|
(keys (where-is-internal sym map)))
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
(if keys
|
|
|
|
|
(concat "<"
|
|
|
|
|
(mapconcat 'key-description
|
|
|
|
|
(sort keys
|
|
|
|
|
#'(lambda (x y)
|
|
|
|
|
(< (length x) (length y))))
|
|
|
|
|
", ")
|
|
|
|
|
">"))))))
|
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_ > icomplete-mode (&optional prefix)
|
1993-12-30 11:56:19 +00:00
|
|
|
|
;;;###autoload
|
1994-09-18 08:27:12 +00:00
|
|
|
|
(defun icomplete-mode (&optional prefix)
|
1997-06-15 02:37:58 +00:00
|
|
|
|
"Activate incremental minibuffer completion for this Emacs session.
|
|
|
|
|
Deactivates with negative universal argument."
|
1994-09-18 08:27:12 +00:00
|
|
|
|
(interactive "p")
|
|
|
|
|
(or prefix (setq prefix 0))
|
|
|
|
|
(cond ((>= prefix 0)
|
|
|
|
|
(setq icomplete-mode t)
|
|
|
|
|
;; The following is not really necessary after first time -
|
|
|
|
|
;; no great loss.
|
|
|
|
|
(add-hook 'minibuffer-setup-hook 'icomplete-minibuffer-setup))
|
|
|
|
|
(t (setq icomplete-mode nil))))
|
|
|
|
|
|
|
|
|
|
;;;_ > icomplete-simple-completing-p ()
|
|
|
|
|
(defun icomplete-simple-completing-p ()
|
|
|
|
|
"Non-nil if current window is minibuffer that's doing simple completion.
|
|
|
|
|
|
|
|
|
|
Conditions are:
|
|
|
|
|
the selected window is a minibuffer,
|
|
|
|
|
and not in the middle of macro execution,
|
|
|
|
|
and minibuffer-completion-table is not a symbol (which would
|
1996-01-04 23:41:53 +00:00
|
|
|
|
indicate some non-standard, non-simple completion mechanism,
|
1994-09-18 08:27:12 +00:00
|
|
|
|
like file-name and other custom-func completions)."
|
|
|
|
|
|
|
|
|
|
(and (window-minibuffer-p (selected-window))
|
1996-05-29 17:17:34 +00:00
|
|
|
|
(not executing-kbd-macro)
|
1994-09-18 08:27:12 +00:00
|
|
|
|
(not (symbolp minibuffer-completion-table))))
|
1995-08-22 20:30:57 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_ > icomplete-minibuffer-setup ()
|
|
|
|
|
;;;###autoload
|
|
|
|
|
(defun icomplete-minibuffer-setup ()
|
|
|
|
|
"Run in minibuffer on activation to establish incremental completion.
|
1995-08-22 20:30:57 +00:00
|
|
|
|
Usually run by inclusion in `minibuffer-setup-hook'."
|
1994-09-18 08:27:12 +00:00
|
|
|
|
(cond ((and icomplete-mode (icomplete-simple-completing-p))
|
1995-08-22 20:30:57 +00:00
|
|
|
|
(make-local-hook 'pre-command-hook)
|
1994-09-18 08:27:12 +00:00
|
|
|
|
(add-hook 'pre-command-hook
|
|
|
|
|
(function (lambda ()
|
1995-08-22 20:30:57 +00:00
|
|
|
|
(run-hooks 'icomplete-pre-command-hook)))
|
|
|
|
|
nil t)
|
|
|
|
|
(make-local-hook 'post-command-hook)
|
1994-09-18 08:27:12 +00:00
|
|
|
|
(add-hook 'post-command-hook
|
|
|
|
|
(function (lambda ()
|
1995-08-22 20:30:57 +00:00
|
|
|
|
(run-hooks 'icomplete-post-command-hook)))
|
|
|
|
|
nil t)
|
1994-09-18 08:27:12 +00:00
|
|
|
|
(run-hooks 'icomplete-minibuffer-setup-hook))))
|
1995-08-22 20:30:57 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_* Completion
|
|
|
|
|
|
|
|
|
|
;;;_ > icomplete-tidy ()
|
|
|
|
|
(defun icomplete-tidy ()
|
|
|
|
|
"Remove completions display \(if any) prior to new user input.
|
1995-08-22 20:30:57 +00:00
|
|
|
|
Should be run in on the minibuffer `pre-command-hook'. See `icomplete-mode'
|
1994-09-18 08:27:12 +00:00
|
|
|
|
and `minibuffer-setup-hook'."
|
|
|
|
|
(if (icomplete-simple-completing-p)
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(if (and (boundp 'icomplete-eoinput)
|
|
|
|
|
icomplete-eoinput)
|
1994-09-18 08:27:12 +00:00
|
|
|
|
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(if (> icomplete-eoinput (point-max))
|
|
|
|
|
;; Oops, got rug pulled out from under us - reinit:
|
|
|
|
|
(setq icomplete-eoinput (point-max))
|
1993-12-30 11:56:19 +00:00
|
|
|
|
(let ((buffer-undo-list buffer-undo-list )) ; prevent entry
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(delete-region icomplete-eoinput (point-max))))
|
1994-09-18 08:27:12 +00:00
|
|
|
|
|
1993-12-30 11:56:19 +00:00
|
|
|
|
;; Reestablish the local variable 'cause minibuffer-setup is weird:
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(make-local-variable 'icomplete-eoinput)
|
|
|
|
|
(setq icomplete-eoinput 1))))
|
1995-08-22 20:30:57 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_ > icomplete-exhibit ()
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(defun icomplete-exhibit ()
|
1994-09-18 08:27:12 +00:00
|
|
|
|
"Insert icomplete completions display.
|
1995-08-22 20:30:57 +00:00
|
|
|
|
Should be run via minibuffer `post-command-hook'. See `icomplete-mode'
|
1994-09-18 08:27:12 +00:00
|
|
|
|
and `minibuffer-setup-hook'."
|
|
|
|
|
(if (icomplete-simple-completing-p)
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(let ((contents (buffer-substring (point-min)(point-max)))
|
|
|
|
|
(buffer-undo-list t))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
; Register the end of input, so we
|
|
|
|
|
; know where the extra stuff
|
|
|
|
|
; (match-status info) begins:
|
|
|
|
|
(if (not (boundp 'icomplete-eoinput))
|
|
|
|
|
;; In case it got wiped out by major mode business:
|
|
|
|
|
(make-local-variable 'icomplete-eoinput))
|
|
|
|
|
(setq icomplete-eoinput (point))
|
|
|
|
|
; Insert the match-status information:
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
(if (and (> (point-max) 1)
|
|
|
|
|
(or
|
|
|
|
|
;; Don't bother with delay after certain number of chars:
|
|
|
|
|
(> (point-max) icomplete-max-delay-chars)
|
|
|
|
|
;; Don't delay if alternatives number is small enough:
|
|
|
|
|
(if minibuffer-completion-table
|
|
|
|
|
(cond ((numberp minibuffer-completion-table)
|
|
|
|
|
(< minibuffer-completion-table
|
|
|
|
|
icomplete-delay-completions-threshold))
|
|
|
|
|
((sequencep minibuffer-completion-table)
|
|
|
|
|
(< (length minibuffer-completion-table)
|
|
|
|
|
icomplete-delay-completions-threshold))
|
|
|
|
|
))
|
|
|
|
|
;; Delay - give some grace time for next keystroke, before
|
|
|
|
|
;; embarking on computing completions:
|
|
|
|
|
(sit-for icomplete-compute-delay)))
|
1993-11-24 00:36:31 +00:00
|
|
|
|
(insert-string
|
1994-09-18 08:27:12 +00:00
|
|
|
|
(icomplete-completions contents
|
|
|
|
|
minibuffer-completion-table
|
|
|
|
|
minibuffer-completion-predicate
|
|
|
|
|
(not
|
|
|
|
|
minibuffer-completion-confirm))))))))
|
1995-08-22 20:30:57 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_ > icomplete-completions (name candidates predicate require-match)
|
|
|
|
|
(defun icomplete-completions (name candidates predicate require-match)
|
1993-11-24 00:36:31 +00:00
|
|
|
|
"Identify prospective candidates for minibuffer completion.
|
|
|
|
|
|
1993-12-30 11:56:19 +00:00
|
|
|
|
The display is updated with each minibuffer keystroke during
|
1993-11-24 00:36:31 +00:00
|
|
|
|
minibuffer completion.
|
|
|
|
|
|
|
|
|
|
Prospective completion suffixes (if any) are displayed, bracketed by
|
|
|
|
|
one of \(), \[], or \{} pairs. The choice of brackets is as follows:
|
|
|
|
|
|
|
|
|
|
\(...) - a single prospect is identified and matching is enforced,
|
|
|
|
|
\[...] - a single prospect is identified but matching is optional, or
|
|
|
|
|
\{...} - multiple prospects, separated by commas, are indicated, and
|
1996-01-04 23:41:53 +00:00
|
|
|
|
further input is required to distinguish a single one.
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
1996-01-04 23:41:53 +00:00
|
|
|
|
The displays for unambiguous matches have ` [Matched]' appended
|
1995-08-22 20:30:57 +00:00
|
|
|
|
\(whether complete or not), or ` \[No matches]', if no eligible
|
1997-06-15 02:37:58 +00:00
|
|
|
|
matches exist. \(Keybindings for uniquely matched commands
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
are exhibited within the square braces.)"
|
|
|
|
|
|
|
|
|
|
;; 'all-completions' doesn't like empty
|
|
|
|
|
;; minibuffer-completion-table's (ie: (nil))
|
|
|
|
|
(if (and (listp candidates) (null (car candidates)))
|
|
|
|
|
(setq candidates nil))
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
|
|
|
|
(let ((comps (all-completions name candidates predicate))
|
|
|
|
|
; "-determined" - only one candidate
|
|
|
|
|
(open-bracket-determined (if require-match "(" "["))
|
|
|
|
|
(close-bracket-determined (if require-match ")" "]"))
|
|
|
|
|
;"-prospects" - more than one candidate
|
|
|
|
|
(open-bracket-prospects "{")
|
|
|
|
|
(close-bracket-prospects "}")
|
|
|
|
|
)
|
Integrated Emacs 19.34 and XEmacs 19.15
corrections (typos, style, command revisions, etc).
Integrated hacked up XEmacs immediate keybindings display. See
`icomplete-show-key-bindings', `icomplete-get-keys', and
`icomplete-completions'. Doesn't work with mainline GNU
Emacs 19.34 (because the cmdloop doesn't set owindow, and the
current-local-map doesn't take optional buffer arg), so feature
is, by default, inhibited unless we're running in XEmacs.
(icomplete-get-keys): Return keys bound to func name in buffer
"owindow" - since "owindow" is calling-buffer history present
only in XEmacs, this function is only useful in XEmacs.
(icomplete-max-delay-chars, icomplete-compute-delay): New vars.
(icomplete-delay-completions-threshold): New var.
These customize the delay behavior, so that completions don't
intrude as quickly for short input.
1997-05-29 18:18:23 +00:00
|
|
|
|
(catch 'input
|
|
|
|
|
(cond ((null comps) (format " %sNo matches%s"
|
|
|
|
|
open-bracket-determined
|
|
|
|
|
close-bracket-determined))
|
|
|
|
|
((null (cdr comps)) ;one match
|
|
|
|
|
(concat (if (and (> (length (car comps))
|
|
|
|
|
(length name)))
|
|
|
|
|
(concat open-bracket-determined
|
|
|
|
|
(substring (car comps) (length name))
|
|
|
|
|
close-bracket-determined)
|
|
|
|
|
"")
|
|
|
|
|
" [Matched"
|
|
|
|
|
(let ((keys (and icomplete-show-key-bindings
|
|
|
|
|
(commandp (intern-soft (car comps)))
|
|
|
|
|
(icomplete-get-keys (car comps)))))
|
|
|
|
|
(if keys
|
|
|
|
|
(concat "; " keys)
|
|
|
|
|
""))
|
|
|
|
|
"]"))
|
|
|
|
|
(t ;multiple matches
|
|
|
|
|
(let* ((most
|
|
|
|
|
(try-completion name candidates
|
|
|
|
|
(and predicate
|
|
|
|
|
;; Wrap predicate in impatience - ie,
|
|
|
|
|
;; `throw' up when pending input is
|
|
|
|
|
;; noticed. Adds some overhead to
|
|
|
|
|
;; predicate, but should be worth it.
|
|
|
|
|
(function
|
|
|
|
|
(lambda (item)
|
|
|
|
|
(if (input-pending-p)
|
|
|
|
|
(throw 'input "")
|
|
|
|
|
(apply predicate
|
|
|
|
|
item nil)))))))
|
|
|
|
|
(most-len (length most))
|
|
|
|
|
most-is-exact
|
|
|
|
|
(alternatives
|
|
|
|
|
(substring
|
|
|
|
|
(apply (function concat)
|
|
|
|
|
(mapcar (function
|
|
|
|
|
(lambda (com)
|
|
|
|
|
(if (input-pending-p)
|
|
|
|
|
(throw 'input ""))
|
|
|
|
|
(if (= (length com) most-len)
|
|
|
|
|
;; Most is one exact match,
|
|
|
|
|
;; note that and leave out
|
|
|
|
|
;; for later indication:
|
|
|
|
|
(progn
|
|
|
|
|
(setq most-is-exact t)
|
|
|
|
|
())
|
|
|
|
|
(concat ","
|
|
|
|
|
(substring com
|
|
|
|
|
most-len)))))
|
|
|
|
|
comps))
|
|
|
|
|
1)))
|
|
|
|
|
(concat (and (> most-len (length name))
|
|
|
|
|
(concat open-bracket-determined
|
|
|
|
|
(substring most (length name))
|
|
|
|
|
close-bracket-determined))
|
|
|
|
|
open-bracket-prospects
|
|
|
|
|
(if most-is-exact
|
|
|
|
|
;; Add a ',' at the front to indicate "complete but
|
|
|
|
|
;; not unique":
|
|
|
|
|
(concat "," alternatives)
|
|
|
|
|
alternatives)
|
|
|
|
|
close-bracket-prospects)))))))
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
1994-09-18 08:27:12 +00:00
|
|
|
|
;;;_* Local emacs vars.
|
|
|
|
|
;;;Local variables:
|
|
|
|
|
;;;outline-layout: (-2 :)
|
|
|
|
|
;;;End:
|
1993-11-24 00:36:31 +00:00
|
|
|
|
|
|
|
|
|
;;; icomplete.el ends here
|