mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-12-15 09:47:20 +00:00
21d908055d
strings mention keybinding for `isearch-yank-word-or-char', rather than `isearch-yank-word', since the former is bound now and the latter is not. (isearch-yank-word-or-char): Fix formatting.
2117 lines
78 KiB
EmacsLisp
2117 lines
78 KiB
EmacsLisp
;;; isearch.el --- incremental search minor mode
|
||
|
||
;; Copyright (C) 1992, 93, 94, 95, 96, 97, 1999, 2000, 2001
|
||
;; Free Software Foundation, Inc.
|
||
|
||
;; Author: Daniel LaLiberte <liberte@cs.uiuc.edu>
|
||
;; Maintainer: FSF
|
||
;; Keywords: matching
|
||
|
||
;; 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 2, 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; see the file COPYING. If not, write to the
|
||
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
||
;; Boston, MA 02111-1307, USA.
|
||
|
||
;;; Commentary:
|
||
|
||
;; Instructions
|
||
|
||
;; For programmed use of isearch-mode, e.g. calling (isearch-forward),
|
||
;; isearch-mode behaves modally and does not return until the search
|
||
;; is completed. It uses a recursive-edit to behave this way.
|
||
|
||
;; The key bindings active within isearch-mode are defined below in
|
||
;; `isearch-mode-map' which is given bindings close to the default
|
||
;; characters of the original isearch.el. With `isearch-mode',
|
||
;; however, you can bind multi-character keys and it should be easier
|
||
;; to add new commands. One bug though: keys with meta-prefix cannot
|
||
;; be longer than two chars. Also see minibuffer-local-isearch-map
|
||
;; for bindings active during `isearch-edit-string'.
|
||
|
||
;; isearch-mode should work even if you switch windows with the mouse,
|
||
;; in which case isearch-mode is terminated automatically before the
|
||
;; switch.
|
||
|
||
;; The search ring and completion commands automatically put you in
|
||
;; the minibuffer to edit the string. This gives you a chance to
|
||
;; modify the search string before executing the search. There are
|
||
;; three commands to terminate the editing: C-s and C-r exit the
|
||
;; minibuffer and search forward and reverse respectively, while C-m
|
||
;; exits and does a nonincremental search.
|
||
|
||
;; Exiting immediately from isearch uses isearch-edit-string instead
|
||
;; of nonincremental-search, if search-nonincremental-instead is non-nil.
|
||
;; The name of this option should probably be changed if we decide to
|
||
;; keep the behavior. No point in forcing nonincremental search until
|
||
;; the last possible moment.
|
||
|
||
;; TODO
|
||
;; - Integrate the emacs 19 generalized command history.
|
||
;; - Think about incorporating query-replace.
|
||
;; - Hooks and options for failed search.
|
||
|
||
;;; Change Log:
|
||
|
||
;; Changes before those recorded in ChangeLog:
|
||
|
||
;; Revision 1.4 92/09/14 16:26:02 liberte
|
||
;; Added prefix args to isearch-forward, etc. to switch between
|
||
;; string and regular expression searching.
|
||
;; Added some support for lemacs.
|
||
;; Added general isearch-highlight option - but only for lemacs so far.
|
||
;; Added support for frame switching in emacs 19.
|
||
;; Added word search option to isearch-edit-string.
|
||
;; Renamed isearch-quit to isearch-abort.
|
||
;; Numerous changes to comments and doc strings.
|
||
;;
|
||
;; Revision 1.3 92/06/29 13:10:08 liberte
|
||
;; Moved modal isearch-mode handling into isearch-mode.
|
||
;; Got rid of buffer-local isearch variables.
|
||
;; isearch-edit-string used by ring adjustments, completion, and
|
||
;; nonincremental searching. C-s and C-r are additional exit commands.
|
||
;; Renamed all regex to regexp.
|
||
;; Got rid of found-start and found-point globals.
|
||
;; Generalized handling of upper-case chars.
|
||
|
||
;; Revision 1.2 92/05/27 11:33:57 liberte
|
||
;; Emacs version 19 has a search ring, which is supported here.
|
||
;; Other fixes found in the version 19 isearch are included here.
|
||
;;
|
||
;; Also see variables search-caps-disable-folding,
|
||
;; search-nonincremental-instead, search-whitespace-regexp, and
|
||
;; commands isearch-toggle-regexp, isearch-edit-string.
|
||
;;
|
||
;; semi-modal isearching is supported.
|
||
|
||
;; Changes for 1.1
|
||
;; 3/18/92 Fixed invalid-regexp.
|
||
;; 3/18/92 Fixed yanking in regexps.
|
||
|
||
;;; Code:
|
||
|
||
|
||
;;; Some additional options and constants.
|
||
|
||
(defgroup isearch nil
|
||
"Incremental search minor mode."
|
||
:link '(emacs-commentary-link "isearch")
|
||
:link '(custom-manual "(emacs)Incremental Search")
|
||
:prefix "isearch-"
|
||
:prefix "search-"
|
||
:group 'matching)
|
||
|
||
|
||
(defcustom search-exit-option t
|
||
"*Non-nil means random control characters terminate incremental search."
|
||
:type 'boolean
|
||
:group 'isearch)
|
||
|
||
(defcustom search-slow-window-lines 1
|
||
"*Number of lines in slow search display windows.
|
||
These are the short windows used during incremental search on slow terminals.
|
||
Negative means put the slow search window at the top (normally it's at bottom)
|
||
and the value is minus the number of lines."
|
||
:type 'integer
|
||
:group 'isearch)
|
||
|
||
(defcustom search-slow-speed 1200
|
||
"*Highest terminal speed at which to use \"slow\" style incremental search.
|
||
This is the style where a one-line window is created to show the line
|
||
that the search has reached."
|
||
:type 'integer
|
||
:group 'isearch)
|
||
|
||
(defcustom search-upper-case 'not-yanks
|
||
"*If non-nil, upper case chars disable case fold searching.
|
||
That is, upper and lower case chars must match exactly.
|
||
This applies no matter where the chars come from, but does not
|
||
apply to chars in regexps that are prefixed with `\\'.
|
||
If this value is `not-yanks', yanked text is always downcased."
|
||
:type '(choice (const :tag "off" nil)
|
||
(const not-yanks)
|
||
(other :tag "on" t))
|
||
:group 'isearch)
|
||
|
||
(defcustom search-nonincremental-instead t
|
||
"*If non-nil, do a nonincremental search instead if exiting immediately.
|
||
Actually, `isearch-edit-string' is called to let you enter the search
|
||
string, and RET terminates editing and does a nonincremental search."
|
||
:type 'boolean
|
||
:group 'isearch)
|
||
|
||
(defcustom search-whitespace-regexp "\\s-+"
|
||
"*If non-nil, regular expression to match a sequence of whitespace chars.
|
||
This applies to regular expression incremental search.
|
||
You might want to use something like \"[ \\t\\r\\n]+\" instead.
|
||
In the Customization buffer, that is `[' followed by a space,
|
||
a tab, a carriage return (control-M), a newline, and `]+'."
|
||
:type 'regexp
|
||
:group 'isearch)
|
||
|
||
(defcustom search-highlight t
|
||
"*Non-nil means incremental search highlights the current match."
|
||
:type 'boolean
|
||
:group 'isearch)
|
||
|
||
(defcustom search-invisible 'open
|
||
"If t incremental search can match hidden text.
|
||
nil means don't match invisible text.
|
||
If the value is `open', if the text matched is made invisible by
|
||
an overlay having an `invisible' property and that overlay has a property
|
||
`isearch-open-invisible', then incremental search will show the contents.
|
||
\(This applies when using `outline.el' and `hideshow.el'.)"
|
||
:type '(choice (const :tag "Match hidden text" t)
|
||
(const :tag "Open overlays" open)
|
||
(const :tag "Don't match hidden text" nil))
|
||
:group 'isearch)
|
||
|
||
(defcustom isearch-hide-immediately t
|
||
"If non-nil, re-hide an invisible match right away.
|
||
This variable makes a difference when `search-invisible' is set to `open'.
|
||
It means that after search makes some invisible text visible
|
||
to show the match, it makes the text invisible again when the match moves.
|
||
Ordinarily the text becomes invisible again at the end of the search."
|
||
:type 'boolean
|
||
:group 'isearch)
|
||
|
||
(defcustom isearch-resume-enabled t
|
||
"*If non-nil, `isearch-resume' commands are added to the command history."
|
||
:type 'boolean
|
||
:group 'isearch)
|
||
|
||
(defvar isearch-mode-hook nil
|
||
"Function(s) to call after starting up an incremental search.")
|
||
|
||
(defvar isearch-mode-end-hook nil
|
||
"Function(s) to call after terminating an incremental search.")
|
||
|
||
;;; Search ring.
|
||
|
||
(defvar search-ring nil
|
||
"List of search string sequences.")
|
||
(defvar regexp-search-ring nil
|
||
"List of regular expression search string sequences.")
|
||
|
||
(defcustom search-ring-max 16
|
||
"*Maximum length of search ring before oldest elements are thrown away."
|
||
:type 'integer
|
||
:group 'isearch)
|
||
(defcustom regexp-search-ring-max 16
|
||
"*Maximum length of regexp search ring before oldest elements are thrown away."
|
||
:type 'integer
|
||
:group 'isearch)
|
||
|
||
(defvar search-ring-yank-pointer nil
|
||
"Index in `search-ring' of last string reused.
|
||
nil if none yet.")
|
||
(defvar regexp-search-ring-yank-pointer nil
|
||
"Index in `regexp-search-ring' of last string reused.
|
||
nil if none yet.")
|
||
|
||
(defcustom search-ring-update nil
|
||
"*Non-nil if advancing or retreating in the search ring should cause search.
|
||
Default value, nil, means edit the string instead."
|
||
:type 'boolean
|
||
:group 'isearch)
|
||
|
||
;;; Define isearch-mode keymap.
|
||
|
||
(defvar isearch-mode-map
|
||
(let* ((i 0)
|
||
(map (make-keymap)))
|
||
(or (vectorp (nth 1 map))
|
||
(char-table-p (nth 1 map))
|
||
(error "The initialization of isearch-mode-map must be updated"))
|
||
;; Make all multibyte characters search for themselves.
|
||
(let ((l (generic-character-list))
|
||
(table (nth 1 map)))
|
||
(while l
|
||
(set-char-table-default table (car l) 'isearch-printing-char)
|
||
(setq l (cdr l))))
|
||
;; Make function keys, etc, exit the search.
|
||
(define-key map [t] 'isearch-other-control-char)
|
||
;; Control chars, by default, end isearch mode transparently.
|
||
;; We need these explicit definitions because, in a dense keymap,
|
||
;; the binding for t does not affect characters.
|
||
;; We use a dense keymap to save space.
|
||
(while (< i ?\ )
|
||
(define-key map (make-string 1 i) 'isearch-other-control-char)
|
||
(setq i (1+ i)))
|
||
|
||
;; Single-byte printing chars extend the search string by default.
|
||
(setq i ?\ )
|
||
(while (< i 256)
|
||
(define-key map (vector i) 'isearch-printing-char)
|
||
(setq i (1+ i)))
|
||
|
||
;; To handle local bindings with meta char prefix keys, define
|
||
;; another full keymap. This must be done for any other prefix
|
||
;; keys as well, one full keymap per char of the prefix key. It
|
||
;; would be simpler to disable the global keymap, and/or have a
|
||
;; default local key binding for any key not otherwise bound.
|
||
(let ((meta-map (make-sparse-keymap)))
|
||
(define-key map (char-to-string meta-prefix-char) meta-map)
|
||
(define-key map [escape] meta-map))
|
||
(define-key map (vector meta-prefix-char t) 'isearch-other-meta-char)
|
||
|
||
;; Several non-printing chars change the searching behavior.
|
||
(define-key map "\C-s" 'isearch-repeat-forward)
|
||
(define-key map "\C-r" 'isearch-repeat-backward)
|
||
;; Define M-C-s and M-C-r like C-s and C-r so that the same key
|
||
;; combinations can be used to repeat regexp isearches that can
|
||
;; be used to start these searches.
|
||
(define-key map "\M-\C-s" 'isearch-repeat-forward)
|
||
(define-key map "\M-\C-r" 'isearch-repeat-backward)
|
||
(define-key map "\177" 'isearch-delete-char)
|
||
(define-key map "\C-g" 'isearch-abort)
|
||
|
||
;; This assumes \e is the meta-prefix-char.
|
||
(or (= ?\e meta-prefix-char)
|
||
(error "Inconsistency in isearch.el"))
|
||
(define-key map "\e\e\e" 'isearch-cancel)
|
||
(define-key map [escape escape escape] 'isearch-cancel)
|
||
|
||
(define-key map "\C-q" 'isearch-quote-char)
|
||
|
||
(define-key map "\r" 'isearch-exit)
|
||
(define-key map "\C-j" 'isearch-printing-char)
|
||
(define-key map "\t" 'isearch-printing-char)
|
||
(define-key map " " 'isearch-whitespace-chars)
|
||
(define-key map [?\S-\ ] 'isearch-whitespace-chars)
|
||
|
||
(define-key map "\C-w" 'isearch-yank-word-or-char)
|
||
(define-key map "\C-y" 'isearch-yank-line)
|
||
|
||
;; Define keys for regexp chars * ? |.
|
||
;; Nothing special for + because it matches at least once.
|
||
(define-key map "*" 'isearch-*-char)
|
||
(define-key map "?" 'isearch-*-char)
|
||
(define-key map "|" 'isearch-|-char)
|
||
|
||
;;; Turned off because I find I expect to get the global definition--rms.
|
||
;;; ;; Instead bind C-h to special help command for isearch-mode.
|
||
;;; (define-key map "\C-h" 'isearch-mode-help)
|
||
|
||
(define-key map "\M-n" 'isearch-ring-advance)
|
||
(define-key map "\M-p" 'isearch-ring-retreat)
|
||
(define-key map "\M-y" 'isearch-yank-kill)
|
||
|
||
(define-key map "\M-\t" 'isearch-complete)
|
||
|
||
;; Pass frame events transparently so they won't exit the search.
|
||
;; In particular, if we have more than one display open, then a
|
||
;; switch-frame might be generated by someone typing at another keyboard.
|
||
(define-key map [switch-frame] nil)
|
||
(define-key map [delete-frame] nil)
|
||
(define-key map [iconify-frame] nil)
|
||
(define-key map [make-frame-visible] nil)
|
||
(define-key map [mouse-movement] nil)
|
||
;; For searching multilingual text.
|
||
(define-key map "\C-\\" 'isearch-toggle-input-method)
|
||
(define-key map "\C-^" 'isearch-toggle-specified-input-method)
|
||
|
||
;; People expect to be able to paste with the mouse.
|
||
(define-key map [mouse-2] #'isearch-mouse-2)
|
||
(define-key map [down-mouse-2] nil)
|
||
|
||
;; Some bindings you may want to put in your isearch-mode-hook.
|
||
;; Suggest some alternates...
|
||
(define-key map "\M-c" 'isearch-toggle-case-fold)
|
||
(define-key map "\M-r" 'isearch-toggle-regexp)
|
||
(define-key map "\M-e" 'isearch-edit-string)
|
||
|
||
map)
|
||
"Keymap for `isearch-mode'.")
|
||
|
||
(defvar minibuffer-local-isearch-map
|
||
(let ((map (make-sparse-keymap)))
|
||
(set-keymap-parent map minibuffer-local-map)
|
||
(define-key map "\r" 'isearch-nonincremental-exit-minibuffer)
|
||
(define-key map "\M-n" 'isearch-ring-advance-edit)
|
||
(define-key map "\M-p" 'isearch-ring-retreat-edit)
|
||
(define-key map "\M-\t" 'isearch-complete-edit)
|
||
(define-key map "\C-s" 'isearch-forward-exit-minibuffer)
|
||
(define-key map "\C-r" 'isearch-reverse-exit-minibuffer)
|
||
map)
|
||
"Keymap for editing isearch strings in the minibuffer.")
|
||
|
||
;; Internal variables declared globally for byte-compiler.
|
||
;; These are all set with setq while isearching
|
||
;; and bound locally while editing the search string.
|
||
|
||
(defvar isearch-forward nil) ; Searching in the forward direction.
|
||
(defvar isearch-regexp nil) ; Searching for a regexp.
|
||
(defvar isearch-word nil) ; Searching for words.
|
||
|
||
(defvar isearch-cmds nil) ; Stack of search status sets.
|
||
(defvar isearch-string "") ; The current search string.
|
||
(defvar isearch-message "") ; text-char-description version of isearch-string
|
||
|
||
(defvar isearch-success t) ; Searching is currently successful.
|
||
(defvar isearch-invalid-regexp nil) ; Regexp not well formed.
|
||
(defvar isearch-within-brackets nil) ; Regexp has unclosed [.
|
||
(defvar isearch-other-end nil) ; Start (end) of match if forward (backward).
|
||
(defvar isearch-wrapped nil) ; Searching restarted from the top (bottom).
|
||
(defvar isearch-barrier 0)
|
||
(defvar isearch-just-started nil)
|
||
(defvar isearch-start-hscroll 0) ; hscroll when starting the search.
|
||
|
||
; case-fold-search while searching.
|
||
; either nil, t, or 'yes. 'yes means the same as t except that mixed
|
||
; case in the search string is ignored.
|
||
(defvar isearch-case-fold-search nil)
|
||
|
||
(defvar isearch-last-case-fold-search nil)
|
||
|
||
;; Used to save default value while isearch is active
|
||
(defvar isearch-original-minibuffer-message-timeout nil)
|
||
|
||
(defvar isearch-adjusted nil)
|
||
(defvar isearch-slow-terminal-mode nil)
|
||
;;; If t, using a small window.
|
||
(defvar isearch-small-window nil)
|
||
(defvar isearch-opoint 0)
|
||
;;; The window configuration active at the beginning of the search.
|
||
(defvar isearch-window-configuration nil)
|
||
|
||
;; Flag to indicate a yank occurred, so don't move the cursor.
|
||
(defvar isearch-yank-flag nil)
|
||
|
||
;;; A function to be called after each input character is processed.
|
||
;;; (It is not called after characters that exit the search.)
|
||
;;; It is only set from an optional argument to `isearch-mode'.
|
||
(defvar isearch-op-fun nil)
|
||
|
||
;;; Is isearch-mode in a recursive edit for modal searching.
|
||
(defvar isearch-recursive-edit nil)
|
||
|
||
;;; Should isearch be terminated after doing one search?
|
||
(defvar isearch-nonincremental nil)
|
||
|
||
;; New value of isearch-forward after isearch-edit-string.
|
||
(defvar isearch-new-forward nil)
|
||
|
||
;; Accumulate here the overlays opened during searching.
|
||
(defvar isearch-opened-overlays nil)
|
||
|
||
;; The value of input-method-function when isearch is invoked.
|
||
(defvar isearch-input-method-function nil)
|
||
|
||
;; A flag to tell if input-method-function is locally bound when
|
||
;; isearch is invoked.
|
||
(defvar isearch-input-method-local-p nil)
|
||
|
||
;; Minor-mode-alist changes - kind of redundant with the
|
||
;; echo area, but if isearching in multiple windows, it can be useful.
|
||
|
||
(or (assq 'isearch-mode minor-mode-alist)
|
||
(nconc minor-mode-alist
|
||
(list '(isearch-mode isearch-mode))))
|
||
|
||
(defvar isearch-mode nil) ;; Name of the minor mode, if non-nil.
|
||
(make-variable-buffer-local 'isearch-mode)
|
||
|
||
(define-key global-map "\C-s" 'isearch-forward)
|
||
(define-key esc-map "\C-s" 'isearch-forward-regexp)
|
||
(define-key global-map "\C-r" 'isearch-backward)
|
||
(define-key esc-map "\C-r" 'isearch-backward-regexp)
|
||
|
||
;;; Entry points to isearch-mode.
|
||
|
||
(defun isearch-forward (&optional regexp-p no-recursive-edit)
|
||
"\
|
||
Do incremental search forward.
|
||
With a prefix argument, do an incremental regular expression search instead.
|
||
\\<isearch-mode-map>
|
||
As you type characters, they add to the search string and are found.
|
||
The following non-printing keys are bound in `isearch-mode-map'.
|
||
|
||
Type \\[isearch-delete-char] to cancel characters from end of search string.
|
||
Type \\[isearch-exit] to exit, leaving point at location found.
|
||
Type LFD (C-j) to match end of line.
|
||
Type \\[isearch-repeat-forward] to search again forward,\
|
||
\\[isearch-repeat-backward] to search again backward.
|
||
Type \\[isearch-yank-word-or-char] to yank word from buffer onto end of search\
|
||
string and search for it.
|
||
Type \\[isearch-yank-line] to yank rest of line onto end of search string\
|
||
and search for it.
|
||
Type \\[isearch-yank-kill] to yank last killed text onto end of search string\
|
||
and search for it.
|
||
Type \\[isearch-quote-char] to quote control character to search for it.
|
||
\\[isearch-abort] while searching or when search has failed cancels input\
|
||
back to what has
|
||
been found successfully.
|
||
\\[isearch-abort] when search is successful aborts and moves point to\
|
||
starting point.
|
||
|
||
Type \\[isearch-toggle-case-fold] to toggle search case-sensitivity.
|
||
Type \\[isearch-toggle-regexp] to toggle regular-expression mode.
|
||
Type \\[isearch-edit-string] to edit the search string in the minibuffer.
|
||
|
||
Also supported is a search ring of the previous 16 search strings.
|
||
Type \\[isearch-ring-advance] to search for the next item in the search ring.
|
||
Type \\[isearch-ring-retreat] to search for the previous item in the search\
|
||
ring.
|
||
Type \\[isearch-complete] to complete the search string using the search ring.
|
||
|
||
If an input method is turned on in the current buffer, that input
|
||
method is also active while you are typing a characters to search. To
|
||
toggle the input method, type \\[isearch-toggle-input-method]. It
|
||
also toggles the input method in the current buffer.
|
||
|
||
To use a different input method for searching, type
|
||
\\[isearch-toggle-specified-input-method], and specify an input method
|
||
you want to use.
|
||
|
||
The above keys, bound in `isearch-mode-map', are often controlled by
|
||
options; do M-x apropos on search-.* to find them.
|
||
Other control and meta characters terminate the search
|
||
and are then executed normally (depending on `search-exit-option').
|
||
Likewise for function keys and mouse button events.
|
||
|
||
If this function is called non-interactively, it does not return to
|
||
the calling function until the search is done."
|
||
|
||
(interactive "P\np")
|
||
(isearch-mode t (not (null regexp-p)) nil (not no-recursive-edit)))
|
||
|
||
(defun isearch-forward-regexp (&optional not-regexp no-recursive-edit)
|
||
"\
|
||
Do incremental search forward for regular expression.
|
||
With a prefix argument, do a regular string search instead.
|
||
Like ordinary incremental search except that your input
|
||
is treated as a regexp. See \\[isearch-forward] for more info."
|
||
(interactive "P\np")
|
||
(isearch-mode t (null not-regexp) nil (not no-recursive-edit)))
|
||
|
||
(defun isearch-backward (&optional regexp-p no-recursive-edit)
|
||
"\
|
||
Do incremental search backward.
|
||
With a prefix argument, do a regular expression search instead.
|
||
See \\[isearch-forward] for more information."
|
||
(interactive "P\np")
|
||
(isearch-mode nil (not (null regexp-p)) nil (not no-recursive-edit)))
|
||
|
||
(defun isearch-backward-regexp (&optional not-regexp no-recursive-edit)
|
||
"\
|
||
Do incremental search backward for regular expression.
|
||
With a prefix argument, do a regular string search instead.
|
||
Like ordinary incremental search except that your input
|
||
is treated as a regexp. See \\[isearch-forward] for more info."
|
||
(interactive "P\np")
|
||
(isearch-mode nil (null not-regexp) nil (not no-recursive-edit)))
|
||
|
||
|
||
(defun isearch-mode-help ()
|
||
(interactive)
|
||
(describe-function 'isearch-forward)
|
||
(isearch-update))
|
||
|
||
|
||
;; isearch-mode only sets up incremental search for the minor mode.
|
||
;; All the work is done by the isearch-mode commands.
|
||
|
||
;; Not used yet:
|
||
;;(defvar isearch-commands '(isearch-forward isearch-backward
|
||
;; isearch-forward-regexp isearch-backward-regexp)
|
||
;; "List of commands for which isearch-mode does not recursive-edit.")
|
||
|
||
|
||
(defun isearch-mode (forward &optional regexp op-fun recursive-edit word-p)
|
||
"Start isearch minor mode. Called by `isearch-forward', etc.
|
||
|
||
\\{isearch-mode-map}"
|
||
|
||
;; Initialize global vars.
|
||
(setq isearch-forward forward
|
||
isearch-regexp regexp
|
||
isearch-word word-p
|
||
isearch-op-fun op-fun
|
||
isearch-last-case-fold-search isearch-case-fold-search
|
||
isearch-case-fold-search case-fold-search
|
||
isearch-string ""
|
||
isearch-message ""
|
||
isearch-cmds nil
|
||
isearch-success t
|
||
isearch-wrapped nil
|
||
isearch-barrier (point)
|
||
isearch-adjusted nil
|
||
isearch-yank-flag nil
|
||
isearch-invalid-regexp nil
|
||
isearch-within-brackets nil
|
||
isearch-slow-terminal-mode (and (<= baud-rate search-slow-speed)
|
||
(> (window-height)
|
||
(* 4
|
||
(abs search-slow-window-lines))))
|
||
isearch-other-end nil
|
||
isearch-small-window nil
|
||
isearch-just-started t
|
||
isearch-start-hscroll (window-hscroll)
|
||
|
||
isearch-opoint (point)
|
||
search-ring-yank-pointer nil
|
||
isearch-opened-overlays nil
|
||
isearch-input-method-function input-method-function
|
||
isearch-input-method-local-p (local-variable-p 'input-method-function)
|
||
regexp-search-ring-yank-pointer nil
|
||
|
||
;; Save the original value of `minibuffer-message-timeout', and
|
||
;; set it to nil so that isearch's messages don't get timed out.
|
||
isearch-original-minibuffer-message-timeout minibuffer-message-timeout
|
||
minibuffer-message-timeout nil)
|
||
|
||
;; We must bypass input method while reading key. When a user type
|
||
;; printable character, appropriate input method is turned on in
|
||
;; minibuffer to read multibyte characters.
|
||
(or isearch-input-method-local-p
|
||
(make-local-variable 'input-method-function))
|
||
(setq input-method-function nil)
|
||
|
||
(looking-at "")
|
||
(setq isearch-window-configuration
|
||
(if isearch-slow-terminal-mode (current-window-configuration) nil))
|
||
|
||
;; Maybe make minibuffer frame visible and/or raise it.
|
||
(let ((frame (window-frame (minibuffer-window))))
|
||
(if (not (memq (frame-live-p frame) '(nil t)))
|
||
(progn
|
||
(make-frame-visible frame)
|
||
(if minibuffer-auto-raise
|
||
(raise-frame frame)))))
|
||
|
||
(setq isearch-mode " Isearch") ;; forward? regexp?
|
||
(force-mode-line-update)
|
||
|
||
(isearch-push-state)
|
||
|
||
(setq overriding-terminal-local-map isearch-mode-map)
|
||
(isearch-update)
|
||
(run-hooks 'isearch-mode-hook)
|
||
|
||
(add-hook 'mouse-leave-buffer-hook 'isearch-done)
|
||
(add-hook 'kbd-macro-termination-hook 'isearch-done)
|
||
|
||
;; isearch-mode can be made modal (in the sense of not returning to
|
||
;; the calling function until searching is completed) by entering
|
||
;; a recursive-edit and exiting it when done isearching.
|
||
(if recursive-edit
|
||
(let ((isearch-recursive-edit t))
|
||
(recursive-edit)))
|
||
isearch-success)
|
||
|
||
|
||
;; Some high level utilities. Others below.
|
||
|
||
(defun isearch-update ()
|
||
;; Called after each command to update the display.
|
||
(if (null unread-command-events)
|
||
(progn
|
||
(if (not (input-pending-p))
|
||
(isearch-message))
|
||
(if (and isearch-slow-terminal-mode
|
||
(not (or isearch-small-window
|
||
(pos-visible-in-window-p))))
|
||
(let ((found-point (point)))
|
||
(setq isearch-small-window t)
|
||
(move-to-window-line 0)
|
||
(let ((window-min-height 1))
|
||
(split-window nil (if (< search-slow-window-lines 0)
|
||
(1+ (- search-slow-window-lines))
|
||
(- (window-height)
|
||
(1+ search-slow-window-lines)))))
|
||
(if (< search-slow-window-lines 0)
|
||
(progn (vertical-motion (- 1 search-slow-window-lines))
|
||
(set-window-start (next-window) (point))
|
||
(set-window-hscroll (next-window)
|
||
(window-hscroll))
|
||
(set-window-hscroll (selected-window) 0))
|
||
(other-window 1))
|
||
(goto-char found-point))
|
||
;; Keep same hscrolling as at the start of the search when possible
|
||
(let ((current-scroll (window-hscroll)))
|
||
(set-window-hscroll (selected-window) isearch-start-hscroll)
|
||
(unless (pos-visible-in-window-p)
|
||
(set-window-hscroll (selected-window) current-scroll))))
|
||
(if isearch-other-end
|
||
(if (< isearch-other-end (point)) ; isearch-forward?
|
||
(isearch-highlight isearch-other-end (point))
|
||
(isearch-highlight (point) isearch-other-end))
|
||
(isearch-dehighlight nil))
|
||
))
|
||
(setq ;; quit-flag nil not for isearch-mode
|
||
isearch-adjusted nil
|
||
isearch-yank-flag nil)
|
||
(isearch-lazy-highlight-new-loop)
|
||
;; We must prevent the point moving to the end of composition when a
|
||
;; part of the composition has just been searched.
|
||
(setq disable-point-adjustment t))
|
||
|
||
(defun isearch-done (&optional nopush edit)
|
||
(if isearch-resume-enabled
|
||
(let ((command `(isearch-resume ,isearch-string ,isearch-regexp
|
||
,isearch-word ,isearch-forward
|
||
,isearch-message
|
||
',isearch-case-fold-search)))
|
||
(unless (equal (car command-history) command)
|
||
(setq command-history (cons command command-history)))))
|
||
|
||
(remove-hook 'mouse-leave-buffer-hook 'isearch-done)
|
||
(remove-hook 'kbd-macro-termination-hook 'isearch-done)
|
||
(setq isearch-lazy-highlight-start nil)
|
||
|
||
;; Called by all commands that terminate isearch-mode.
|
||
;; If NOPUSH is non-nil, we don't push the string on the search ring.
|
||
(setq overriding-terminal-local-map nil)
|
||
;; (setq pre-command-hook isearch-old-pre-command-hook) ; for lemacs
|
||
(setq minibuffer-message-timeout isearch-original-minibuffer-message-timeout)
|
||
(isearch-dehighlight t)
|
||
(isearch-lazy-highlight-cleanup isearch-lazy-highlight-cleanup)
|
||
(let ((found-start (window-start (selected-window)))
|
||
(found-point (point)))
|
||
(if isearch-window-configuration
|
||
(set-window-configuration isearch-window-configuration))
|
||
|
||
(if isearch-small-window
|
||
(goto-char found-point)
|
||
;; Exiting the save-window-excursion clobbers window-start; restore it.
|
||
(set-window-start (selected-window) found-start t))
|
||
|
||
;; If there was movement, mark the starting position.
|
||
;; Maybe should test difference between and set mark iff > threshold.
|
||
(if (/= (point) isearch-opoint)
|
||
(or (and transient-mark-mode mark-active)
|
||
(progn
|
||
(push-mark isearch-opoint t)
|
||
(or executing-kbd-macro (> (minibuffer-depth) 0)
|
||
(message "Mark saved where search started"))))))
|
||
|
||
(setq isearch-mode nil)
|
||
(if isearch-input-method-local-p
|
||
(setq input-method-function isearch-input-method-function)
|
||
(kill-local-variable 'input-method-function))
|
||
|
||
(force-mode-line-update)
|
||
|
||
;; If we ended in the middle of some intangible text,
|
||
;; move to the further end of that intangible text.
|
||
(let ((after (if (eobp) nil
|
||
(get-text-property (point) 'intangible)))
|
||
(before (if (bobp) nil
|
||
(get-text-property (1- (point)) 'intangible))))
|
||
(when (and before after (eq before after))
|
||
(if isearch-forward
|
||
(goto-char (next-single-property-change (point) 'intangible))
|
||
(goto-char (previous-single-property-change (point) 'intangible)))))
|
||
|
||
(if (and (> (length isearch-string) 0) (not nopush))
|
||
;; Update the ring data.
|
||
(isearch-update-ring isearch-string isearch-regexp))
|
||
|
||
(run-hooks 'isearch-mode-end-hook)
|
||
(and (not edit) isearch-recursive-edit (exit-recursive-edit)))
|
||
|
||
(defun isearch-update-ring (string &optional regexp)
|
||
"Add STRING to the beginning of the search ring.
|
||
REGEXP says which ring to use."
|
||
(if regexp
|
||
(if (or (null regexp-search-ring)
|
||
(not (string= string (car regexp-search-ring))))
|
||
(progn
|
||
(setq regexp-search-ring
|
||
(cons string regexp-search-ring))
|
||
(if (> (length regexp-search-ring) regexp-search-ring-max)
|
||
(setcdr (nthcdr (1- search-ring-max) regexp-search-ring)
|
||
nil))))
|
||
(if (or (null search-ring)
|
||
(not (string= string (car search-ring))))
|
||
(progn
|
||
(setq search-ring (cons string search-ring))
|
||
(if (> (length search-ring) search-ring-max)
|
||
(setcdr (nthcdr (1- search-ring-max) search-ring) nil))))))
|
||
|
||
;;; Switching buffers should first terminate isearch-mode.
|
||
;;; ;; For Emacs 19, the frame switch event is handled.
|
||
;;; (defun isearch-switch-frame-handler ()
|
||
;;; (interactive) ;; Is this necessary?
|
||
;;; ;; First terminate isearch-mode.
|
||
;;; (isearch-done)
|
||
;;; (isearch-clean-overlays)
|
||
;;; (handle-switch-frame (car (cdr last-command-char))))
|
||
|
||
|
||
;; Commands active while inside of the isearch minor mode.
|
||
|
||
(defun isearch-exit ()
|
||
"Exit search normally.
|
||
However, if this is the first command after starting incremental
|
||
search and `search-nonincremental-instead' is non-nil, do a
|
||
nonincremental search instead via `isearch-edit-string'."
|
||
(interactive)
|
||
(if (and search-nonincremental-instead
|
||
(= 0 (length isearch-string)))
|
||
(let ((isearch-nonincremental t))
|
||
(isearch-edit-string)))
|
||
(isearch-done)
|
||
(isearch-clean-overlays))
|
||
|
||
|
||
(defun isearch-edit-string ()
|
||
"Edit the search string in the minibuffer.
|
||
The following additional command keys are active while editing.
|
||
\\<minibuffer-local-isearch-map>
|
||
\\[exit-minibuffer] to resume incremental searching with the edited string.
|
||
\\[isearch-nonincremental-exit-minibuffer] to do one nonincremental search.
|
||
\\[isearch-forward-exit-minibuffer] to resume isearching forward.
|
||
\\[isearch-reverse-exit-minibuffer] to resume isearching backward.
|
||
\\[isearch-ring-advance-edit] to replace the search string with the next item in the search ring.
|
||
\\[isearch-ring-retreat-edit] to replace the search string with the previous item in the search ring.
|
||
\\[isearch-complete-edit] to complete the search string using the search ring.
|
||
\\<isearch-mode-map>
|
||
If first char entered is \\[isearch-yank-word-or-char], then do word search instead."
|
||
|
||
;; This code is very hairy for several reasons, explained in the code.
|
||
;; Mainly, isearch-mode must be terminated while editing and then restarted.
|
||
;; If there were a way to catch any change of buffer from the minibuffer,
|
||
;; this could be simplified greatly.
|
||
;; Editing doesn't back up the search point. Should it?
|
||
(interactive)
|
||
(condition-case err
|
||
(progn
|
||
(let ((isearch-nonincremental isearch-nonincremental)
|
||
|
||
;; Locally bind all isearch global variables to protect them
|
||
;; from recursive isearching.
|
||
;; isearch-string -message and -forward are not bound
|
||
;; so they may be changed. Instead, save the values.
|
||
(isearch-new-string isearch-string)
|
||
(isearch-new-message isearch-message)
|
||
(isearch-new-forward isearch-forward)
|
||
(isearch-new-word isearch-word)
|
||
|
||
(isearch-regexp isearch-regexp)
|
||
(isearch-op-fun isearch-op-fun)
|
||
(isearch-cmds isearch-cmds)
|
||
(isearch-success isearch-success)
|
||
(isearch-wrapped isearch-wrapped)
|
||
(isearch-barrier isearch-barrier)
|
||
(isearch-adjusted isearch-adjusted)
|
||
(isearch-yank-flag isearch-yank-flag)
|
||
(isearch-invalid-regexp isearch-invalid-regexp)
|
||
(isearch-within-brackets isearch-within-brackets)
|
||
;;; Don't bind this. We want isearch-search, below, to set it.
|
||
;;; And the old value won't matter after that.
|
||
;;; (isearch-other-end isearch-other-end)
|
||
;;; Perhaps some of these other variables should be bound for a
|
||
;;; shorter period, ending before the next isearch-search.
|
||
;;; But there doesn't seem to be a real bug, so let's not risk it now.
|
||
(isearch-opoint isearch-opoint)
|
||
(isearch-slow-terminal-mode isearch-slow-terminal-mode)
|
||
(isearch-small-window isearch-small-window)
|
||
(isearch-recursive-edit isearch-recursive-edit)
|
||
;; Save current configuration so we can restore it here.
|
||
(isearch-window-configuration (current-window-configuration))
|
||
|
||
;; Temporarily restore `minibuffer-message-timeout'.
|
||
(minibuffer-message-timeout
|
||
isearch-original-minibuffer-message-timeout)
|
||
(isearch-original-minibuffer-message-timeout
|
||
isearch-original-minibuffer-message-timeout)
|
||
)
|
||
|
||
;; Actually terminate isearching until editing is done.
|
||
;; This is so that the user can do anything without failure,
|
||
;; like switch buffers and start another isearch, and return.
|
||
(condition-case err
|
||
(isearch-done t t)
|
||
(exit nil)) ; was recursive editing
|
||
|
||
(isearch-message) ;; for read-char
|
||
(unwind-protect
|
||
(let* (;; Why does following read-char echo?
|
||
;;(echo-keystrokes 0) ;; not needed with above message
|
||
(e (let ((cursor-in-echo-area t))
|
||
(read-event)))
|
||
;; Binding minibuffer-history-symbol to nil is a work-around
|
||
;; for some incompatibility with gmhist.
|
||
(minibuffer-history-symbol)
|
||
(message-log-max nil))
|
||
;; If the first character the user types when we prompt them
|
||
;; for a string is the yank-word character, then go into
|
||
;; word-search mode. Otherwise unread that character and
|
||
;; read a key the normal way.
|
||
;; Word search does not apply (yet) to regexp searches,
|
||
;; no check is made here.
|
||
(message (isearch-message-prefix nil nil t))
|
||
(if (memq (lookup-key isearch-mode-map (vector e))
|
||
'(isearch-yank-word
|
||
isearch-yank-word-or-char))
|
||
(setq isearch-word t;; so message-prefix is right
|
||
isearch-new-word t)
|
||
(cancel-kbd-macro-events)
|
||
(isearch-unread e))
|
||
(setq cursor-in-echo-area nil)
|
||
(setq isearch-new-string
|
||
(let (junk-ring)
|
||
(read-from-minibuffer
|
||
(isearch-message-prefix nil nil isearch-nonincremental)
|
||
isearch-string
|
||
minibuffer-local-isearch-map nil
|
||
'junk-ring))
|
||
isearch-new-message
|
||
(mapconcat 'isearch-text-char-description
|
||
isearch-new-string "")))
|
||
;; Always resume isearching by restarting it.
|
||
(isearch-mode isearch-forward
|
||
isearch-regexp
|
||
isearch-op-fun
|
||
nil
|
||
isearch-word)
|
||
|
||
;; Copy new local values to isearch globals
|
||
(setq isearch-string isearch-new-string
|
||
isearch-message isearch-new-message
|
||
isearch-forward isearch-new-forward
|
||
isearch-word isearch-new-word))
|
||
|
||
;; Empty isearch-string means use default.
|
||
(if (= 0 (length isearch-string))
|
||
(setq isearch-string (or (car (if isearch-regexp
|
||
regexp-search-ring
|
||
search-ring))
|
||
"")
|
||
|
||
isearch-message
|
||
(mapconcat 'isearch-text-char-description
|
||
isearch-string ""))
|
||
;; This used to set the last search string,
|
||
;; but I think it is not right to do that here.
|
||
;; Only the string actually used should be saved.
|
||
))
|
||
|
||
;; Push the state as of before this C-s.
|
||
(isearch-push-state)
|
||
|
||
;; Reinvoke the pending search.
|
||
(isearch-search)
|
||
(isearch-update)
|
||
(if isearch-nonincremental
|
||
(progn
|
||
;; (sit-for 1) ;; needed if isearch-done does: (message "")
|
||
(isearch-done))))
|
||
|
||
(quit ; handle abort-recursive-edit
|
||
(isearch-abort) ;; outside of let to restore outside global values
|
||
)))
|
||
|
||
(defun isearch-nonincremental-exit-minibuffer ()
|
||
(interactive)
|
||
(setq isearch-nonincremental t)
|
||
(exit-minibuffer))
|
||
|
||
(defun isearch-forward-exit-minibuffer ()
|
||
(interactive)
|
||
(setq isearch-new-forward t)
|
||
(exit-minibuffer))
|
||
|
||
(defun isearch-reverse-exit-minibuffer ()
|
||
(interactive)
|
||
(setq isearch-new-forward nil)
|
||
(exit-minibuffer))
|
||
|
||
(defun isearch-cancel ()
|
||
"Terminate the search and go back to the starting point."
|
||
(interactive)
|
||
(goto-char isearch-opoint)
|
||
(isearch-done t)
|
||
(isearch-clean-overlays)
|
||
(signal 'quit nil)) ; and pass on quit signal
|
||
|
||
(defun isearch-abort ()
|
||
"Abort incremental search mode if searching is successful, signaling quit.
|
||
Otherwise, revert to previous successful search and continue searching.
|
||
Use `isearch-exit' to quit without signaling."
|
||
(interactive)
|
||
;; (ding) signal instead below, if quitting
|
||
(discard-input)
|
||
(if isearch-success
|
||
;; If search is successful, move back to starting point
|
||
;; and really do quit.
|
||
(progn (goto-char isearch-opoint)
|
||
(setq isearch-success nil)
|
||
(isearch-done t) ; exit isearch
|
||
(isearch-clean-overlays)
|
||
(signal 'quit nil)) ; and pass on quit signal
|
||
;; If search is failing, or has an incomplete regexp,
|
||
;; rub out until it is once more successful.
|
||
(while (or (not isearch-success) isearch-invalid-regexp)
|
||
(isearch-pop-state))
|
||
(isearch-update)))
|
||
|
||
(defun isearch-repeat (direction)
|
||
;; Utility for isearch-repeat-forward and -backward.
|
||
(if (eq isearch-forward (eq direction 'forward))
|
||
;; C-s in forward or C-r in reverse.
|
||
(if (equal isearch-string "")
|
||
;; If search string is empty, use last one.
|
||
(setq isearch-string
|
||
(or (if isearch-regexp
|
||
(car regexp-search-ring)
|
||
(car search-ring))
|
||
"")
|
||
isearch-message
|
||
(mapconcat 'isearch-text-char-description
|
||
isearch-string "")
|
||
isearch-case-fold-search isearch-last-case-fold-search)
|
||
;; If already have what to search for, repeat it.
|
||
(or isearch-success
|
||
(progn
|
||
(goto-char (if isearch-forward (point-min) (point-max)))
|
||
(setq isearch-wrapped t))))
|
||
;; C-s in reverse or C-r in forward, change direction.
|
||
(setq isearch-forward (not isearch-forward)))
|
||
|
||
(setq isearch-barrier (point)) ; For subsequent \| if regexp.
|
||
|
||
(if (equal isearch-string "")
|
||
(setq isearch-success t)
|
||
(if (and isearch-success (equal (match-end 0) (match-beginning 0))
|
||
(not isearch-just-started))
|
||
;; If repeating a search that found
|
||
;; an empty string, ensure we advance.
|
||
(if (if isearch-forward (eobp) (bobp))
|
||
;; If there's nowhere to advance to, fail (and wrap next time).
|
||
(progn
|
||
(setq isearch-success nil)
|
||
(ding))
|
||
(forward-char (if isearch-forward 1 -1))
|
||
(isearch-search))
|
||
(isearch-search)))
|
||
|
||
(isearch-push-state)
|
||
(isearch-update))
|
||
|
||
(defun isearch-repeat-forward ()
|
||
"Repeat incremental search forwards."
|
||
(interactive)
|
||
(isearch-repeat 'forward))
|
||
|
||
(defun isearch-repeat-backward ()
|
||
"Repeat incremental search backwards."
|
||
(interactive)
|
||
(isearch-repeat 'backward))
|
||
|
||
(defun isearch-toggle-regexp ()
|
||
"Toggle regexp searching on or off."
|
||
;; The status stack is left unchanged.
|
||
(interactive)
|
||
(setq isearch-regexp (not isearch-regexp))
|
||
(if isearch-regexp (setq isearch-word nil))
|
||
(isearch-update))
|
||
|
||
(defun isearch-toggle-case-fold ()
|
||
"Toggle case folding in searching on or off."
|
||
(interactive)
|
||
(setq isearch-case-fold-search
|
||
(if isearch-case-fold-search nil 'yes))
|
||
(let ((message-log-max nil))
|
||
(message "%s%s [case %ssensitive]"
|
||
(isearch-message-prefix nil nil isearch-nonincremental)
|
||
isearch-message
|
||
(if isearch-case-fold-search "in" "")))
|
||
(setq isearch-adjusted t)
|
||
(sit-for 1)
|
||
(isearch-update))
|
||
|
||
(defun isearch-delete-char ()
|
||
"Discard last input item and move point back.
|
||
If no previous match was done, just beep."
|
||
(interactive)
|
||
(if (null (cdr isearch-cmds))
|
||
(ding)
|
||
(isearch-pop-state))
|
||
(isearch-update))
|
||
|
||
|
||
(defun isearch-yank-string (string)
|
||
"Pull STRING into search string."
|
||
;; Downcase the string if not supposed to case-fold yanked strings.
|
||
(if (and isearch-case-fold-search
|
||
(eq 'not-yanks search-upper-case))
|
||
(setq string (downcase string)))
|
||
(if isearch-regexp (setq string (regexp-quote string)))
|
||
(setq isearch-string (concat isearch-string string)
|
||
isearch-message
|
||
(concat isearch-message
|
||
(mapconcat 'isearch-text-char-description
|
||
string ""))
|
||
;; Don't move cursor in reverse search.
|
||
isearch-yank-flag t)
|
||
(isearch-search-and-update))
|
||
|
||
(defun isearch-yank-kill ()
|
||
"Pull string from kill ring into search string."
|
||
(interactive)
|
||
(isearch-yank-string (current-kill 0)))
|
||
|
||
(defun isearch-yank-x-selection ()
|
||
"Pull current X selection into search string."
|
||
(interactive)
|
||
(isearch-yank-string (x-get-selection)))
|
||
|
||
|
||
(defun isearch-mouse-2 (click arg)
|
||
"Handle mouse-2 in Isearch mode.
|
||
For a click in the echo area, invoke `isearch-yank-x-selection'.
|
||
Otherwise invoke whatever mouse-2 is bound to outside of Isearch."
|
||
(interactive "e\nP")
|
||
(let* ((w (posn-window (event-start click)))
|
||
(overriding-terminal-local-map nil)
|
||
(key (vector (event-basic-type click)))
|
||
(binding (key-binding key)))
|
||
(if (and (window-minibuffer-p w)
|
||
(not (minibuffer-window-active-p w))) ; in echo area
|
||
(isearch-yank-x-selection)
|
||
(when binding
|
||
;; Kluge to allow passing ARG to functions that support it,
|
||
;; like mouse-yank-at-click.
|
||
(if (equal (cadr (interactive-form binding)) "e\nP")
|
||
(funcall binding click arg)
|
||
(funcall binding click))))))
|
||
|
||
|
||
(defun isearch-yank-internal (jumpform)
|
||
"Pull the text from point to the point reached by JUMPFORM.
|
||
JUMPFORM is a lambda expression that takes no arguments and returns a
|
||
buffer position, possibly having moved point to that position. For
|
||
example, it might move point forward by a word and return point, or it
|
||
might return the position of the end of the line."
|
||
(isearch-yank-string
|
||
(save-excursion
|
||
(and (not isearch-forward) isearch-other-end
|
||
(goto-char isearch-other-end))
|
||
(buffer-substring-no-properties (point) (funcall jumpform)))))
|
||
|
||
(defun isearch-yank-char ()
|
||
"Pull next letter from buffer into search string."
|
||
(interactive)
|
||
(isearch-yank-internal (lambda () (forward-char 1) (point))))
|
||
|
||
(defun isearch-yank-word-or-char ()
|
||
"Pull next character or word from buffer into search string."
|
||
(interactive)
|
||
(isearch-yank-internal
|
||
(lambda ()
|
||
(if (or (= (char-syntax (or (char-after) 0)) ?w)
|
||
(= (char-syntax (or (char-after (1+ (point))) 0)) ?w))
|
||
(forward-word 1)
|
||
(forward-char 1)) (point))))
|
||
|
||
(defun isearch-yank-word ()
|
||
"Pull next word from buffer into search string."
|
||
(interactive)
|
||
(isearch-yank-internal (lambda () (forward-word 1) (point))))
|
||
|
||
(defun isearch-yank-line ()
|
||
"Pull rest of line from buffer into search string."
|
||
(interactive)
|
||
(isearch-yank-internal (lambda () (line-end-position))))
|
||
|
||
|
||
(defun isearch-search-and-update ()
|
||
;; Do the search and update the display.
|
||
(if (and (not isearch-success)
|
||
;; unsuccessful regexp search may become
|
||
;; successful by addition of characters which
|
||
;; make isearch-string valid
|
||
(not isearch-regexp))
|
||
nil
|
||
;; In reverse search, adding stuff at
|
||
;; the end may cause zero or many more chars to be
|
||
;; matched, in the string following point.
|
||
;; Allow all those possibilities without moving point as
|
||
;; long as the match does not extend past search origin.
|
||
(if (and (not isearch-forward) (not isearch-adjusted)
|
||
(condition-case ()
|
||
(let ((case-fold-search isearch-case-fold-search))
|
||
(if (and (eq case-fold-search t) search-upper-case)
|
||
(setq case-fold-search
|
||
(isearch-no-upper-case-p isearch-string isearch-regexp)))
|
||
(looking-at (if isearch-regexp isearch-string
|
||
(regexp-quote isearch-string))))
|
||
(error nil))
|
||
(or isearch-yank-flag
|
||
(<= (match-end 0)
|
||
(min isearch-opoint isearch-barrier))))
|
||
(progn
|
||
(setq isearch-success t
|
||
isearch-invalid-regexp nil
|
||
isearch-within-brackets nil
|
||
isearch-other-end (match-end 0))
|
||
(if (and (eq isearch-case-fold-search t) search-upper-case)
|
||
(setq isearch-case-fold-search
|
||
(isearch-no-upper-case-p isearch-string isearch-regexp))))
|
||
;; Not regexp, not reverse, or no match at point.
|
||
(if (and isearch-other-end (not isearch-adjusted))
|
||
(goto-char (if isearch-forward isearch-other-end
|
||
(min isearch-opoint
|
||
isearch-barrier
|
||
(1+ isearch-other-end)))))
|
||
(isearch-search)
|
||
))
|
||
(isearch-push-state)
|
||
(if isearch-op-fun (funcall isearch-op-fun))
|
||
(isearch-update))
|
||
|
||
|
||
;; *, ?, and | chars can make a regexp more liberal.
|
||
;; They can make a regexp match sooner or make it succeed instead of failing.
|
||
;; So go back to place last successful search started
|
||
;; or to the last ^S/^R (barrier), whichever is nearer.
|
||
;; + needs no special handling because the string must match at least once.
|
||
|
||
(defun isearch-*-char ()
|
||
"Handle * and ? specially in regexps."
|
||
(interactive)
|
||
(if isearch-regexp
|
||
(let ((idx (length isearch-string)))
|
||
(while (and (> idx 0)
|
||
(eq (aref isearch-string (1- idx)) ?\\))
|
||
(setq idx (1- idx)))
|
||
(when (= (mod (- (length isearch-string) idx) 2) 0)
|
||
(setq isearch-adjusted t)
|
||
;; Get the isearch-other-end from before the last search.
|
||
;; We want to start from there,
|
||
;; so that we don't retreat farther than that.
|
||
;; (car isearch-cmds) is after last search;
|
||
;; (car (cdr isearch-cmds)) is from before it.
|
||
(let ((cs (nth 5 (car (cdr isearch-cmds)))))
|
||
(setq cs (or cs isearch-barrier))
|
||
(goto-char
|
||
(if isearch-forward
|
||
(max cs isearch-barrier)
|
||
(min cs isearch-barrier)))))))
|
||
(isearch-process-search-char last-command-char))
|
||
|
||
|
||
(defun isearch-|-char ()
|
||
"If in regexp search, jump to the barrier."
|
||
(interactive)
|
||
(if isearch-regexp
|
||
(progn
|
||
(setq isearch-adjusted t)
|
||
(goto-char isearch-barrier)))
|
||
(isearch-process-search-char last-command-char))
|
||
|
||
|
||
(defalias 'isearch-other-control-char 'isearch-other-meta-char)
|
||
|
||
(defun isearch-other-meta-char ()
|
||
"Exit the search normally and reread this key sequence.
|
||
But only if `search-exit-option' is non-nil, the default.
|
||
If it is the symbol `edit', the search string is edited in the minibuffer
|
||
and the meta character is unread so that it applies to editing the string."
|
||
(interactive)
|
||
(let* ((key (this-command-keys))
|
||
(main-event (aref key 0))
|
||
(keylist (listify-key-sequence key)))
|
||
(cond ((and (= (length key) 1)
|
||
(let ((lookup (lookup-key function-key-map key)))
|
||
(not (or (null lookup) (integerp lookup)
|
||
(keymapp lookup)))))
|
||
;; Handle a function key that translates into something else.
|
||
;; If the key has a global definition too,
|
||
;; exit and unread the key itself, so its global definition runs.
|
||
;; Otherwise, unread the translation,
|
||
;; so that the translated key takes effect within isearch.
|
||
(cancel-kbd-macro-events)
|
||
(if (lookup-key global-map key)
|
||
(progn
|
||
(isearch-done)
|
||
(apply 'isearch-unread keylist))
|
||
(setq keylist
|
||
(listify-key-sequence (lookup-key function-key-map key)))
|
||
(while keylist
|
||
(setq key (car keylist))
|
||
;; If KEY is a printing char, we handle it here
|
||
;; directly to avoid the input method and keyboard
|
||
;; coding system translating it.
|
||
(if (and (integerp key)
|
||
(>= key ?\ ) (/= key 127) (< key 256))
|
||
(progn
|
||
(isearch-process-search-char key)
|
||
(setq keylist (cdr keylist)))
|
||
;; As the remaining keys in KEYLIST can't be handled
|
||
;; here, we must reread them.
|
||
(apply 'isearch-unread keylist)
|
||
(setq keylist nil)))))
|
||
(
|
||
;; Handle an undefined shifted control character
|
||
;; by downshifting it if that makes it defined.
|
||
;; (As read-key-sequence would normally do,
|
||
;; if we didn't have a default definition.)
|
||
(let ((mods (event-modifiers main-event)))
|
||
(and (integerp main-event)
|
||
(memq 'shift mods)
|
||
(memq 'control mods)
|
||
(lookup-key isearch-mode-map
|
||
(let ((copy (copy-sequence key)))
|
||
(aset copy 0
|
||
(- main-event (- ?\C-\S-a ?\C-a)))
|
||
copy)
|
||
nil)))
|
||
(setcar keylist (- main-event (- ?\C-\S-a ?\C-a)))
|
||
(cancel-kbd-macro-events)
|
||
(apply 'isearch-unread keylist))
|
||
((eq search-exit-option 'edit)
|
||
(apply 'isearch-unread keylist)
|
||
(isearch-edit-string))
|
||
(search-exit-option
|
||
(let (window)
|
||
(cancel-kbd-macro-events)
|
||
(apply 'isearch-unread keylist)
|
||
|
||
;; Properly handle scroll-bar and mode-line clicks for
|
||
;; which a dummy prefix event was generated as (aref key
|
||
;; 0). Note that we don't have to modify the event
|
||
;; anymore in 21 because read_key_sequence no longer modifies
|
||
;; events to produce fake prefix keys.
|
||
(when (and (> (length key) 1)
|
||
(symbolp (aref key 0))
|
||
(listp (aref key 1))
|
||
(not (numberp (posn-point
|
||
(event-start (aref key 1))))))
|
||
(pop unread-command-events)
|
||
(setq main-event (car unread-command-events)))
|
||
|
||
;; If we got a mouse click event, that event contains the
|
||
;; window clicked on. maybe it was read with the buffer
|
||
;; it was clicked on. If so, that buffer, not the current one,
|
||
;; is in isearch mode. So end the search in that buffer.
|
||
|
||
;; ??? I have no idea what this if checks for, but it's
|
||
;; obviously wrong for the case that a down-mouse event
|
||
;; on another window invokes this function. The event
|
||
;; will contain the window clicked on and that window's
|
||
;; buffer is certainaly not always in Isearch mode.
|
||
;;
|
||
;; Leave the code in, but check for current buffer not
|
||
;; being in Isearch mode for now, until someone tells
|
||
;; what it's really supposed to do.
|
||
;;
|
||
;; --gerd 2001-08-10.
|
||
|
||
(if (and (not isearch-mode)
|
||
(listp main-event)
|
||
(setq window (posn-window (event-start main-event)))
|
||
(windowp window)
|
||
(or (> (minibuffer-depth) 0)
|
||
(not (window-minibuffer-p window))))
|
||
(save-excursion
|
||
(set-buffer (window-buffer window))
|
||
(isearch-done)
|
||
(isearch-clean-overlays))
|
||
(isearch-done)
|
||
(isearch-clean-overlays))))
|
||
(t;; otherwise nil
|
||
(isearch-process-search-string key key)))))
|
||
|
||
(defun isearch-quote-char ()
|
||
"Quote special characters for incremental search."
|
||
(interactive)
|
||
(let ((char (read-quoted-char (isearch-message t))))
|
||
;; Assume character codes 0200 - 0377 stand for characters in some
|
||
;; single-byte character set, and convert them to Emacs
|
||
;; characters.
|
||
(and enable-multibyte-characters
|
||
(>= char ?\200)
|
||
(<= char ?\377)
|
||
(setq char (unibyte-char-to-multibyte char)))
|
||
(isearch-process-search-char char)))
|
||
|
||
(defun isearch-return-char ()
|
||
"Convert return into newline for incremental search.
|
||
Obsolete."
|
||
(interactive)
|
||
(isearch-process-search-char ?\n))
|
||
|
||
(defun isearch-printing-char ()
|
||
"Add this ordinary printing character to the search string and search."
|
||
(interactive)
|
||
(let ((char last-command-char))
|
||
(if (= char ?\S-\ )
|
||
(setq char ?\ ))
|
||
(if (and enable-multibyte-characters
|
||
(>= char ?\200)
|
||
(<= char ?\377))
|
||
(if (keyboard-coding-system)
|
||
(isearch-process-search-multibyte-characters char)
|
||
(isearch-process-search-char (unibyte-char-to-multibyte char)))
|
||
(if current-input-method
|
||
(isearch-process-search-multibyte-characters char)
|
||
(isearch-process-search-char char)))))
|
||
|
||
(defun isearch-whitespace-chars ()
|
||
"Match all whitespace chars, if in regexp mode.
|
||
If you want to search for just a space, type \\<isearch-mode-map>\\[isearch-quote-char] SPC."
|
||
(interactive)
|
||
(if isearch-regexp
|
||
(if (and search-whitespace-regexp (not isearch-within-brackets)
|
||
(not isearch-invalid-regexp))
|
||
(isearch-process-search-string search-whitespace-regexp " ")
|
||
(isearch-printing-char))
|
||
(progn
|
||
;; This way of doing word search doesn't correctly extend current search.
|
||
;; (setq isearch-word t)
|
||
;; (setq isearch-adjusted t)
|
||
;; (goto-char isearch-barrier)
|
||
(isearch-printing-char))))
|
||
|
||
(defun isearch-process-search-char (char)
|
||
;; Append the char to the search string, update the message and re-search.
|
||
(isearch-process-search-string
|
||
(char-to-string char)
|
||
(if (>= char ?\200)
|
||
(char-to-string char)
|
||
(isearch-text-char-description char))))
|
||
|
||
(defun isearch-process-search-string (string message)
|
||
(setq isearch-string (concat isearch-string string)
|
||
isearch-message (concat isearch-message message))
|
||
(isearch-search-and-update))
|
||
|
||
|
||
;; Search Ring
|
||
|
||
(defun isearch-ring-adjust1 (advance)
|
||
;; Helper for isearch-ring-adjust
|
||
(let* ((ring (if isearch-regexp regexp-search-ring search-ring))
|
||
(length (length ring))
|
||
(yank-pointer-name (if isearch-regexp
|
||
'regexp-search-ring-yank-pointer
|
||
'search-ring-yank-pointer))
|
||
(yank-pointer (eval yank-pointer-name)))
|
||
(if (zerop length)
|
||
()
|
||
(set yank-pointer-name
|
||
(setq yank-pointer
|
||
(mod (+ (or yank-pointer 0)
|
||
(if advance -1 1))
|
||
length)))
|
||
(setq isearch-string (nth yank-pointer ring)
|
||
isearch-message (mapconcat 'isearch-text-char-description
|
||
isearch-string "")))))
|
||
|
||
(defun isearch-ring-adjust (advance)
|
||
;; Helper for isearch-ring-advance and isearch-ring-retreat
|
||
(isearch-ring-adjust1 advance)
|
||
(if search-ring-update
|
||
(progn
|
||
(isearch-search)
|
||
(isearch-update))
|
||
(isearch-edit-string)
|
||
)
|
||
(isearch-push-state))
|
||
|
||
(defun isearch-ring-advance ()
|
||
"Advance to the next search string in the ring."
|
||
;; This could be more general to handle a prefix arg, but who would use it.
|
||
(interactive)
|
||
(isearch-ring-adjust 'advance))
|
||
|
||
(defun isearch-ring-retreat ()
|
||
"Retreat to the previous search string in the ring."
|
||
(interactive)
|
||
(isearch-ring-adjust nil))
|
||
|
||
(defun isearch-ring-advance-edit (n)
|
||
"Insert the next element of the search history into the minibuffer.
|
||
With prefix arg N, insert the Nth element."
|
||
(interactive "p")
|
||
(let* ((yank-pointer-name (if isearch-regexp
|
||
'regexp-search-ring-yank-pointer
|
||
'search-ring-yank-pointer))
|
||
(yank-pointer (eval yank-pointer-name))
|
||
(ring (if isearch-regexp regexp-search-ring search-ring))
|
||
(length (length ring)))
|
||
(if (zerop length)
|
||
()
|
||
(set yank-pointer-name
|
||
(setq yank-pointer
|
||
(mod (- (or yank-pointer 0) n)
|
||
length)))
|
||
|
||
(delete-field)
|
||
(insert (nth yank-pointer ring))
|
||
(goto-char (point-max)))))
|
||
|
||
(defun isearch-ring-retreat-edit (n)
|
||
"Insert the previous element of the search history into the minibuffer.
|
||
With prefix arg N, insert the Nth element."
|
||
(interactive "p")
|
||
(isearch-ring-advance-edit (- n)))
|
||
|
||
;;(defun isearch-ring-adjust-edit (advance)
|
||
;; "Use the next or previous search string in the ring while in minibuffer."
|
||
;; (isearch-ring-adjust1 advance)
|
||
;; (erase-buffer)
|
||
;; (insert isearch-string))
|
||
|
||
;;(defun isearch-ring-advance-edit ()
|
||
;; (interactive)
|
||
;; (isearch-ring-adjust-edit 'advance))
|
||
|
||
;;(defun isearch-ring-retreat-edit ()
|
||
;; "Retreat to the previous search string in the ring while in the minibuffer."
|
||
;; (interactive)
|
||
;; (isearch-ring-adjust-edit nil))
|
||
|
||
|
||
(defun isearch-complete1 ()
|
||
;; Helper for isearch-complete and isearch-complete-edit
|
||
;; Return t if completion OK, nil if no completion exists.
|
||
(let* ((ring (if isearch-regexp regexp-search-ring search-ring))
|
||
(alist (mapcar (function (lambda (string) (list string))) ring))
|
||
(completion-ignore-case case-fold-search)
|
||
(completion (try-completion isearch-string alist)))
|
||
(cond
|
||
((eq completion t)
|
||
;; isearch-string stays the same
|
||
t)
|
||
((or completion ; not nil, must be a string
|
||
(= 0 (length isearch-string))) ; shouldn't have to say this
|
||
(if (equal completion isearch-string) ;; no extension?
|
||
(progn
|
||
(if completion-auto-help
|
||
(with-output-to-temp-buffer "*Isearch completions*"
|
||
(display-completion-list
|
||
(all-completions isearch-string alist))))
|
||
t)
|
||
(and completion
|
||
(setq isearch-string completion))))
|
||
(t
|
||
(message "No completion") ; waits a second if in minibuffer
|
||
nil))))
|
||
|
||
(defun isearch-complete ()
|
||
"Complete the search string from the strings on the search ring.
|
||
The completed string is then editable in the minibuffer.
|
||
If there is no completion possible, say so and continue searching."
|
||
(interactive)
|
||
(if (isearch-complete1)
|
||
(isearch-edit-string)
|
||
;; else
|
||
(sit-for 1)
|
||
(isearch-update)))
|
||
|
||
(defun isearch-complete-edit ()
|
||
"Same as `isearch-complete' except in the minibuffer."
|
||
(interactive)
|
||
(setq isearch-string (buffer-string))
|
||
(if (isearch-complete1)
|
||
(progn
|
||
(delete-field)
|
||
(insert isearch-string))))
|
||
|
||
|
||
;; The search status stack (and isearch window-local variables, not used).
|
||
;; Need a structure for this.
|
||
|
||
(defun isearch-top-state ()
|
||
(let ((cmd (car isearch-cmds)))
|
||
(setq isearch-string (car cmd)
|
||
isearch-message (car (cdr cmd))
|
||
isearch-success (nth 3 cmd)
|
||
isearch-forward (nth 4 cmd)
|
||
isearch-other-end (nth 5 cmd)
|
||
isearch-word (nth 6 cmd)
|
||
isearch-invalid-regexp (nth 7 cmd)
|
||
isearch-wrapped (nth 8 cmd)
|
||
isearch-barrier (nth 9 cmd)
|
||
isearch-within-brackets (nth 10 cmd)
|
||
isearch-case-fold-search (nth 11 cmd))
|
||
(goto-char (car (cdr (cdr cmd))))))
|
||
|
||
(defun isearch-pop-state ()
|
||
(setq isearch-cmds (cdr isearch-cmds))
|
||
(isearch-top-state))
|
||
|
||
(defun isearch-push-state ()
|
||
(setq isearch-cmds
|
||
(cons (list isearch-string isearch-message (point)
|
||
isearch-success isearch-forward isearch-other-end
|
||
isearch-word
|
||
isearch-invalid-regexp isearch-wrapped isearch-barrier
|
||
isearch-within-brackets isearch-case-fold-search)
|
||
isearch-cmds)))
|
||
|
||
|
||
;; Message string
|
||
|
||
(defun isearch-message (&optional c-q-hack ellipsis)
|
||
;; Generate and print the message string.
|
||
(let ((cursor-in-echo-area ellipsis)
|
||
(m (concat
|
||
(isearch-message-prefix c-q-hack ellipsis isearch-nonincremental)
|
||
isearch-message
|
||
(isearch-message-suffix c-q-hack ellipsis)
|
||
)))
|
||
(if c-q-hack
|
||
m
|
||
(let ((message-log-max nil))
|
||
(message "%s" m)))))
|
||
|
||
(defun isearch-message-prefix (&optional c-q-hack ellipsis nonincremental)
|
||
;; If about to search, and previous search regexp was invalid,
|
||
;; check that it still is. If it is valid now,
|
||
;; let the message we display while searching say that it is valid.
|
||
(and isearch-invalid-regexp ellipsis
|
||
(condition-case ()
|
||
(progn (re-search-forward isearch-string (point) t)
|
||
(setq isearch-invalid-regexp nil
|
||
isearch-within-brackets nil))
|
||
(error nil)))
|
||
;; If currently failing, display no ellipsis.
|
||
(or isearch-success (setq ellipsis nil))
|
||
(let ((m (concat (if isearch-success "" "failing ")
|
||
(if (and isearch-wrapped
|
||
(if isearch-forward
|
||
(> (point) isearch-opoint)
|
||
(< (point) isearch-opoint)))
|
||
"over")
|
||
(if isearch-wrapped "wrapped ")
|
||
(if isearch-word "word " "")
|
||
(if isearch-regexp "regexp " "")
|
||
(if nonincremental "search" "I-search")
|
||
(if isearch-forward "" " backward")
|
||
(if current-input-method
|
||
(concat " [" current-input-method-title "]: ")
|
||
": ")
|
||
)))
|
||
(concat (upcase (substring m 0 1)) (substring m 1))))
|
||
|
||
|
||
(defun isearch-message-suffix (&optional c-q-hack ellipsis)
|
||
(concat (if c-q-hack "^Q" "")
|
||
(if isearch-invalid-regexp
|
||
(concat " [" isearch-invalid-regexp "]")
|
||
"")))
|
||
|
||
|
||
;;; Searching
|
||
|
||
(defun isearch-search ()
|
||
;; Do the search with the current search string.
|
||
(isearch-message nil t)
|
||
(if (and (eq isearch-case-fold-search t) search-upper-case)
|
||
(setq isearch-case-fold-search
|
||
(isearch-no-upper-case-p isearch-string isearch-regexp)))
|
||
(condition-case lossage
|
||
(let ((inhibit-point-motion-hooks search-invisible)
|
||
(inhibit-quit nil)
|
||
(case-fold-search isearch-case-fold-search)
|
||
(retry t))
|
||
(if isearch-regexp (setq isearch-invalid-regexp nil))
|
||
(setq isearch-within-brackets nil)
|
||
(while retry
|
||
(setq isearch-success
|
||
(funcall
|
||
(cond (isearch-word
|
||
(if isearch-forward
|
||
'word-search-forward 'word-search-backward))
|
||
(isearch-regexp
|
||
(if isearch-forward
|
||
're-search-forward 're-search-backward))
|
||
(t
|
||
(if isearch-forward 'search-forward 'search-backward)))
|
||
isearch-string nil t))
|
||
;; Clear RETRY unless we matched some invisible text
|
||
;; and we aren't supposed to do that.
|
||
(if (or (eq search-invisible t)
|
||
(not isearch-success)
|
||
(bobp) (eobp)
|
||
(= (match-beginning 0) (match-end 0))
|
||
(not (isearch-range-invisible
|
||
(match-beginning 0) (match-end 0))))
|
||
(setq retry nil)))
|
||
(setq isearch-just-started nil)
|
||
(if isearch-success
|
||
(setq isearch-other-end
|
||
(if isearch-forward (match-beginning 0) (match-end 0)))))
|
||
|
||
(quit (isearch-unread ?\C-g)
|
||
(setq isearch-success nil))
|
||
|
||
(invalid-regexp
|
||
(setq isearch-invalid-regexp (car (cdr lossage)))
|
||
(setq isearch-within-brackets (string-match "\\`Unmatched \\["
|
||
isearch-invalid-regexp))
|
||
(if (string-match
|
||
"\\`Premature \\|\\`Unmatched \\|\\`Invalid "
|
||
isearch-invalid-regexp)
|
||
(setq isearch-invalid-regexp "incomplete input")))
|
||
(error
|
||
;; stack overflow in regexp search.
|
||
(setq isearch-invalid-regexp (format "%s" lossage))))
|
||
|
||
(if isearch-success
|
||
nil
|
||
;; Ding if failed this time after succeeding last time.
|
||
(and (nth 3 (car isearch-cmds))
|
||
(ding))
|
||
(goto-char (nth 2 (car isearch-cmds)))))
|
||
|
||
|
||
;;; Called when opening an overlay, and we are still in isearch.
|
||
(defun isearch-open-overlay-temporary (ov)
|
||
(if (not (null (overlay-get ov 'isearch-open-invisible-temporary)))
|
||
;; Some modes would want to open the overlays temporary during
|
||
;; isearch in their own way, they should set the
|
||
;; `isearch-open-invisible-temporary' to a function doing this.
|
||
(funcall (overlay-get ov 'isearch-open-invisible-temporary) ov nil)
|
||
;; Store the values for the `invisible' and `intangible'
|
||
;; properties, and then set them to nil. This way the text hidden
|
||
;; by this overlay becomes visible.
|
||
|
||
;; Do we really need to set the `intangible' property to t? Can we
|
||
;; have the point inside an overlay with an `intangible' property?
|
||
;; In 19.34 this does not exist so I cannot test it.
|
||
(overlay-put ov 'isearch-invisible (overlay-get ov 'invisible))
|
||
(overlay-put ov 'isearch-intangible (overlay-get ov 'intangible))
|
||
(overlay-put ov 'invisible nil)
|
||
(overlay-put ov 'intangible nil)))
|
||
|
||
|
||
;;; This is called at the end of isearch. It will open the overlays
|
||
;;; that contain the latest match. Obviously in case of a C-g the
|
||
;;; point returns to the original location which surely is not contain
|
||
;;; in any of these overlays, se we are safe in this case too.
|
||
(defun isearch-open-necessary-overlays (ov)
|
||
(let ((inside-overlay (and (> (point) (overlay-start ov))
|
||
(< (point) (overlay-end ov))))
|
||
;; If this exists it means that the overlay was opened using
|
||
;; this function, not by us tweaking the overlay properties.
|
||
(fct-temp (overlay-get ov 'isearch-open-invisible-temporary)))
|
||
(when (or inside-overlay (not fct-temp))
|
||
;; restore the values for the `invisible' and `intangible'
|
||
;; properties
|
||
(overlay-put ov 'invisible (overlay-get ov 'isearch-invisible))
|
||
(overlay-put ov 'intangible (overlay-get ov 'isearch-intangible))
|
||
(overlay-put ov 'isearch-invisible nil)
|
||
(overlay-put ov 'isearch-intangible nil))
|
||
(if inside-overlay
|
||
(funcall (overlay-get ov 'isearch-open-invisible) ov)
|
||
(if fct-temp
|
||
(funcall fct-temp ov t)))))
|
||
|
||
;;; This is called when exiting isearch. It closes the temporary
|
||
;;; opened overlays, except the ones that contain the latest match.
|
||
(defun isearch-clean-overlays ()
|
||
(when isearch-opened-overlays
|
||
(mapc 'isearch-open-necessary-overlays isearch-opened-overlays)
|
||
(setq isearch-opened-overlays nil)))
|
||
|
||
|
||
(defun isearch-intersects-p (start0 end0 start1 end1)
|
||
"Return t if regions START0..END0 and START1..END1 intersect."
|
||
(or (and (>= start0 start1) (< start0 end1))
|
||
(and (> end0 start1) (<= end0 end1))
|
||
(and (>= start1 start0) (< start1 end0))
|
||
(and (> end1 start0) (<= end1 end0))))
|
||
|
||
|
||
;;; Verify if the current match is outside of each element of
|
||
;;; `isearch-opened-overlays', if so close that overlay.
|
||
|
||
(defun isearch-close-unnecessary-overlays (begin end)
|
||
(let ((overlays isearch-opened-overlays))
|
||
(setq isearch-opened-overlays nil)
|
||
(dolist (ov overlays)
|
||
(if (isearch-intersects-p begin end (overlay-start ov) (overlay-end ov))
|
||
(push ov isearch-opened-overlays)
|
||
(let ((fct-temp (overlay-get ov 'isearch-open-invisible-temporary)))
|
||
(if fct-temp
|
||
;; If this exists it means that the overlay was opened
|
||
;; using this function, not by us tweaking the overlay
|
||
;; properties.
|
||
(funcall fct-temp ov t)
|
||
(overlay-put ov 'invisible (overlay-get ov 'isearch-invisible))
|
||
(overlay-put ov 'intangible (overlay-get ov 'isearch-intangible))
|
||
(overlay-put ov 'isearch-invisible nil)
|
||
(overlay-put ov 'isearch-intangible nil)))))))
|
||
|
||
|
||
(defun isearch-range-invisible (beg end)
|
||
"Return t if all the text from BEG to END is invisible."
|
||
(and (/= beg end)
|
||
;; Check that invisibility runs up to END.
|
||
(save-excursion
|
||
(goto-char beg)
|
||
(let (
|
||
;; can-be-opened keeps track if we can open some overlays.
|
||
(can-be-opened (eq search-invisible 'open))
|
||
;; the list of overlays that could be opened
|
||
(crt-overlays nil))
|
||
(when (and can-be-opened isearch-hide-immediately)
|
||
(isearch-close-unnecessary-overlays beg end))
|
||
;; If the following character is currently invisible,
|
||
;; skip all characters with that same `invisible' property value.
|
||
;; Do that over and over.
|
||
(while (and (< (point) end)
|
||
(let ((prop
|
||
(get-char-property (point) 'invisible)))
|
||
(if (eq buffer-invisibility-spec t)
|
||
prop
|
||
(or (memq prop buffer-invisibility-spec)
|
||
(assq prop buffer-invisibility-spec)))))
|
||
(if (get-text-property (point) 'invisible)
|
||
(progn
|
||
(goto-char (next-single-property-change (point) 'invisible
|
||
nil end))
|
||
;; if text is hidden by an `invisible' text property
|
||
;; we cannot open it at all.
|
||
(setq can-be-opened nil))
|
||
(unless (null can-be-opened)
|
||
(let ((overlays (overlays-at (point)))
|
||
ov-list
|
||
o
|
||
invis-prop)
|
||
(while overlays
|
||
(setq o (car overlays)
|
||
invis-prop (overlay-get o 'invisible))
|
||
(if (if (eq buffer-invisibility-spec t)
|
||
invis-prop
|
||
(or (memq invis-prop buffer-invisibility-spec)
|
||
(assq invis-prop buffer-invisibility-spec)))
|
||
(if (overlay-get o 'isearch-open-invisible)
|
||
(setq ov-list (cons o ov-list))
|
||
;; We found one overlay that cannot be
|
||
;; opened, that means the whole chunk
|
||
;; cannot be opened.
|
||
(setq can-be-opened nil)))
|
||
(setq overlays (cdr overlays)))
|
||
(if can-be-opened
|
||
;; It makes sense to append to the open
|
||
;; overlays list only if we know that this is
|
||
;; t.
|
||
(setq crt-overlays (append ov-list crt-overlays)))))
|
||
(goto-char (next-overlay-change (point)))))
|
||
;; See if invisibility reaches up thru END.
|
||
(if (>= (point) end)
|
||
(if (and (not (null can-be-opened)) (consp crt-overlays))
|
||
(progn
|
||
(setq isearch-opened-overlays
|
||
(append isearch-opened-overlays crt-overlays))
|
||
(mapc 'isearch-open-overlay-temporary crt-overlays)
|
||
nil)
|
||
t))))))
|
||
|
||
|
||
;;; Highlighting
|
||
|
||
(defvar isearch-overlay nil)
|
||
|
||
(defun isearch-highlight (beg end)
|
||
(unless (null search-highlight)
|
||
(cond (isearch-overlay
|
||
;; Overlay already exists, just move it.
|
||
(move-overlay isearch-overlay beg end (current-buffer)))
|
||
|
||
(t
|
||
;; Overlay doesn't exist, create it.
|
||
(setq isearch-overlay (make-overlay beg end))
|
||
(overlay-put isearch-overlay 'face isearch)
|
||
(overlay-put isearch-overlay 'priority 1) ;higher than lazy overlays
|
||
))))
|
||
|
||
(defun isearch-dehighlight (totally)
|
||
(when isearch-overlay
|
||
(delete-overlay isearch-overlay)))
|
||
|
||
|
||
;;; General utilities
|
||
|
||
|
||
(defun isearch-no-upper-case-p (string regexp-flag)
|
||
"Return t if there are no upper case chars in STRING.
|
||
If REGEXP-FLAG is non-nil, disregard letters preceded by `\\' (but not `\\\\')
|
||
since they have special meaning in a regexp."
|
||
(let (quote-flag (i 0) (len (length string)) found)
|
||
(while (and (not found) (< i len))
|
||
(let ((char (aref string i)))
|
||
(if (and regexp-flag (eq char ?\\))
|
||
(setq quote-flag (not quote-flag))
|
||
(if (and (not quote-flag) (not (eq char (downcase char))))
|
||
(setq found t))))
|
||
(setq i (1+ i)))
|
||
(not found)))
|
||
|
||
;; Portability functions to support various Emacs versions.
|
||
|
||
(defun isearch-text-char-description (c)
|
||
(cond
|
||
((< c ?\ ) (format "^%c" (+ c 64)))
|
||
((= c ?\^?) "^?")
|
||
(t (char-to-string c))))
|
||
|
||
;; General function to unread characters or events.
|
||
;; Also insert them in a keyboard macro being defined.
|
||
(defun isearch-unread (&rest char-or-events)
|
||
(mapc 'store-kbd-macro-event char-or-events)
|
||
(setq unread-command-events
|
||
(append char-or-events unread-command-events)))
|
||
|
||
|
||
;;; isearch-lazy-highlight feature
|
||
;;; by Bob Glickstein <http://www.zanshin.com/~bobg/>
|
||
|
||
;;; When active, *every* match for the current search string is
|
||
;;; highlighted: the current one using the normal isearch match color
|
||
;;; and all the others using `isearch-lazy-highlight-face'. The extra
|
||
;;; highlighting makes it easier to anticipate where the cursor will
|
||
;;; land each time you press C-s or C-r to repeat a pending search.
|
||
;;; Highlighting of these additional matches happens in a deferred
|
||
;;; fashion using "idle timers," so the cycles needed do not rob
|
||
;;; isearch of its usual snappy response.
|
||
|
||
;;; IMPLEMENTATION NOTE: This depends on some isearch internals.
|
||
;;; Specifically:
|
||
;;; - `isearch-update' is expected to be called (at least) every time
|
||
;;; the search string or window-start changes;
|
||
;;; - `isearch-string' is expected to contain the current search
|
||
;;; string as entered by the user;
|
||
;;; - the type of the current search is expected to be given by
|
||
;;; `isearch-word' and `isearch-regexp';
|
||
;;; - the direction of the current search is expected to be given by
|
||
;;; `isearch-forward';
|
||
;;; - the variable `isearch-invalid-regexp' is expected to be true
|
||
;;; iff `isearch-string' is an invalid regexp.
|
||
|
||
(require 'timer)
|
||
|
||
(defgroup isearch-lazy-highlight nil
|
||
"Lazy highlighting feature for incremental search."
|
||
:prefix "isearch-lazy-highlight-"
|
||
:version "21.1"
|
||
:group 'isearch)
|
||
|
||
(defcustom isearch-lazy-highlight t
|
||
"*Controls the lazy-highlighting during incremental searches.
|
||
When non-nil, all text in the buffer matching the current search
|
||
string is highlighted lazily (see `isearch-lazy-highlight-initial-delay'
|
||
and `isearch-lazy-highlight-interval')."
|
||
:type 'boolean
|
||
:group 'isearch-lazy-highlight)
|
||
|
||
(defcustom isearch-lazy-highlight-cleanup t
|
||
"*Controls whether to remove extra highlighting after a search.
|
||
If this is nil, extra highlighting can be \"manually\" removed with
|
||
\\[isearch-lazy-highlight-cleanup]."
|
||
:type 'boolean
|
||
:group 'isearch-lazy-highlight)
|
||
|
||
(defcustom isearch-lazy-highlight-initial-delay 0.25
|
||
"*Seconds to wait before beginning to lazily highlight all matches."
|
||
:type 'number
|
||
:group 'isearch-lazy-highlight)
|
||
|
||
(defcustom isearch-lazy-highlight-interval 0 ; 0.0625
|
||
"*Seconds between lazily highlighting successive matches."
|
||
:type 'number
|
||
:group 'isearch-lazy-highlight)
|
||
|
||
(defcustom isearch-lazy-highlight-max-at-a-time 20
|
||
"*Maximum matches to highlight at a time (for `isearch-lazy-highlight').
|
||
Larger values may reduce isearch's responsiveness to user input;
|
||
smaller values make matches highlight slowly.
|
||
A value of nil means highlight all matches."
|
||
:type '(choice (const :tag "All" nil)
|
||
(integer :tag "Some"))
|
||
:group 'isearch-lazy-highlight)
|
||
|
||
(defgroup isearch-faces nil
|
||
"Lazy highlighting feature for incremental search."
|
||
:version "21.1"
|
||
:group 'isearch)
|
||
|
||
(defface isearch
|
||
'((((type tty pc) (class color))
|
||
(:background "magenta4" :foreground "cyan1"))
|
||
(((class color) (background light))
|
||
;; The background must not be too dark, for that means
|
||
;; the character is hard to see when the cursor is there.
|
||
(:background "magenta2" :foreground "lightskyblue1"))
|
||
(((class color) (background dark))
|
||
(:background "palevioletred2" :foreground "brown4"))
|
||
(t (:inverse-video t)))
|
||
"Face for highlighting Isearch matches."
|
||
:group 'isearch-faces)
|
||
(defvar isearch 'isearch)
|
||
|
||
(defface isearch-lazy-highlight-face
|
||
'((((type tty pc) (class color))
|
||
(:background "turquoise3"))
|
||
(((class color) (background light))
|
||
(:background "paleturquoise"))
|
||
(((class color) (background dark))
|
||
(:background "paleturquoise4"))
|
||
(t (:underline t)))
|
||
"Face for lazy highlighting of Isearch matches other than the current one."
|
||
:group 'isearch-faces)
|
||
(defvar isearch-lazy-highlight-face 'isearch-lazy-highlight-face)
|
||
|
||
(defvar isearch-lazy-highlight-overlays nil)
|
||
(defvar isearch-lazy-highlight-wrapped nil)
|
||
(defvar isearch-lazy-highlight-start nil)
|
||
(defvar isearch-lazy-highlight-end nil)
|
||
(defvar isearch-lazy-highlight-timer nil)
|
||
(defvar isearch-lazy-highlight-last-string nil)
|
||
(defvar isearch-lazy-highlight-window nil)
|
||
(defvar isearch-lazy-highlight-window-start nil)
|
||
(defvar isearch-lazy-highlight-case-fold-search nil)
|
||
(defvar isearch-lazy-highlight-regexp nil)
|
||
|
||
(defun isearch-lazy-highlight-cleanup (&optional force)
|
||
"Stop lazy highlighting and remove extra highlighting from current buffer.
|
||
FORCE non-nil means do it whether or not `isearch-lazy-highlight-cleanup'
|
||
is nil. This function is called when exiting an incremental search if
|
||
`isearch-lazy-highlight-cleanup' is non-nil."
|
||
(interactive '(t))
|
||
(if (or force isearch-lazy-highlight-cleanup)
|
||
(while isearch-lazy-highlight-overlays
|
||
(delete-overlay (car isearch-lazy-highlight-overlays))
|
||
(setq isearch-lazy-highlight-overlays
|
||
(cdr isearch-lazy-highlight-overlays))))
|
||
(when isearch-lazy-highlight-timer
|
||
(cancel-timer isearch-lazy-highlight-timer)
|
||
(setq isearch-lazy-highlight-timer nil)))
|
||
|
||
(defun isearch-lazy-highlight-new-loop ()
|
||
"Cleanup any previous `isearch-lazy-highlight' loop and begin a new one.
|
||
This happens when `isearch-update' is invoked (which can cause the
|
||
search string to change or the window to scroll)."
|
||
(when (and isearch-lazy-highlight
|
||
(sit-for 0) ;make sure (window-start) is credible
|
||
(or (not (equal isearch-string
|
||
isearch-lazy-highlight-last-string))
|
||
(not (eq (selected-window)
|
||
isearch-lazy-highlight-window))
|
||
(not (eq isearch-lazy-highlight-case-fold-search
|
||
isearch-case-fold-search))
|
||
(not (eq isearch-lazy-highlight-regexp
|
||
isearch-regexp))
|
||
(not (= (window-start)
|
||
isearch-lazy-highlight-window-start))))
|
||
;; something important did indeed change
|
||
(isearch-lazy-highlight-cleanup t) ;kill old loop & remove overlays
|
||
(when (not isearch-invalid-regexp)
|
||
(setq isearch-lazy-highlight-window (selected-window)
|
||
isearch-lazy-highlight-window-start (window-start)
|
||
isearch-lazy-highlight-start (point)
|
||
isearch-lazy-highlight-end (point)
|
||
isearch-lazy-highlight-last-string isearch-string
|
||
isearch-lazy-highlight-case-fold-search isearch-case-fold-search
|
||
isearch-lazy-highlight-regexp isearch-regexp
|
||
isearch-lazy-highlight-wrapped nil)
|
||
(setq isearch-lazy-highlight-timer
|
||
(run-with-idle-timer isearch-lazy-highlight-initial-delay nil
|
||
'isearch-lazy-highlight-update)))))
|
||
|
||
(defun isearch-lazy-highlight-search ()
|
||
"Search ahead for the next or previous match, for lazy highlighting.
|
||
Attempt to do the search exactly the way the pending isearch would."
|
||
(let ((case-fold-search isearch-case-fold-search)
|
||
(choices (cond (isearch-word
|
||
'(word-search-forward . word-search-backward))
|
||
(isearch-regexp
|
||
'(re-search-forward . re-search-backward))
|
||
(t
|
||
'(search-forward . search-backward)))))
|
||
(funcall (if isearch-forward
|
||
(car choices)
|
||
(cdr choices))
|
||
isearch-string
|
||
(if isearch-forward
|
||
(if isearch-lazy-highlight-wrapped
|
||
isearch-lazy-highlight-start
|
||
(window-end))
|
||
(if isearch-lazy-highlight-wrapped
|
||
isearch-lazy-highlight-end
|
||
(window-start)))
|
||
t)))
|
||
|
||
(defun isearch-lazy-highlight-update ()
|
||
"Update highlighting of other matches for current search."
|
||
(let ((max isearch-lazy-highlight-max-at-a-time)
|
||
(looping t)
|
||
nomore)
|
||
(save-excursion
|
||
(save-match-data
|
||
(goto-char (if isearch-forward
|
||
isearch-lazy-highlight-end
|
||
isearch-lazy-highlight-start))
|
||
(while looping
|
||
(let ((found (isearch-lazy-highlight-search)))
|
||
(when max
|
||
(setq max (1- max))
|
||
(if (<= max 0)
|
||
(setq looping nil)))
|
||
(if found
|
||
(let ((mb (match-beginning 0))
|
||
(me (match-end 0)))
|
||
(if (= mb me) ;zero-length match
|
||
(forward-char 1)
|
||
|
||
;; non-zero-length match
|
||
(let ((ov (make-overlay mb me)))
|
||
(overlay-put ov 'face isearch-lazy-highlight-face)
|
||
(overlay-put ov 'priority 0) ;lower than main overlay
|
||
(overlay-put ov 'window (selected-window))
|
||
(push ov isearch-lazy-highlight-overlays)))
|
||
(if isearch-forward
|
||
(setq isearch-lazy-highlight-end (point))
|
||
(setq isearch-lazy-highlight-start (point))))
|
||
|
||
;; not found
|
||
(if isearch-lazy-highlight-wrapped
|
||
(setq looping nil
|
||
nomore t)
|
||
(setq isearch-lazy-highlight-wrapped t)
|
||
(if isearch-forward
|
||
(progn
|
||
(setq isearch-lazy-highlight-end (window-start))
|
||
(goto-char (window-start)))
|
||
(setq isearch-lazy-highlight-start (window-end))
|
||
(goto-char (window-end)))))))
|
||
(unless nomore
|
||
(setq isearch-lazy-highlight-timer
|
||
(run-at-time isearch-lazy-highlight-interval nil
|
||
'isearch-lazy-highlight-update)))))))
|
||
|
||
(defun isearch-resume (search regexp word forward message case-fold)
|
||
"Resume an incremental search.
|
||
SEARCH is the string or regexp searched for.
|
||
REGEXP non-nil means the resumed search was a regexp search.
|
||
WORD non-nil means resume a word search.
|
||
FORWARD non-nil means resume a forward search.
|
||
MESSAGE is the echo-area message recorded for the search resumed.
|
||
CASE-FOLD non-nil means the search was case-insensitive."
|
||
(isearch-mode forward regexp nil nil word)
|
||
(setq isearch-string search
|
||
isearch-message message
|
||
isearch-case-fold-search case-fold)
|
||
(isearch-search))
|
||
|
||
;;; isearch.el ends here
|