Download Git Homepage
;;; icicles-chg.el --- Change logs for Icicles libraries.
;;
;; Filename: icicles-chg.el
;; Description: Change logs for Icicles libraries.
;; Author: Drew Adams
;; Maintainer: Drew Adams (concat "drew.adams" "@" "oracle" ".com")
;; Copyright (C) 2007-2023, Drew Adams, all rights reserved.
;; Created: Tue Nov 27 07:47:53 2007
;; Last-Updated: Mon Oct 28 09:44:07 2024 (-0700)
;; By: dradams
;; Update #: 11947
;; URL: https://www.emacswiki.org/emacs/download/icicles-chg.el
;; Doc URL: https://www.emacswiki.org/emacs/Icicles
;; Keywords: extensions, help, abbrev, local, minibuffer,
;; keys, apropos, completion, matching, regexp, command
;; Compatibility: GNU Emacs: 20.x, 21.x, 22.x, 23.x, 24.x, 25.x, 26.x
;;
;; Features that might be required by this library:
;;
;; None
;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;
;;; Commentary:
;;
;; Change logs for Icicles libraries.
;;
;; This file consolidates the change logs for all Icicles libraries.
;; It contains no code.
;;
;; Libraries `icicles-doc1.el' and `icicles-doc2.el' contain only
;; documentation, and they do not have change logs. Initially,
;; everything was in one library, `icicles.el', so its change log is
;; the oldest.
;;
;; This is a long file. To fontify it, you will likely need to
;; increase `font-lock-maximum-size'. (I use the value 1024000.)
;;
;; ****************************************************************************************************
;; NOTE: If you byte-compile Icicles (recommended), then WHENEVER `icicles-mac.el' is updated, you
;; MUST LOAD `icicles-mac.el' (not just `icicles-mac.elc'), then compile it, then RECOMPILE *ALL*
;; of the other Icicles source files as well. This is normal for Lisp. Code that depends on
;; macros needs to be byte-compiled anew after loading the updated macros.
;; ****************************************************************************************************
;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;
;; This program 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.
;;
;; This program 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 this program; see the file COPYING. If not, write to
;; the Free Software Foundation, Inc., 51 Franklin Street, Fifth
;; Floor, Boston, MA 02110-1301, USA.
;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;(@> "Index")
;;
;; If you have library `linkd.el' and Emacs 22 or later, load
;; `linkd.el' and turn on `linkd-mode' now. It lets you easily
;; navigate around the sections of this doc. Linkd mode will
;; highlight this Index, as well as the cross-references and section
;; headings throughout this file. You can get `linkd.el' here:
;; https://www.emacswiki.org/emacs/download/linkd.el.
;;
;; (@> "CHANGE LOG FOR `icicles-cmd1.el'")
;; (@> "CHANGE LOG FOR `icicles-cmd2.el'")
;; (@> "CHANGE LOG FOR `icicles-face.el'")
;; (@> "CHANGE LOG FOR `icicles-fn.el'")
;; (@> "CHANGE LOG FOR `icicles-mac.el'")
;; (@> "CHANGE LOG FOR `icicles-mcmd.el'")
;; (@> "CHANGE LOG FOR `icicles-mode.el'")
;; (@> "CHANGE LOG FOR `icicles-opt.el'")
;; (@> "CHANGE LOG FOR `icicles-var.el'")
;; (@> "CHANGE LOG FOR `icicles.el'")
;; (@> "CHANGE LOG FOR `icicles-cmd.el'" - Deprecated file)
;;;(@* "CHANGE LOG FOR `icicles-cmd1.el'")
;;
;; 2023/07/27 dadams
;; icicle-repeat-complex-command: Updated per vanilla, for Emacs 25+.
;; icicle-repeat-complex-command--called-interactively-skip is only for Emacs 24.
;; 2022/01/26 dadams
;; icicle-pp-display-expression: Add undo (sync def with that in pp+.el).
;; 2021/04/15 dadams
;; icicle-file-of-content-apropos-complete-match: Typo: file-name -> input, for date transform.
;; icicle-locate-file-of-content:
;; Update doc string for middle part of multi-comp, to be like *-recent*-of-content.
;; 2019/09/21 dadams
;; icicle-bbdb-complete-mail: Updated for BBDB v3.2.
;; Hash-table predicate for all-completions needs to be binary.
;; And the hash table now holds string keys, not symbol keys.
;; 2018/09/21 dadams
;; icicle-bbdb-complete-name, icicle-bookmark-jump-1, icicle-buffer(-no-search)
;; icicle-visit-marked-file-of-content-1:
;; Use icicle--pop-to-buffer-same-window, not switch-to-buffer.
;; 2018/06/29 dadams
;; icicle-pp-eval-expression: Ensure not just (boundp 'lexical-binding) but also Emacs 24+.
;; 2018/06/21 dadams
;; Added: icicle-delete-window-by-name.
;; 2018/03/02 dadams
;; icicle-buffer: Updated doc string for C-x i -|+.
;; 2018/02/13 dadams
;; Removed (Emacs 23-25 only now): icicle-zap-to-char.
;; 2017/12/12 dadams
;; icicle-kill-buffer: Use icicle-buffer behavior: multi-completions, filtering keys, etc.
;; Put icicle-Completions-window-max-height 200.
;; icicle-buffer-multi-complete: Use icicle-buffer-easy-files only if bound.
;; 2017/12/10 dadams
;; icicle-buffer-name-prompt: Added new case: plain minus (-) for modified buffers.
;; icicle-default-buffer-names:
;; Use icicle-bufflist only if consp. Emacs < 23: first name (not buffer) of icicle-bufflist.
;; icicle-buffer-multi-complete: Use icicle-bufflist only if listp.
;; 2017/12/07 dadams
;; icicle-find-file-no-search-1: Bind icicle-pref-arg before prompt.
;; 2017/08/11 dadams
;; icicle-file-of-content-apropos-complete-match: Corrected for dir matching with no content input.
;; 2017/06/25 dadams
;; icicle-kmacro, icicle-kmacro-action: Soft-require kmacro.el.
;; 2017/06/09 dadams
;; icicle-file-of-content-apropos-complete-match:
;; Raise use of icicle-file-skip-functions: do not lose image-file etc. candidate if skipping.
;; Use icicle-file-search-dir-as-dired-flag, in addition to find-file-run-dired (no Dired content
;; search, by default).
;; 2017/01/26 dadams
;; icicle-doremi-increment-variable+: Removed optional arg OPTIONP (prefix-arg only interactive).
;; 2016/11/18 dadams
;; icicle-bookmark-set: Updated for Bookmark+ EWW support.
;; 2016/10/07 dadams
;; icicle-dabbrev-completion, icicle-lisp-complete-symbol:
;; Use icicle-msg-maybe-in-minibuffer, not message.
;; 2016/08/31 dadams
;; icicle-locate-file-of-content-1, icicle-locate-file-no-search-1:
;; Use t, not (confirm-nonexistent-file-or-buffer), for REQUIRE-MATCH arg.
;; 2016/05/21 dadams
;; icicle-pp-display-expression: Soft-require pp+.el and use pp-display-expression if available.
;; icicle-pp-eval-expression: Return (car values). Use icicle-read--expression (forgot).
;; icicle-read--expression: Do not use setq-local or add-function, to support older byte-code.
;; 2015/08/25 dadams
;; icicle-find-file-(no-search|of-content)-in-tags-table-1:
;; Fix for MS Windows: use file-relative-name, to convert \\ to /. Thx to Chris Hecker.
;; 2015/08/04 dadams
;; icicle-bbdb-complete-name:
;; Corrected fix of 2014-01-25: Removed NOT for zerop string-to-number. Thx to Nick Alcock.
;; 2015/06/18 dadams
;; icicle-make-bookmark-candidate: Favor property location over property buffer name for non-file.
;; icicle-bookmark-help-string: Use bookmark-prop-get, not bmkp-get-buffer-name, for buffer name.
;; 2015/06/17 dadams
;; icicle-make-bookmark-candidate, icicle-bookmark-help-string:
;; Updated to handle location field in bookmarks. Thx to Martin Oppegaard.
;; 2015/05/17 dadams
;; icicle-execute-extended-command-1:
;; Do not bind message-log-max to nil. Treat an empty-string current-message like nil.
;; 2015/04/18 dadms
;; Added: icicle-read--expression.
;; icicle-pp-eval-expression: Updated for Emacs 24.4+: use icicle-read--expression.
;; 2015/02/20 dadams
;; icicle-buffer-multi-complete, icicle-describe-opt-of-type-complete:
;; Do not initialize STRG if it is non-nil.
;; 2015/02/19 dadams
;; icicle-buffer-multi-complete: Delete nils introduced by mapcar with buffer-name, from BUFS.
;; 2015/02/08 dadams
;; icicle-bookmark-set: Soft-require Bookmark+ - don't test with featurep.
;; Do not overwrite properties listed in option bmkp-properties-to-keep.
;; 2014/12/15 dadams
;; Added: icicle-bookmark(-local|-remote)-non-dir-file(-other-window).
;; Added (commented out - not used yet): icicle-bookmark-non-dir-file-narrow.
;; 2014/11/22 dadams
;; icicle-buffer-multi-complete: Do not prepend ^ if TAB completion method is not basic.
;; 2014/10/26 dadams
;; For Emacs 25+: defalias icicle-ORIG-elisp-completion-at-point to elisp-completion-at-point.
;; 2014/08/22 dadams
;; icicle-file-of-content-apropos-complete-match: Update icicle-new-bufs-to-kill before searching.
;; icicle-bookmark-jump-1: Better error if input BOOKMARK does not name an existing bookmark.
;; 2014/08/21 dadams
;; Added: icicle-bookmark-annotated-narrow.
;; icicle-bookmark-bind-narrow-commands: Bind icicle-bookmark-annotated-narrow.
;; 2014/08/19 dadams
;; Added: icicle-bookmark-(dired-this-dir|dired-wildcards|navlist)-narrow.
;; icicle-bookmark: Updated doc string for narrowing keys and to mention M-&.
;; icicle-bookmark-bind-narrow-commands:
;; Bind icicle-bookmark-*-narrow, for *:
;; dired-(this-dir|wildcards)|function|icicle-search-hits|lighted|marked|modified|navlist|
;; orphaned(-local|-remote)-file|sequence|snippet|tagged|variable-list
;; icicle-bookmark-*-narrow: Use named predicates now, instead of lambdas.
;; icicle-bookmark-url-narrow: Handle either kind of URL bookmark.
;; icicle-bookmarked-(buffer|file)-list: Added optional arg MSGP.
;; 2014/08/16 dadams
;; icicle-customize-face(-other-window), icicle-face-list, icicle-customize-apropos-faces:
;; Bind icicle-face-completing-p.
;; icicle-customize-apropos: string-match -> icicle-string-match-p.
;; Bug fix: 1st arg to icicle-string-matchp: if, not and.
;; 2014/08/10 dadams
;; Moved to icicles-fn.el (and modified): icicle-binary-option-p.
;; icicle-apropos-variable: Bind icicle-variable-completing-p.
;; icicle-bookmark(-other-window), icicle-bookmark-list: Bind icicle-bookmark-completing-p.
;; icicle-apropos-variable: Bind icicle-variable-completing-p.
;; 2014/08/06 dadams
;; icicle-other-window-or-frame:
;; C-u C-u is select win from any frame. C-u C-u C-u also choosed from all frames.
;; icicle-select-window: Negative prefix arg means use all frames.
;; icicle-choose-window-by-name: Negative prefix arg means use all frames. +/-99: do not select.
;; icicle-make-window-alist: ALL-P can have value visible; other non-nil now means use all frames.
;; 2014/08/04 dadams
;; icicle-buffer-multi-complete: Filter with PRED.
;; 2014/07/28 dadams
;; Added new version of icicle-bbdb-complete-mail. Thx to Alan Schmitt for testing.
;; 2014/07/14 dadams
;; icicle-cd-for-loc-files: Bind enable-recursive-minibuffers.
;; 2014/06/19 dadams
;; icicle-explore: Added note to doc string about binding *-incremental-completion to always.
;; 2014/06/06 dadams
;; Added: icicle-choose-window-for-buffer-display, icicle-choose-window-by-name,
;; icicle-read-choose-window-args.
;; Advised: display-buffer, switch-to-buffer, switch-to-buffer-other-window.
;; icicle-other-window-or-frame: C-u C-u does icicle-choose-window-for-buffer-display (Emacs 24+).
;; icicle-select-window-by-name:
;; Redefine using icicle-read-choose-window-args and icicle-choose-window-by-name.
;; 2014/05/17 dadams
;; icicle-shell-dynamic-complete-as-command, icicle-apropos-zippy, icicle-describe-process:
;; with-output-to-temp-buffer -> icicle-with-help-window.
;; 2014/05/09 dadams
;; icicle-repeat-complex-command*: Use trick only for Emacs 24.4+.
;; 2014/05/04 dadams
;; Added: icicle-repeat-complex-command--called-interactively-skip.
;; icicle-repeat-complex-command: Apply trick used to fix Emacs bug #14136.
;; 2014/04/22 dadams
;; icicle-apropos-*: Updated to use Emacs 24.4 apropos-user-option.
;; 2014/04/20 dadams
;; icicle-describe-option-of-type: Use the function icicle-anychar-regexp, not the variable.
;; icicle-select-frame-by-name: Use frame-name-history if available.
;; Removed some old $$$$$ comments (cleanup).
;; 2014/04/01 dadams
;; icicle-bookmark(-other-window|-list|-set):
;; Faces icicle-annotation & icicle-msg-emphasis, not file-name-shadow & bookmark-menu-heading.
;; 2014/03/09 dadams
;; icicle-file(-other-window): Set this-command so user sees msgs appropriate to the command.
;; 2014/03/08 dadams
;; Use (featurep 'icomplete), not (boundp 'icomplete-mode), everywhere.
;; icicle-execute-extended-command-1: Move run of pre-command-hook after binding of this-command.
;; icicle-apropos-value, icicle-describe-option-of-type, *-find-file*-in-tags-table*:
;; Put properties icicle-turn-off-(icomplete-mode|incremental-completion).
;; icicle-(recent-file|find-file-abs)*: Put property icicle-hide-common-match.
;; icicle-locate*: Put properties icicle-turn-off* and icicle-hide-common-match.
;; icicle-find-file*(-in-tags-table*): Put property icicle-Completions-window-max-height.
;; 2014/02/22 dadams
;; icicle-lisp-complete-symbol: Fixed regression introduced by 2014-01-15 change:
;; Max, not min, of point and BEG. If END is nil, use BEG for PATTERN. Go to BEG before insert.
;; 2014/02/08 dadams
;; icicle-find-file-(no-search|of-content)-action-1:
;; Pass icicle-find-file-(no-search|of-content)-1 as arg, not icicle-find-file-action-fn.
;; icicle-find-file-or-expand-dir: Use funcall, not call-interactively (not really a command).
;; Use file-directory-p, not icicle-looks-like-dir-name-p.
;; Use file-name-as-directory to get new default-directory.
;; 2014/01/25 dadams
;; icicle-bbdb-complete-name: Do not define if bbdb-version is not a number.
;; 2014/01/18 dadams
;; icicle-customize-face(-other-window): Handle proxy candidates in action function. Updated doc.
;; 2014/01/15 dadams
;; icicle-lisp-complete-symbol:
;; Prevent read-only error message for empty input in minibuffer. Update a bit wrt vanilla.
;; Wrap END calculation in unwind-protect also.
;; 2014/01/08 dadams
;; icicle-command-abbrev-action: Set CMD to the invoked command, using command-history.
;; 2014/01/06 dadams
;; icicle-apropos-value, icicle-command-abbrev: Bind icicle--last-toggle-transforming-msg.
;; 2014/01/04 dadams
;; icicle-locate-file-*-1: Typo: Mistakenly used recentf-list instead of default-directory.
;; icicle-recent-file-*-1: Ensure recentf-list is boundp.
;; 2014/01/02 dadams
;; icicle-execute-extended-command(-1):
;; Restore SPC correctly. If CMD turns off Icicle mode then not icicle-self-insert.
;; 2013/12/09 dadams
;; Added:
;; icicle-find-file-of-content-in-tags-table, icicle-find-file-no-search-in-tags-table,
;; icicle-find-file-of-content-in-tags-table-other-window,
;; icicle-find-file-no-search-in-tags-table-other-window,
;; icicle-find-file-of-content-in-tags-table-1, icicle-find-file-no-search-in-tags-table-1
;; icicle-find-file-in-tags-table(-other-window): use defalias now - either of-content|no-search.
;; Applied renamings: icicle-buffer-skip-hook to icicle-buffer-skip-functions,
;; icicle-find-file-of-content-skip-hook to icicle-file-skip-functions.
;; 2013/12/08 dadams
;; Added:
;; icicle-find-file-abs-action-fn, icicle-find-file-action-fn, icicle-new-bufs-to-keep,
;; icicle-new-bufs-to-kill, icicle-existing-bufs,
;; icicle-find-file-no-search-1 (from w/o *-1) using action fn (and same cleanup for undo),
;; icicle-find-file-of-content-1 (from w/o *-1) using action fn,
;; icicle-find-file-abs-no-search-1 (from w/o *-1) using action fn,
;; icicle-find-file-abs-of-content-1 (from w/o *-1) using action fn,
;; icicle-recent-file-no-search-1 (from w/o *-1) using action fn
;; (& icicle-pref-arg, not curr, & same cleanup for undo),
;; icicle-recent-file-of-content-1 (from w/o *-1) using action fn,
;; icicle-locate-file-no-search-1 (from icicle-locate-file-1) using action fn (& same cleanup),
;; icicle-locate-file-of-content-1,
;; icicle-find-file-abs-read-only, icicle-find-file-abs-read-only-other-window,
;; icicle-locate-file-no-search, icicle-locate-file-no-search-other-window,
;; icicle-locate-file-no-search-no-symlinks,
;; icicle-locate-file-no-search-no-symlinks-other-window,
;; icicle-locate-file-of-content, icicle-locate-file-of-content-other-window,
;; icicle-locate-file-of-content-no-symlinks,
;; icicle-locate-file-of-content-no-symlinks-other-window,
;; icicle-locate-no-search, icicle-locate-no-search-other-window,
;; icicle-locate-of-content, icicle-locate-of-content-other-window,
;; icicle-find-file-abs-no-search-action-1, icicle-find-file-abs-of-content-action-1,
;; icicle-find-file-no-search-action-1, icicle-find-file-of-content-action-1,
;; icicle-find-file-no-search-action, icicle-find-file-no-search-other-window-action,
;; icicle-find-file-of-content-action, icicle-find-file-of-content-other-window-action,
;; icicle-find-file-of-content-ro-action, icicle-find-file-of-content-ro-ow-action,
;; icicle-find-file-abs-no-search-action, icicle-find-file-abs-no-search-other-window-action,
;; icicle-find-file-abs-no-search-ro-action, icicle-find-file-abs-no-search-ro-ow-action,
;; icicle-find-file-abs-of-content-action, icicle-find-file-abs-of-content-other-window-action,
;; icicle-find-file-abs-of-content-ro-action, icicle-find-file-abs-of-content-ro-ow-action.
;; icicle-(find-file(-abs)|recent-file|read-only)-(of-content|no-search)(-other-window):
;; Redefined as a defun, using *-1 and *-action-fn.
;; icicle-locate(-file)(-no-symlinks)(-other-window): defalias now - either of-content|no-search.
;; Removed: icicle-locate-file-action-fn, icicle-locate-file(-other-window)-action,
;; icicle-find-file-abs-1, icicle-locate-file-1.
;; icicle-find-file(-abs)-read-only(-other-window): Define for *-abs-* and *-of-content-* also.
;; icicle-buffer-multi-complete: Use new icicle-* vars, so do not bother to test with boundp.
;; 2013/12/03 dadams
;; Added: icicle-find-file-abs-1.
;; icicle-find-file-abs-of-content(-other-window), icicle-recent-file-of-content(-other-window):
;; Use icicle-find-file-abs-1.
;; icicle-completing-yank: Typo - paren too early.
;; 2013/12/01 dadams
;; Added: icicle-recent-file-of-content, icicle-recent-file-of-content-other-window.
;; Renamed: *-recent-file(-other-window) to icicle-recent-file-no-search(-other-window).
;; Redefine icicle-recent-file(-other-window) as *-of-content* or *-no-search*, per Emacs version.
;; icicle-execute-extended-command-1: Restore SPC to self inserting, for recursive minibuffers.
;; icicle-find-file-abs-of-content: Pass nil as OTHER-WINDOW-P arg to *-find-file-or-expand-dir
;; icicle-find-file(-abs)-of-content*:
;; 1. Do the cleanup also for undo code, not just last code.
;; 2. Just kill-buffer, instead of visiting and doing restore-buffer-modified-p first.
;; 2013/11/29 dadams
;; icicle-find-file(-abs)(-no-search|of-content)*, icicle-find-file-in-tags-table*:
;; icicle-all-candidates-list-alt-action-fn needs to icicle-transform-multi-completion each file.
;; 2013/11/26 dadams
;; icicle-execute-extended-command: Temporarily bind SPC to minibuffer-complete-word.
;; 2013/11/23 dadams
;; Added: icicle-find-file-abs-of-content, icicle-find-file-abs-of-content-other-window.
;; Renamed: *-find-file-absolute(-other-window) to icicle-find-file-abs-no-search(-other-window).
;; Redefine icicle-find-file-absolute(-other-window) as *-no-search* or *-of-content*.
;; icicle-find-file-of-content(-other-window):
;; Just set FILE (no FIL2 binding).
;; First code: Reset current-prefix-arg to nil, so can use it anew in action function.
;; Added msg: Gathering files...
;; icicle-file-of-content-apropos-complete-match:
;; Handle date for absolute file names (icicle-find-file-abs-of-content).
;; icicle-make-file+date-candidate: Removed final space after %T.
;; 2013/11/19 dadams
;; icicle-yank-pop-commands, icicle-completing-yank: Bind enable-recursive-minibuffers to t.
;; 2013/11/03 dadams
;; Added: icicle-visit-marked-file-of-content-recursive(-other-window),
;; icicle-visit-marked-file-of-content-1, icicle-vmfoc-other-win-p, icicle-vmfoc-recursive-p
;; icicle-visit-marked-file-of-content(-other-window): Use icicle-visit-marked-file-of-content-1.
;; icicle-locate-file-no-symlinks: Fixed typo: action function is not *-other-window.
;; 2013/10/31 dadams
;; icicle-visit-marked-file-of-content*: Use diredp-get-files, so handle recursively marked files.
;; 2013/10/29 dadams
;; icicle-bookmark-cmd: Use bmkp-bookmark-set-confirm-overwrite, not bookmark-set, if defined.
;; icicle-bookmark-set: Added code from Bookmark+ bookmark-set, for confirmation query if exists.
;; 2013/10/27 dadams
;; Added: icicle-custom-theme (Emacs 24+).
;; 2013/09/02 dadams
;; Added: icicle-dabbrev--last-completion-buffer, icicle-dabbrev--last-obarray.
;; icicle-dabbrev-completion: Use those Icicles vars - dabbrev.el versions removed in Emacs 24.
;; 2013/08/19 dadams
;; icicle-kill-buffer: Bind icicle-use-candidates-only-once-flag to t.
;; icicle-kill-a-buffer-and-update-completions: Do not update minibuffer-completion-table.
;; 2013/08/05 dadams
;; icicle-find-file-or-expand-dir: Reverted last change. Expand only for RET, not C-RET.
;; 2013/08/04 dadams
;; icicle-find-file-or-expand-dir: bind enable-recursive-minibuffers to t (for C-RET etc.).
;; 2013/08/03 dadams
;; icicle-kmacro-action: Fixed numeric prefix arg for count.
;; Applied renamings: icicle-*-first-p.
;; 2013/08/02 dadams
;; Added: icicle-find-file-or-expand-dir.
;; icicle-find-file(of-content|-no-search)(-other-window), : Use icicle-find-file-or-expand-dir.
;; 2013/08/01 dadams
;; icicle-comint-dynamic-complete-as-filename: Bind enable-recursive-minibuffers to t.
;; 2013/07/29 dadams
;; icicle-comint-dynamic-simple-complete: Bind enable-recursive-minibuffers to t.
;; 2013/07/23 dadams
;; icicle-buffer-multi-complete, icicle-describe-opt-of-type-complete:
;; Use regexp-quote before concat ^ to front of string.
;; 2013/07/04 dadams
;; Use icicle-read-regexp, not read-string, for reading all regexps.
;; 2013/07/02 dadams
;; Added: icicle-bookmark-help (factored out), icicle-bookmark-act-on-prop.
;; icicle-bookmark(-list|(-jump)(-other-window)):
;; Bind icicle-candidate-alt-action-fn to icicle-bookmark-act-on-prop.
;; icicle-bookmark(-set|list|-other-window|jump(-other-window)):
;; Bind icicle-candidate-help-fn to icicle-bookmark-help.
;; 2013/06/23 dadams
;; icicle-find-file-of-content(-other-window): Ensure handle mode, vars, hooks, & handlers OK.
;; In action fn: UN-visit any buffers that were created for content searching.
;; 2013/04/24 dadams
;; icicle-dired-saved-file-candidates:
;; Removed error if no saved file names. Forgot to remove, when added icicle-file-list choosing.
;; icicle-dired-saved-file-candidates(-other-window): Error if no files after icicle-file-list.
;; 2013/04/17 dadams
;; icicle-buffer-name-prompt, icicle-default-buffer-names: C-u C-u C-u means invisible buffers.
;; icicle-kill-buffer: Add current buff to icicle-default-buffer-names.
;; icicle-visit-marked-file-of-content*: Pass no arg to icicle-default-buffer-names.
;; icicle-add-buffer-candidate: Single default if < Emacs 23.
;; 2013/04/06 dadams
;; icicle-default-buffer-names: If ARG is nil, put other-buffer first. Return up to six, not four.
;; 2013/04/02 dadams
;; Removed: icicle-ess-* (four Icicles completion functions for ESS).
;; 2013/03/31 dadams
;; icicle-buffer-name-prompt: (new) C-u C-u means visible buffer.
;; icicle-buffer: Update doc string for visible buffers as candidates.
;; 2013/03/27 dadams
;; Do not require dabbrev for Emacs 24+ (until I get around to fixing icicle-dabbrev-completion).
;; Temporarily removed icicle-dabbrev-completion for Emacs 24+.
;; 2013/03/16 dadams
;; custom-variable-p: Return nil if arg is not a symbol.
;; icicle-buffer-multi-complete, icicle-(buffer|file-of-content)-apropos-complete-match:
;; Test this-command, not last-command, and test it also for icicle-cycling-command.
;; icicle-binary-option-p, icicle-buffer-multi-complete: Use icicle-get-safe, not get.
;; 2013/03/12 dadams
;; Added: icicle-buffer-cand-help (factored out).
;; icicle-buffer(other-window), icicle-visit-marked-file-of-content(-other-window):
;; Use icicle-buffer-cand-help.
;; icicle-visit-marked-file-of-content:
;; Bind icicle-last-apropos-complete-match-fn to icicle-buffer-apropos-complete-match.
;; Bind icicle-apropos-complete-match-fn in second part of icicle-buffer-bindings, not first.
;; icicle-send-bug-report: Ask for Update # from icicles-chg.el.
;; 2013/03/11 dadams
;; icicle(-customize)-apropos-options-of-type:
;; Bound *-last-apropos-complete-match-fn to *-multi-comp-apropos-complete-match for progressive.
;; 2013/03/08 dadams
;; (icicle-(visit-marked-file-of-content|buffer(-no-search)))-other-window:
;; Forgot OTHER-WIN arg to icicle-buffer-name-prompt.
;; 2013/03/07 dadams
;; Updated to use icicle-user-error where appropriate.
;; 2013/03/05 dadams
;; icicle-search-read-context-regexp: Provide default(s) using icicle-defaults-at-point (new).
;; 2013/02/25 dadams
;; icicle-buffer-multi-complete, icicle-buffer-apropos-complete-match, icicle-find-file-of-content:
;; isearch-update-ring if find content-pat match.
;; 2013/02/24 dadams
;; icicle-find-file-of-content(-other-window):
;; Use normal-mode, not revert-buffer. No need to restore r-o status. Thx to Michael Heerdegen.
;; 2013/02/16 dadams
;; Renamed: icicle-find-file(-other-window) to icicle-find-file-no-search(-other-window).
;; Added defaliases for (new) icicle-find-file(-other-window), depending on Emacs version.
;; icicle-file(-other-window): Corrected current-prefix-arg binding.
;; icicle-find-file-absolute(-other-window): Prefix arg on candidate means open it read-only.
;; *-find-file-(absolute|no-search)(-other-window): Include *-mouse-candidate-action in memq test.
;; icicle-find-file-read-only*: Use icicle-find-file-no-search*, not icicle-find-file*.
;; icicle-find-file-of-content(-other-window): Restore correct read-only status after reverting.
;; *-dired-(saved-file-candidates|project)-other-window, *-find-file-no-search(-other-window)
;; *-find-file-read-only-other-window, *-((recent|locate)-file(-no-symlinks)|locate)-other-window:
;; Put property icicle-Completions-window-max-height (forgot).
;; 2013/02/15 dadams
;; icicle-pp-eval-expression: Bind deactivate-mark to nil, like fix for Emacs bug #13724.
;; 2013/02/04 dadams
;; Removed all autoload cookies.
;; 2013/01/06 dadams
;; icicle-execute-extended-command-1:
;; Extra safeguards: Ensure CMD is fboundp before calling symbol-function.
;; Ensure it is commandp before calling it interactively. Error if not.
;; 2013/01/05 dadams
;; icicle-bookmark-*-narrow: No-op unless (featurep 'bookmark+).
;; icicle-(delete-file|dired|find-file(-absolute|-of-content|-in-tags-table)|recent-file|
;; locate(-file)|(file|directory)-list):
;; Updated doc string for new C-x C-t bindings.
;; 2013/01/04 dadams
;; icicle-bookmark-(autofile|autonamed)-narrow:
;; Use icicle-transform-multi-completion, not icicle-mctized-display-candidate, like others.
;; 2013/01/02 dadams
;; icicle-other-window-or-frame: Use 1on1-other-frame.
;; 2012/12/21 dadams
;; icicle-buffer-multi-complete, icicle-file-of-content-apropos-complete-match:
;; Added filtering by icicle-(buffer|find-file-of-content)-skip-hook. Thx to C. Schmidt.
;; 2012/12/20 dadams
;; Removed: icicle-find-file-of-content-multi-complete. Use only *-apropos-complete-match.
;; icicle-file-of-content-apropos-complete-match:
;; Do not use find-file-noselect, except for a dir.
;; Use find-buffer-visiting or create-file-buffer, and with-current-buffer, insert-file-contents.
;; Add buffer to new-bufs--to-kill.
;; icicle-find-file-of-content(-other-window):
;; Do not bind icicle-read-file-name-internal-fn to icicle-find-file-of-content-multi-complete.
;; revert-buffer, so use correct mode.
;; 2012/12/15 dadams
;; icicle-find-file-of-content*:
;; Bind icicle-apropos-complete-match-fn to icicle-file-of-content-apropos-complete-match, to fix
;; apropos completion
;; Bind icicle-compute-narrowing-regexp-p to t, for narrowing optimization.
;; Set buffer-modified-p to nil before calling kill-buffer.
;; icicle-file-of-content-apropos-complete-match:
;; Require that each file name is matched by icicle-narrow-regexp (optimization for narrowing).
;; 2012/12/14 dadams
;; icicle-describe-option-of-type:
;; Bind icicle-last-apropos-complete-match-fn to icicle-multi-comp-apropos-complete-match,
;; for progressive completion. Bind icicle-dot-string to icicle-anychar-regexp.
;; Updated doc to reflect improved behavior.
;; 2012/12/12 dadams
;; Added: icicle-buffer-apropos-complete-match, icicle-file-of-content-apropos-complete-match.
;; icicle-buffer(-other-window):
;; Bind icicle-last-apropos-complete-match-fn to icicle-buffer-apropos-complete-match.
;; Move binding of icicle-apropos-complete-match-fn to post-bindings.
;; icicle-find-file-of-content(-other-window):
;; Bind icicle-last-apropos-complete-match-fn to icicle-file-of-content-apropos-complete-match.
;; Reverted the 12/07 change. Binding *-apropos-complete-match-fn to nil broke apropos compl.
;; icicle-find-file-of-content-multi-complete:
;; Rewrote. Do not use all-completions. Use completion-table-in-turn for everything, passing
;; content-matching predicate.
;; icicle-execute-extended-command-1, icicle-command-abbrev-action:
;; Bind completion-annotate-function to nil, to cancel top-level binding.
;; 2012/12/07 dadams
;; icicle-find-file-of-content(-other-window):
;; Restored binding of icicle-apropos-complete-match-fn to nil.
;; 2012/12/02 dadams
;; Removed: icicle-find-file-of-content-read-file-name (use icicle-read-file-name-default instead).
;; icicle-find-file-of-content(-other-window):
;; Bind icicle-read-file-name-internal-fn, not read-file-name-function.
;; No longer bind icicle-apropos-complete-match-fn to nil.
;; 2012/12/01 dadams
;; icicle-find-file-of-content-multi-complete:
;; Use icicle-completion--embedded-envvar-table & completion-file-name-table, not internal Emacs.
;; 2012/11/29 dadams
;; icicle-find-file-of-content: Typo: removed -other-window.
;; 2012/11/28 dadams
;; icicle-apropos-value: Minor corrections. And treat C-u case like C-0 for C-$.
;; icicle-completing-yank:
;; Do not icicle-delete-dups when constructing cands. Let icicle-transform-function do it.
;; 2012/11/26 dadams
;; Added: icicle-apropos-value. Thx to Michael Heerdegen.
;; icicle-execute-extended-command(-1): Save and restore icicle-toggle-transforming-message.
;; 2012/11/19 dadams
;; icicle-execute-extended-command-1: Show key-reminder after invoking CMD. Thx to M. Heerdegen.
;; icicle-customize-apropos: lexical-let -> let. Put PATTERN in progress msg. Add comma for TYPE.
;; icicle-find-tag-define-candidates-1: Put regexp in progress msg.
;; 2012/11/17 dadams
;; icicle-execute-extended-command-1: Show key-reminder msg before sit-for. Thx to M. Heerdegen.
;; 2012/11/10 dadams
;; custom-variable-p, icicle-binary-option-p: icicle-get-safe -> get.
;; icicle-increment-(option|variable): intern -> intern-soft. Thx to Michael Heerdegen.
;; 2012/11/08 dadams
;; custom-variable-p, icicle-execute-extended-command-1, icicle-binary-option-p:
;; Use icicle-get-safe.
;; Doc strings: Use \\[...] more.
;; 2012/11/07 dadams
;; icicle-zap-to-char: char-to-string -> string.
;; 2012/11/03 dadams
;; Typo in eval-when-compile around icicle-bbdb-complete-name.
;; 2012/11/02 dadams
;; icicle-buffer-multi-complete: Use prog1 around content search in *-remove-if-not.
;; Wrap icicle-bbdb-complete-name in eval-when-compile to avoid byte-compile error for BBDB 3.02.
;; icicle-(buffer|file-of-content)-multi-complete: Put back prepending ^ for prefix mode.
;; 2012/11/01 dadams
;; icicle-(buffer|file-of-content)-multi-complete: Handle metadata COMPLETION-MODE arg.
;; Comment out prepending ^ for prefix mode.
;; 2012/10/28 dadams
;; icicle-execute-extended-command, icicle-command-abbrev: With icicle-pre-minibuffer-buffer.
;; 2012/10/27 dadams
;; Added: icicle-bbdb-complete-mail (version for BBDB 3.02).
;; icicle-execute-extended-command, icicle-command-abbrev:
;; Bind icicle-last-transform-function: show only bound cmds. Thx to Michael Heerdegen.
;; Bind completion-annotate-function: annotate with key bindings.
;; 2012/10/21 dadams
;; Added: icicle-cached-files-without-buffers, icicle-recent-files-without-buffers.
;; icicle-buffer-multi-complete, icicle-buffer(-other-window):
;; Add file names from recentf-list and file-cache-alist as candidates.
;; 2012/10/20 dadams
;; icicle-cd-for-(abs|loc)-files:
;; Same change as 2012/08/27 fix to *-make-directory: Use dir in minibuffer as default.
;; 2012/10/18 dadams
;; icicle-directory-list: New feature: proxy candidates = vars with dir-list (i.e., path) values.
;; icicle-locate-file-1:
;; New feature: Treat plain C-u and C-u C-u, prompting for dir list.
;; Ensure correct prefix arg treatment for icicle-locate (vs *-locate-file*).
;; icicle-string-list: Last code: reset icicle-proxy-candidates to ().
;; 2012/10/09 dadams
;; icicle-customize-face*, icicle(-customize)-apropos-options-of-type,
;; icicle-describe-option-of-type, icicle-dired-saved-file-candidates*, icicle-bookmark*,
;; icicle-buffer*, icicle-visit-marked-file-of-content*, icicle-send-signal-to-process,
;; icicle-find-file-absolute*, icicle-find-file-of-content*, icicle-recent-file*,
;; icicle-locate-file-1, icicle-find-file-in-tags-table*, icicle-face-list, icicle-bookmark-list:
;; Bind icicle-multi-completing-p.
;; icicle-cd-for-(abs|loc)-files: Test icicle-multi-completing-p, not icicle-list-use-nth-parts.
;; 2012/10/05 dadams
;; Added: icicle-find-file-of-content(-other-window|-multi-complete|-read-file-name).
;; icicle-buffer-multi-complete: Add new bufs to NEW-BUFS--TO-KILL, so can kill them when done.
;; icicle-visit-marked-file-of-content(-other-window):
;; Action arg: Transform multi-completion before passing to switch-to-buffer*.
;; Save visited buffer to NEW-BUFS--TO-KEEP.
;; When done, kill any unused buffers that were created, per new option
;; icicle-kill-visited-buffers-flag. But prefix arg flips that.
;; 2012/10/04 dadams
;; icicle-find-file(-other-window): If precede C-! with prefix arg, then open all read-only.
;; 2012/10/02 dadams
;; icicle-describe-opt-of-type-complete, icicle-buffer-multi-complete:
;; In try-completion: change PRED to a predicate that works on a singleton list, not a string.
;; 2012/09/24 dadams
;; icicle-recent-file(-other-window): Bind icicle-transform-before-sort-p to t,
;; icicle-sort-comparer to icicle-last-accessed-first-p.
;; 2012/09/22 dadams
;; icicle-bookmark-jump-1:
;; Use full bookmark, not name, after jump and before crosshairs, in case renamed autonamed bmk.
;; 2012/09/15 dadams
;; icicle-visit-marked-file-of-content*: *-remove-if -> use filter as dired-get-marked-files arg.
;; 2012/09/11 dadams
;; Renamed:
;; *-buffer(-other-window) to *-buffer-no-search(-other-window)
;; *-buffer-of-content(-other-window|complete) to *-buffer(-other-window|multi-complete)
;; icicle-buffer(-other-window): Simplified prompt (no multi-completion hint).
;; Updated doc strings for this icicle-buffer switch.
;; icicle-default-buffer-names: Respect icicle-buffer-ignore-space-prefix-flag. Optimize a bit.
;; 2012/09/09 dadams
;; Added: icicle-visit-marked-file-of-content(-other-window).
;; icicle-default-buffer-names: If BNAME is not in icicle-bufflist then do not use it.
;; 2012/09/08 dadams
;; Added: icicle-buffer-of-content(-other-window), icicle-buffer-of-content-complete.
;; icicle-buffer-list: Remove binding of icicle-ignore-space-prefix-flag.
;; 2012/09/07 dadams
;; icicle-buffer(-other-window): Exclude icicle-orig-buff from candidates.
;; 2012/08/13 dadams
;; icicle-customize-face: Doc string improvement.
;; 2012/08/10 dadams
;; icicle-bookmark-set: If bookmark-make-record provides a name, use that as default.
;; 2012/08/06 dadams
;; Renamed old-* to icicle-ORIG-*:
;; icicle-ORIG-file, icicle-ORIG-customize-face, icicle-ORIG-customize-face-other-window,
;; icicle-ORIG-dabbrev-completion, icicle-ORIG-lisp-complete-symbol,
;; icicle-ORIG-lisp-completion-at-point, icicle-ORIG-repeat-complex-command.
;; 2012/07/31 dadams
;; Added widgets icicle-file, old-file. Added command icicle-widget-file-complete.
;; icicle-comint-dynamic-complete(-as)-filename, icicle-comint-replace-by-expanded-filename:
;; Added optional (prefix) arg REPLACE-TO-EOL-P.
;; 2012/07/22 dadams
;; icicle-pp-display-expression: Do not try to select old-window if it is no longer live.
;; 2012/07/21 dadams
;; Replace defun of *-comint-completion-at-point by defalias to *-comint-dynamic-complete.
;; icicle-comint-replace-orig-completion-fns: Redefined for new format of
;; icicle-comint-dynamic-complete-replacements. Thx to Christopher Schmidt.
;; icicle-execute-extended-command-1: Pass non-nil NOINDIRECT arg to where-is-internal.
;; 2012/07/19 dadams
;; icicle-default-buffer-names: Added optional ARG. Use in all calls to it.
;; icicle-buffer-list: Allow also Dired buffers for positive prefix arg.
;; icicle-(kill|insert)-buffer, icicle-add-buffer-candidate:
;; Removed doc string content - just refer to icicle-buffer doc.
;; 2012/07/10 dadams
;; icicle-comint-dynamic-complete-as-filename:
;; (file-name-nondir* (directory-file-name...)) -> (directory-file-name (file-relative-name...))
;; Thx to Christopher Schmidt.
;; 2012/07/08 dadams
;; Added icicle-comint-completion-at-point. Thx to Christopher Schmidt and Michael Heerdegen.
;; 2012/06/29 dadams
;; icicle-command-abbrev:
;; Bind icicle-sort-comparer to icicle-proxy-candidate-first-p, not
;; icicle-command-abbrev-used-more-p. icicle-command-abbrev-used-more-p is second sort order.
;; Bind icicle-allowed-sort-predicate (new), to allow icicle-command-abbrev-used-more-p.
;; Improved doc string, mentioning icicle-command-abbrev-alist.
;; icicle-command-abbrev-action:
;; Add abbrev-or-cmd to icicle-commands-for-abbrev if it is in icicle-command-abbrev-alist.
;; Do not bind icicle-sort-comparer here - not needed (?).
;; During completion, bind icicle-current-input to abbrev-or-cmd.
;; Removed #' from lambdas.
;; 2012/06/24 dadams
;; icicle-shell-dynamic-complete-as-command:
;; Use shell-command-to-string in *Help* explicitly, not just shell-command.
;; Thx to Christopher Schmidt & Michael Heerdegen.
;; 2012/06/09 dadams
;; icicle-pp-display-expression: Use backquote+comma, not lexical-let (bug fix).
;; 2012/06/04 dadams
;; Comment or otherwise handle free vars in lambdas: some lexical-let, some backquoting.
;; 2012/06/03 dadams
;; icicle-execute-extended-command-1:
;; Do not show "You can invoke..." message for multi-command use. Do it only for top-level M-x.
;; Use backquote+comma to eliminate free var CMD.
;; 2012/05/30 dadams
;; icicle-dired-insert-as-subdir: Include default-directory as candidate for ANCESTOR-DIR.
;; 2012/05/25 dadams
;; Added: icicle-dired-insert-as-subdir.
;; 2012/05/22 dadams
;; icicle-comint-dynamic-complete-as-filename, icicle-dired-(project|saved-file-candidates(*)),
;; icicle-grep-saved-file-candidates:
;; Test with icicle-file-remote-p before file-exists-p, to avoid Tramp.
;; 2012/05/13 dadams
;; Added: icicle-dired-save-marked(-more|to-cache-file|to-fileset|to-variable)-recursive,
;; 2012/04/22 dadams
;; Added: icicle-buffer-name-prompt.
;; Removed: icicle-filter-buffer-cands-for-mode (replaced by *-(remove|keep-only)* in *-mcmd.el).
;; icicle-(kill|insert)-buffer, icicle-buffer(-other-window), icicle-add-buffer-candidate:
;; Use icicle-buffer-name-prompt, icicle-(un)bind-buffer-candidate-keys. Updated doc string.
;; icicle-add-buffer-candidate:
;; Bind icicle-delete-candidate-object to icicle-remove-buffer-candidate-action (as previously).
;; 2012/04/09 dadams
;; Fixed typos: double single-quotes in autoload cookies.
;; 2012/04/08 dadams
;; Make autoload cookies for commands load icicles[.el] explicitly.
;; 2012/04/07 dadams
;; icicle-bookmark-set:
;; Updated for Bookmark+ changes, including new defaulting, removing region handling, and making
;; bmk temporary.
;; Updated doc string with info from icicle-bookmark-cmd. Refer to bookmark-set doc.
;; icicle-bookmark-cmd:
;; Updated doc string. Refer to icicle-bookmark-set doc.
;; 2012/04/04 dadams
;; Moved hint about (S-)TAB from icicle-read-args-w-val-satisfying to callers that need it.
;; 2012/04/03 dadams
;; Added: icicle-apropos-vars-w-val-satisfying, icicle-describe-var-w-val-satisfying,
;; icicle-customize-opts-w-val-satisfying, icicle-read-args-w-val-satisfying.
;; icicle-send-signal-to-process:
;; Moved it and icicle-describe-process here from *-cmd2.el. Added autoload cookie.
;; Changed definition guard condition to locate-library. Updated def, including to
;; require proced.el.
;; icicle-kmacro:
;; Changed autoload cookie to be conditional on locate-library.
;; Changed definition guard condition to locate-library. Updated def to require kmacro.el.
;; Moved here from *cmd2.el:
;; icicle-apropos, icicle-apropos-command, icicle-apropos-function, icicle-apropos-option,
;; icicle-apropos-options-of-type, icicle-apropos-variable, icicle-apropos-zippy,
;; icicle-apropos-opt-action, icicle-describe-option-of-type, icicle-describe-opt-action,
;; icicle-describe-opt-of-type-complete.
;; Plus compile-time requires of libraries yow, cookie1, apropos-fn+var.
;; 2012/04/01 dadams
;; Removed: old-customize-apropos* (no longer redefine automatically for Icicle mode).
;; 2012/03/31 dadams
;; icicle-customize-apropos: Do not call split-string if string is empty.
;; Allow word list for Emacs 22+, not 24+.
;; icicle-customize-apropos*: Added optional MSGP arg - display progress msg if non-nil.
;; 2012/03/30 dadams
;; Added: icicle-customize-apropos-opt-action.
;; icicle-customize-apropos-options-of-type: Rewrote as a multi-command using multi-completions.
;; icicle-customize-apropos*:
;; Updated wrt Emacs 24 (handle PATTERN). Fixed vanilla Emacs bugs #11124, #11126, #11132.
;; 2012/03/29 dadams
;; icicle-customize-apropos-options-of-type:
;; Pass inherit-or-value to icicle-var-is-of-type-p as the MODE.
;; Handle the case where the user just enters a regexp, without using completion: mapatoms.
;; icicle-customize-apropos: Use backquote and comma on regexp in lambda.
;; 2012/03/28 dadams
;; Changed FILE arg in autoloads by removing .el, so .elc will be loaded if available.
;; 2012/03/10 dadams
;; Added: icicle-make-bookmark-candidate (factored out).
;; icicle-bookmark(-set|-list|-other-window):
;; Use icicle-make-bookmark-candidate to define icicle-candidates-alist.
;; 2012/03/09 dadams
;; icicle-bookmarked-file-list: Call bookmark-maybe-load-default-file.
;; icicle-customize-apropos(-faces|-groups|-options(-of-type)), icicle-(re)set-option-to-(t|nil),
;; icicle-toggle-option, icicle-increment-(option|variable), icicle-doremi-increment-variable+,
;; icicle-command-abbrev, icicle-execute-named-keyboard-macro, icicle-buffer-list:
;; When Icomplete mode, use normal PRED, not *-must-pass-after-match-predicate.
;; icicle-execute-extended-command: Likewise - redid it.
;; icicle-customize-apropos-options: If prefix arg, still use user-variable-p also (or).
;; 2012/03/03 dadams
;; icicle-execute-extended-command:
;; If in Icomplete mode, use the normal PRED arg, instead of *-must-pass-after-match-predicate.
;; 2012/02/26 dadams
;; Update to reflect Bookmark+ changes (bindings etc.).
;; Added: icicle-bookmark-autofile-(all|some)-tags(-regexp)(-other-window).
;; icicle-bookmark: Update doc string for binding changes.
;; icicle-bookmark-bind-narrow-commands: Update bindings to reflect Bookmark+ changes.
;; icicle-bookmark-help-string: Initialize no-position-p from bookmark, so it works if no pos.
;; Typo: icicle-bookmark-this-dir-file-all-tags -> icicle-bookmark-file-this-dir-all-tags.
;; 2012/02/11 dadams
;; Applied renaming.
;; 2012/01/31 dadams
;; icicle-yank-pop-commands, icicle-completing-yank: Minor changes to doc strings.
;; 2012/01/20 dadams
;; icicle-bookmark-*-tags(-other-window): Pass prefix arg to bmkp-read-tags-completing, to refresh.
;; 2012/01/15 dadams
;; icicle-bookmark-set: Added missing quote mark for (icicle-)bookmark-history.
;; 2012/01/14 dadams
;; Added: icicle-zap-to-char.
;; 2012/01/08 dadams
;; Added: icicle-yank-pop-commands, icicle-bookmark-bind-narrow-commands,
;; icicle-bookmark-(autofile|autonamed(-this-buffer)|file-this-dir|temporary)-narrow.
;; Soft-require second-sel.el.
;; icicle-bookmark-set: Mention narrowing in doc string.
;; icicle-bookmark: Suggest in doc string to refresh cache if error.
;; Added C-x j bindings to doc string: a, C-f, x, # ., # #.
;; icicle-bookmark(-set|-other-window): Use icicle-bookmark-bind-narrow-commands.
;; icicle-bookmark-*-narrow:
;; Use icicle-transform-multi-completion, not funcall icicle-get-alist-candidate-function.
;; icicle-completing-yank: Add prefix arg behavior: use secondary-selection-ring. Update doc.
;; Add alt action of copying to other selection ring.
;; icicle-yank-maybe-completing: Bind current-prefix-arg to nil around icicle-completing-yank.
;; 2011/12/19 dadams
;; icicle-find-file-absolute(-other-window): Do not insert default directory as initial input.
;; icicle-ess-R-complete-object-name: Use line-end-position, not point-at-eol (not in Emacs 20).
;; icicle-bookmark-(cmd|set), icicle-bbdb-complete-name: Use line-(beginning|end)-position.
;; 2011/12/14 dadams
;; Added: icicle-bookmark-bookmark-file-narrow, icicle-bookmark-image-narrow,
;; icicle-bookmark-image(-other-window).
;; icicle-bookmark-set, icicle-bookmark(-other-window):
;; Changed bindings to be the same as top-level jump bindings.
;; Added bindings: icicle-bookmark-bookmark-file-narrow, icicle-bookmark-image-narrow.
;; icicle-bookmark-list:
;; Return bookmarks, not their names, unless prefix arg or icicle-bookmark-list-names-only-p.
;; Bind icicle-unpropertize-completion-result-flag. Use icicle-unpropertize-completion, not
;; icicle-substring-no-properties, so remove only Icicles internal properties.
;; Call bookmark-maybe-load-default-file whether Bookmark+ or not.
;; Use icicle-bookmark-types only for Bookmark+. Use all bookmarks otherwise.
;; 2011/11/23 dadams
;; icicle-locate-file-1: when -> unless icicle-locate-file-use-locate-p.
;; 2011/11/21 dadams
;; icicle-locate-file-1:
;; Do not bind current-prefix-arg, so pick up prefix arg for vanilla Emacs locate cmd.
;; Require locate.el in ignored binding, not first code.
;; No progress message (gathering...) if use external locate cmd.
;; Put prop icicle-fancy-candidates only if not using external locate cmd.
;; icicle-locate: Improved doc string.
;; icicle-find-file-absolute*, icicle-locate-file-1:
;; Bind C-c C-d to icicle-cd-for-(abs|loc)-files (it was mistakenly removed).
;; icicle-(delete|recent)-file, icicle-dired, icicle-find-file(-read-only|-in-tags-table),
;; icicle-(file|directory)-list:
;; Removed mention of C-c C-d in doc string - inappropriate here.
;; 2011/11/13 dadams
;; icicle-locate-file-1: Corrected placement of kill-buffer in unwind-protect.
;; 2011/11/07 dadams
;; icicle-locate-file-1:
;; Use with-current-buffer with locate-buffer-name, to hide switch-to-buffer in locate.
;; 2011/11/06 dadams
;; icicle-locate-file-1: Wrap use of external locate program in save-window-excursion.
;; 2011/11/01 dadams
;; Added: icicle-bookmark-autofile(-other-window),
;; icicle-bookmark-autonamed(-this-buffer)(-other-window), icicle-bookmark-bookmark-file,
;; icicle-bookmark-temporary(-other-window).
;; 2011/10/29 dadams
;; icicle-delete-file: Add icicle-remove-candidate-display-others to action fn. Remove S-delete.
;; 2011/10/21 dadams
;; icicle-remove-entry-from-saved-completion-set: Bind icicle-remove-icicles-props-p to nil.
;; icicle-execute-extended-command-1: Don't bind WAIT-TIME to 0 if CURR-MSG.
;; icicle-(add|remove)-entry-(to|from)-saved-completion-set, icicle-remove-saved-set-action,
;; icicle-execute-extended-command-1, icicle-kmacro-action, icicle-toggle-option,
;; icicle-increment-(option|variable), icicle-find-tag-help, icicle-add-buffer-candidate,
;; icicle-remove-buffer-(candidate|config)-action, icicle-remove-from-recentf-candidate-action,
;; icicle-locate-file-1, icicle-(string|sexp|keyword|face|buffer|bookmark|file|directory)-list:
;; Use icicle-propertize.
;; Applied renaming: icicle-unpropertize -> icicle-unpropertize-completion.
;; 2011/10/10 dadams
;; icicle-define-bookmark-command*: Moved to icicles-mac.el.
;; 2011/10/08 dadams
;; icicle-dired-project*, icicle-bookmark*, icicle*-buffer*: Use icicle-kbd.
;; 2011/10/03 dadams
;; icicle-customize-face: Updated for Emacs 24: Added optional arg OTHER-WINDOW.
;; 2011/09/21 dadams
;; Added: icicle-locate-other-window, icicle-locate-file-use-locate-p. Improved doc string.
;; icicle-locate: Use icicle-locate-file-1 (not icicle-define-command).
;; icicle-locate-file-1: Use locate external program, if non-nil icicle-locate-file-use-locate-p.
;; icicle-(find-file-(absolute|in-tags-table)|recent-file)(-other-window), icicle-locate-file-1,
;; icicle-cd-for-abs-files:
;; Use file-name-as-directory instead of concat with /.
;; 2011/09/18 dadams
;; Added: icicle-sexp-list, icicle-string-list.
;; Moved here from icicles-cmd2.el: icicle-keyword-list.
;; Added: icicle-locate. Thx to Michael Heerdegen.
;; icicle-bookmarked-(buffer|file)-list, icicle-define-add-to-alist-command,
;; icicle-(bookmark|buffer|face|file|directory|regexp|keyword)-list, icicle-add-buffer-config:
;; Bind icicle-prompt.
;; icicle-(bookmark|buffer|face|file|directory|regexp|keyword)-list:
;; Added msg saying Added... when interactive.
;; 2011/09/02 dadams
;; icicle-completing-yank: Put kills in order, respecting kill-ring-yank-pointer.
;; (put 'icicle-completing-yank 'delete-selection 'yank).
;; icicle-insert-for-yank: Set this-command to yank.
;; 2011/08/30 dadams
;; icicle-yank-maybe-completing: Put delete-selection prop, so region is deleted.
;; 2011/08/26 dadams
;; icicle-comint-dynamic-complete-as-filename, icicle-comint-dynamic-simple-complete,
;; icicle-bbdb-complete-name, icicle-explore, icicle-bookmark(-list|-other-window),
;; icicle-define-bookmark-command-1, icicle-find-tag-action,
;; icicle-kill-a-buffer-and-update-completions, icicle-color-theme,
;; icicle-delete-file-or-directory:
;; Use icicle-condition-case-no-debug instead of condition-case. Thx to Michael Heerdegen.
;; Make sure to pass format string as first arg to calls to functions error and message.
;; 2011/08/12 dadams
;; icicle-delete-file, icicle-(file|directory)-list, icicle-(dired|file)*,
;; icicle-find-file(-absolute|-read-only|in-tags-table)*, icicle-(recent|locate)-file*:
;; Use icicle-(un)bind-file-candidate-keys. Don't do/undo such bindings individually here.
;; icicle-find-file-(absolute|in-tags-table)*, icicle-(recent|locate)-file*:
;; Bind icicle-full-cand-fn.
;; icicle-dired-(project|buffer)*: Removed fboundp test of icicle-bookmark-* (just test Bookmark+).
;; 2011/08/11 dadams
;; icicle-find-file-absolute(-other-window):
;; Bind C-x a [+-] to adding/removing tags.
;; 2011/08/09 dadams
;; icicle-define(-file)-command calls: Removed undo code if same as last code, so do not repeat it.
;; 2011/08/07 dadams
;; icicle-(find-file-absolute|recent-file)(-other-window), icicle-locate-file-1,
;; icicle-cd-for-(abs|loc)-files:
;; Bind icicle-abs-file-candidates to the COLLECTION alist (no longer just list of strings).
;; 2011/07/30 dadams
;; Moved to icicles-cmd2.el and wrapped in eval-after-load bookmark+.el:
;; icicle-find-file-(all|some)-tags(-regexp)(-other-window), icicle-(un)tag-a-file.
;; 2011/07/26 dadams
;; Removed: icicle-list-end-string (no longer needed). Thx to Michael Heerdegen.
;; 2011/05/22 dadams
;; Added defvars for free vars to quiet byte compiler.
;; 2011/05/21 dadams
;; icicle-customize-apropos(-options): let -> let* for interactive form.
;; 2011/04/29 dadams
;; icicle-execute-extended-command(-1), icicle-command-abbrev(-action|-command),
;; icicle-execute-named-keyboard-macro, icicle-increment-(option|variable),
;; icicle-doremi-increment-variable+:
;; Renamed: orig-must-pass-after-match-predicate to icicle-orig-must-pass-after-match-pred,
;; new-last-cmd to icicle-new-last-cmd.
;; 2011/04/25 dadams
;; Commands defined with icicle-define-file-command and using icicle-file-bindings:
;; Remove binding for icicle-candidate-help-fn - done in icicles-mac.el now.
;; 2011/04/13 dadams
;; Fixed autoload cookies for icicle-define-file-command commands added yesterday.
;; 2011/04/12 dadams
;; Added: icicle-bookmark-save-marked-files(-as-project|-more|-persistently|-to-variable),
;; icicle-find-file-(all|some)-tags(-regexp)(-other-window), icicle-(un)tag-a-file.
;; icicle-bookmark(-list|-set|-other-window|-delete-action), icicle-define-bookmark-command-1:
;; Applied Bookmark+ renaming: bmkp-sort-and-remove-dups -> bmkp-sort-omit.
;; icicle-bookmark-set: Fixed typo: bmkp-light-bookmarks-this-buffer -> bmkp-light-this-buffer.
;; icicle-define-bookmark-command-1: Doc strings now mention corresponding Bookmark+ command.
;; icicle-execute-extended-command-1:
;; Apply icicle-transform-multi-completion to arg. Thx to Michael Heerdegen.
;; 2011/04/04 dadams
;; icicle-bookmark-jump-1, icicle-pop-tag-mark: Use icicle-recenter.
;; 2011/04/02 dadams
;; Added: icicle-bookmark-file-this-dir((-all|some)-tags(-regexp))(-other-window),
;; icicle-locate-file-(action-fn|no-symlinks-p).
;; icicle-kmacro(-action), icicle-clear(-current)-history(-1):
;; Use (new) icicle-pref-arg, not pref-arg.
;; icicle(-kill|-insert)-buffer(-other-window), icicle-default-buffer-names,
;; icicle-filter-buffer-cands-for-mode, icicle-add-buffer-candidate:
;; Use (new) icicle-bufflist, not bufflist.
;; icicle-locate-file(-1|-no-symlinks)(-other-window):
;; Use (new) icicle-locate-file-no-symlinks-p, not no-symlinks-p.
;; 2011/03/31 dadams
;; icicle-search-action-1: Applied renaming: i*-target-window-recenter-amount to icicle-recenter.
;; icicle-customize-apropos-options-of-type: Wrap icicle-var-is-of-type-p with condition-case.
;; 2011/03/29 dadams
;; Use new icicle-* vars for various free vars (orig-buff etc.).
;; 2011/03/26 dadams
;; Added: icicle-bookmark-file-(all|some)-tags(-regexp)(-other-window).
;; 2011/02/22 dadams
;; Added: icicle-lisp-completion-at-point.
;; 2011/01/06 dadams
;; Added: icicle-filter-buffer-cands-for-mode.
;; icicle-(kill|insert)-buffer, icicle-buffer(-other-window), icicle-add-buffer-candidate:
;; Bind C-x M to icicle-filter-buffer-cands-for-mode.
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/12/18 dadams
;; Added more autoload cookies for cmds & macros; removed from non-cmd fns. Thx to Richard Kim.
;; Specify cmd and file for cmds defined by Icicles macros.
;; Require icicles-opt.el before icicles-var.el (but it makes no difference).
;; 2010/11/21 dadams
;; defalias both old-lisp-complete-symbol and (for Emacs 23+) old-lisp-completion-at-point.
;; 2010/11/10 dadams
;; icicle-lisp-complete-symbol: Remove return value. Let it do everything (chg is in ici*mode.el).
;; 2010/11/04 dadams
;; icicle-lisp-complete-symbol: Fixed return value for Emacs 23.2+. Thx to Michael Heerdegen.
;; 2010/11/03 dadams
;; defalias old-lisp-completion-at-point, not old-lisp-complete-symbol, for Emacs 23.2+.
;; icicle-lisp-complete-symbol:
;; Explicitly return nil, for use in completion-at-point-functions (Emacs 23.2+).
;; 2010/10/25 dadams
;; icicle-buffer-list: Use icicle-must-pass-after-match-predicate, not icicle-must-pass-predicate.
;; icicle-directory-list:
;; Bind icicle-file-predicate instead of using PREDICATE arg. No emacs-version limit now.
;; 2010/10/24 dadams
;; icicle-customize-apropos(-faces|-groups|-options(-of-type)), icicle-execute-extended-command,
;; icicle-command-abbrev, icicle-execute-named-keyboard-macro, icicle-(re)set-option-to-(t|nil),
;; icicle-toggle-option, icicle-increment-(option|variable), icicle-doremi-increment-variable+:
;; Use icicle-must-pass-after-match-predicate, not PREDICATE arg.
;; icicle-execute-extended-command-1, icicle-command-abbrev-action,
;; icicle-increment-(option|variable), icicle-doremi-increment-variable+:
;; Restore orginal icicle-must-pass-after-match-predicate.
;; 2010/10/09 dadams
;; icicle-customize-face, icicle-repeat-complex-command, icicle-delete-window:
;; Updated doc string for new prefix and modal cycling keys.
;; 2010/08/27 dadams
;; icicle-pp-display-expression: Set the hooks locally instead of let-binding them, to avoid msg
;; "Making change-major-mode-hook buffer-local while locally
;; let-bound!" - suggestion from Stefan M.
;; 2010/07/20 dadams
;; icicle-find-file-in-tags-table(-other-window):
;; Pick up default-directory of TAGS table. Thx to Chris Hecker.
;; icicle-bookmark-jump-1: Applied renaming of bmkp-use-region-flag to bmkp-use-region.
;; 2010/07/17 dadams
;; Added: icicle-bookmark-url-narrow, icicle-bookmark-url(-other-window).
;; icicle-bookmark(-list|-set|-other-window|-propertize-candidate|-help-string),
;; icicle-define-bookmark-command-1: w3m -> url.
;; Bound URL commands to C-M-u, C-x j u.
;; 2010/07/02 dadams
;; icicle-bookmark-set: Added INTERACTIVEP arg. Prompt for tags when bmkp-prompt-for-tags-flag.
;; Highlight bookmark if bmkp-auto-light-when-set.
;; icicle-bookmark-cmd: Call icicle-bookmark-set with new INTERACTIVEP arg.
;; 2010/06/25 dadams
;; icicle-find-file(-other-window):
;; Use default-directory, not nil, as third arg to read-file-name. Thx to Thomas Lim.
;; Note: This more or less reverts a change I made (why?) on 2008/12/27 (see that, below).
;; 2010/06/18 dadams
;; Renamed: bookmarkp-* to bmkp-*.
;; 2010/06/11 dadams
;; icicle-find-file-absolute*, icicle-recent-file*, icicle-locate-file-1:
;; Bind C-c + to icicle-make-directory.
;; icicle-find-file-in-tags-table*: Removed bindings: C-x m, C-backspace.
;; 2010/06/10 dadams
;; icicle-cd-for-abs-files: Bound enable-recursive-minibuffers to t.
;; 2010/06/08 dadams
;; Added: icicle-bookmark-delete-action: Make it refresh the cache.
;; icicle-bookmark(-list|-other-window), icicle-define-bookmark-command-1:
;; Use icicle-bookmark-delete-action.
;; Use condition-case to filter out bad bookmarks (so no error). Thx to M. Heerdegen.
;; 2010/06/04 dadams
;; Applied renamings of doremi commands (added +).
;; icicle-(buffer|*file|directory)*: Updated doc string to mention icicle-(buffers|files)-ido-like.
;; 2010/05/30 dadams
;; Added: icicle-locate-file-no-symlinks(-other-window), icicle-locate-file(-other-window)-action,
;; icicle-locate-file-1.
;; icicle-locate-file*: Moved body to icicle-locate-file-1. Use named action functions.
;; Respect icicle-ignored-directories (via *-files-within).
;; icicle-cd-for-loc-files: Added optional arg NO-SYMLINKS-P.
;; icicle-dired-saved-file-candidates(-other-window): Handle multi-completion candidates.
;; Thx to M. Heerdegen.
;; 2010/05/28 dadams
;; icicle-(recent|locate)-file(-other-window),
;; Use *-transform-multi-completion in *-all-candidates-list-alt-action-fn. Thx to M. Heerdegen.
;; 2010/05/27 dadams
;; icicle-cd-for-loc-files: Wrap interactive spec in save-selected-window. Thx to M. Heerdegen.
;; 2010/05/26 dadams
;; icicle-bookmark-set: Removed pseudo-default. Thx to Michael Heerdegen.
;; 2010/05/24 dadams
;; icicle-comint-replace-orig-completion-fns: Rewrote to not use case. Thx to Michael Heerdegen.
;; 2010/05/21 dadams
;; icicle-bookmark-help-string:
;; Use BOOKMARK-NAME, not BMK, as arg to vanilla fns, for Emacs < 23. Thx to Alexander Haeckel.
;; 2010-05-18 dadams
;; Added: icicle-cd-for-abs-files, icicle-cd-for-loc-files.
;; icicle-find-file-absolute*, icicle-locate-file*: Bind C-c C-d to icicle-cd-for-(abs|loc)-files.
;; icicle-locate-file*: Make icicle-list-use-nth-parts be nil if no non-positive prefix arg.
;; 2010/05/16 dadams
;; icicle-define-bookmark-command-1: Defined command requires bookmark+.el.
;; Added: icicle-bookmark-specific-(buffers|files)-narrow, icicle-bookmark-this-buffer-narrow.
;; icicle-bookmark(-other-window), icicle-bookmark-set:
;; Bound C-M-= (b|f), C-M-. for narrowing to specific-(buffers|files), this-buffer.
;; icicle-bookmark-cleanup: Updated for added narrowing keys.
;; 2010/05/15 dadams
;; Added: icicle-define-bookmark-command(-1). Added ARGS param for use as arg for *-alist-only.
;; Added same-window commands for bookmark jumping.
;; Added: *-specific-(buffers|files)*, *-this-buffer*, *-(all|some)-tags(-regexp)* jump commands,
;; *-bookmarked-(buffer|file)-list.
;; icicle-bookmark-set: *-selected-buffers-alist-only -> *-specific-buffers-alist-only.
;; 2010/05/06 dadams
;; icicle-bookmark-set: Removed spurious format call with its arg.
;; 2010/04/29 dadams
;; icicle-explore: Bind icicle-remove-icicles-props-p to nil around call to completing-read.
;; Call icicle-unpropertize at the end (without that binding).
;; 2010/04/20 dadams
;; icicle-dired(-other-window): Use icicle-dirs-first-p, not icicle-dirs-last-p, and don't reverse.
;; 2010/04/17 dadams
;; Added: icicle-bookmark-set.
;; icicle-bookmark-cmd: Use icicle-bookmark-set, not bookmark-set. Simpler PARG code in that case.
;; icicle-bookmark(-list|-other-window), icicle-define-bookmark-other-window-command:
;; Use icicle-transform-multi-completion in icicle-delete-candidate-object.
;; 2010/04/10 dadams
;; Corrected prefix arg use for icicle-find-file(-read-only)(-other-window). Thx to M. Heerdegen.
;; 2010/04/09 dadams
;; Added: icicle-find-file-read-only(-other-window).
;; icicle-find-file(-other-window):
;; Prefix arg on individual candidate means visit read-only.
;; Prefix arg for the command means reverse the prefix arg effect: read-only for all by default.
;; 2010/04/02 dadams
;; Added: icicle-bookmark-list.
;; icicle-bookmark-cleanup: Clean up both minibuffer maps.
;; 2010/03/27 dadams
;; icicle-define-bookmark-other-window-command: Use optional PROMPT arg.
;; 2010/03/19 dadams
;; icicle-define-bookmark-other-window-command: Rich multi-completions per icicle-bookmark.
;; 2010/03/16 dadams
;; icicle-bookmark(-other-window):
;; Use tags, not just file names, in the multi-completions.
;; Use the default join string, ^G^J, and end string, ^J^J.
;; Use just icicle-candidate-properties-alist to highlight the file name.
;; Remove extra quote marks from face names.
;; 2010/03/14 dadams
;; icicle-bookmark(-other-window):
;; Copy file/buffer name string for candidate-part face, so we don't touch bookmark-alist.
;; Handle icicle-bookmark-refresh-cache-flag and C-u.
;; Bind the narrow keys in minibuffer-local-completion also (lax for multi-completion).
;; Use face file-name-shadow, not icicle-candidate-part (too distracting).
;; icicle-bookmark-*-narrow: Use icicle-get-alist-candidate-function.
;; icicle-define-bookmark-other-window-command: Rewrote to handle multi-completion.
;; icicle-bookmark-non-file-narrow: Use bookmarkp-non-file-bookmark-p.
;; icicle-bookmark-propertize-candidate: Typo in a face name.
;; 2010/03/13 dadams
;; icicle-bookmark(-other-window):
;; If Bookmark+ available then, depending on icicle-show-multi-completion-flag, use a
;; multi-completion showing file or buffer. Use icicle-candidates-alist to do that.
;; Don't put icicle-fancy-candidates prop on prompt.
;; Don't use icicle-sorted-bookmark-alist (removed). Recompute each time.
;; 2010/03/10 dadams
;; icicle-bookmark-help-string:
;; Mention the type in the help: sequence, function, bookmark list, desktop, etc.
;; Don't show position for types that don't use one. Don't show file for buffer & Dired.
;; 2010/03/09 dadams
;; icicle-color-theme: Initialize variable icicle-color-themes here, not in icicles-opt.el.
;; 2010/03/04 dadams
;; icicle-bookmark(-other-window): Use bookmarkp-describe-bookmark(-internals) for C-M-RET.
;; 2010/03/03 dadams
;; icicle-bookmark(-other-window), icicle-define-bookmark-other-window-command:
;; Use bookmarkp-sort-and-remove-dups.
;; Bind icicle-sort-orders-alist, using bookmarkp predicates.
;; icicle-bookmark(-other-window):
;; Set icicle-sorted-bookmark-alist and bookmarkp-sorted-alist.
;; Use bookmarkp-sorted-alist.
;; Don't append original icicle-sort-orders-alist. Just include a couple of its entries.
;; Applied renamings: icicle-sort-function to icicle-sort-comparer,
;; icicle-sort-functions-alist to icicle-sort-orders-alist.
;; 2010/02/28 dadams
;; icicle-send-bug-report: Formatted body a bit.
;; 2010/02/14 dadams
;; Added: icicle-bookmark-bookmark-list-other-window, icicle-bookmark-bookmark-list-narrow.
;; icicle-bookmark(-other-window):
;; Bound to C-M- prefix: icicle-bookmark-bookmark-list-narrow. Updated doc string.
;; 2010/02/13 dadams
;; Added: icicle-bookmark-(desktop|man)-other-window,
;; icicle-bookmark-(dired|desktop|man)-narrow.
;; icicle-define-bookmark-other-window-command: Raise error if bookmark+.el not found.
;; icicle-bookmark(-other-window):
;; Bound to C-M- prefix: icicle-bookmark-(dired|desktop|man)-narrow.
;; icicle-bookmark-propertize-candidate:
;; Handle also: sequence, function, bookmark list, desktop, man, buffer, bad bookmarks.
;; 2010/02/02 dadams
;; icicle-bookmark-jump-1: Don't select minibuffer window and give it focus.
;; 2010/01/30 dadams
;; icicle-dired(-other-window), icicle-(find|recent|locate)-file(-absolute)(-other-window)
;; icicle-find-file-in-tags-table(-other-window):
;; Bind icicle-all-candidates-list-alt-action-fn to open Dired on matching files.
;; 2010/01/13 dadams
;; icicle-recent-file(-other-window):
;; Restore C-S-RET as icicle-remove-from-recentf-candidate-action (accidentally removed).
;; 2010/01/12 dadams
;; Added: icicle-pp-display-expression.
;; icicle-pp-eval-expression: Use icicle-pp-display-expression.
;; icicle-bbdb-complete-name: save-excursion + set-buffer -> with-current-buffer.
;; 2009/12/21 dadams
;; fset -> defalias.
;; 2009/12/13 dadams
;; Added: icicle-bookmark-dired-other-window, icicle-dired(-other-window).
;; *-buffer*, *-dired-project*, *-find-file(-absolute)*, *-(recent|locate)-file*,
;; *-find-file-in-tags-table*:
;; Bind C-x m to icicle-bookmark-(non-file|dired|file)-other-window.
;; 2009/11/27 dadams
;; Added: icicle(-doremi)-increment-(variable|option).
;; 2009/11/25 dadams
;; icicle-color-theme: Raise error for empty input. Thx to Ahei.
;; 2009/11/24 dadams
;; icicle-color-theme: Take a snapshot each time invoked, unless prefix arg.
;; 2009/11/22 dadams
;; icicle-color-theme: Use color-theme-initialize instead of load-library, to load themes.
;; 2009/11/21 dadams
;; icicle-color-theme: Use color-theme-snapshot to let C-g undo changes.
;; Try to load color-theme-library.el (available with version 6.6.0).
;; 2009/11/17 dadams
;; icicle-bbdb-complete-name: Bind completion-case-ignore.
;; 2009/11/14 dadams
;; icicle-bbdb-complete-name: Replace macro bbdb-hashtable by its expansion.
;; 2009/09/21 dadams
;; icicle-lisp-complete-symbol:
;; Complete symbol in buffer as far as possible first. Show completions initially.
;; 2009/09/17 dadams
;; icicle-delete-file, icicle-(file|directory)-list,
;; icicle-find-file(-absolute)(-other-window),
;; icicle-(recent|locate)-file(-other-window),
;; icicle-find-file-in-tags-table(-other-window): Use icicle-file-bindings (new macro).
;; 2009/09/16 dadams
;; Added: icicle-insert-buffer.
;; icicle-kill-buffer, icicle-buffer(-other-window), icicle-add-buffer-candidate:
;; Use icicle-buffer-bindings (new macro).
;; 2009/08/29 dadams
;; Added: icicle-define-bookmark-other-window-command, icicle-select-bookmarked-region,
;; icicle-bookmark(-region|-info|-gnus|-w3m|(-non|-local|-remote)-file)-other-window.
;; icicle-bookmark-propertize-candidate: Updated to reflect renamed bookmark+.el face names.
;; icicle-bookmark-file-narrow: Use bookmarkp-file-bookmark-p.
;; (lambda...) -> #'(lambda...).
;; 2009/08/25 dadams
;; Added: icicle-bookmark-cleanup-on-quit.
;; icicle-bookmark(-other-window): Use icicle-bookmark-cleanup-on-quit.
;; icicle-bookmark-cleanup: Removed code to return to original window a focus minibuffer.
;; 2009/08/24 dadams
;; Added: icicle-bookmark-propertize-candidate.
;; icicle-bookmark(-other-window): Put faces on bookmark candidates according to type.
;; 2009/08/23 dadams
;; Added: icicle-bookmark-(region|info|gnus|w3m|(non-|local-|remote-)file)-narrow.
;; icicle-bookmark(-other-window): Bind keys to bookmark candidate narrowing commands.
;; icicle-bookmark-cleanup: Unbind the same commands.
;; icicle-bookmark-cmd:
;; Let bookmark+.el (latest version) handle prompting for name, even for region bookmark.
;; Remove any newlines in bookmark name, when no prompting (thx to Thierry Volpiatto).
;; 2009/08/21 dadams
;; icicle-bookmark-jump-1: Typo.
;; 2009/08/20 dadams
;; icicle-bookmark-cmd: Use icicle-bookmark-other-window, not icicle-bookmark.
;; Fix trimmed-name: no longer than def-name.
;; icicle-bookmark(-other-window): Bind enable-recursive-minibuffers, in case need to read.
;; icicle-bookmark-jump-1: No crosshair highlighting for region bookmarks.
;; 2009/08/19 dadams
;; Added: icicle-bookmark-help-string.
;; icicle-bookmark-cmd: Handle creation of region bookmarks (new default values).
;; icicle-bookmark-name-length-max now applies to whole bookmark name.
;; icicle-bookmark(-other-window):
;; Apply icicle-candidate-short-help to candidates. Use also for the help function.
;; icicle-bookmark-jump-1: Use bookmark--jump-via if it is defined.
;; 2009/06/21 dadams
;; icicle-bookmark-jump-1: Removed temporary Emacs 23 workaround for (fixed) bug #1175.
;; 2009/06/07 dadams
;; icicle-get-alist-candidate -> funcall icicle-get-alist-candidate-function.
;; 2009/05/22 dadams
;; Require icicles-mac.el if load-library doesn't find it.
;; Created - Split off from icicles-cmd.el.
;;;(@* "CHANGE LOG FOR `icicles-cmd2.el'")
;;
;; 2022/06/25 dadams
;; icicle-ido-like-mode: Removed optional args for define-minor-mode - use only keywords.
;; 2022/05/22 dadams
;; icicle-add-key+cmd: Use icicle-characterp.
;; 2021/03/17 dadams
;; Use buffer-string, not buffer-substring, for whole buffer.
;; 2020/11/05 dadams
;; icicle-color-completion-setup:
;; Wrap soft-require of palette in condition-case to ignore error hard-requiring vline.el.
;; 2020/10/16 dadams
;; icicle-describe-package: Updated for Emacs 25+ (sync with help-fns+.el).
;; 2020/08/14 dadams
;; icicle-search-define-candidates, icicle-char-properties-in-buffers:
;; bookmark-jump-noselect is obsolete.
;; icicle-add-key+cmd: generic-char-p is obsolete.
;; icicle-font: Typo in doc string: non-nil -> nil.
;; 2020/02/03 dadams
;; icicle-search-read-context-regexp: Use icicle-read-number if available.
;; 2020/01/20 dadams
;; icicle-search-thing-scan:
;; Fix off-by-1 hack to handle vanilla thing-at-point, which returns thing even if before point.
;; 2019/06/09 dadams
;; icicle-next-font-lock-keywords-repeat:
;; Removed require of repeat.el (in icicle-repeat-command now).
;; 2018/10/15 dadams
;; icicle-choose-candidate-of-type: Bind icicle-sort-comparer and icicle-buffer-completing-p.
;; Do not use icicle-buffer-sort-first-time-p.
;; 2018/09/09 dadams
;; icicle-Info-goto-node-1: Test numeric, not raw, prefix arg with natnump.
;; 2017/02/01 dadams
;; Added: icicle-woman.
;; 2017/01/31 dadams
;; Added: icicle-man. Thx to Charles Roelli.
;; 2017/01/17 dadams
;; icicle-complete-keys-1: Added optional arg NO-ERROR = do not raise error if no completions.
;; Do nothing if icicle-complete-keys-alist is empty.
;; icicle-keys+cmds-w-prefix: Do not add `..' candidate if there are no others.
;; icicle-auto-complete-key: Pass NO-ERROR arg to icicle-complete-keys-1.
;; 2017/01/16 dadams
;; icicle-complete-keys-1: Do not complete if the only (pseudo-)completion is `..'.
;; 2017/01/13 dadams
;; icicle-auto-complete-key: Do not complete if this-command-keys-vector is bound to a function.
;; 2016/12/23 dadams
;; Accommodate renaming of palette-mode-map to palette-menu.
;; 2016/06/29 dadams
;; icicle-search: Escaped a few backslashes in doc string. Thx to Tino Calancha.
;; 2016/06/12 dadams
;; Added: icicle-auto-complete-key, icicle-auto-complete-keys-mode.
;; 2016/05/29 dadams
;; icicle-goto-marker-1: Delete any nil entries from mapping icicle-marker+text over markers.
;; icicle-marker+text: Make clear in doc string that it can return nil.
;; 2016/03/27 dadams
;; icicle-add-key+cmd: Use princ, not prin1, for BNDG, for commands like icicle-dispatch-C-..
;; 2016/03/03 dadams
;; icicle-search-read-context-regexp: Bind icicle-regexp-quote-flag to nil when reading regexp.
;; 2016/03/01 dadams
;; icicle-search-action: Corrected doc string: If icicle-search-highlight-threshold is NOT zero.
;; icicle-search-highlight-input-matches-here: Wrap re-search-forward in condition-case.
;; 2016/02/28 dadams
;; icicle-complete-keys: Mention icicle-complete-keys-separator in doc string.
;; icicle-complete-keys-action, icicle-add-key+cmd, icicle-complete-keys-help:
;; Use new option icicle-complete-keys-separator.
;; 2016/02/?? dadams
;; icicle-search-replace-match: Corrected (swapped) calls to replace-match-maybe-edit.
;; 2016/01/24 dadams
;; icicle-where-is: Added format string as first arg to message, to protect % in message text.
;; 2015/09/19 dadams
;; icicle-synonyms: Action fn passes APPENDP and MOREP to synonyms-action (are free in action fn).
;; 2015/08/23 dadams
;; icicle-buffer-narrowing, icicle-select-zone-action: Same as for icicle-select-zone yesterday.
;; 2015/08/22 dadams
;; icicle-select-zone:
;; Added optional parameters. Different prefix arg behavior (like zz-add-zone).
;; User can specify var. Can select zones in multiple buffers. Uses icicle-izones-var.
;; icicle-select-zone-action: Use icicle-izones-var, not zz-izones-var.
;; 2015/08/19 dadams
;; icicle-occur, icicle-search-(sentences|paragraphs|pages), icicle-compilation-search:
;; Use face remapping (face-remap-(re)set-base) instead of set-face-* for Emacs 23+.
;; Thx to Jonathan H (PythonNut).
;; 2015/08/18 dadams
;; Added: icicle-select-zone, icicle-select-zone-action.
;; Renamed: icicle-narrow(-action) to icicle-buffer-narrowing(-action).
;; icicle-buffer-narrowing(-action): Use zz-izones-var, not zz-izones.
;; icicle-buffer-narrowing-action:
;; Corrected indexes into candidate - was off by one because of izone num index.
;; Bind zz-izone-add-anyway-p to nil, not t. (Do not add new narrowings.)
;; Protect zz-narrowing-lighter with boundp mode-line-modes.
;; Applied renaming of zz-izone-add-anyway-p to zz-add-zone-anyway-p.
;; 2015/08/16 dadams
;; Renamed: icicle-wide-n(-action) to icicle-narrow(-action). Renamed wide-n.el stuff to zones.el.
;; icicle-narrow (was icicle-wide-n): Update for new zone format and lack of entry "all".
;; 2015/08/12 dadams
;; icicle-wide-n, icicle-wide-n-action: Updated for wide-n.el restrictions format change.
;; 2015/08/01 dadams
;; Added: icicle-hide/show-comments-1.
;; icicle-hide/show-comments:
;; Use with-silent-modifications if available. Use icicle-hide/show-comments-1, which was
;; updated per hide-comnt.el, including respect icicle-hide-whitespace-before-comment-flag.
;; 2015/07/29 dadams
;; icicle-search-char-prop-matches-p: Loop over all overlays at point, do not just use the first.
;; 2015/04/11 dadams
;; icicle-search-action, icicle-search-action-1, icicle-search-in-context-default-fn,
;; icicle-search-highlight-and-maybe-replace:
;; Rename arg REPLACE-STRING to REPLACEMENT (it can now be a function).
;; icicle-search-highlight-and-maybe-replace: Test stringp before string= (can be a function now).
;; icicle-search-replace-search-hit, icicle-search-replace-all-search-hits:
;; Pass current-prefix-arg to icicle-search-define-replacement.
;; icicle-search-replace-match: First arg can now be a function. If it is, get replacement string
;; by applying it to the match string.
;; icicle-search: Updated doc string for possibility of using a function for replacement.
;; 2015/02/20 dadams
;; icicle-Info-multi-read-node-name, icicle-search-highlight-all-input-matches:
;; Do not initialize STRG/INPUT if it is non-nil.
;; 2015/01/11 dadams
;; icicle-imenu-1: Bind icicle-remove-icicles-props-p to nil (for property icicle-whole-candidate).
;; 2014/12/28 dadams
;; Require completion.el at compile time.
;; icicle-marker+text: Prefix buffer name with line number.
;; icicle-imenu-(command|non-interactive-function)(-full): Use icicle-alist-key-match, not assoc.
;; 2014/11/28 dadams
;; Added: icicle-goto-any-marker.
;; icicle-goto-marker-or-set-mark-command: C-0 is now icicle-goto-any-marker.
;; icicle-goto-marker-1:
;; Handle symbol all as arg. Pass buffers or symbol global, not rings, to icicle-markers.
;; Remove duplicates.
;; icicle-marker+text: No-op if MARKER buffer is invalid.
;; icicle-markers: Arg is now BUFFERS, not a marker ring: the symbol global or a list of buffers.
;; 2014/10/19 dadams
;; icicle-Info-index: Updated doc string for highlighting of visited nodes.
;; 2014/10/17 dadams
;; icicle-this-command-keys-prefix:
;; If in minibuffer, ignore prefix key of icicle-key-complete-keys-for-minibuffer.
;; icicle-same-vector-keyseq-p:
;; Wrap with (kbd (key-description before comparing, to treat as same: [ESC ...], [27 ...].
;; 2014/10/15 dadams
;; icicle-imenu-1: Add contents of imenu-after-jump-hook to icicle-search-hook.
;; 2014/09/02 dadams
;; icicle-search-replace-match: Temporary (?) fix for braindead Emacs 24.4 regression (bug #18388).
;; 2014/08/31 dadams
;; icicle-search-highlight-and-maybe-replace: Removed code that reset match data to
;; icicle-search-regexp when icicle-search-replace-whole-candidate-flag=nil. IOW, returned to
;; fix of 2013-12-10, removing unwise change of 2013-12-26 that treated nil case the same as
;; non-nil case. For nil case, need keep match data for current-input match.
;; 2014/08/24 dadams
;; icicle-search-bookmark, icicle-search-bookmarks-together: Better prompt for context regexp.
;; icicle-search-bookmark: Bind icicle-bookmark-completing-p.
;; 2014/08/23 dadams
;; icicle-search-regexp-scan: Add each context number and total number to icicle-mode-line-help.
;; 2014/08/22 dadams
;; icicle-pick-color-by-name(-1): Added optional arg MSGP. Show message if non-nil.
;; 2014/08/21 dadams
;; Added: icicle-pick-color-by-name-1 - from icicle-pick-color-by-name-action.
;; icicle-pick-color-by-name: Bind icicle-list-use-nth-parts. Use icicle-pick-color-by-name-1.
;; icicle-pick-color-by-name-action: If palette is not shown, do not try to redisplay it.
;; Use icicle-pick-color-by-name-1.
;; icicle-color-from-multi-completion-input: Removed bindings of icicle-list-*.
;; icicle-bookmark-tagged(-other-window): Bind icicle-bookmark-completing-p.
;; 2014/08/18 dadams
;; icicle-choose-(in)visible-faces: Bind icicle-face-completing-p.
;; 2014/08/17 dadams
;; Added: icicle-color-from-multi-completion-input.
;; icicle-read-color: Wrap call to icicle-read-color-WYSIWYG in condition-case. Removed all of the
;; rest of the code, except check for empty input.
;; icicle-read-color-WYSIWYG: Just call icicle-color-from-multi-completion-input, to handle input.
;; icicle-pick-color-by-name: Redefined as defun, not using icicle-define-command.
;; Use icicle-read-color. Bind icicle-color-completing-p.
;; icicle-pick-color-by-name-action: Redefined to use icicle-color-from-multi-completion-input.
;; Added M-c binding for palette.
;; icicle-widget-color-complete: Bind icicle-color-completing.
;; 2014/08/16 dadams
;; Renamed: icicle-read-color-wysiwyg to icicle-read-color-WYSIWYG.
;; icicle-read-color-WYSIWYG: Bind icicle-color-completing-p.
;; icicle-imenu-1: Fixed bug introduced 2014/06/21: Set REGEXP from SUBMENU.
;; 2014/08/12 dadams
;; Added: icicle-wide-n, icicle-wide-n-action.
;; 2014/08/10 dadams
;; Added: icicle-describe-package.
;; Moved to icicles-fn.el (and modified): icicle-defined-thing-p.
;; icicle-choose-faces: Bind icicle-face-completing-p.
;; 2014/08/06 dadams
;; icicle-complete-keys, icicle-complete-menu-bar:
;; Bind icicle-must-pass-after-match-predicate to nil. (M-x ESC S-TAB did not complete.)
;; 2014/07/31 dadams
;; icicle-complete-keys-action: Do not use icicle-orig-buff, icicle-orig-window) - not bound.
;; See change-log entry for 2014/02/24. Must have forgotten to finish that change by doing this.
;; 2014/07/28 dadams
;; icicle-complete: Added sort orders. Bind completion-ignore-case.
;; 2014/07/27 dadams
;; Added: icicle-complete: Icicles version of command complete from completion.el.
;; 2014/06/21 dadams
;; icicle-imenu-1: Handle multiple submenus with the same name (e.g. Functions).
;; 2014/06/19 dadams
;; icicle-apply, icicle-search:
;; Added note to doc string about binding *-incremental-completion to always.
;; 2014/05/17 dadams
;; icicle-color-help, icicle-tags-search: with-output-to-temp-buffer -> icicle-with-help-window.
;; 2014/05/11 dadams
;; icicle-WYSIWYG-font:
;; Fixed wrt Emacs bug #17457: Do not truncate before calling font-info, and ignore its errors.
;; Distinguish, for user, font-info error from its nil return (font not loaded).
;; 2014/04/20 dadams
;; icicle-synonyms: Use icicle-sort-comparer, not icicle-sort-function (typo).
;; Removed some old $$$$$ comments (cleanup).
;; 2014/04/01 dadams
;; Added: icicle-bookmark-tagged, icicle-bookmark-tagged-other-window.
;; icicle-search-bookmark:
;; Faces icicle-annotation & icicle-msg-emphasis, not file-name-shadow & bookmark-menu-heading.
;; 2014/03/30 dadams
;; icicle-find-file-tagged(-other-window): Rebind icicle-candidate-help-fn to appropriate help fn.
;; 2014/03/08 dadams
;; Use (featurep 'icomplete), not (boundp 'icomplete-mode), everywhere.
;; 2014/03/03 dadams
;; icicle-search-xml-element: Try to handle attributes and <ELTNAME/> too.
;; 2014/02/24 dadams
;; icicle-complete-keys, icicle-complete-menu-bar:
;; Do not bind icicle-orig-buff or icicle-orig-window - they are the minibuffer buf & window.
;; 2014/02/07 dadams
;; Added: icicle-same-vector-keyseq-p.
;; icicle-this-command-keys-prefix:
;; Respect new option icicle-complete-keys-ignored-prefix-keys.
;; Use this-command-keys-vector, not this-command-keys.
;; 2014/01/14 dadams
;; icicle-compilation-search-in-context-fn:
;; Wrap body in condition-case, so can tolerate non-error lines as no-op in compilation buffer.
;; 2014/01/11 dadams
;; icicle-this-command-keys-prefix:
;; Reverted change made 2013/12/01. S-TAB following any prefix key should complete that key.
;; 2014/01/06 dadams
;; icicle-vardoc, icicle-fundoc, icicle-plist, icicle-doc:
;; Bind icicle--last-toggle-transforming-msg.
;; 2014/01/05 dadams
;; Added: icicle-next-font-lock-keywords, icicle-next-font-lock-keywords-repeat,
;; icicle-font-lock-keyword, icicle-update-f-l-keywords.
;; 2013/12/26 dadams
;; icicle-hide/show-comments: Updated from hide/show-comments in hide-comnts.el.
;; 2013/12/23 dadams
;; Added: icicle-load-library.
;; Moved icicle-named-colors defvar inside icicle-cmd2-after-load-hexrgb.
;; 2013/12/10 dadams
;; Added: icicle-search-regexp.
;; icicle-search-define-candidates-1: Set icicle-search-regexp.
;; icicle-search-highlight-and-maybe-replace:
;; Search for main regexp, to set match data for replace-match (via icicle-search-replace-match).
;; 2013/12/01 dadams
;; icicle-this-command-keys-prefix: Use [] as prefix key if this command is icicle-complete-keys.
;; 2013/11/17 dadams
;; Added: icicle-occur-dired-marked, icicle-occur-dired-marked-recursive,
;; icicle-search-dired-marked, icicle-search-dired-marked-recursive-1.
;; icicle-search-generic: Added optional PREFIX-ARG argument. Bind icicle-pref-arg to it.
;; icicle-search, icicle-search-where-arg:
;; Bind current-prefix-arg to icicle-pref-arg, so can get pref arg from icicle-search-generic.
;; icicle-search-dired-marked*: Use icicle-search-dired-marked-recursive-1.
;; 2013/10/18 dadams
;; Added: icicle-imenu-help.
;; icicle-imenu: Bind icicle-candidate-help-fn to icicle-imenu-help.
;; icicle-search: Respect an existing value of icicle-candidate-help-fn.
;; 2013/10/02 dadams
;; icicle-next-visible-thing-1: Put back <=, not <, for comparison. See comment.
;; 2013/09/29 dadams
;; icicle-search-char-prop-matches-p: Typo: isearchp-some -> icicle-some.
;; 2013/09/21 dadams
;; icicle-search-char-prop-matches-p: Corrected for overlays: only overlays, not get-char-property.
;; 2013/09/16 dadams
;; icicle-search-regexp-scan:
;; If icicle-search-complement-domain-p then PREDICATE should not succeed.
;; 2013/09/11 dadams
;; icicle-Info-multi-read-node-name: Bind case-fold-search to t in filter function for NODES.
;; 2013/09/06 dadams
;; Added: icicle-imenu-macro-full.
;; icicle-imenu-*-full: First arg to icicle-imenu-1 should just be non-nil.
;; icicle-imenu-non-interactive-function: Emacs Lisp only, not Lisp mode too.
;; icicle-imenu-macro-full: Typo: Macro -> Macros.
;; 2013/08/13 dadams
;; icicle-where-is: Bind icicle-highlight-input-completion-failure to nil if no prefix arg.
;; 2013/07/24 dadams
;; icicle-exchange-point-and-mark: Use region-(beginning|end), not mark function - simpler.
;; icicle-next-visible-thing(-and-bounds): Use buffer limit if region is empty.
;; 2013/07/23 dadams
;; icicle-Info-multi-read-node-name: Use regexp-quote before concat ^ to front of string.
;; 2013/07/09 dadams
;; Added: icicle-complete-menu-bar.
;; icicle-add-key+cmd: Corrected menu-item description: Always use MITEM if available.
;; icicle-complete-(keys|menu-bar): Made case-insensitive by default.
;; 2013/07/07 dadams
;; icicle-add-key+cmd: Use face icicle-key-complete-menu(-local) for menu items.
;; 2013/07/04 dadams
;; Use icicle-read-regexp, not read-string, for reading all regexps.
;; 2013/06/19 dadams
;; Added: icicle-WYSIWYG-font. Removed (commented out): icicle-font-w-orig-size.
;; icicle-font: Rewrote, to show WYSIWYG candidates.
;; 2013/03/26 dadams
;; icicle-Info-multi-read-node-name: setq STRG only if it is nil.
;; icicle-Info-goto-node-of-content: Do not bother to bind icicle-candidate-properties-alist.
;; 2013/03/23 dadams
;; Renamed icicle-Info-goto-node to icicle-Info-goto-node-no-search.
;; Added: icicle-Info-goto-node (new version) - use *-of-content or *-no-search.
;; icicle-Info-menu-cmd: Use icicle-Info-goto-node-no-search, not new icicle-Info-goto-node.
;; icicle-Info-content-match: Set Info-tag-table-marker to saved position.
;; icicle-Info-read-node-of-content: Save position of Info-tag-table-marker for *-content-match.
;; 2013/03/17 dadams
;; Added: icicle-Info-goto-node-of-content, icicle-Info-apropos-complete-match,
;; icicle-Info-content-match, icicle-Info-read-node-of-content,
;; icicle-Info-multi-read-node-name,
;; 2013/03/16 dadams
;; icicle-Info-goto-node-action: Give focus back to minibuffer frame at end.
;; icicle-Info-read-node-name: Retain INCLUDE-FILE-P arg in recursive call.
;; 2013/03/15 dadams
;; Removed: icicle-Info-book-order-p (just ensure book order as default order).
;; icicle-Info-goto-node:
;; Bind icicle-pref-arg, so it is available in icicle-Info-goto-node-action.
;; Use nil, not icicle-Info-book-order-p, in icicle-sort-orders-alist and icicle-sort-comparer.
;; icicle-Info-goto-node-1: Use natnump as ARG test.
;; icicle-Info-build-node-completions-1: Ensure result is in book order, whatever Emacs version.
;; icicle-Info-build-node-completions: Do not do any reversing, since *-1 now uses book order.
;; icicle-Info-goto-node-action: Pass icicle-pref-arg to icicle-Info-goto-node-1 (bug fix).
;; Do not reverse list.
;; 2013/03/07 dadams
;; Updated to use icicle-user-error where appropriate.
;; 2013/02/28 dadams
;; icicle-cmd2-after-load-hexrgb, icicle-cmd2-after-load-wid-edit+:
;; Use fset, not defalias, for redefinitions of read-color, widget-color-complete.
;; 2013/02/04 dadams
;; Removed all autoload cookies.
;; 2013/01/06 dadams
;; icicle-(bookmark|(un)tag)-a-file: Updated calls to bmkp-*, to add nil NO-UPDATE-P argument.
;; 2013/01/05 dadams
;; icicle-find-file-(all|some)-tags*: protect free vars in lambdas using backquote quote comma.
;; icicle-(bookmark-a-file|find-file-tagged|): Updated doc string for new C-x C-t bindings.
;; 2012/12/31 dadams
;; icicle-search-in-context-default-fn:
;; Set icicle-mode-line-help instead of using icicle-show-help-in-mode-line.
;; 2012/12/22 dadams
;; Added: icicle-search-file-found-p.
;; icicle-search-define-candidates:
;; Search only files that have at least one regexp match: use icicle-search-file-found-p to test.
;; 2012/11/28 dadams
;; icicle-(fundoc|vardoc|plist): Use C-$ to toggle command/fn, option/var, faces/all.
;; icicle-vardoc: Do not use non-neg prefix arg for options.
;; icicle-doc: Be able to use C-$ to limit to commands, options, and faces.
;; Correction: separate setq in and, in case icicle-fn-doc-minus-sig returns nil.
;; 2012/11/20 dadams
;; icicle-search-define-candidates:
;; Added progress message for context gathering. Thx to Michael Heerdegen.
;; 2012/11/10 dadams
;; icicle-defined-thing-p: icicle-get-safe -> get.
;; icicle-read-color-wysiwyg:
;; Fix case where user inputs name or RGB without completing (transformed to "").
;; Mention sorting in doc string.
;; 2012/11/08 dadams
;; icicle-defined-thing-p: Use icicle-get-safe.
;; Doc strings: Use \\[...] more.
;; 2012/11/05 dadams
;; Use \\[...] in doc strings instead of hard-coding, for some more keys.
;; 2012/11/03 dadams
;; Added: icicle-cmd2-after-load-wid-edit+. eval-after-load it for wid-edit+.el.
;; Use it for all of the widget stuff (take that out of icicle-cmd2-after-load-highlight).
;; 2012/10/26 dadams
;; icicle-search: Use \\[...] in doc string instead of hard-coding some of the keys.
;; 2012/10/22 dadams
;; icicle-Info-index: Bind *-transform-function to *-remove-duplicates. Emacs bug #12705.
;; 2012/10/20 dadams
;; icicle-read-color: Fix case where user inputs without completing (WYSIWYG transforms to "").
;; 2012/10/09 dadams
;; icicle-find-file-tagged*, icicle-read-color(-wysiwyg), icicle-frame-(bg|fg),
;; icicle-choose(-(in)visible)-faces, icicle-(var|fun)doc, icicle-plist,
;; icicle-goto-global-marker, icicle-occur, icicle-imenu-1,
;; icicle-search(-bookmark(s-together|list-marked)|-buffer|-file|-sentences|-paragraphs|-pages):
;; Bind icicle-multi-completing-p.
;; 2012/10/06 dadams
;; icicle-hide/show-comments: Call comment-normalize-vars first. Thx to Stefan Monnier.
;; 2012/09/08 dadams
;; icicle-apply: Override icicle-buffer-ignore-space-prefix-flag, not icicle-ignore-space-prefix*.
;; icicle-search: Remove mention of overriding icicle-ignore-space-prefix-flag.
;; icicle-choose-candidate-of-type: Remove binding of icicle-ignore-space-prefix-flag.
;; 2012/09/06 dadams
;; Use icicle-string-match-p.
;; 2012/09/05 dadams
;; Added: icicle-select-text-at-point.
;; 2012/08/21 dadams
;; tap-symbol-nearest-point -> symbol-nearest-point. (icicles-opt.el DTRT.)
;; 2012/08/18 dadams
;; symbol-nearest-point -> tap-symbol-nearest-point.
;; bounds-of-thing-at-point -> icicle-bounds-of-thing-at-point.
;; next-visible-thing-(1|2) -> thgcmd-next-visible-thing-(1|2).
;; next-visible-thing-1: Note: < seems better than <= for comparison. I changed it to < for
;; Icicles version on 2011-05-14. But just changed the thing-cmd.el version to < today.
;; 2012/08/14 dadams
;; icicle-cmd2-after-load-highlight:
;; For Emacs < 24, require wid-edit.el before defalias to widget-color-complete.
;; 2012/08/12 dadams
;; icicle-read-color-wysiwyg: Convert raw prefix arg `-' to -1.
;; 2012/08/06 dadams
;; Renamed old-* to icicle-ORIG-*:
;; icicle-ORIG-color, icicle-ORIG-read-color, icicle-ORIG-widget-color-complete.
;; icicle-Info-index(-20|-action), icicle-Info-menu, icicle-Info-goto-node-1:
;; Applied renaming to new: icicle-ORIG-*.
;; 2012/08/05 dadams
;; Added: widgets icicle-color, old-color. Added function icicle-widget-color-complete.
;; icicle-read-color-wysiwyg:
;; Added optional arg INITIAL-INPUT.
;; Return only variable's value if user-option candidate is chosen.
;; 2012/07/17 dadams
;; Removed: icicle-maybe-byte-compile-after-load (macro). Removed all calls to it.
;; 2012/07/07 dadams
;; icicle-Info-index:
;; Bind icicle-Info-(index-nodes|manual|hist-list), for highlighting visited nodes.
;; Raise error if not in Info-mode.
;; 2012/07/02 dadams
;; Moved defcustom of icicle-byte-compile-eval-after-load-flag to icicles-mcmd.el (loaded first).
;; icicle-search-bookmark(-action): Use *-search-context-regexp, not regexp, so no free warning.
;; Changed #'(lambda...) to (lambda...).
;; 2012/05/22 dadams
;; icicle-search-define-candidates, icicle-char-properties-in-buffers:
;; Test with icicle-file-remote-p before file-exists-p, to avoid Tramp.
;; 2012/05/15 dadams
;; Removed: icicle-search-desktop-bookmark (useless).
;; 2012/05/07 dadams
;; Renamed: icicle-search-dired-marked to icicle-search-dired-marked-recursive.
;; 2012/05/06 dadams
;; icicle-search-dired-marked: Call diredp-get-confirmation-recursive to get confirmation.
;; 2012/04/23 dadams
;; icicle-search-dired-marked: Use diredp-get-files. Raise error if Dired+ not present.
;; Moved other icicle-search-dired-* functions to Dired+ as diredp-*.
;; icicle-search-dired-get-files:
;; If user answers no, then pick up only the marked files here 9and all files underneath).
;; icicle-search-dired-get-files-for-dir: A no answer does not change what happens for top dir.
;; 2012/04/20 dadams
;; Added: icicle-search-dired-get-files-for-dir, icicle-search-dired-marked-here.
;; icicle-search-dired-marked:
;; Added arg IGNORE-MARKS-P (prefix arg). Pass it to icicle-search-dired-get-files.
;; icicle-search-dired-get-files: Rewrote - uses icicle-search-dired-get-files-for-dir.
;; Ask user whether to use Dired buffers for subdirs, if there are any.
;; 2012/04/14 dadams
;; icicle-search-dired-get-files: Moved handling of IGNORE-MARKS-P outside the lambda.
;; 2012/04/13 dadams
;; Added: icicle-search-dired-get-files.
;; icicle-search-dired-marked: Use icicle-search-dired-get-files, not dired-get-marked-files.
;; 2012/04/09 dadams
;; Changed last-command-char to last-command-event.
;; Fixed typos: double single-quotes in autoload cookies.
;; 2012/04/08 dadams
;; Make autoload cookies for commands load icicles[.el] explicitly.
;; 2012/04/03 dadams
;; Moved to *-cmd1.el:
;; icicle-send-signal-to-process, icicle-apropos, icicle-apropos-command, icicle-apropos-function,
;; icicle-apropos-option, icicle-apropos-options-of-type, icicle-apropos-variable,
;; icicle-apropos-zippy, icicle-apropos-opt-action, icicle-describe-option-of-type,
;; icicle-describe-opt-action, icicle-describe-opt-of-type-complete.
;; Plus compile-time requires of libraries yow, cookie1, apropos-fn+var.
;; 2012/04/01 dadams
;; Added: icicle-apropos-options-of-type, icicle-apropos-opt-action.
;; icicle-where-is: In help fn, wrap individual key sequences in `', not just all of them together.
;; 2012/03/31 dadams
;; icicle-apropos*: Updated wrt Emacs 24 (handle PATTERN). Added optional MSGP arg.
;; 2012/03/28 dadams
;; Changed FILE arg in autoloads by removing .el, so .elc will be loaded if available.
;; 2012/03/10 dadams
;; icicle-bookmark-a-file, icicle-find-file-tagged(-other-window): Bind icicle-full-cand-fn.
;; icicle-find-file-(handle-bookmark|(all|some)-tags(-regexp))(-other-window):
;; First code, last code: Call icicle-(un)bind-file-candidate-keys.
;; icicle-search-bookmark: Use icicle-make-bookmark-candidate to define icicle-candidates-alist.
;; 2012/03/09 dadams
;; icicle-untag-a-file, icicle-find-file-(all|some)-tags(-regexp)(-other-window), icicle-where-is,
;; icicle-apropos-(variable|option|function|command), icicle-apply,
;; icicle-save-string-to-variable, icicle-choose-candidate-of-type,
;; icicle-read-var-value-satisfying, icicle-read-args-for-set-completion-methods:
;; When Icomplete mode, use normal PRED, not *-must-pass-after-match-predicate.
;; icicle-find-file-handle-bookmark(-other-window): Use bmkp-find-file(-other-window) as action fn.
;; 2012/02/26 dadams
;; Update to reflect Bookmark+ changes (bindings etc.).
;; Added icicle-find-file-handle-bookmark(-other-window), as nontagging C-f commands.
;; icicle-find-file-tagged*: Use bmkp-find-file*, not find-file*, as action fn.
;; Pass prefix arg to bmkp-read-tags-completing, to update cache.
;; 2012/02/20 dadams
;; Added: icicle-Info-menu-cmd. Actually, renamed icicle-Info-menu to icicle-Info-menu-cmd and
;; added non-interactive icicle-Info-menu with args for compatibility with vanilla Emacs.
;; icicle-Info-index: Added optional arg for non-interactive compatibility with vanilla Emacs.
;; 2012/02/12
;; Added def of icicle-byte-compile-eval-after-load-flag here too, so can load before icicles.el.
;; 2012/02/11 dadams
;; icicle-search: Update doc string for new input expansion.
;; icicle-search-highlight-all-input-matches:
;; Expand when apropos and 4 or prefix and 3 or 4.
;; 2012/01/25 dadams
;; icicle-exchange-point-and-mark: Support also vanilla Emacs 22+ use of a prefix arg.
;; 2012/01/16 dadams
;; icicle-search-define-candidates: Add COMPLEMENT to error msg. Thx to Michael Heerdegen.
;; 2011/12/19 dadams
;; icicle-marker+text, icicle-compilation-search-in-context-fn: Use line-(beginning|end)-position.
;; 2011/12/14 dadams
;; icicle-search-where-arg: Do not bind icicle-bookmark-types here.
;; icicle-search-define-candidates: For bookmarks, WHERE is a cons of conses (not just a cons).
;; 2011/12/13 dadams
;; icicle-search-define-candidates: In bookmarks part, test BEG =? END only if both are non-nil.
;; 2011/12/06 dadams
;; icicle-send-signal-to-process: Add process name to prompt. Thx to Michael Heerdegen.
;; 2011/11/26 dadams
;; Renamed icicle-read-color to icicle-read-color-wysiwyg.
;; Added icicle-read-color (args compatible with vanilla read-color), for *-functions-to-redefine.
;; icicle-read-color-wysiwyg: Added MSGP arg. Updated hexrgb-read-color call (new arg list).
;; icicle-color-help: Corrected for different cases of icicle-list-use-nth-parts (not just (1 2)).
;; icicle-color-distance-(rgb|hsv)-lessp, icicle-choose-candidate-of-type:
;; Applied renaming: icicle-read-color-wysiwyg.
;; 2011/11/02 dadams
;; Added: icicle-search-autonamed-bookmark, icicle-search-temporary-bookmark.
;; *-full search commands:
;; Corrected doc strings to refer to the right option, icicle-hide-non-matching-lines-flag.
;; 2011/10/22 dadams
;; icicle-send-signal-to-process:
;; Bind icicle-last-transform-function to nil, so icicle-toggle-transforming still works well.
;; 2011/10/21 dadams
;; icicle-read-color, icicle-where-is, icicle-apply((-list)-action), icicle-search-thing-args,
;; icicle-set-completion-methods-for-command:
;; Use icicle-propertize.
;; 2011/10/19 dadams
;; Added: icicle-describe-process, icicle-send-signal-to-process. Thx to Michael Heerdegen.
;; 2011/10/10 dadams
;; icicle-define-search-bookmark-command: Moved to icicles-mac.el.
;; Moved here (and to icicles-face.el) from icicles-mac.el: icicle-maybe-byte-compile-after-load.
;; Replaced bodies of eval-after-load sexps with call to icicle-cmd2-after-load-*.
;; Added: icicle-cmd2-after-load-(bookmark+'|hexrgb|highlight|palette|synonyms).
;; Removed: icicle-read-single-key-description (unused).
;; 2011/10/08 dadams
;; Moved to icicles-mac.el: icicle-read-kbd-macro, icicle-edmacro-parse-keys.
;; Removed: icicle-orig-(buff|win)-key-complete - use regular icicle-orig*.
;; icicle-complete-keys: Bind regular icicle-orig*, not icicle-orig-(buff|win)-key-complete.
;; icicle-complete-keys-1: New icicle-key-description, with PREFIX arg and ANGLES, not NO-ANGLES.
;; icicle-complete-keys-action: Set buffer & window to icicle-orig*.
;; icicle-keys+cmds-w-prefix: Use icicle-delete-alist-dups. Thx to Michael Heerdegen.
;; icicle-add-key+cmd:
;; Do not follow indirection to ultimate symbol. Include NO-REMAP arg to key-binding.
;; Replace ESC by M-.. Follow remapped command to its target. Thx to Michael Heerdegen.
;; Do not remove VARIATION* names (Unicode).
;; icicle-read-single-key-description: Change NO-ANGLES arg to ANGLES.
;; icicle-where-is: Use icicle-key-description, not key-description.
;; icicle-Info-(index|read-node-name), icicle-search-bookmark, palette-mode-map: Use icicle-kbd.
;; 2011/10/02 dadams
;; icicle-add-key+cmd:
;; Use Unicode char name in place of self-insert-command. Remove empty and VARIATION* names.
;; 2011/09/27 dadams
;; Added: icicle-search-modes (macro).
;; icicle-search-where-arg: Use icicle-search-modes - handle zero prefix arg.
;; icicle-(occur|sentences|paragraphs|pages), Use *-search-where-arg, to search files & bookmarks.
;; icicle-search-define-candidates: Use nil for BEG and END if region is empty.
;; Thx to Michael Heerdegen.
;; 2011/09/18 dadams
;; Added: icicle-search-property-default-match-fn. Handles MuMaMo major mode zones.
;; icicle-search-char-prop-matches-p. Doesn't just flatten overlay & text props and use
;; set intersect. Uses icicle-some with MATCH-FN.
;; Moved to icicles-fn.el: icicle-flat-list (no longer used).
;; Moved to icicles-cmd1.el: icicle-(keyword|regexp)-list.
;; icicle-color-completion-setup: Ensure icicle-prompt is a string before adding property.
;; icicle-search-where-arg, icicle-search-choose-buffers, icicle-search-(buffer|file):
;; Bind icicle-prompt.
;; icicle-search-char-property: Added arg MATCH-FN. Add it to the return value.
;; icicle-search-(overlay|text)-property:
;; Added arg MATCH-FN (pass to icicle-search). Made all args mandatory.
;; icicle-search-text-property: When PROP is face, call font-lock-fontify-region.
;; icicle-search-property-args:
;; Bind match-fn to icicle-search-property-default-match-fn. Add it to return value.
;; Bind icicle-prompt and icicle-hist-var.
;; For values: for non-face prop, use icicle-sexp-list, not icicle-completing-read-history.
;; icicle-search-char-property-scan:
;; Added arg MATCH-FN. Use icicle-search-char-prop-matches-p.
;; Extend zone if matching prop values also in contiguous zone.
;; icicle-search-(regexp|thing)-scan, icicle-search-highlight-input-matches-here,
;; icicle-search-char-property-scan:
;; Handle t value for icicle-search-highlight-threshold.
;; 2011/09/09 dadams
;; icicle-search-w-isearch-string: Added prefix-arg treatment.
;; 2011/09/08 dadams
;; Added: icicle-search-w-isearch-string, from a lambda in icicles-mode.el.
;; 2011/09/05 dadams
;; icicle-imenu-*: Others -> Other, as submenu name.
;; icicle-search, icicle-imenu*-full: Mention C-x . in doc strings.
;; 2011/09/04 dadams
;; icicle-add-key+cmd: Handle Emacs 23+ consp char-range events, for self-insert.
;; Applied renaming of icicle-complete-keys-self-insert-flag to *-ranges.
;; Removed: icicle-insert-char.
;; 2011/09/02 dadams
;; Removed: icicle-Info-index-cmd, icicle-Info-menu-cmd, icicle-Info-goto-node-cmd.
;; icicle-Info-index(-20|-action): Use old-Info-index.
;; icicle-Info-goto-node-1: Use old-Info-goto-node.
;; 2011/08/27 dadams
;; icicle-search-char-property-scan: Added optional ACTION arg. Move hit-end after ACTION.
;; Added: icicle-imenu-1. Created from old icicle-imenu*, but: (1) added args FULLP for full,
;; SUBMENU-FN to pick submenu, (2) pass PREDICATE and pos after forward-sexp for FULLP.
;; icicle-imenu, icicle-imenu-command: Use icicle-imenu-1.
;; Added: icicle-imenu(-command|-non-interactive-function)-full, icicle-search-defs-full,
;; icicle-imenu-(macro|variable|user-option|face|key-(implicit|explicit)-map)(-full),
;; icicle-apply-action, icicle-apply-list-action, icicle-search-regexp-scan,
;; icicle-search-action-1, icicle-search-bookmark, icicle-define-search-bookmark-command,
;; icicle-search-thing-scan, icicle-search-char-property-scan:
;; Use icicle-condition-case-no-debug instead of condition-case. Thx to Michael Heerdegen.
;; 2011/08/26 dadams
;; icicle-imenu:
;; When multiple Others menus, name them uniquely.
;; When only one submenu, just use it (no choosing).
;; icicle-complete-keys-action: Removed useless condition-case.
;; Make sure to pass format string as first arg to calls to functions error and message.
;; 2011/08/17 dadams
;; icicle-search-thing-scan: Use correct code (not 1+) also if thingatpt+.el is loaded.
;; icicle-search-regexp-scan: Quit while loop if no more match, except if complementing.
;; icicle-search-read-context-regexp, icicle-search-(thing|property)-args, icicle-tags-search:
;; Change prompt when complementing (add: *NOT*).
;; 2011/08/16 dadams
;; icicle-maybe-byte-compile-after-load the eval-after-load definitions.
;; 2011/08/14 dadams
;; icicle-search-thing-scan: Handle icicle-search-complement-domain-p.
;; Updated doc strings of search commands to mention complementing.
;; icicle-imenu(-command|-non-interactive-function), icicle-complete-keys-1:
;; Replaced mapc with dolist so do not require cl.el at runtime (Emacs 20).
;; icicle-imenu: Ignore case when completing to the type (function etc.).
;; 2011/08/13 dadams
;; Added: icicle-bookmark-a-file.
;; icicle-search-regexp-scan, icicle-search-char-property-scan:
;; Handle icicle-search-complement-domain-p.
;; 2011/08/12 dadams
;; icicle-find-file-tagged(-other-window):
;; Bind icicle-full-cand-fn. Use icicle-file-bindings.
;; Use icicle-(un)bind-file-candidate-keys. Don't do/undo such bindings individually here.
;; 2011/08/09 dadams
;; icicle-find-file-tagged(-other-window): Bind C-x a [+-] to adding/removing tags.
;; icicle-define(-file)-command calls: Removed undo code if same as last code, so do not repeat it.
;; 2011/08/08 dadams
;; icicle-find-file-tagged(-other-window): Prefix arg means use all (not just tagged) autofiles.
;; 2011/08/07 dadams
;; Added: icicle-find-file-tagged(-other-window).
;; 2011/08/05 dadams
;; icicle-(un)tag-a-file: Bind icicle-use-candidates-only-once-flag to t.
;; 2011/07/31 dadams
;; Added: icicle-search-xml-element-text-node.
;; icicle-search-thing(-scan): Added TRANSFORM-FN arg.
;; icicle-search-define-candidates: Added message when only one candidate.
;; 2011/07/30 dadams
;; Moved here from icicles-cmd1.el and wrapped in eval-after-load bookmark+.el:
;; icicle-find-file-(all|some)-tags(-regexp)(-other-window), icicle-(un)tag-a-file.
;; Moved here from synonyms.el and wrapped in eval-after-load synonyms.el: (icicle)-synonyms.
;; Moved here from icicles-fn.el and wrapped in eval-after-load hexrgb.el:
;; icicle-color-*-lessp (except -rgb-), icicle-color-completion-setup, icicle-color-help,
;; icicle-make-color-candidate.
;; Soft-require hexrgb.el only when byte-compile.
;; icicle-frame-(bg|fg), icicle-read-color: Wrap in eval-after-load hexrgb.el.
;; icicle-(insert|complete)-thesaurus-entry(-cand-fn): Wrap in eval-after-load synonyms.el.
;; icicle-choose(-(in)visible)-faces, icicle-(hide|show)(-only)-faces:
;; Use eval-after-load highlight.el, not featurep.
;; icicle-pick-color-by-name(-action), palette keys: Use eval-after-load palette.el, not featurep.
;; 2011/07/27 dadams
;; icicle-search-read-word: Changed regexp to what vanilla Emacs uses for word search.
;; icicle-search(-word): Updated doc string wrt word search.
;; 2011/07/26 dadams
;; Removed: icicle-list-end-string (no longer needed). Thx to Michael Heerdegen.
;; 2011/07/24 dadams
;; Moved here from palette.el, and renamed with prefix icicle-:
;; icicle-pick-color-by-name, icicle-pick-color-by-name-action
;; Moved here from highlight.el, and renamed with prefix icicle- (from hlt-) and suffix -faces:
;; icicle-(hide|show)(-only)-faces, icicle-choose(-(in)visible)-faces.
;; Added: icicle-invisible-face-p.
;; icicle-choose(-(in)visible)-faces: Corrected:
;; Lax if icicle-WYSIWYG-Completions-flag. Put icicle-fancy-candidates on prompt.
;; Use icicle-list-*, for multi-completions. Use icicle-invisible-face-p to test invisibility.
;; Added eval-when-compile with soft requires for bookmark+.el and highlight.el.
;; 2011/07/18 dadams
;; icicle-search-thing, icicle-search-thing-scan:
;; Moved normalizing BEG, END to *-scan, for multiple buffers case. Thx to M. Heerdegen.
;; 2011/07/13 dadams
;; icicle-search-replace-cand-in-mct: Changed <= to < for len-rep. Thx to M. Heerdegen.
;; 2011/07/04 dadams
;; icicle-search-in-context-default-fn:
;; Bound icicle-last-completion-candidate, icicle-completion-candidates. Thx to M. Heerdegen.
;; 2011/07/02 dadams
;; Added: icicle-defined-thing-p.
;; icicle-things-alist: Use icicle-defined-thing-p. Thx to Michael Heerdegen.
;; 2011/06/03 dadams
;; Replace icicle-help-in-mode-line-flag by icicle-help-in-mode-line-delay everywhere.
;; 2011/05/25 dadams
;; icicle-fundoc, icicle-vardoc, icicle-plist:
;; Use icicle-doc-action only. Bind icicle-list-use-nth-parts to (1). Thx to Michael Heerdegen.
;; 2011/05/24 dadams
;; icicle-invisible-p: Use invisible-p if available (Emacs 22+).
;; 2011/05/22 dadams
;; Added defvars for free vars to quiet byte compiler.
;; 2011/05/16 dadams
;; icicle-search-thing-args: Message about C-M-; when ignoring comments and THING is comment.
;; 2011/05/15 dadams
;; Added: icicle-search-xml-element.
;; icicle-search-thing, icicle-search-thing-scan: Added PREDICATE optional arg.
;; 2011/05/14 dadams
;; Added: icicle-things-alist.
;; icicle-search-thing-args, icicle-(next|previous)-visible-thing:
;; Use icicle-things-alist, not (now removed) option icicle-thing-types.
;; icicle-next-visible-thing-1: Change comparison to < from <=
;; Removed: icicle-defined-thing-p (not used).
;; 2011/05/13 dadams
;; Renamed: icicle-last-visible-thing-type to icicle-last-thing-type.
;; icicle-last-thing-type: Use thgcmd-last-thing-type value as default, if available.
;; icicle-search-thing: Ensure BEG is before END (swap if needed).
;; icicle-search-thing-args, icicle-(next|previous)-visible-thing:
;; Use completing-read, not read-string, to read thing type.
;; icicle-(next|previous)-visible-thing: Do not set this-command (no need).
;; icicle-search-thing-scan: Removed code defining BEG, END if nil. Go to BEG, not min BEG, END.
;; icicle-next-visible-thing-2: Do not return an empty thing.
;; 2011/05/11 dadams
;; Added: icicle-invisible-p, icicle-previous-single-char-property-change.
;; icicle-search-thing-scan:
;; Handle also text invisible due to overlay, and invisible prop other than t.
;; icicle-next-visible-thing-2: Separate handling overlay and text prop. Use icicle-invisible-p.
;; 2011/05/10 dadams
;; Added: icicle-last-visible-thing-type, icicle-previous-visible-thing,
;; icicle-next-visible-thing-(and-bounds|1|2).
;; Alias icicle-next-visible-thing-(1|2) to the same commands from thing-cmds.el.
;; icicle-search-thing-scan:
;; Use when, not while, to skip over invisible (since use next-single-property-change).
;; Use new icicle-next-visible-and-bounds, so save-excursion and goto min.
;; Old icicle-next-visible is now ~ *-2, but that handles backward too. New one is a command.
;; 2011/05/07 dadams
;; Added: icicle-with-comments-hidden, icicle-hide/show-comments, icicle-search-thing,
;; icicle-defined-thing-p, icicle-next-visible-thing, icicle-search-thing-args,
;; icicle-search-thing-scan.
;; icicle-search: Doc string tweak.
;; 2011/05/04 dadams
;; icicle-search-read-context-regexp: Changed prompt to make clear that we search within contexts.
;; icicle-search-define-candidates: Remove any region highlighting, so we can see search hits.
;; 2011/04/29 dadams
;; icicle-choose-candidate-of-type: Rewrote buffer bindings based on icicle-buffer-bindings.
;; 2011/04/26 dadams
;; Added: icicle-search-autofile-bookmark.
;; 2011/04/12 dadams
;; Added: icicle-search-bookmark-list-marked, icicle-named-colors.
;; icicle-search-bookmark, icicle-define-search-bookmark-command:
;; Applied Bookmark+ renaming: bmkp-sort-and-remove-dups -> bmkp-sort-omit.
;; icicle-comint-search: Improved doc string (don't use C-next etc.).
;; icicle-frame-(bg|fg), icicle-read-color: Rename free var named-colors to icicle-named-colors.
;; Bind it in icicle-frame-(bg|fg), icicle-read-color, for use in icicle-color-completion-setup.
;; 2011/04/04 dadams
;; icicle-insert-thesaurus-entry-cand-fn, icicle-goto-marker-1-action, icicle-search-final-act,
;; icicle-comint-search: Use icicle-recenter.
;; 2011/04/02 dadams
;; Added: icicle-info-(buff|window), icicle-key-prefix(-2), icicle-active-map,
;; Moved here from icicles-var.el:
;; icicle-orig-buff-key-complete, icicle-orig-extra-cands, icicle-orig-font, icicle-orig-frame,
;; icicle-orig-menu-bar, icicle-orig-pixelsize, icicle-orig-pointsize, icicle-this-cmd-keys,
;; icicle-orig-show-initially-flag, icicle-orig-sort-orders-alist, icicle-orig-win-key-complete.
;; icicle-Info-index(-goto-node)(-action):
;; Use (new) icicle-info-(buff|window), not info-(buff|window).
;; icicle-describe-option-of-type, icicle-describe-opt-of-type-complete:
;; Use (new) icicle-pref-arg, not pref-arg.
;; icicle-search: Bind (new) icicle-scan-fn-or-regexp.
;; Moved any alias inside emacs-major-version test.
;; icicle-complete-keys-1: Bind (new) icicle-key-prefix.
;; icicle-complete-keys-action: Use (new) icicle-key-prefix, not prefix.
;; icicle-keys+cmds-w-prefix: Bind (new) icicle-key-prefix-2. Use icicle-active-map, not map.
;; icicle-add-key+cmd: Use icicle-key-prefix-2 and icicle-active-map, not prefix and map.
;; 2011/03/31 dadams
;; icicle-describe-opt-of-type-complete: Wrap icicle-var-is-of-type-p with condition-case.
;; 2011/03/29 dadams
;; icicle-search-action-1: Set icicle-other-window. Use icicle-target-window-recenter-amount.
;; Use new icicle-* vars for various free vars (orig-buff etc.).
;; icicle-frame-(bg|fg), icicle-read-color: prompt -> icicle-prompt.
;; 2011/03/03 dadams
;; icicle-insert-thesaurus-entry: Changed to strict completion from lax.
;; icicle-describe-option-of-type, icicle-(fun|var)doc, icicle-plist:
;; Removed mention of RET in prompt.
;; 2011/02/17 dadams
;; Added defalias old-read-color for read-color.
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/12/18 dadams
;; Added more autoload cookies for commands. Thx to Richard Kim.
;; Specify command and file for commands defined by Icicles macros.
;; Require icicles-opt.el before icicles-var.el (but it makes no difference).
;; 2010/12/14 dadams
;; icicle-search-regexp-scan: Don't create marker if hit string is "".
;; icicle-search-highlight-all-input-matches:
;; Don't search within empty search contexts. Do nothing if input and expanded input are "".
;; If search doesn't advance point then forward-char. Stop searching if eobp.
;; Don't add (empty) overlay if search is empty.
;; icicle-search-highlight-context-levels: Don't add overlay for empty match.
;; icicle-search-highlight-input-matches-here: If search doesn't advance point then forward-char.
;; icicle-search-char-property-scan: Don't create empty overlays.
;; 2010/11/10 dadams
;; Added: icicle-read-args-for-set-completion-methods.
;; icicle-set-((S-)TAB|completion)-methods-for-command: Added METHODS arg.
;; 2010/11/09 dadams
;; Added: icicle-set-((S-)TAB|completion)-methods-for-command.
;; 2010/11/07 dadams
;; Applied renaming of icicle-all-candidates-action-p to icicle-all-candidates-action.
;; 2010/10/27 dadams
;; icicle-where-is: Use different prompt if prefix arg. Clarify the pref-arg diff in doc string.
;; 2010/10/25 dadams
;; icicle-search: Remove mention of icicle-search-context-match-predicate (no longer exists).
;; 2010/10/24 dadams
;; icicle-where-is, icicle-apropos-(variable|option|function|command), icicle-apply,
;; icicle-save-string-to-variable, icicle-choose-candidate-of-type,
;; icicle-read-var-value-satisfying:
;; Use icicle-must-pass-after-match-predicate, not PREDICATE arg.
;; 2010/10/09 dadams
;; icicle-Info-goto-node, icicle-apply, icicle-goto-marker, icicle-occur, icicle-complete-keys,
;; icicle-(comint|compilation)-search, icicle-search(-sentences|-paragraphs|-pages):
;; Updated doc string for new prefix and modal cycling keys.
;; 2010/07/17 dadams
;; Added: icicle-search-url-bookmark.
;; icicle-search-bookmark, icicle-define-search-bookmark-command: w3m -> url. Added C-M-u binding.
;; 2010/07/14 dadams
;; icicle-Info-index: Bind C-x m to icicle-bookmark-info-other-window.
;; icicle-Info-read-node-name: Restore original binding of C-x m, if any.
;; 2010/06/21 dadams
;; icicle-comint-search: Wrap search with unwind-protect to remove hook. Thx to M. Heerdegen.
;; 2010/06/18 dadams
;; icicle-search-replace-match: Specific error message for read-only buffer. Thx to M. Heerdegen.
;; Renamed: bookmarkp-* to bmkp-*.
;; 2010/06/12 dadams
;; icicle-goto-marker-or-set-mark-command:
;; Set this-command so C-SPC C-SPC activates when not t-m mode. Thx to Chris Hecker.
;; 2010/06/11 dadams
;; icicle-search-action-1: (unless (pos-visible-in-window-p) (recenter -2)). Thx to M. Heerdegen.
;; 2010/06/08 dadams
;; icicle-search-bookmark, icicle-define-search-bookmark-command:
;; Use icicle-bookmark-delete-action.
;; Use condition-case to filter out bad bookmarks (so no error).
;; 2010/06/04 dadams
;; Added: icicle-ido-like-mode.
;; 2010/05/16 dadams
;; Added: icicle-search-(all|some)-tags(-regexp)-bookmark, icicle-search-desktop-bookmark,
;; icicle-search-specific-(buffers|files)-bookmark, icicle-search-this-buffer-bookmark.
;; icicle-define-search-bookmark-command: Defined cmd requires bookmark+.el. Added &rest arg ARGS.
;; 2010/05/15 dadams
;; icicle-search-highlight-and-maybe-replace: If candidate number is nil, set to 0.
;; icicle-search: Updated doc string: Can sort. Don't say not to use C-|.
;; 2010/05/09 dadams
;; Icicles search: Change to allow sorting. Use mctized candidates, not alist + candidate nb.
;; icicle-search-highlight-and-maybe-replace:
;; Use *-replace-cand-in-mct, not *-replace-cand-in-alist. Do not *-input-matches-here.
;; icicle-search-replace-cand-in-mct: Rewrote.
;; Handle multi-completions also. Update CAND+MRKER to use replacement string, but keep props.
;; icicle-search-in-context-default-fn: Rewrote.
;; Update icicle-last-completion-candidate to current candidate. Insert that.
;; Recompute input-match highlighting in current context. Remove current if no candidates.
;; icicle-search-action-1: Do nothing if no candidates.
;; icicle-search-help: Bind icicle-whole-candidate-as-text-prop-p to t, not nil.
;; 2010/05/04 dadams
;; icicle-object-action: Pass TYP to icicle-apply-to-saved-candidate. (UNTESTED)
;; icicle-choose-anything-candidate: Pass TYPE to icicle-apply-to-saved-candidate. (UNTESTED)
;; icicle-apply, icicle-read-var-value-satisfying: Bug fix: Removed #'.
;; 2010/04/30 dadams
;; icicle-search: Delete icicle-search-current-overlay via icicle-no-match-hook (& restore hook).
;; 2010/04/29 dadams
;; icicle-apply: Added optional args predicate initial-input hist def inherit-input-method.
;; Pass them to icicle-explore.
;; icicle-goto-marker-1: Pass a PREDICATE arg that ensures the marker points somewhere.
;; 2010/04/25 dadams
;; icicle-complete-keys-action:
;; Bind icicle-*, esp. *-initially-flag, around call of this-command-keys. Thx to M. Heerdegen.
;; icicle-complete-keys: Save some icicle-* vars to reuse in icicle-complete-keys-action.
;; 2010/04/17 dadams
;; icicle-search-bookmark, icicle-define-search-bookmark-command:
;; Use icicle-transform-multi-completion in icicle-delete-candidate-object.
;; 2010/04/08 dadams
;; icicle-get-anything-candidates: Removed #' - it was preventing the fn from being functionp.
;; 2010/04/03 dadams
;; Removed: icicle-search-desktop-bookmark (no need).
;; 2010/04/02 dadams
;; Removed:
;; icicle-add-region, icicle-delete-region-from-alist, icicle-purge-bad-file-regions,
;; icicle-region-add-buffers, icicle-region-add-short-help, icicle-region-help,
;; icicle-region-open-all-files, icicle-regions, icicle-region-sorted,
;; icicle-remove-all-regions-action, icicle-remove-all-regions-in-buffer, icicle-remove-region,
;; icicle-search-all-regions, icicle-search-region(-action), icicle-select-region(-action).
;; Added:
;; icicle-search-bookmark-list-bookmark, icicle-search-bookmarks-together,
;; icicle-search-desktop-bookmark, icicle-search-dired-bookmark, icicle-search-man-bookmark.
;; icicle-exchange-point-and-mark, icicle-search(-define-candidates),
;; icicle-char-properties-in-buffers:
;; Use only region bookmarks, not Icicles saved regions.
;; icicle-exchange-point-and-mark: Negative prefix arg prompts for bookmark name.
;; icicle-search-define-candidates(-1): Raise the no-candidates error in parent, not in (-1).
;; icicle-search-bookmark: Use full multi-completions. Use bookmark sort orders.
;; Define narrowing keys in both minibuffer maps.
;; icicle-search-bookmark-action: Transform multi-completion. Use bookmark posns only for region.
;; icicle-define-search-bookmark-command: Added PROMPT arg. Use multi-completions, bookmark sorts.
;; 2010/03/28 dadams
;; Renamed: icicle-search-all-regions to icicle-search-region.
;; Removed: old icicle-search-region (use icicle-search-region-bookmark instead),
;; icicle-region-add-buffers, icicle-region-add-short-help, icicle-region-help,
;; icicle-region-sorted, icicle-region-open-all-files, icicle-add-region,
;; icicle-remove-region, icicle-delete-region-from-alist,
;; icicle-purge-bad-file-regions, icicle-remove-all-regions-(in-buffer|action).
;; icicle-search-all-regions: Use region bookmarks, not icicle-region-alist.
;; 2010/03/27 dadams
;; Added: icicle-search-(bookmark-list|desktop|dired|man)-bookmark.
;; icicle-search-bookmark: Use multi-completions.
;; icicle-search-bookmark-action:
;; Use icicle-transform-multi-completion. Use both minibuffer completion maps.
;; Search region if region bookmark.
;; icicle-define-search-bookmark-command: Added optional PROMPT arg. Use multi-completions.
;; 2010/03/13 dadams
;; Applied renaming of icicle-add-buffer-name-flag to icicle-show-multi-completion-flag.
;; 2010/03/09 dadams
;; icicle-regions: Use icicle-reversible-sort (with KEY arg), not sort.
;; 2010/03/03 dadams
;; Applied renamings: icicle-sort-function to icicle-sort-comparer
;; icicle-sort-functions-alist to icicle-sort-orders-alist,
;; icicle-alternative-sort-function to icicle-alternative-sort-comparer,
;; icicle-last-sort-function to icicle-last-sort-comparer.
;; 2010/02/06 dadams
;; icicle-where-is: Make sure orig-buff is current when look up the bindings.
;; 2010/01/12 dadams
;; icicle-insert-thesaurus-entry-cand-fn, icicle-marker+text,
;; icicle-search-(bookmark|region)-action, icicle-char-properties-in-buffer,
;; icicle-search-char-property-scan:
;; save-excursion + set-buffer -> with-current-buffer (+ save-excursion).
;; icicle-search-regexp-scan: set-buffer -> with-current-buffer.
;; 2009/12/13 dadams
;; icicle-Info-read-node-name: Bind C-x m to icicle-bookmark-info-other-window.
;; 2009/11/24 dadams
;; icicle-read-color: Copy the prompt string, so *-color-completion-setup can put props.
;; 2009/11/22 dadams
;; icicle-frame-(bg|fg): Don't apply *-make-color-candidate to named-colors (done already).
;; 2009/11/03 dadams
;; icicle-frame-(bg|fg): Use named-colors, not x-defined-colors.
;; icicle-read-color: No need to bind icicle-transform-function, since we use hexrgb.el.
;; 2009/09/05 dadams
;; icicle-search-replace-all-search-hits:
;; Bind to nil: icicle-minibuffer-message-ok-p, icicle-help-in-mode-line-flag.
;; icicle-search-action-1: Add condition-case to ignore disappearance of *Completions* win.
;; icicle-search-highlight-and-maybe-replace:
;; Apply renaming of icicle-acting-on-next/prev (no -p).
;; Use length of *-completion-candidates, not mct.
;; Fix assignment of new candidate nb, and for both directions.
;; Bind icicle-minibuffer-message-ok-p to inhibit no-candidates msg.
;; Wrap around to first only if not icicle-acting-on-next/prev.
;; 2009/09/02 dadams
;; icicle-exchange-point-and-mark: Respect icicle-region-bookmarks-flag.
;; 2009/08/29 dadams
;; Added: icicle-define-search-bookmark-command,
;; icicle-search(-region|-info|-gnus|-w3m|(-non|-local|-remote)-file)-bookmark,
;; icicle-search-bookmark-action.
;; Moved (and redefined) to icicles-cmd1.el: icicle-select-bookmarked-region.
;; (lambda...) -> #'(lambda...).
;; 2009/08/25 dadams
;; Added icicle-select-bookmarked-region.
;; icicle-exchange-point-and-mark:
;; If bookmark+ is loaded, use region bookmarks.
;; Raise error if try to save inactive region or try to select with no saved regions.
;; 2009/08/11 dadams
;; Added: icicle-search-replace-all-search-hits.
;; Renamed: icicle-search-replace-candidate to icicle-search-replace-cand-in-alist.
;; Added: icicle-search-replace-cand-in-mct (not used, for now).
;; icicle-search:
;; Bind icicle-all-candidates-list-alt-action-fn to icicle-search-replace-all-search-hits.
;; Bind replace-count to 0. Bind icicle-current-input to empty string.
;; Updated doc string.
;; icicle-search-replace-search-hit:
;; Do not bind icicle-completion-candidates, icicle-candidate-nb, icicle-last-input.
;; No lack-of-current-candidate error if icicle-all-candidates-action-p.
;; Added: icicle-search-action-1 (factored out from icicle-search-action.
;; icicle-search-action, icicle-search-help:
;; Bind icicle-whole-candidate-as-text-prop-p to nil, to force use of alist.
;; icicle-search-action(-1): Do not bind icicle-candidate-nb, so don't save and restore it.
;; icicle-search-in-context-default-fn: If replacement tried, then update the dialog state.
;; icicle-search-highlight-and-maybe-replace: REWRITE.
;; Msg if string to be replaced is not found in candidate.
;; Swap order: Don't search unless first time (or replacing all).
;; icicle-search-replace-candidate -> icicle-search-replace-cand-in-alist.
;; If replacement done, then: Update alist, minibuffer-completion-table, and
;; minibuffer content. Change candidate nb if navigating next/prev. Complete again.
;; Return indication of whether we tried to replace something.
;; icicle-search-replace-cand-in-alist: Added catch, to skip whole list traversal.
;; Moved byte-compile quieting defvars to top level. Added one for tooltip-mode.
;; 2009/07/20 dadams
;; icicle-font: Ensure no nil elements in COLLECTION arg to completing-read, for Emacs 22+.
;; 2009/06/07 dadams
;; icicle-get-alist-candidate -> funcall icicle-get-alist-candidate-function.
;; Added: icicle-purge-bad-file-regions.
;; icicle-add-region, icicle-(select|search)-region-action:
;; Special-case Info buffers. Thx to Thierry Volpiatto.
;; 2009/05/28 dadams
;; Bind icicle-search-replacement to nil. (Somehow forgot when moved to icicle-explore.)
;; icicle-search-replace-search-hit: Raise an error if icicle-candidate-nb is nil.
;; 2009/05/26 dadams
;; icicle-compilation-search: Use value 'until-move for next-error-highlight.
;; 2009/05/22 dadams
;; Added: icicle-Info-virtual-book.
;; Require icicles-mac.el if load-library doesn't find it.
;; icicle-search: Set icicle-search-final-choice to result.
;; Created - Split off from icicles-cmd.el.
;;;(@* "CHANGE LOG FOR `icicles-face.el'")
;;
;; 2020/11/12 dadams
;; Added soft-require of hexrgb.el (but not really needed).
;; 2014/10/19 dadams
;; icicle-historical-candidate-other: Updated doc string for icicle-Info-highlight-visited-nodes.
;; 2013/07/07 dadams
;; Added: icicle-key-complete-menu, icicle-key-complete-menu-local.
;; 2013/02/04 dadams
;; Removed all autoload cookies.
;; 2013/01/18 dadams
;; Removed: icicle-increment-color-(hue|saturation|value) - moved to hexrgb.el and modified.
;; icicle-search-context-level-*: Use hexrgb-increment-*, with past increment divided by 100.
;; 2012/11/04 dadams
;; icicle-annotation: Fix default value for older Emacs versions.
;; 2012/10/27 dadams
;; Added icicle-annotation.
;; 2012/07/07 dadams
;; Added: icicle-historical-candidate-other (used only for icicle-Info-index so far).
;; 2012/03/29 dadams
;; Removed autoload cookies: hexrgb require, defs of *-increment-*, and *-search-context-level-*.
;; 2012/03/28 dadams
;; Soft-require hexrgb.el at autoload generation-time and load-time. Removed eval-when-compile.
;; Moved *-increment-* function defs from *-face-after-load-hexrgb to (when (featurep 'hexrgb)...),
;; and add autoload cookie for that.
;; Removed: icicle-byte-compile-eval-after-load-flag, icicle-maybe-byte-compile-after-load,
;; icicle-face-after-load-hexrgb.
;; Use (when (featurep 'hexrgb)...) instead of (defun icicle-face-after-load-hexrgb...) as wrapper.
;; Removed calls to icicle-maybe-byte-compile-after-load.
;; Removed (eval-after-load "hexrgb" '(icicle-face-after-load-hexrgb)).
;; Removed autoload cookie with autoloads for icicle-increment-color-*.
;; Changed FILE arg in autoloads by removing .el, so .elc will be loaded if available.
;; 2012/03/25 dadams
;; Replace autoload cookies for *-increment-color-* by autoloads inside soft-require of hexrgb.el.
;; 2012/02/12
;; Added def of icicle-byte-compile-eval-after-load-flag here too, so can load before icicles.el.
;; 2011/10/21 dadams
;; Added face: icicle-msg-emphasis.
;; 2011/10/10 dadams
;; Added: icicle-face-after-load-hexrgb.
;; Replaced bodies of eval-after-load sexps with call to icicle-face-after-load-hexrgb.
;; Added autoload cookies for icicle-increment-color-*.
;; Removed eval-when-compile to load icicles-mac.
;; Moved here (and to icicles-cmd2.el) from icicles-mac.el: icicle-maybe-byte-compile-after-load.
;; 2011/10/08 dadams
;; eval-when-compile icicles-mac.el.
;; 2011/08/16 dadams
;; Require icicles-mac.el.
;; icicle-maybe-byte-compile-after-load the eval-after-load definitions.
;; 2011/07/30 dadams
;; eval-after-load hexrgb.el, not runtime error if not feature, for all fns that use hexrgb.el.
;; Moved here from icicles-opt.el: icicle-increment-color-value.
;; icicle-search-context-level-*: Use fboundp icicle-increment-color-satur*, not featurep hexrgb.
;; Soft-require hexrgb.el when byte compile.
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/05/05 dadams
;; icicle-mustmatch-completion: Changed line-width from 2 to -2.
;; 2010/04/08 dadams
;; Added autoload cookies.
;; 2010/03/13 dadams
;; Made icicle-candidate-part paler (light background): #EF84FFEAF427, not #DB17FFF4E581.
;; 2010/02/17 dadams
;; Moved functions here from icicles-opt.el: icicle-increment-color-(hue|saturation).
;; So no longer require icicles-opt.el.
;; 2009/04/18 dadams
;; Removed load-time warning about using Icicles in a text terminal.
;; 2009/04/12 dadams
;; Added: face icicle-mode-line-help.
;; 2009/01/13 dadams
;; Added: icicle-extra-candidate.
;; 2008/10/26 dadams
;; Added group: Icicles-Files.
;; 2008/03/29 dadams
;; Redefined and renamed faces for completion status indicators.
;; Renamed: icicle-completing-mustmatch-prompt-prefix to icicle-mustmatch-completion,
;; icicle-mode-lighter-highlight(-plus) to icicle(-multi-command)-completion.
;; Removed: icicle-completing-prompt-prefix, icicle-prompt-suffix.
;; 2008/03/09 dadams
;; Added: icicle-mode-lighter-highlight.
;; 2007/12/10 dadams
;; Added: icicle-input-completion-fail-lax.
;; 2007/11/18 dadams
;; Added: icicle-proxy-candidate.
;; icicle-special-candidate: No longer use a raised box.
;; 2007/10/22 dadams
;; icicle-special-candidate: Raised box.
;; 2007/08/19 dadams
;; Added: icicle-input-completion-fail.
;; 2007/06/21 dadams
;; Added: icicle-candidate-part. Changed definition of icicle-special-candidate.
;; 2007/06/17 dadams
;; Added: icicle-saved-candidate.
;; 2007/06/12 dadams
;; icicle-prompt-suffix: No box for dark background.
;; 2007/06/11 dadams
;; Better defaults for dark background frames.
;; 2007/06/07 dadams
;; Changed emacs-commentary-link to point to icicles-doc1.el and icicles-doc2.el.
;; 2007/05/22 dadams
;; Protected icicle-search-context-level-1 to *-8, in case hexrgb is not loaded.
;; 2007/04/20 dadams
;; Added: icicle-search-context-level-1 through *-8.
;; Require icicles-opt.el.
;; 2006/12/22 dadams
;; Renamed group icicles to Icicles.
;; Added Icicles subgroups, and assigned them instead of group Icicles:
;; -Buffers, -Completions-Display, -Key-Bindings, -Key-Completion, -Matching,
;; -Minibuffer-Display, -Miscellaneous, -Searching.
;; 2006/11/06 dadams
;; icicle-search-highlight-all-flag -> icicle-search-highlight-threshold (integer)
;; 2006/10/16 dadams
;; icicle-special-candidate: changed background from Pink to #DB17FFF4E581.
;; 2006/10/04 dadams
;; Added: icicle-special-candidate.
;; 2006/08/13 dadams
;; Added: icicle-completing-prompt-prefix.
;; 2006/07/16 dadams
;; Added dark-background face suggestions from Le Wang - thx.
;; 2006/06/30 dadams
;; Added: minibuffer-prompt for Emacs < 22 (e.g. Emacs 21.4 has propertize).
;; 2006/04/28 dadams
;; Added: icicle-whitespace-highlight.
;; 2006/04/14 dadams
;; Renamed icicle-search-refined-regexp to icicle-search-current-input.
;; 2006/04/07 dadams
;; Added: icicle-search-main-regexp-others.
;; Renamed: icicle-search-main-regexp to icicle-search-main-regexp-current.
;; 2006/03/27 dadams
;; Added: icicle-search-*-regexp.
;; 2006/03/22 dadams
;; Renamed: icicle-root-highlight-* to icicle-match-highlight-*.
;; 2006/03/21 dadams
;; Added: icicle-common-match-highlight-Completions.
;; icicle-root-highlight-Completions: Changed default face.
;; 2006/03/08 dadams
;; Added: icicle-current-candidate-highlight.
;;;(@* "CHANGE LOG FOR `icicles-fn.el'")
;;
;; 2024/10/28 dadams
;; icicle-insert-candidates: Emacs 28+ doesn't use icomplete-tidy.
;; 2023/07/27 dadams
;; icicle-read-buffer: Added optional arg PREDICATE.
;; See https://lists.gnu.org/archive/html/emacs-devel/2023-07/msg00802.html.
;; 2022/06/30 dadams
;; icicle-handle-default-for-prompt:
;; Update for Emacs 28+: take into account option minibuffer-default-prompt-format.
;; Unconditionally added vacuous defvars for byte-compiler: filesets-tree-max-level,
;; icicle-read-char-history, icicle-read-char-by-name-multi-completion-flag.
;; 2022/05/22 dadams
;; icicle-SPC-scatter-re, icicle-file-name-(non)directory, icicle-input-from-minibuffer:
;; Use icicle-characterp.
;; 2021/04/10 dadams
;; icicle-increment-cand-nb+signal-end: Respect new option, icicle-wrap-around-cycling-flag.
;; 2021/04/06 dadams
;; icicle-get-candidates-from-saved-set: Ensure point is bob before trying to read.
;; 2021/03/17 dadams
;; Use buffer-string, not buffer-substring, for whole buffer.
;; 2021/01/25 dadams
;; icicle-scatter-re: Use version of make-obsolete that's compatible with all Emacs versions.
;; 2020/11/05 dadams
;; icicle-read-face-name:
;; Wrap soft-require of palette in condition-case to ignore error hard-requiring vline.el.
;; 2020/08/14 dadams
;; icicle-display-completion-list: Use help-print-return-message, not print-help-return-message.
;; 2020/02/04 dadams
;; icicle-read-number:
;; Updated for Emacs 27+. Added HIST arg (default read-number-history). Thx to Tino Calancha.
;; 2020/01/12 dadams
;; icicle-fit-completions-window: Fix last change, for Emacs 20.
;; 2020/01/03 dadams
;; icicle-fit-completions-window: Do not text-scale if terminal Emacs. Thx to Ron Parker.
;; 2019/06/09 dadams
;; icicle-repeat-command: Same as in zz-repeat-command in zones.el now.
;; 2018/09/21 dadams
;; Added: icicle--pop-to-buffer-same-window.
;; icicle-try-switch-buffer: Use icicle--pop-to-buffer-same-window.
;; 2018/06/01 dadams
;; icicle-filter-wo-input: Protect against improper default value passed to completing-read.
;; 2018/03/03 dadams
;; icicle-delete-dups: defalias the symbol, not its symbol-function (dunno why I did the latter).
;; 2018/02/13 dadams
;; Removed (Emacs 23-25 only now): icicle-char-cands-from-charlist, icicle-make-char-candidate,
;; icicle-ucs-names, (icicle(-ORIG)-)read-char-by-name,
;; icicle-read-char-maybe-completing.
;; 2018/01/15 dadams
;; Added: icicle-SPC-scatter-match, icicle-SPC-scatter-re.
;; Renamed: icicle-scatter to icicle-scatter-re.
;; icicle-scatter-match: Applied renaming of icicle-scatter. Added it as obsolete alias.
;; 2017/12/10 dadams
;; icicle-read-buffer: If icicle-buffer-complete-fn is nil use icicle-bufflist if it is a list.
;; 2017/10/22 dadams
;; icicle-frames-on: Remove (unused) second arg.
;; 2017/09/17 dadams
;; icicle-special-candidate-p:
;; If string with no *special* face, test its symbol in alist. Fixes old sorting bug with
;; icicle-special-candidates-first-p.
;; 2017/06/25 dadams
;; Added: icicle-custom-rogue-p.
;; 2017/01/15 dadams
;; Use icicle-string-match-p, not its expansion, everywhere.
;; 2016/12/21 dadams
;; icicle-read-file-name: Use icicle-ffap-guesser, not ffap-guesser. Thx to Tino Calancha.
;; 2016/10/12 dadams
;; Added: icicle-completion-pcm--all-completions and icicle-ORIG-completion-pcm--all-completions
;; (workaround for Emacs bug #24676).
;; 2016/10/07 dadams
;; icicle-choose-completion-string:
;; Check icicle-lisp-complete-symbol too, not just lisp-complete-symbol.
;; 2016/08/30 dadams
;; icicle-string-match-p: Do NOT alias string-match-p, because that is a defsubst.
;; 2016/06/10 dadams
;; icicle-maybe-sort-maybe-truncate:
;; Call icicle-reversible-sort even if icicle-sort-comparer is nil.
;; icicle-reversible-sort: Reverse LIST if icicle-reverse-sort-p is non-nil.
;; 2016/03/01 dadams
;; icicle-insert-cand-in-minibuffer: Wrap string-match in condition-case, to ignore errors.
;; 2016/02/28 dadams
;; icicle-prefix-keys-first-p, icicle-command-names-alphabetic-p:
;; Use new option icicle-complete-keys-separator, not its default value.
;; 2016/02/26 dadams
;; icicle-read-char-by-name:
;; Handle case where multi-completing-p but user enters whole name without completing.
;; icicle-mctize-all: Do not mctize a list that is a lambda form.
;; 2015/10/15 dadams
;; icicle-(lru|mru)-window-for-buffer: Convert times to lists (needed for Emacs 24, not for 25+).
;; 2015/09/20 dadams
;; Added: icicle-flx-score-greater-p, if can soft-require flx.el (Emacs 24.3+).
;; http://emacs.stackexchange.com/a/16522/105.
;; 2015/08/21 dadams
;; Added: icicle-lru-window-for-buffer, icicle-mru-window-for-buffer.
;; 2015/08/20
;; icicle-read-string: Replaced hard-coded non-nil INCLUDE arg by (eq icicle-default-value t).
;; 2015/07/05 dadams
;; icicle-levenshtein-strict-match: Raise error if cannot load levenshtein.el.
;; 2015/02/20 dadams
;; icicle-insert-Completions-help-string:
;; Hard-code mouse-[12]. since mouse-choose-completion is no longer an alias (bound).
;; icicle-insert-candidates: Wrap Icomplete stuff with save-excursion, so help string is at top.
;; 2015/02/07 dadams
;; icicle-unsorted-file-name-prefix-candidates: For proxy cands and extra cands, use relative name.
;; 2015/01/21 dadams
;; icicle-choose-completion-string (Emacs 23.2+): Delete region even for INSERT-FUNCTION case.
;; 2015/01/20 dadams
;; icicle-choose-completion-string (Emacs 23.2+): Update for Emacs 24+.
;; Added arg INSERT-FUNCTION. Remove mouse-face from copy of CHOICE, before inserting it,
;; instead of removing it from buffer text after inserting.
;; Delete region up to read-only limits.
;; 2014/12/23 dadams
;; Added: icicle-alist-key-match.
;; 2014/12/15 dadams
;; Added: icicle-bookmark-non-dir-file-p.
;; 2014/11/15 dadams
;; Moved to icicles-mode.el: icicle-help-line-buffer, icicle-help-line-file,
;; icicle-show-help-in-mode-line, icicle-show-in-mode-line.
;; 2014/11/08 dadams
;; icicle-barf-if-*: Use or, not unless, so return non-nil if no error raised.
;; 2014/10/27 dadams
;; icicle-make-char-candidate, icicle-read-char-by-name:
;; Respect icicle-read-char-by-name-multi-completion-flag: nothing special if nil.
;; icicle-read-char-by-name: Do not override option icicle-show-multi-completion-flag.
;; 2014/10/19 dadams
;; icicle-display-candidates-in-Completions: Moved to icicles-mcmd.el. It is now a command.
;; Highlight Info index-entry cand on demand with C-x C-M-l, or automatically per new option
;; icicle-Info-highlight-visited-nodes.
;; 2014/09/12 dadams
;; icicle-display-candidates-in-Completions:
;; Handle possibility that image-dired-get-thumbnail-image returns nil, i.e., if it cannot
;; make/get a thumbnail for the image.
;; Handle Emacs 20 crash for expand-file-name with nil second arg.
;; icicle-expand-file-name-20: Make arg DIR optional.
;; 2014/08/29 dadams
;; Added: icicle-file-elc-p.
;; 2014/08/22 dadams
;; Added: icicle-file-desktop-p.
;; icicle-file-compressed-p: Handle cons argument.
;; 2014/08/21 dadams
;; Added: icicle-bookmark-annotated-p.
;; 2014/08/19 dadams
;; Added: icicle-bookmark-navlist-p.
;; Removed (commented out):
;; icicle-bookmark-last-specific-(buffer|file)-p, icicle-bookmark-this-file-p (not used yet).
;; icicle-bookmark(-autonamed)-this-buffer-p, icicle-bookmark-(dired|file)-this-dir-p:
;; Wrap body in with-current-buffer, for ORIG buf.
;; 2014/08/17 dadams
;; Moved to icicles-opt.el: icicle-color-defined-p.
;; 2014/08/12 dadams
;; icicle-special-candidates-first-p: Use icicle-special-candidate-p.
;; 2014/08/10 dadams
;; Added:
;; icicle-bookmark-autofile-p, icicle-bookmark-autonamed-p,
;; icicle-bookmark-autonamed-this-buffer-p, icicle-bookmark-bookmark-file-p,
;; icicle-bookmark-bookmark-list-p, icicle-bookmark-desktop-p, icicle-bookmark-dired-p,
;; icicle-bookmark-dired-this-dir-p, icicle-bookmark-dired-wildcards-p, icicle-bookmark-file-p,
;; icicle-bookmark-file-this-dir-p, icicle-bookmark-flagged-p, icicle-bookmark-function-p,
;; icicle-bookmark-gnus-p, icicle-bookmark-icicle-search-hits-p, icicle-bookmark-image-p,
;; icicle-bookmark-info-p, icicle-bookmark-last-specific-buffer-p,
;; icicle-bookmark-last-specific-file-p, icicle-bookmark-lighted-p,
;; icicle-bookmark-local-directory-p, icicle-bookmark-local-file-p, icicle-bookmark-man-p,
;; icicle-bookmark-marked-p, icicle-bookmark-modified-p, icicle-bookmark-non-file-p,
;; icicle-bookmark-omitted-p, icicle-bookmark-orphaned-file-p,
;; icicle-bookmark-orphaned-local-file-p, icicle-bookmark-orphaned-remote-file-p,
;; icicle-bookmark-region-p, icicle-bookmark-remote-file-p, icicle-bookmark-sequence-p,
;; icicle-bookmark-snippet-p, icicle-bookmark-tagged-p, icicle-bookmark-temporary-p,
;; icicle-bookmark-this-buffer-p, icicle-bookmark-this-file-p, icicle-bookmark-url-p,
;; icicle-bookmark-url-browse-p, icicle-bookmark-variable-list-p, icicle-bookmark-w3m-p,
;; icicle-buffer-modified-p, icicle-color-defined-p, icicle-color-gray-p,
;; icicle-color-supported-p, icicle-compilation-buffer-p, icicle-custom-variable-p,
;; icicle-face-bold-p, icicle-face-differs-from-default-p, icicle-face-inverse-video-p,
;; icicle-face-italic-p, icicle-face-nontrivial-p, icicle-face-underline-p,
;; icicle-ffap-file-remote-p, icicle-ffap-url-p, icicle-file-accessible-directory-p,
;; icicle-file-compressed-p, icicle-file-directory-p, icicle-file-executable-p,
;; icicle-file-exists-p, icicle-file-locked-p, icicle-file-name-absolute-p,
;; icicle-file-regular-p, icicle-file-symlink-p, icicle-frame-iconified-p,
;; icicle-frame-invisible-p, icicle-frame-splittable-p, icicle-frame-thumbnail-p,
;; icicle-frame-unsplittable-p, icicle-interesting-buffer-p, icicle-next-error-buffer-p,
;; icicle-nondirectory-p, icicle-not-special-candidate-p, icicle-package-built-in-p,
;; icicle-package-disabled-p, icicle-package-installed-p, icicle-recentf-include-p,
;; icicle-recentf-keep-p, icicle-special-candidate-p, icicle-special-display-p,
;; icicle-special-variable-p, icicle-window-at-bottom-p, icicle-window-at-left-p,
;; icicle-window-at-right-p, icicle-window-at-top-p, icicle-window-dedicated-p,
;; icicle-window-deletable-p, icicle-window-invisible-p.
;; Moved here from icicles-opt.el (and modified): icicle-image-file-p.
;; Moved here from icicles-cmd1.el (and modified): icicle-binary-option-p.
;; Moved here from icicles-cmd2.el (and modified): icicle-defined-thing-p.
;; Renamed: icicle-lisp-vanilla-completing-read to icicle-completing-read-default.
;; icicle-completing-read-default: Rewrote based on completing-read-default. Added opt arg KEYMAP.
;; icicle-completing-read: Added optional arg KEYMAP.
;; icicle-read-from-minibuffer: When Emacs < 23 and DEFAULT-VALUE is a list, set it to the car.
;; Advise read-file-local-variable: Bind icicle-variable-completing-p.
;; icicle-file-readable-p, icicle-file-remote-p, icicle-looks-like-dir-name-p:
;; Make it work also for a cons (completion) arg.
;; icicle-completing-p: Rewrote to just look for a binding of [icicle-is-completion-map].
;; 2014/07/29 dadams
;; icicle-read-file-name: For Emacs 23+ do not bind ffap vars to nil, so get multiple M-n defaults.
;; This reverses the change from 2008/02/03.
;; 2014/05/19 dadams
;; icicle-completing-read: Use only first default to prepare for icicle-handle-default-for-prompt.
;; 2014/05/17 dadams
;; icicle-read-shell-command-completing: with-output-to-temp-buffer -> icicle-with-help-window.
;; 2014/05/16 dadams
;; icicle-completing-read, args DEF and INCLUDE passed to icicle-handle-default-for-prompt:
;; If insert-default-directory then show DEF as relative to default-directory.
;; Pass non-nil INCLUDE only if insert-default-directory does not insert it as input.
;; 2014/04/29 dadams
;; Added: icicle-mouseover-help, icicle-create-thumb.
;; icicle-display-candidates-in-Completions: Provide mouseover tooltip image preview.
;; Hide mouse-face highlighting when image-only.
;; 2014/04/20 dadams
;; icicle-insert-candidates:
;; Automatic on/off of Icomplete mode and sorting: Turn on only if it was turned on here.
;; When turn off, set flag icicle-auto-no-*-p.
;; Icomplete: Call icomplete-exhibit when turn on. Update icicle-last-icomplete-mode-value.
;; No Icomplete auto on/off for Emacs < 23.
;; Removed some old $$$$$ comments (cleanup).
;; 2014/04/13 dadams
;; icicle-insert-candidates:
;; When toggling icomplete-mode automatically, ensure done in the minibuffer, not *Completions*.
;; When toggling sorting: Do not turn on unless it was automatically turned off for this cmd.
;; 2014/04/01 dadams
;; icicle-display-candidates-in-Completions:
;; For icicle-candidate-properties-alist, use \', not $, in regexp for string-match.
;; icicle-insert-candidates: Do not use icomplete-tidy for Emacs 20-22.
;; 2014/03/06 dadams
;; icicle-insert-candidates:
;; Respect new options icicle-icomplete-mode-max-candidates and icicle-sorting-max-candidates.
;; 2014/03/04 dadams
;; icicle-display-candidates-in-Completions:
;; Use icicle-display-completion-list, not display-completion-list.
;; Removed icicle-condition-case-no-debug around that call.
;; Pass NB-CANDS to icicle-display-completion-list.
;; icicle-display-completion-list: Added optional arg NB-CANDS. Pass it to *-insert-candidates.
;; icicle-insert-candidates: Added optional arg NUMBER-OF-CANDIDATES. Use it if available.
;; 2014/02/21 dadams
;; Added: icicle-read-file-name-default.
;; icicle-read-file-name, icicle-read-file-name-1, icicle-dired-read-shell-command,
;; icicle-dired-guess-shell-command:
;; Added optional HISTORY arg.
;; icicle-read-file-name-1: If icicle-orig-read-file-name-fn = read-file-name-default then
;; use icicle-read-file-name-default, which accepts a HISTORY arg.
;; icicle-dired-read-shell-command, icicle-dired-guess-shell-command:
;; Use shell-command-history by default.
;; icicle-read-shell-command-completing: Pass HIST to icicle-read-file-name.
;; 2014/02/19 dadams
;; icicle-read-file-name:
;; 2014/02/08 dadams
;; Renamed: icicle-file-directory-p to icicle-looks-like-dir-name-p.
;; icicle-looks-like-dir-name-p: Better doc string.
;; 2014/02/07 dadams
;; Added: icicle-unlist. Use it in icicle-read-from-minibuffer, icicle-read-string-completing,
;; icicle-read-string, icicle-insert-candidates, icicle-read-regexp.
;; 2014/01/18 dadams
;; icicle-read-face-name: Rewrote for Emacs 24. Doc string updated per Emacs bug #16483.
;; 2014/01/11 dadams
;; icicle-completion-setup-function (Emacs 20-21): Wrap in condition case - Emacs bug.
;; 2014/01/05 dadams
;; Added: icicle-list-position, icicle-repeat-command.
;; icicle-completing-read: Bind icicle-orig-*, so can use icicle-recomplete-from-original-domain.
;; 2013/12/30 dadams
;; icicle-make-char-candidate: 3-part multi-completion now - added hex code point.
;; icicle-read-char-by-name:
;; 3-part multi-completion now - can complete against hex code point too.
;; Ensure ignore case for comparison outside completion. Report invalid INPUT, not CHR.
;; 2013/12/29 dadams
;; Added: icicle-make-char-candidate. Add hex and octal for code point in help echo.
;; icicle-read-char-by-name: Redefined to use multi-completion. Can now use with narrowing.
;; 2013/12/26 dadams
;; icicle-read-char-by-name: put NAME, not SYMB as icicle-orig-cand text property.
;; 2013/11/28 dadams
;; icicle-read-face-name: Better fix for brain-dead vanilla Emacs PROMPT.
;; 2013/11/24 dadams
;; icicle-read-face-name: Updated for Emacs 24.
;; 2013/11/19 dadams
;; Removed: icicle-ORIG-read-file-name-default and icicle-read-file-name-default.
;; 2013/10/30 dadams
;; icicle-fuzzy-candidates, icicle(-unsorted(-file-name))-(prefix|apropos)-candidates:
;; Always set icicle-common-match-string - to nil or to icicle-expanded-common-match.
;; For prefix completion, icicle-expanded-common-match if icicle-must-pass-after-match-predicate.
;; 2013/08/03 dadams
;; Added: icicle-dirs-and-latest-use-first-p, icicle-latest-use-first-p.
;; Renamed: icicle-last-(accessed|modified)-first-p to icicle-latest-(access|modification)-first-p,
;; icicle-most-recent-first-p to icicle-latest-input-first-p.
;; icicle-show-help-in-mode-line, icicle-help-line-(buffer|file):
;; Propertize only the values, not their headings too.
;; icicle-help-line-file: Add access time.
;; icicle-historical-alphabetic-p, icicle-latest-input-first-p: Apply abbreviate-file-name.
;; 2013/08/01 dadams
;; icicle-choose-completion-string: Do not display obnoxious vanilla Emacs obsolescence warning.
;; 2013/07/04 dadams
;; Added: icicle-find-tag-default-as-regexp, icicle-read-regexp.
;; 2013/06/21 dadams
;; icicle-display-candidates-in-Completions: Removed vestigial code for highlighting special cand.
;; 2013/05/11 dadams
;; icicle-handle-default-for-prompt: Do not add nil DEFAULT to prompt.
;; 2013/04/30 dadams
;; Renamed: icicle-add-default-to-prompt to icicle-handle-default-for-prompt.
;; icicle-handle-default-for-prompt: Always remove existing default expression from prompt.
;; Added INCLUDE. If nil, do not add DEFAULT (just remove it).
;; icicle-completing-read:
;; Invoke icicle-handle-default-for-prompt unconditionally, passing (eq icicle-default-value t).
;; icicle-read-string: Use icicle-handle-default-for-prompt, not icicle-add-default-to-prompt.
;; 2013/04/22 dadams
;; icicle-read-buffer: Pass all args to read-buffer-function funcall. Thx to Nick Alcock.
;; 2013/04/08 dadams
;; icicle-choose-completion-string: Added versions for Emacs 23.1 and 23.2+.
;; 2013/04/06 dadams
;; icicle-completing-p:
;; Bug fix for Emacs > 24.3. Test minibuffer-completing-file-name, not filename keymaps.
;; 2013/03/11 dadams
;; icicle-try-switch-buffer: If BUFFER is already current, do nothing, to prevent hooks kicking in.
;; 2013/03/07 dadams
;; Updated to use icicle-user-error where appropriate.
;; 2013/03/05 dadams
;; Added: icicle-defaults-at-point.
;; 2013/02/28 dadams
;; eval-after-load crm: Use fset, not defalias. Thx to Michael Heerdegen.
;; 2013/02/26 dadams
;; icicle-(prefix|apropos)-any(-file-name)-candidates-p:
;; Fix for use with Icomplete - take icicle-must-pass-after-match-predicate into account.
;; 2013/02/12 dadams
;; Typo fix: minibuffer-default--* -> minibuffer-default-*. Thx to Christopher Schmidt.
;; 2013/02/10 dadams
;; icicle-bounds-of-thing-at-point: Use SYNTAX-TABLE arg only if it is a syntax table.
;; 2013/02/06 dadams
;; icicle-unpropertize-completion: Added rear-nonsticky. Thx to Christopher Schmidt.
;; 2013/02/04 dadams
;; Removed all autoload cookies.
;; 2013/02/03 dadams
;; Moved to icicles-mcmd.el: icicle-isearch-complete-past-string.
;; 2012/12/31 dadams
;; icicle-next-candidate: Set icicle-mode-line-help. Do not call icicle-show-help-in-mode-line.
;; icicle-insert-cand-in-minibuffer:
;; Ignore errors in put-text-property. If retrieve singleton cand set, it is read-only (why?).
;; icicle-insert-candidates: Corrected '(face 'icicle-annotation) to '(face icicle-annotation).
;; 2012/12/28 dadams
;; icicle-add-default-to-prompt: Handle nil DEFAULT. Thx to Michael Heerdegen.
;; 2012/12/22 dadams
;; Added: icicle-add-default-to-prompt.
;; icicle-completing-read, icicle-read-string: Use icicle-add-default-to-prompt.
;; 2012/12/21 dadams
;; icicle-unsorted(-file-name)-(prefix|apropos)-candidates:
;; Compute common match in all cases except i-e-i-t-c-m = 0, and set *-common-match-string to it.
;; icicle-save-or-restore-input:
;; Removed test for icicle-expand-input-to-common-match level: expand for all levels.
;; 2012/12/14 dadams
;; Added: icicle-multi-comp-apropos-complete-match.
;; 2012/12/12 dadams
;; icicle-expanded-common-match-1:
;; Use string-match, not icicle-apropos-complete-match-fn, except for first condition (and).
;; icicle-insert-candidates: Wrap funcall of annotation fn with condition-case, just in case.
;; 2012/12/10 dadams
;; icicle-read-file-name-default: Protect minibuffer-local-filename-syntax with boundp.
;; 2012/12/06 dadams
;; Moved minibuffer-with-setup-hook here from icicles-mac.el (and removed eval-when-compile).
;; icicle-read-shell-command, icicle-dired-read-shell-command:
;; Use minibuffer-with-setup-hook unconditionally, since provided here unconditionally.
;; 2012/12/05 dadams
;; icicle-completing-read: Remove HINT before adding it our way. Thx to Christopher Schmidt.
;; 2012/12/02 dadams
;; Added: icicle-read-file-name-default, icicle-ORIG-read-file-name-default.
;; 2012/11/27 dadams
;; icicle-completing-read:
;; For icicle-default-value = t: Append ": " to icicle-default-in-prompt-format-function result.
;; 2012/11/26 dadams
;; icicle-completing-read: Use new option icicle-default-in-prompt-format-function.
;; 2012/11/21 dadams
;; icicle-completing-read: Commented out removing dir part of icicle-default-value in prompt.
;; 2012/11/17 dadams
;; icicle-completing-read:
;; When (eq icicle-default-value t) add DEF to PROMPT. Thx to Michael Heerdegen.
;; 2012/11/10 dadams
;; icicle-custom-type: icicle-get-safe -> get.
;; icicle-fuzzy-candidates: Show all (not no) candidates for empty input, sorted alphabetically.
;; 2012/11/08 dadams
;; Added: icicle-get-safe.
;; icicle-completion-setup-function, icicle-var-(is-of|matches|inherits)-type-p,
;; icicle-var-val-satisfies-type-p, icicle-custom-type, icicle-fit-completions-window,
;; icicle-next-candidate, icicle-recompute-candidates, icicle-save-or-restore-input,
;; icicle-highlight-input-noncompletion:
;; Use icicle-get-safe.
;; 2012/11/07 dadams
;; icicle-read-char-by-name, icicle-read-from-minibuffer: char-to-string -> string.
;; icicle-scatter: Non-backtracking version.
;; 2012/10/27 dadams
;; Added: icicle-member-ignore-case.
;; icicle-insert-candidates:
;; Insert annotation only if icicle-show-annotations-flag. Highlight w/ face icicle-annotation.
;; 2012/10/24 dadams
;; icicle-completion--embedded-envvar-table: Return 0 as the first boundary. Thx to M. Heerdegen.
;; 2012/10/22 dadams
;; icicle-display-candidates-in-Completions: Check Info topic first in icicle-Info-index-cache.
;; icicle-Info-node-is-indexed-by-topic:
;; Return triplet: (TOPIC NODE FILE). Cache triplet in icicle-Info-index-cache (new).
;; 2012/10/21 dadams
;; icicle-take: Use a simpler definition.
;; 2012/10/20 dadams
;; icicle-completion--embedded-envvar-table: Added more of vanilla code. Thx to Michael Heerdegen.
;; 2012/10/18 dadams
;; icicle-read-file-name, icicle-read-number, icicle-read-char-exclusive,
;; icicle-read-string-completing, icicle-read-face-name:
;; Do not augment icicle-proxy-candidates if icicle-exclude-default-proxies is non-nil.
;; For all of them except icicle-read-face-name (already done): Augment, do not just replace.
;; 2012/10/17 dadams
;; icicle-display-candidates-in-Completions:
;; For *Completions* mode line: treat nil icicle-apropos-complete-match-fn like apropos.
;; 2012/10/15 dadams
;; icicle-(highlight|clear)-lighter: Use || to indicate multi-completion.
;; 2012/10/10 dadams
;; icicle-display-candidates-in-Completions:
;; Add lighter and completion mode to *Completions* mode line.
;; icicle-(prefix|apropos)-candidates:
;; Call *-maybe-sort-maybe-truncate even if *-sort-comparer is nil. Needed for truncation.
;; icicle-maybe-sort-maybe-truncate:
;; Handle new icicle-max-candidates value of RESET, from icicle-doremi-increment-max-candidates+
;; 2012/10/09 dadams
;; icicle-read-face-name: Bind icicle-multi-completing-p to t.
;; 2012/10/05 dadams
;; icicle-next-candidate: Removed setting of icicle-default-directory (unused).
;; 2012/10/02 dadams
;; icicle-file-name-(non)directory, icicle-input-from-minibuffer:
;; string-to-list -> append the string to (),
;; Because Emacs 24 now breaks older byte-compiled code, since it removed string-to-sequence.
;; 2012/10/01 dadams
;; icicle-file-name-(non)directory, icicle-input-from-minibuffer:
;; Rewrote to be more robust: do not hard-code ^G as the REPL-CHAR. Use a char not in string.
;; 2012/09/25 dadams
;; icicle-input-from-minibuffer, icicle-minibuf-input-sans-dir,
;; icicle-highlight-input-noncompletion:
;; Handle the icicle-abs-file-candidates case also - same as the icicle-file-name-input-p case.
;; 2012/09/24 dadams
;; Added: icicle-last-accessed-first-p.
;; icicle-read-shell-command-completing: Pass non-nil NO-ERROR-P arg to icicle-describe-file.
;; icicle-file-type-less-p, icicle-dirs-(first|last)-p, icicle-last-modified-first-p:
;; Use file comparison also if icicle-abs-file-candidates.
;; 2012/09/17 dadams
;; icicle-insert-candidates:
;; Add an extra newline after multi-line candidates only, not after all cands if ANY-MULTILINE-P.
;; 2012/09/08 dadams
;; Added: icicle-read-buffer, icicle-ORIG-read-buffer.
;; icicle-unsorted-(prefix|apropos)-candidates:
;; Use buffer-name alist, if not ignoring space prefix and not internal-complete-buffer.
;; Ensure icicle-buffer-name-input-p to pass icicle-buffer-ignore-space-prefix-flag arg.
;; icicle-unsorted-file-name-(prefix|apropos)-candidates,
;; icicle-apropos-any-file-name-candidates-p:
;; Do not pass icicle-ignore-space-prefix-flag arg to icicle-all-completions.
;; icicle-display-Completions, icicle-apropos-any-candidates-p:
;; Ensure icicle-buffer-name-input-p to pass icicle-buffer-ignore-space-prefix-flag arg.
;; 2012/09/06 dadams
;; Added icicle-string-match-p. Use it.
;; 2012/08/31 dadams
;; icicle-read-from-minibuffer: Improved doc string.
;; 2012/08/28 dadams
;; icicle-read-number: Allow for DEFAULT to be a cons with nil elements. Thx to C. Schmidt.
;; 2012/08/18 dadams
;; Added: icicle-bounds-of-thing-at-point.
;; thing-at-point -> icicle-thing-at-point, everywhere.
;; 2012/08/13 dadams
;; icicle-completing-read-multiple: Doc string improvement.
;; 2012/08/06 dadams
;; Renamed old-* to icicle-ORIG-*:
;; icicle-ORIG-choose-completion-string, icicle-ORIG-completing-read,
;; icicle-ORIG-completing-read-multiple, icicle-ORIG-completion-setup-function,
;; icicle-ORIG-dired-smart-shell-command, icicle-ORIG-display-completion-list,
;; icicle-ORIG-face-valid-attribute-values, icicle-ORIG-minibuffer-default-add-completions,
;; icicle-ORIG-read-char-by-name, icicle-ORIG-read-face-name,
;; icicle-ORIG-read-from-minibuffer, icicle-ORIG-read-number,
;; icicle-ORIG-read-string, icicle-ORIG-shell-command, icicle-ORIG-shell-command-on-region,
;; icicle-ORIG-crm-local-completion-map, icicle-ORIG-crm-local-must-match-map.
;; icicle-read-file-name-1: Applied renaming: new name icicle-orig-read-file-name-fn.
;; 2012/07/21 dadams
;; icicle-show-help-in-mode-line:
;; Allow value of property icicle-mode-line-help to be a function.
;; For a file-name candidate, call icicle-help-line-buffer with NO-FILE-P.
;; icicle-help-line-buffer: Added optional arg NO-FILE-P. Include file name, if any.
;; 2012/07/19 dadams
;; icicle-insert-candidates: Fix change from 7/18: ensure icicle-last-completion is non-nil.
;; 2012/07/18 dadams
;; icicle-insert-candidates: Handle annotations.
;; 2012/07/17 dadams
;; icicle-read-char-by-name: Show char and its code point in mode line when cycle.
;; 2012/07/07 dadams
;; Added: icicle-Info-node-is-indexed-by-topic.
;; icicle-display-candidates-in-Completions:
;; Added highlighting of topics pointing to visited Info nodes, for icicle-Info-index.
;; Call icicle-transform-multi-completion on file-name cand for historical-cand highlighting.
;; File-name completion fixes (thx to Michael Heerdegen):
;; Added: icicle-completion--embedded-envvar-table.
;; icicle-unsorted-file-name-prefix-candidates:
;; Use substitute-in-file-name on arg INPUT.
;; For Emacs 24+, bind minibuffer-completion-table to icicle-file-name-completion-table.
;; icicle-insert-cand-in-minibuffer: Removed insert-default-directory from AND as condition.
;; icicle-save-or-restore-input:
;; Removed insert-default-directory from COMMON condition for file-name completion.
;; Pass (NOT INSERT-DEFAULT-DIRECTORY) as 3rd arg to icicle-abbreviate-or-expand-file-name.
;; icicle-abbreviate-or-expand-file-name: Added optional arg DONT-ADD-DEFAULT-DIR-P.
;; Removed #' from lambdas.
;; 2012/06/25 dadams
;; Corrected change of 5/13: Removed call to file-name-as-directory.
;; icicle-alt-act-fn-for-type: Removed backquoting from lambda, since it uses a macro in *-mac.el.
;; 2012/06/24 dadams
;; icicle-read-shell-command-completing:
;; Use shell-command-to-string in *Help* explicitly, not just shell-command.
;; Thx to Christopher Schmidt & Michael Heerdegen.
;; icicle-help-line-(buffer|file): Handle fixnum overflow if buffer or file is too big.
;; icicle-insert-candidates: Remove extra newline at eob when vertical format.
;; 2012/06/21 dadams
;; icicle-prefix-any-file-name-candidates-p: updated for Emacs 23+ (file-name PRED).
;; 2012/06/18 dadams
;; icicle-help-line-buffer: Use format-mode-line if available.
;; 2012/06/09 dadams
;; icicle-display-candidates-in-Completions, icicle-highlight-initial-whitespace:
;; Use point-max if 1+ point is greater.
;; icicle-display-completion-list:
;; Insert help string only if there are completions.
;; Show text "There are no possible..." anyway, even if the show flag is nil.
;; icicle-expand-file-name-20: Move forward-line only if the show flag is non-nil - else no-op.
;; 2012/05/22 dadams
;; icicle-file-remote-p: Aligned with bmkp-file-remote-p - removed ffap; added final string-match.
;; icicle-show-help-in-mode-line, icicle-quote-file-name-part-of-cmd:
;; Test with icicle-file-remote-p before file-exists-p, to avoid Tramp. Thx to Michael Albinus.
;; 2012/05/13 dadams
;; icicle-completion-setup-function (all Emacs versions):
;; Corrected what becomes default-directory: Use substitute-in-file-name, to expand env vars.
;; Use expand-file-name and file-name-as-directory.
;; 2012/04/30 dadams
;; icicle-unsorted-file-name-prefix-candidates:
;; Forgot to use PRED, not default-directory, in second call to try-completion.
;; 2012/04/23 dadams
;; icicle-files-within(-1): If Dired+ available, use diredp-files-within(-1).
;; Moved to dired+.el (and renamed prefix): icicle-directories-within.
;; 2012/04/20 dadams
;; Added: icicle-directories-within (not yet used).
;; icicle-files-within: Added args INCLUDE-DIRS-P, PREDICATE. Remove killed Dired buffers.
;; 2012/04/13 dadams
;; icicle-files-within-1: Allow FILE-LIST to be a function. *-within: Updated doc accordingly.
;; 2012/04/08 dadams
;; icicle-minibuffer-default-add-dired-shell-commands: Make autoload cookie load icicles[.el].
;; 2012/03/30 dadams
;; icicle-join-nth-parts:
;; Handle a singleton PARTS normally, according to icicle-list-use-nth-parts - do not just
;; return the CAND. If PARTS is nil, return "".
;; 2012/03/16 dadams
;; icicle-display-candidates-in-Completions:
;; Show thumbnails for image-file bookmarks also (see Bookmark+).
;; Call remove-images to remove left-over image overlays (bug fix).
;; icicle-unpropertize-completion: Removed icicle-keep-newline (no longer used).
;; 2012/02/29 dadams
;; icicle-set-difference. Added optional KEY arg.
;; 2012/02/22 dadams
;; icicle-read-char-by-name: Updated per Juri's Emacs 24 patch (see Emacs bug #10857).
;; 2012/02/18 dadams
;; icicle-show-help-in-mode-line: Use property help-echo if icicle-mode-line-help is nil.
;; 2012/02/11 dadams
;; icicle-display-candidates-in-Completions:
;; Always highlight expanded common match now, not just when prefix or *-expand-input is non-nil.
;; icicle-unsorted(-file-name)-(prefix|apropos)-candidates:
;; Set icicle-common-match-string to expansion only if expanding (prefix: 3 or 4, apropos: 4).
;; icicle-save-or-restore-input:
;; Do not save if apropos and not 4 or prefix and not 3 or 4. (Before: checked only for apropos.)
;; icicle-remove-duplicates:
;; Do not use hash table for Emacs 20, even if cl.el loaded, so can byte-compile and use later.
;; 2012/02/08 dadams
;; icicle-remove-duplicates: Redefined to use a hash table.
;; icicle-remove-dups-if-extras: Call icicle-remove-duplicates (not inlined).
;; 2012/02/02 dadams
;; icicle-fuzzy-candidates: Use (min (length input) icicle-swank-prefix-length), not just the var.
;; 2012/01/20 dadams
;; icicle-call-then-update-Completions: Do the sit-for even if only one candidate.
;; 2012/01/17 dadams
;; icicle-insert-candidates:
;; Put mouse-face on final \n also. No longer use property icicle-keep-newline.
;; No longer treat single-newline candidate specially. Thx to Michael Heerdegen.
;; icicle-file-remote-p: Respect new var icicle-network-drive-means-remote-flag: nil means local.
;; icicle-call-then-update-Completions: Corrected logic for triggering re-complete.
;; In particular, REMOTE-TEST = file-remote-p prevents, rather than causes, re-completion.
;; icicle-ms-windows-NET-USE: Corrected hash-table support test: fboundp puthash, not hash-table-p.
;; icicle-choose-completion-string: let -> let* (typo).
;; 2012/01/14 dadams
;; Added: icicle-char-cands-from-charlist, icicle-read-char-maybe-completing, icicle-ucs-names.
;; icicle-read-char-by-name: Added optional arg NAMES. Use icicle-ucs-names, not ucs-names.
;; 2011/12/31 dadams
;; Reversed fix of 2011/04/12 for Emacs < 23:
;; icicle-unsorted-file-name-*, icicle-apropos-any-file-name-candidates-p:
;; Use default-directory, not minibuffer-completion-predicate, for Emacs < 23.
;; 2011/12/28 dadams
;; Removed mention of obsolete option icicle-cycle-into-subdirs-flag.
;; 2011/12/24 dadams
;; icicle-insert-candidates:
;; When only one column, set window width to column width.
;; Use option icicle-Completions-max-columns.
;; icicle-fit-completions-window: Clarify doc string.
;; 2011/12/15 dadams
;; icicle-display-candidates-in-Completions:
;; For face icicle-historical-candidate, expand file names before comparing.
;; 2011/12/06 dadams
;; icicle-read-from-minibuffer: Do not add default value to prompt.
;; 2011/10/21 dadams
;; Added: icicle-propertize.
;; Renamed: icicle-unpropertize to icicle-unpropertize-completion. Applied renaming everywhere.
;; icicle-display-candidates-in-Completions, icicle-kill-a-buffer: Use icicle-propertize.
;; 2011/10/09 dadams
;; Moved here from icicles-mac.el: icicle-try-switch-buffer, select-frame-set-input-focus.
;; Copied here from icicles-mac.el: icicle-assoc-delete-all.
;; Removed autoload cookie for icicle-maybe-cached-action.
;; 2011/10/08 dadams
;; Added: icicle-delete-alist-dups.
;; icicle-completing-read-history:
;; Use prin1, not princ, to convert to strings. Thx to Michael Heerdegen.
;; icicle-key-description: Added PREFIX arg. Use Emacs 22+ form of key-description if available.
;; Changed arg NO-ANGLES to ANGLES.
;; icicle-read-char-by-name: Do not remove VARIATION* names (Unicode).
;; 2011/10/05 dadams
;; icicle-display-candidates-in-Completions:
;; Use same font family, not same font, as orig buff. Only for Emacs 23+, and only when
;; icicle-pre-minibuffer-buffer is defined. Removed dedicated-p condition. Removed zoom-out.
;; 2011/10/02 dadams
;; Added: icicle-read-char-by-name.
;; icicle-display-candidates-in-Completions: Give *Completions* the same font as starting buffer.
;; 2011/09/14 dadams
;; Added: icicle-some.
;; Moved here from icicles-cmd2.el: icicle-flat-list (but no longer used).
;; 2011/09/05 dadams
;; icicle-display-candidates-in-Completions: Act on new option icicle-hide-non-matching-lines-flag.
;; 2011/09/02 dadams
;; Added: icicle-delete-dups.
;; icicle-display-candidates-in-Completions: Don't highlight an empty match.
;; icicle-insert-candidates:
;; If only one column then colwidth should not be more than max-cand-len.
;; If whole cand is a single \n then do not treat it as the last \n (do not remove mouse-face).
;; 2011/08/27 dadams
;; icicle-recentf-make-menu-items, icicle-display-candidates-in-Completions,
;; icicle-command-abbrev-save, icicle-kill-a-buffer:
;; Use icicle-condition-case-no-debug instead of condition-case. Thx to Michael Heerdegen.
;; 2011/08/26 dadams
;; icicle-place-cursor: Put cursor at eob if get invalid-regexp error.
;; icicle-get-candidates-from-saved-set: Use %s, not %S, in error format string.
;; 2011/08/15 dadams
;; icicle-display-completion-list: Do not call (last ...) if COMPLETIONS is null.
;; Added: icicle-all-completions.
;; Use icicle-all-completions, not all-completions, wherever a 4th arg is passed.
;; 2011/08/12 dadams
;; icicle-completing-p: Handle cases of filename must-match maps.
;; icicle-file-name-input-p: Improved doc string.
;; 2011/08/09 dadams
;; Added: icicle-replace-mct-cand-in-mct.
;; 2011/08/07 dadams
;; icicle-display-candidates-in-Completions,
;; icicle-highlight-(initial-whitespace|complete-input|lighter), icicle-case-string-less-p,
;; icicle-expanded-common-match-1, icicle-insert-cand-in-minibuffer, icicle-place-cursor,
;; icicle-(special|extra)-candidates-first-p: Handle absolute file names too:
;; (icicle-file-name-input-p) -> (or (icicle-file-name-input-p) icicle-abs-file-candidates)
;; icicle-display-candidates-in-Completions:: icicle-transform-multi-completion for image-file.
;; 2011/08/03 dadams
;; icicle-lisp-vanilla-completing-read:
;; Handle recent Emacs 24 changes: make-compose-keymap etc. Thx to Stefan Monnier.
;; 2011/07/30 dadams
;; Moved to icicles-cmd2.el and wrapped in eval-after-load hexrgb:
;; icicle-color-*-lessp (except -rgb-), icicle-color-completion-setup, icicle-color-help,
;; icicle-make-color-candidate.
;; 2011/07/27 dadams
;; Use icicle-completions-format everywhere, not icicle-completions-format-internal (removed).
;; icicle-nb-of-cand-in-Completions-horiz: Bind icicle-completions-format to horizontal, not nil.
;; 2011/07/26 dadams
;; icicle-insert-candidates: Vertical multiline: add only one newline, not two. Use \' not $.
;; Removed: icicle-list-end-string (no longer needed).
;; Thx to Michael Heerdegen.
;; 2011/07/20 dadams
;; icicle-mctized-full-candidate: Don't change icicle-completions-format-internal to horizontal.
;; icicle-insert-candidates: If any candidate is multiline then use only one column.
;; Thx to Michael Heerdegen.
;; 2011/07/06 dadams
;; icicle-fit-completions-window:
;; Emacs 22/23 fix: do not call fit-window-to-buffer. Thx to Michael Heerdegen.
;; icicle-read-face-name: Added version for Emacs 24+.
;; 2011/06/05 dadams
;; icicle-unsorted(-file-name)-prefix-candidates, icicle-prefix-any(-file-name)-candidates-p:
;; Add METADATA arg to icicle-completion-(try|all)-completion(s) calls.
;; 2011/06/03 dadams
;; icicle-completion-(all|try)-completion(s):
;; Added optional METADATA arg to handle Emacs 24's new METADATA arg.
;; Replace icicle-help-in-mode-line-flag by icicle-help-in-mode-line-delay everywhere.
;; icicle-show-in-mode-line: Use icicle-help-in-mode-line-delay, not hard-coded 10 sec.
;; 2011/05/31 dadams
;; icicle-read-file-name: Reordered let bindings (cosmetic).
;; 2011/05/22 dadams
;; Added defvars for free vars to quiet byte compiler.
;; 2011/05/12 dadams
;; icicle-candidate-short-help: Do nothing if string is empty ("").
;; 2011/05/07 dadams
;; icicle-insert-cand-in-minibuffer: Go to prompt end before insert.
;; 2011/05/04 dadams
;; icicle-transform-multi-completion: If cand is "" just return it. (Emacs 20 split-string bug.)
;; 2011/05/03 dadams
;; Added: icicle-position, icicle-merge-saved-order-less-p.
;; icicle-display-candidates-in-Completions: Respect icicle-highlight-saved-candidates-flag.
;; 2011/04/20 dadams
;; icicle-completion-setup-function: Last version is for Emacs 23.3 also. Thx to Michael Heerdegen.
;; 2011/04/18 dadams
;; icicle-face-valid-attribute-values: Added Emacs 23+ version. Thx to Aankhen.
;; 2011/04/12 dadams
;; Added defvars for icicle-dirs-done and icicle-files, for free vars.
;; Bind *-files in icicle-dired-read-shell-command. Bind *-dirs-done in icicle-files-within.
;; Use *-files in icicle-*-add-dired-*. Use *-dirs-done in icicle-files-within-1.
;; icicle-color-completion-setup: Renamed (free elsewhere): named-colors -> icicle-named-colors.
;; Applied renaming: prompt -> icicle-prompt.
;; icicle-unsorted-file-name-prefix-candidates, icicle-unsorted-file-name-apropos-candidates,
;; icicle-apropos-any-file-name-candidates-p:
;; Use minibuffer-completion-predicate, not default-directory, in calls to all-completions.
;; Thx to Michael Heerdegen.
;; 2011/03/31 dadams
;; icicle-read-file-name, icicle-read-number, icicle-read-char-exclusive,
;; icicle-read-string-completing, icicle-color-completion-setup:
;; Wrap calls to icicle-var-is-of-type-p with condition-case. Thx to Michael Heerdegen.
;; 2011/03/29 dadams
;; icicle-show-help-in-mode-line: Removed boundp condition for icicle-completing-keys-p.
;; icicle-scroll-or-update-Completions:
;; Applied renaming: icicle-scroll-Completions to icicle-scroll-Completions-forward.
;; icicle-color-completion-setup: prompt -> icicle-prompt.
;; icicle-alt-act-fn-for-type: orig-window -> icicle-orig-window.
;; 2011/03/26 dadams
;; icicle-read-face-name: Need copy-sequence for prompt in later Emacs versions also (forgot).
;; 2011/03/17 dadams
;; icicle-display-candidates-in-Completions: Added 2-pixel margin around thumbnail image.
;; 2011/03/04 dadams
;; icicle-read-file-name: Bind read-file-name-predicate. Thx to Michael Heerdegen.
;; icicle-alt-act-fn-for-type: Ensure orig-window is live before use it. Thx to Michael Heerdegen.
;; 2011/02/22 dadams
;; icicle-display-candidates-in-Completions: Show thumbnail for an image file.
;; Call icicle-fit-completions-window explicitly here.
;; icicle-fit-completions-window: Added optional arg (not used yet). Ensure window is Completions.
;; 2011/02/20 dadams
;; Added: icicle-color-(distance)-(hsv|rgb)-lessp.
;; icicle-color-completion-setup: Added sort orders for HSV and RGB: component order and distance.
;; 2011/02/17 dadams
;; icicle-join-nth-parts: If only one part then don't append the join string.
;; 2011/01/31 dadams
;; icicle-insert-candidates: Fixed test for remainder cands: (= n (* r c)), not (= 0 (mod n r)).
;; 2011/01/11 dadams
;; icicle-choose-completion-string:
;; Removed code that uses base-size, choose-completion-delete-max-match. Just replace all input.
;; 2011/01/05 dadams
;; Added: icicle-file-type-less-p.
;; icicle-highlight-input-noncompletion: When move overlay, specify buffer (for recursive minibuf).
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/12/23 dadams
;; icicle-expand-file-name-20: Allow for inputs to be nil.
;; 2010/12/18 dadams
;; Moved icicle-assoc-delete-all to icicles-mac.el, since used there.
;; Added autoload cookies for cmds & macro; removed them from non-interactive functions.
;; 2010/12/14 dadams
;; Added: icicle-expand-file-name-20.
;; Renamed: icicle-expand-file-name to icicle-expand-file-or-dir-name.
;; icicle-abbreviate-or-expand-file-name, icicle-expand-file-or-dir-name:
;; Use icicle-expand-file-name-20.
;; icicle-completion-setup-function for Emacs < 22: Fix typo: last-command -> this-command.
;; icicle-expanded-common-match: Removed from doc string: statement that result is regexp-quoted.
;; 2010/12/11 dadams
;; icicle-completion-setup-function: Added a version for Emacs 23.2+. Thx to Michael Heerdegen.
;; 2010/11/20 dadams
;; icicle-toggle-icicle-mode-twice: Soft-require icicles-mode.el.
;; eval-after-load for crm.el:
;; Put toggle-twice on eval-after-load of icicles-mode, instead of doing it if i-m.el is loaded.
;; 2010/11/07 dadams
;; Added helper macro icicle-maybe-cached-action.
;; icicle-alt-act-fn-for-type: use icicle-maybe-cached-action so use same action for all cands.
;; 2010/11/06 dadams
;; icicle-fuzzy-candidates: Filter using icicle-must-pass-after-match-predicate.
;; Respect also extra cands and proxy cands.
;; Let C-g exit completion.
;; 2010/10/25 dadams
;; icicle-read-shell-command-completing:
;; Use icicle-must-pass-after-match-predicate, not icicle-must-pass-predicate.
;; 2010/10/24 dadams
;; icicle-unsorted(-file-name)-(prefix|apropos)-candidates:
;; Respect icicle-must-pass-after-match-predicate.
;; icicle-alt-act-fn-for-type: Use icicle-must-pass-after-match-predicate, not PREDICATE arg.
;; 2010/10/07 dadams
;; Added: icicle-current-TAB-method (function). Use it in place of var everywhere.
;; 2010/10/04 dadams
;; directory-sep-char -> ?/ (It was removed from Emacs 24.)
;; 2010/06/18 dadams
;; icicle-completing-read:
;; Initialize icicle-completions-format-internal to icicle-completions-format.
;; icicle-mctized-full-candidate:
;; Set icicle-completions-format-internal to horizontal for multi-line multi-completions.
;; icicle-insert-candidates:
;; Remove face property from end of candidate to next column.
;; Replace icicle-completions-format by icicle-completions-format-internal.
;; Renamed: bookmarkp-* to bmkp-*.
;; 2010/06/14 dadams
;; icicle-read-from-minibuffer:
;; If add file-name default to prompt, remove dir part first. Thx to Chris Hecker.
;; icicle-next-candidate: Do not icicle-recompute-candidates if this command was repeated.
;; icicle-increment-cand-nb+signal-end:
;; Signal wrap from initial, not from 0. Negative INCR -> start at end. Thx to M. Heerdegen.
;; icicle-call-then-update-Completions:
;; Set icicle-last-input to nil so icicle-save-or-restore-input makes next-candidate recompute.
;; 2010/06/12 dadams
;; icicle-fit-completions-window: Let-bind window-min-height to prevent deletion in Emacs 23.
;; 2010/06/10 dadams
;; icicle-maybe-sort-and-strip-candidates:
;; Set icicle-completion-candidates to result of *maybe...maybe*. (It broke C-~.)
;; 2010/06/09 dadams
;; icicle-isearch-complete-past-string: Use the last-used ring. Thx to Michael Heerdegen.
;; 2010/06/08 dadams
;; icicle-display-candidates-in-Completions: Show also total when truncated: N shown / M.
;; icicle-maybe-sort-maybe-truncate: Save icicle-nb-candidates-before-truncation before truncating.
;; 2010/06/04 dadams
;; Added: icicle-clear-lighter, icicle-maybe-sort-maybe-truncate, icicle-take.
;; icicle-(prefix|apropos)-candidates, icicle-strip-ignored-files-and-sort,
;; icicle-maybe-sort-and-strip-candidates, icicle-display-Completions:
;; Use icicle-maybe-sort-maybe-truncate, not icicle-reversible-sort.
;; icicle-(un)highlight-lighter: Use icicle-clear-lighter (factored out).
;; 2010/05/30 dadams
;; Added: icicle-files-within-1.
;; icicle-files-within:
;; Use icicle-files-within-1. Optionally don't follow symlinks (new arg NO-SYMLINKS-P).
;; Don't process same dir twice. Respect icicle-ignored-directories. Thx to Michael Heerdegen.
;; 2010/05/18 dadams
;; icicle-save-or-restore-input:
;; Use icicle-file-directory-p, not file-directory-p (fails: ~/foo//usr/). Thx to M. Heerdegen.
;; 2010/05/04 dadams
;; icicle-alt-act-fn-for-type: Pass TYPE to icicle-apply-to-saved-candidate.
;; 2010/04/30 dadams
;; icicle(-file-name)-unsorted-(apropos|prefix)-candidates, icicle-fuzzy-candidates:
;; Set icicle-common-match-string to nil when no candidates.
;; 2010/04/29 dadams
;; icicle-unpropertize: Do nothing unless icicle-remove-icicles-props-p.
;; 2010/04/27 dadams
;; icicle-show-help-in-mode-line: Test value, not just boundp, of icicle-completing-keys-p.
;; 2010/04/21 dadams
;; icicle-mode-line-name-less-p: Removed bogus calls to symbol-name. Thx to Michael Heerdegen.
;; 2010/04/20 dadams
;; Added: icicle-dirs-first-p.
;; 2010/04/02/dadams
;; icicle-completing-p: Cache t, not the keymap portion.
;; 2010/03/16 dadams
;; icicle-display-candidates-in-Completions, treating icicle-candidate-properties-alist:
;; For subsequent matches of join string, skip over the last join string (not 1 char).
;; icicle-candidate-short-help: Treat each property individually.
;; 2010/03/13 dadams
;; icicle-reversible-sort: Respect icicle-transform-before-sort-p.
;; 2010/03/10 dadams
;; icicle-show-help-in-mode-line:
;; Put this test first: If candidate is a string with a help property, use that.
;; Use get-file-buffer, not get-buffer, for a visited file.
;; 2010/03/09 dadams
;; icicle-reversible-sort: Added optional KEY arg. Set LIST to sort result and return it.
;; icicle-multi-sort: Set RESULT to funcall result.
;; 2010/03/03 dadams
;; Added: icicle-multi-sort, icicle-make-plain-predicate, icicle-alpha-p.
;; icicle-reversible-sort: Use icicle-sort-comparer and icicle-multi-sort.
;; Reset to unsorted if an error is raised.
;; Applied renamings: icicle-sort-function to icicle-sort-comparer,
;; icicle-sort-functions-alist to icicle-sort-orders-alist.
;; icicle-read-shell-command-completing: Removed extra binding for icicle-sort-function.
;; 2010/01/12 dadams
;; icicle-display-candidates-in-Completions: set-buffer -> with-current-buffer.
;; 2009/12/25 dadams
;; icicle-strip-ignored-files-and-sort:
;; Call completion-ignored-build-apply and icicle-update-ignored-extensions-regexp.
;; 2009/12/21 dadams
;; fset -> defalias.
;; 2009/12/07 dadams
;; Added: icicle-minibuffer-default-add-dired-shell-commands.
;; icicle-dired-read-shell-command: Instead of using minibuffer-default-add-shell-commands,
;; use icicle-minibuffer-default-add-dired-shell-commands.
;; icicle-read-shell-command-completing: Bind insert-default-directory to nil.
;; icicle-dir-prefix-wo-wildcards: Don't ever return nil - return "" if need be.
;; icicle-read-string:
;; Handle a consp default-value when user enters "": use the car. Thx to Sakuma Ryo.
;; 2009/12/03 dadams
;; icicle-completing-read:
;; Make sure we don't use a nil def value for init value. Thx to Sebastian Luque.
;; 2009/11/27 dadams
;; *-display-candidates-in-Completions, *-prefix-candidates, *-fuzzy-candidates:
;; Handle swank completions too.
;; 2009/11/25 dadams
;; icicle-insert-candidates: Handle vertical layout: icicle-completions-format.
;; 2009/11/03 dadams
;; icicle-color-completion-setup: Use hexrgb-defined-colors, not x-defined-colors.
;; No icicle-transform-function, since we use hexrgb.el.
;; 2009/10/25 dadams
;; Added: icicle-dir-prefix-wo-wildcards. Use in icicle-insert-cand-in-minibuffer.
;; icicle-save-or-restore-input: Remove test comparing last completion with current input.
;; icicle-abbreviate-or-expand-file-name: If arg is absolute, do not expand.
;; icicle-display-candidates-in-Completions, icicle-prefix-candidates,
;; icicle-not-basic-prefix-completion-p:
;; Updated for new completion methods. Use *-current-TAB-method, not old fuzzy flag.
;; 2009/10/24 dadams
;; icicle-unsorted-file-name-*-candidates, icicle-*-any-file-name-candidates-p:
;; Got rid of slashed-p.
;; icicle-unsorted-file-name-apropos-candidates:
;; Set icicle-common-match-string to nil if there are no candidates.
;; icicle-apropos-any-file-name-candidates-p:
;; When input is a dir, remove final /, so we don't non-match highlight the / (empty dir).
;; Bind case-fold-search, for apropos matching.
;; icicle-abbreviate-or-expand-file-name: Set DIR to nil if it's relative.
;; 2009/10/22 dadams
;; Added: icicle-file-name-directory.
;; icicle-completion-setup-function, icicle-display-candidates-in-Completions,
;; icicle-save-or-restore-input, icicle-file-name-directory-w-default,
;; icicle-historical-alphabetic-p:
;; Use icicle-file-name-directory, not file-name-directory.
;; 2009/10/17 dadams
;; icicle-completion-try-completion: Return RES.
;; 2009/10/12 dadams
;; icicle-unsorted-prefix-candidates, icicle-prefix-any-candidates-p:
;; Use length of INPUT, not length from point backward to field-beginning.
;; icicle-input-from-minibuffer: Added optional LEAVE-ENVVARS-P arg.
;; icicle-next-candidate, icicle-highlight-complete-input:
;; Call icicle-input-from-minibuffer with LEAVE-ENVVARS-P arg.
;; icicle-completion-all-completions:
;; If not basic completion (Emacs 23) and input ends in $, then append $ to cands also.
;; 2009/09/25 dadams
;; icicle-file-name-prefix-candidates: Use whole input, not just nondirectory.
;; Added: icicle-not-basic-prefix-completion-p. Use where appropriate.
;; 2009/09/19 dadams
;; icicle-unpropertize: Remove the internal text properties added by Icicles.
;; icicle-completing-read, icicle-read-file-name: Call icicle-unpropertize unconditionally.
;; 2009/09/12 dadams
;; icicle-kill-a-buffer: Bind enable-recursive-minibuffers, to confirm modified buffer.
;; 2009/09/05 dadams
;; icicle-msg-maybe-in-minibuffer: Do nothing if icicle-minibuffer-message-ok-p is nil.
;; 2009/08/19 dadams
;; icicle-candidate-short-help: Return (possibly propertized) STRING.
;; 2009/08/09 dadams
;; Added: icicle-insert-cand-in-minibuffer - factored out code from icicle-next-candidate.
;; eval-after-load "crm":
;; Test that icy-mode is available using featurep, not fboundp. Thx to Michael Heerdegen.
;; 2009/07/26 dadams
;; icicle-completing-read, icicle-read-file-name-1:
;; Bind minibuffer-history-variable to itself.
;; 2009/07/13 dadams
;; icicle-read-face-name (Emacs 20 version): Use copy-sequence on prompt, before add prop.
;; 2009/07/12 dadams
;; icicle-display-completion-list:
;; Use different protection (fboundp) for fix for latest Emacs 23 crap (base size in cdr).
;; 2009/07/11 dadams
;; icicle-next-candidate:
;; If icicle-regexp-quote-flag, regexp-quote before string-match for highlighting root.
;; icicle-place-cursor: If icicle-regexp-quote-flag, regexp-quote input to search for it.
;; 2009/07/02 dadams
;; icicle-displayable-cand-from-saved-set:
;; If icicle-readable-to-markers returns an atom, just use that.
;; 2009/06/17 dadams
;; icicle-fit-completions-window: Scale text size initially.
;; 2009/06/07 dadams
;; icicle-get-alist-candidate -> funcall icicle-get-alist-candidate-function.
;; icicle-mctize-all: If PRED is nil, so is NEWPRED (use and instead of when).
;; 2009/05/22 dadams
;; Require icicles-mac.el if load-library doesn't find it.
;; 2009/05/18 dadams
;; icicle-display-candidates-in-Completions: deactivate-mark in *Completions* after display.
;; 2009/05/17 dadams
;; icicle-next-candidate: Updated to reflect thumb-frm.el name changes.
;; 2009/05/17 dadams
;; Added: icicle-toggle-icicle-mode-twice.
;; In eval-after-load crm: Use icicle-toggle-icicle-mode-twice, not icy-mode calls.
;; 2009/05/15 dadams
;; icicle-unhighlight-lighter: Wrap redisplay in condition-case, like elsewhere.
;; 2009/05/11 dadams
;; Added: icicle-upcase. Use in place of upcase everywhere, to work around Emacs 20 bug.
;; Added: icicle-local-keys-first-p.
;; icicle-display-candidates-in-Completions:
;; Don't highlight historical candidate if in icicle-hist-cands-no-highlight.
;; 2009/05/09 dadams
;; icicle-input-from-minibuffer: Keep text properties when pick up input.
;; icicle-highlight-input-noncompletion(-rest): Use an overlay instead of text property.
;; icicle-show-help-in-mode-line: Fix special case for pseudo-key/cmd ..: go up to prefix.
;; 2009/05/07 dadams
;; icicle-display-candidates-in-Completions, in the code that hides common match:
;; Don't reset display property to nil.
;; Use icicle-common-match-string, not current input.
;; icicle-expanded-common-match-1:
;; If input doesn't match candidate, return nil. Throw nil, not input, everywhere.
;; *-unsorted(-file-name)-apropos-candidates, *-apropos-any(-file-name)-candidates-p:
;; Protect calls to icicle-apropos-complete-match-fn with condition-case, for Emacs 20.
;; icicle-place-cursor: Added optional arg.
;; 2009/05/05 dadams
;; icicle-alt-act-fn-for-type:
;; Bind completion-ignore-case, based on read-buffer-completion-ignore-case.
;; 2009/05/03 dadams
;; Use (fboundp 'minibuffer-default-add-completions), not (> emacs-major version 22).
;; 2009/05/01 dadams
;; Renamed: icicle-choose-action-for-type to icicle-alt-act-fn-for-type.
;; icicle-type-actions-alist: Rewrote. Handle both list of objs and single obj.
;; icicle-quote-file-name-part-of-cmd: Rewrote. Quote file name always, and only file name.
;; 2009/04/30 dadams
;; icicle-show-in-mode-line: Clear any message (e.g. Computing completion candidates...).
;; 2009/04/29 dadams
;; icicle-get-alist-candidate: If NO-ERROR-P is 'no-error-no-msg, just return nil (no msg).
;; icicle-choose-action-for-type: Use lax completion.
;; 2009/04/28 dadams
;; icicle-choose-action-for-type:
;; Moved here from icicles-mac.el, changed to a function, and locally bind
;; *-alt-action-fn to icicle-choose-action-for-type function.
;; For undefined TYPE, provide all functions as candidates.
;; Added eval-when-compile of load-library icicles-mac.
;; 2009/04/27 dadams
;; icicle-recompute-candidates:
;; Keep no-display completion mode, if that's current.
;; Set icicle-last-completion-command only if completion type, not user input, changed.
;; icicle-complete-again-update: Added icicle-prefix-complete-no-display to first case.
;; 2009/04/19 dadams
;; Use unless instead of or for fset's. (cosmetic)
;; icicle-completing-read, icicle-read-from-minibuffer, icicle-read-string:
;; Renamed history parameter to HIST-m@%=!$+&^*z, so C-h f output looks less strange.
;; 2009/04/18 dadams
;; Soft-require hexrgb.el unconditionally, not just when there is a window-system.
;; 2009/04/12 dadams
;; icicle-display-candidates-in-Completions: Added number of candidates to mode-line.
;; icicle-show-help-in-mode-line: Use face icicle-show-help-in-mode-line. Fix prefix keys.
;; 2009/04/11 dadams
;; icicle-candidate-short-help:
;; Do nothing if either icicle-help-in-mode-line-flag or tooltip-mode is nil.
;; icicle-show-help-in-mode-line:
;; If no symbol help, try string.
;; Handle lambdas, menu-function-# from easy-menu, and prefix keys.
;; icicle-make-color-candidate: Construct short help only if user will see it.
;; 2009/04/10 dadams
;; Added: icicle-candidate-short-help, icicle-color-completion-setup (from icicle-read-color).
;; Moved here from icicle-cmds.el:
;; icicle-remove-color-duplicates, icicle-color-help, icicle-make-color-candidate.
;; icicle-make-color-candidate: Added short help, using icicle-candidate-short-help.
;; icicle-show-help-in-mode-line:
;; Treat :icicle-candidate-help text property on strings.
;; Use candidate, not cand, for stringp clause, and use icicle-transform-multi-completion.
;; Renamed: :icicle-candidate-help to icicle-mode-line-help.
;; 2009/04/08 dadams
;; icicle-show-help-in-mode-line: Treat absolute file names too.
;; 2009/04/07 dadams
;; icicle-show-help-in-mode-line: (bufferp (get-buffer...)...) -> (get-buffer...) Duh.
;; 2009/04/06 dadams
;; Added: icicle-show-help-in-mode-line - from code in icicle-next-candidate:
;; Added arg. Handle: faces, buffer names, file names, :icicle-candidate-help.
;; Added: icicle-help-line-(buffer|file).
;; icicle-next-candidate: Use icicle-show-help-in-mode-line.
;; 2009/04/05 dadams
;; Added: icicle-show-in-mode-line.
;; icicle-next-candidate: Use icicle-show-in-mode-line to show help in mode-line.
;; 2009/04/04 dadams
;; Added: icicle-buffer-smaller-p, icicle-major-mode-name-less-p,
;; icicle-mode-line-name-less-p, icicle-buffer-file/process-name-less-p.
;; 2009/04/03 dadams
;; icicle-read-from-minibuffer: Save filtered default val as icicle-filtered-default-value.
;; icicle-lisp-vanilla-completing-read: Use icicle-filtered-default-value, not DEF, at end.
;; 2009/03/29 dadams
;; icicle-read-shell-command: If non-nil initial-contents, punt to use original (old-*).
;; 2009/03/27 dadams
;; Don't fset minibuffer-default-add-completions unless > Emacs 22.
;; 2009/03/27 dadams
;; icicle-read-from-minibuffer: Use icicle-filter-wo-input on default-value (all values).
;; icicle-completing-read, icicle-read-file-name-1:
;; Use icicle-filter-wo-input on default value only to get init value.
;; Added: icicle-minibuffer-default-add-completions, icicle-first-N.
;; 2009/03/26 dadams
;; icicle-completing-read, icicle-read-file-name-1:
;; Filter default values using icicle-filter-wo-input.
;; icicle-filter-wo-input: Return the candidate, if it passes filtering.
;; 2009/03/16 dadams
;; Added: icicle-recentf-make-menu-items.
;; 2009/03/10 dadams
;; icicle-read-shell-command-completing: Applied renamings: icicle-guess-commands-in-path,
;; icicle-shell-command-candidates-cache, icicle-recompute-shell-command-candidates.
;; Moved to icicles-opt.el and renamed: icicle-shell-command-candidates.
;; 2009/03/08 dadams
;; Added: icicle-quote-file-name-part-of-cmd.
;; icicle-read-shell-command-completing:
;; Call icicle-quote-file-name-part-of-cmd to escape spaces etc. in file names.
;; Removed unneeded minibuffer-local-*-map let bindings.
;; icicle-dired-smart-shell-command:
;; Protected dired-default-directory with fboundp, for Emacs 20.
;; 2009/03/01 dadams
;; icicle-read-from-minibuffer:
;; No longer use icicle-complete-on-demand-cmd and on-demand-map.
;; 2009/02/28 dadams
;; Don't fset old-dired-smart-shell-command here - do after load Dired-X (icicles-mode.el).
;; Added for Emacs 20: definition of replace-regexp-in-string.
;; icicle-read-(number|string-completing):
;; No need for fboundp of replace-regexp-in-string, since provide it now for Emacs 20.
;; icicle-read-file-name: Treat directory candidates as special candidates.
;; icicle-read-shell-command-completing:
;; Candidate help depends on candidate type.
;; Use existing icicle-extra-candidates as its own default, not icicle-file-extras.
;; 2009/02/27 dadams
;; icicle-shell-command: Fixed typo: shell-command -> old-shell-command.
;; icicle-read-shell-command-completing: Append icicle-file-extras to i*-extra-candidates.
;; 2009/02/23 dadams
;; icicle-read-shell-command-completing:
;; Bind icicle-extra-candidates-dir-insert-p, not insert-default-directory, to nil.
;; icicle-next-candidate: Protect dir insertion with icicle-extra-candidates-dir-insert-p.
;; 2009/02/22 dadams
;; icicle-dired-read-shell-command: Use minibuffer-default-add-shell-commands if available.
;; 2009/02/20 dadams
;; icicle-read-from-minibuffer: Treat icicle-complete-on-demand-cmd - on-demand completion.
;; Added: icicle-dired-smart-shell-command, icicle-read-shell-command-completing,
;; icicle-dired-read-shell-command, icicle-extra-candidates-first-p,
;; icicle-require-match-p, icicle-shell-command(-on-region).
;; icicle-read-shell-command:
;; Call icicle-read-shell-command-completing. Define always, not just when mailcap.
;; icicle-dired-guess-shell-command: Just call icicle-read-shell-command-completing.
;; icicle-shell-command-candidates: Cache completions in icicle-shell-command-candidates.
;; icicle-highlight-input-noncompletion(-rest), icicle-highlight-lighter:
;; Use function icicle-require-match-p, not var.
;; icicle-completing-p: Test also whether parent map is a completion map. Always cache.
;; 2009/02/17 dadams
;; icicle-read-shell-command: Handle nil default-value. Thx to Kao Felix.
;; icicle-read-file-name: Append new proxy cands to any existing ones.
;; Don't assume that a proxy cand is a variable.
;; 2009/01/25 dadams
;; Added: *-dired-guess-shell-command, *-read-shell-command, *-shell-command-candidates.
;; 2009/01/17 dadams
;; icicle-display-candidates-in-Completions: Highlight Levenshtein (1) match.
;; icicle-unsorted-apropos(-file-name)-candidates, icicle-display-Completions,
;; icicle-apropos-any(-file-name)-candidates-p: Removed PCM.
;; Added: icicle-levenshtein(-strict|-one)-match, icicle-levenshtein-one-regexp,
;; icicle-substrings-of-length.
;; 2009/01/15 dadams
;; Lose "icicle-" for fboundp's: completion-all-completions, completion-try-completion.
;; 2009/01/14 dadams
;; Added: icicle-remove-dups-if-extras.
;; 2009/01/13 dadams
;; Added: icicle-completion-all-completions, icicle-completion-try-completion.
;; icicle-unsorted(-file-name)-(prefix|apropos)-candidates, icicle-display-Completions,
;; icicle-any-(prefix|apropos)(-file-name)-candidates-p:
;; Respect icicle-respect-completion-styles-p (Emacs 23).
;; icicle-unsorted-file-name-prefix-candidates: Removed matching "^"++(regexp-quote input).
;; icicle(-unsorted)(-file-name)-(prefix|apropos)-candidates:
;; Call icicle-transform-candidates for extra candidates and proxy candidates too.
;; icicle-display-candidates-in-Completions: Highlight extra candidates.
;; icicle-face-valid-attribute-values:
;; Use font-family-list instead of x-font-family-list, if available.
;; 2009/01/03 dadams
;; icicle-call-then-update-Completions:
;; If icicle-last-completion-command is nil, test icicle-current-completion-mode - don't
;; just call icicle-prefix-complete. E.g. icicle-search shouldn't end with a single
;; prefix match.
;; 2008/12/25 dadams
;; Added: icicle-save-raw-input (factored out from icicle-save-or-restore-input).
;; icicle-save-or-restore-input:
;; Change test whether last-command is cycling cmd to add also not being completing cmd.
;; Use icicle-completing-p instead of testing this-command for being a cycling cmd.
;; Use icicle-save-raw-input.
;; icicle-next-candidate: Set icicle-cycling-p (new var) to t.
;; 2008/12/20 dadams
;; icicle-save-or-restore-input: Don't restore last input if this is a completing command.
;; 2008/12/07 dadams
;; icicle-completing-read, icicle-read-file-name-1:
;; Removed icicle-prompt. Don't add completion prompt prefix, except for Emacs 20.
;; 2008/12/06 dadams
;; icicle-call-then-update-Completions:
;; To update, call icicle-last-completion-command, not icicle-(apropos|prefix)-complete.
;; 2008/12/02 dadams
;; icicle-unsorted(-file-name)-apropos-candidates:
;; Call icicle-filter-wo-input before filtering with user input (as the doc string says).
;; 2008/11/28 dadams
;; icicle-recompute-candidates, icicle-save-or-restore-input:
;; Test property icicle-(prefix|apropos)-completing-command, not eq cmds.
;; 2008/11/23 dadams
;; icicle-read-file-name:
;; Don't initialize icicle-proxy-candidates unless icicle-add-proxy-candidates-flag.
;; Don't add + to completion indicator if Emacs 23.
;; 2008/11/22 dadams
;; icicle-completing-read:
;; Bind icicle-fancy-cands-internal-p. Do not call icicle-mctize-all unless fancy cands.
;; icicle-mctized-full-candidate:
;; No-op unless icicle-fancy-cands-internal-p or icicle-whole-candidate-as-text-prop-p.
;; icicle-read-(number|char-exclusive|string-completing|face-name):
;; Put icicle-fancy-candidates property on prompt if proxy candidates.
;; icicle-display-candidates-in-Completions:
;; Don't transform candidates unless icicle-fancy-cands-internal-p.
;; 2008/11/18 dadams
;; icicle-display-candidates-in-Completions:
;; Add icicle-special-candidate property as text property to candidates in
;; icicle-completion-candidates, instead of just to display candidate, so returned also.
;; Added support for icicle-display-string property.
;; For these properties: look up symbol first in minibuffer-completion-table if obarray.
;; 2008/11/14 dadams
;; icicle-display-candidates-in-Completions:
;; Respect icicle-hide-common-match-in-Completions-flag.
;; 2008/11/10 dadams
;; icicle(-unsorted)(-file-name)-(apropos|prefix)-candidates:
;; Moved special and proxy candidates outside match filtering,
;; reversing a change made on 2007/11/18. Dunno why that change was made.
;; But filter special and proxy candidates using the input.
;; 2008/11/09 dadams
;; Added: icicle-join-nth-parts, icicle-display-cand-from-full-cand.
;; icicle-transform-multi-completion: Use icicle-join-nth-parts.
;; icicle-transform-multi-completion: Don't test icicle-list-join-string (always non-nil).
;; icicle-first-matching-candidate:
;; Fix: set res properly, not to the tested value. Thx to Hannes Janetzek.
;; 2008/11/07 dadams
;; icicle-color-name-w-bg: Return input if hexrgb.el is not loaded. Thx to Fabrice Knevez.
;; 2008/11/04 dadams
;; icicle-read-face-name: Soft-require eyedropper.el or palette.el.
;; 2008/11/03 dadams
;; icicle-expanded-common-match: Bug fix for Emacs 20: If error matching, just return INPUT.
;; icicle-highlight-input-noncompletion: Erase any message first before highlighting.
;; 2008/11/02 dadams
;; icicle-display-candidates-in-Completions: For icicle-candidate-properties-alist, use
;; narrowed buffer content, not i-current-completion-in-Completions.
;; 2008/10/24 dadams
;; icicle-first-matching-candidate:
;; Use regexp-quote on CAND.
;; Add icicle-list-end-string to each entry in CANDIDATES.
;; Iteration, not recursion.
;; icicle-get-alist-candidate: Added optional arg NO-ERROR-P.
;; 2008/10/18 dadams
;; Replaced customize-save-variable by funcall icicle-customize-save-variable-function.
;; 2008/10/14 dadams
;; Applied renaming of icicle-completion-help to icicle-minibuffer-help.
;; 2008/10/06 dadams
;; Don't toggle icy-mode after loading crm.el unless icy-mode is defined (!).
;; icicle-ms-windows-NET-USE: If hash tables not available, just run the NET USE process.
;; 2008/10/04 dadams
;; Substitute Icicles version of completing-read-multiple and its maps. Thx to Per Nordlow.
;; Added: (icicle|old)-completing-read-multiple, icicle-define-crm-completion-map,
;; (icicle|old)-crm-local-(completion|must-match)-map.
;; icicle-display-completion-list: Protect against Emacs 23 nonsense with base-size in cdr.
;; 2008/09/30 dadams
;; Added: icicle-ms-windows-NET-USE. Thx to Thomas Lim.
;; icicle-file-remote-p: Use icicle-ms-windows-NET-USE.
;; icicle-highlight-input-noncompletion: Return file-local-p if test shows it's local.
;; icicle-call-then-update-Completions:
;; Treat also known file-local-p return from icicle-highlight-input-noncompletion.
;; Renamed icicle-isearch-complete-1 to icicle-isearch-complete-past-string and moved it
;; here from icicles-mcmd.el.
;; icicle-isearch-complete-past-string: Always use regexp-search-ring. Changed prompt.
;; 2008/09/27 dadams
;; icicle-highlight-input-noncompletion: Fixed typo: implicit-remote -> implicit.
;; 2008/09/20 dadams
;; icicle-(apropos|prefix)-candidates, icicle-maybe-sort-and-strip-candidates:
;; Strip ignored files if icicle-abs-file-candidates.
;; 2008/09/19 dadams
;; icicle-get-candidates-from-saved-set: Added optional arg DONT-EXPAND-FILESETS-P.
;; Use icicle-kill-a-buffer, not kill-buffer.
;; Moved icicle-kill-a-buffer here from icicles-cmd.el.
;; Added: icicle-unpropertize.
;; icicle-completing-read, icicle-read-file-name: Use icicle-unpropertize.
;; 2008/09/16 dadams
;; filesets-get-filelist: Fixed :tree so it includes files in subdirs.
;; Added: icicle-filesets-files-under.
;; 2008/09/15 dadams
;; Added: icicle-saved-fileset-p, icicle-displayable-cand-from-saved-set.
;; icicle-get-candidates-from-saved-set:
;; Rewrote code to convert saved candidates to displayable candidates.
;; Use icicle-displayable-cand-from-*, icicle-saved-fileset-p. Require filesets.el.
;; Moved filesets-get-fileset-from-name into and of first cond clause.
;; Wrapped defun of filesets-get-filelist in eval-after-load.
;; 2008/09/13 dadams
;; Added: icicle-get-candidates-from-saved-set (factored from code in
;; icicle-retrieve-candidates-from-set), filesets-get-filelist (redefined),
;; icicle-explicit-saved-completion-candidates.
;; Moved here from icicles-mcmd.el: icicle-readable-to-markers.
;; 2008/09/04 dadams
;; icicle-read-file-name-1: Removed unused code for non icicle-mode case.
;; 2008/09/03 dadams
;; Removed: icicle-(un)highlight-crosshairs, icicle-unhighlight-crosshairs+cleanup.
;; 2008/09/01 dadams
;; Added: icicle-(un)highlight-crosshairs, icicle-unhighlight-crosshairs+cleanup.
;; 2008/08/29 dadams
;; icicle-mctize-all:
;; Do it for all list collections (new icicle-mctized-full-candidate).
;; Adjust PRED to use cdr only for conses with string cars.
;; icicle-mctized-full-candidate:
;; Treat all kinds of list entries: strings, symbols, and conses with symbol args, etc.
;; 2008/08/25 dadams
;; icicle-display-candidates-in-Completions: Do nothing if NO-DISPLAY-P is 'no-msg.
;; 2008/08/24 dadams
;; icicle-filter-wo-input: Filter out empty-string candidates: "".
;; Added: icicle-minibuf-input-sans-dir.
;; Renamed: icicle-minibuffer-contents-from-minibuffer to icicle-input-from-minibuffer,
;; icicle-minibuffer-contents to icicle-minibuf-input.
;; icicle-display-candidates-in-Completions, icicle-next-candidate, icicle-place-cursor:
;; Use icicle-minibuf-input-sans-dir.
;; 2008/08/23 dadams
;; icicle-display-candidates-in-Completions:
;; Wrap preliminary display of *Completions* in save-selected-window.
;; 2008/08/22 dadams
;; icicle-display-candidates-in-Completions:
;; Display *Completions* before calling with-output-to-temp-buffer and filling it.
;; This is so we can know the window width, to determine the correct formatting.
;; icicle-insert-candidates:
;; Don't use lru window or *-Completions-*-default-width (removed). Failsafe width 40.
;; 2008/08/21 dadams
;; icicle-completing-read:
;; Bind minibuffer-completing-file-name to nil if not completing a file name.
;; Removed setq of minibuffer-completion-table. Already do it in *-lisp-vanilla-*.
;; 2008/08/20 dadams
;; icicle-insert-candidates:
;; Turn off mouse-face after insert candidate.
;; Fixup whitespace correctly: Don't remove whitespace that is part of a candidate.
;; Added: icicle-ding.
;; icicle-read-number: Replaced ding by icicle-ding.
;; 2008/08/18 dadams
;; Moved here from icicles-cmd.el (and renamed from *-less-p): icicle-cdr-lessp.
;; Added: icicle-delete-count, icicle-mctize-all, icicle-mctized-(display|full)-candidate,
;; icicle-part-1-cdr-lessp.
;; Renamed: icicle-delete-if(-not) to icicle-remove-if(-not),
;; icicle-put-alist-candidate to icicle-put-whole-cand-prop,
;; icicle-update-completions to icicle-complete-again-update.
;; icicle-completing-read: Factored out transformation to MCT into new fn icicle-mctize-all.
;; 2008/08/08 dadams
;; icicle-completing-read: Updated doc string for Emacs 23.
;; 2008/08/03 dadams
;; icicle-completing-read: Convert the predicate to apply to just the cdr (= original cons).
;; icicle-save-or-restore-input: Don't save empty string ("") to C-l history.
;; 2008/07/27 dadams
;; Added: icicle-2nd-part-string-less-p.
;; Moved here from icicles-mcmd.el: icicle-transform-multi-completion.
;; 2008/07/19 dadams
;; icicle-choose-completion-string: Don't move to point-max unless in minibuffer.
;; 2008/06/24 dadams
;; Make *-must-match-filename-map an alias for *-filename-completion-map. Use the latter.
;; 2008/06/22 dadams
;; icicle-completing-read, icicle-read-file-name:
;; Remove text properties from result (only) if icicle-unpropertize-*-flag.
;; 2008/06/21 dadams
;; icicle-read-file-name: Remove text properties from result file name.
;; 2008/06/01 dadams
;; icicle-lisp-vanilla-completing-read: Typo: minibuffer-local-must-match-filename-map.
;; Put sort predicate properties on some sort predicate symbols, e.g. icicle-dirs-last-p.
;; 2008/05/22 dadams
;; icicle-read-file-name: Bind minibuffer-completing-file-name to t.
;; icicle-read-file-name-1: Do not prepend ". " if Emacs 23+, since it uses completing-read.
;; icicle-(un)highlight-lighter: Reflect case-sensitivity in lighter.
;; 2008/05/11 dadams
;; icicle-unsorted(-file-name)-apropos-candidates:
;; Pass input to all-completions only if not icicle-apropos-complete-match-fn.
;; 2008/05/11 dadams
;; Renamed icicle-fit-Completions-window to icicle-fit-completions-window.
;; icicle-fit-completions-window: Use current window - not necessarily for *Completions*.
;; 2008/05/06 dadams
;; icicle-highlight-lighter: Wrap redisplay in condition-case to ignore any errors.
;; 2008/05/05 dadams
;; icicle-file-name-input-p: Redefined to just use minibuffer-completing-file-name.
;; 2008/05/01 dadams
;; icicle-lisp-vanilla-completing-read, icicle-lisp-vanilla-completing-read,
;; icicle-read-from-minibuffer, icicle-read-number, icicle-read-string-completing:
;; Adapted to Emacs 23 change to allow list of strings for default value.
;; 2008/04/25 dadams
;; icicle-call-then-update-Completions:
;; nil icicle-test-for-remote-files-flag means don't test for remote file name.
;; icicle-highlight-input-noncompletion:
;; Correction: implicit, not always, in combination with not incremental completion.
;; Added check for icicle-completing-command if value is explicit*.
;; Added check for icicle-test-for-remote-files-flag if *-strict with lax completion.
;; Protect call to icicle-file-remote-p with check of icicle-test-for-remote-files-flag.
;; 2008/04/18 dadams
;; Renamed icicle-init-value-flag to icicle-default-value.
;; icicle-read-from-minibuffer:
;; If icicle-default-value is t, add to prompt. Thx to Dominique Quatrevaux.
;; icicle-completing-read, icicle-read-file-name-1, icicle-read-from-minibuffer:
;; Change icicle-default-value test to rule out t also.
;; icicle-completion-setup-function:
;; Don't call file-name-directory unless minibuffer-completing-file-name.
;; 2008/04/01 dadams
;; icicle-unsorted(-file-name)-apropos-candidates:
;; If icicle-unsorted-apropos-candidates pass input to all-completions.
;; icicle-expanded-common-match-1:
;; Use icicle-apropos-complete-match-fn throughout, but return nil if that is nil.
;; icicle-display-candidates-in-Completions:
;; If icicle-apropos-complete-match-fn is nil, don't try to highlight input match.
;; 2008/03/31 dadams
;; icicle-display-candidates-in-Completions:
;; Allow for no completion type, for No completions msg.
;; 2008/03/30 dadams
;; icicle-read-file-name-1:
;; Bind read-file-name-function to nil.
;; Funcall icicle-old-read-file-name-fn instead of old-read-file-name.
;; icicle-(un)highlight-lighter: Respect icicle-highlight-lighter-flag.
;; Top-level: Moved fset for old-read-file-name to icicles-mode.el and renamed it.
;; 2008/03/29 dadams
;; icicle-completing-read, icicle-read-file-name-1:
;; Combine new faces for single-character minibuffer completion status indicator.
;; Call icicle-highlight-lighter after establishing require-match, not at beginning.
;; No longer use completing-prompt-prefix(-symb).
;; No longer use icicle-reminder-prompt-flag (no longer add help to prompt).
;; Removed: icicle-control-reminder-prompt.
;; icicle-highlight-lighter:
;; Combine faces for highlighting. Indicate multi-command and strict/lax completion.
;; icicle-unhighlight-lighter: Add + for multi-command. Don't bother to propertize strg.
;; icicle-file-remote-p: If name matches Windows drive letter, don't try other remote tests.
;; 2008/03/11 dadams
;; icicle-completing-read-history:
;; Convert cons list elements to strings. Lets you use M-o with command-history.
;; 2008/03/09 dadams
;; Added: icicle-(un)highlight-lighter.
;; icicle-completing-read, icicle-read-file-name: Call icicle-highlight-lighter.
;; 2008/03/08 dadams
;; icicle-completing-p: Replaced where-is-internal test with completion keymaps test.
;; 2008/03/05 dadams
;; icicle-completing-read:
;; Copy TABLE etc. only if candidates are strings. Thx to Damon Permezel for bug report.
;; icicle-files-within: Skip inaccessible directories and unreadable files. Thx to Damon.
;; 2008/02/28 dadams
;; icicle-completing-read: Fixed test for multicompletion: List of strings, not just list.
;; 2008/02/24 dadams
;; Added: icicle-scatter(-match).
;; icicle-display-*-in-Completions: Highlighting of input match can use icicle-scatter.
;; Use icicle-apropos-complete-match-fn in message.
;; icicle-expanded-common-match-1: Use icicle-apropos-complete-match-fn, not string-match.
;; 2008/02/23 dadams
;; icicle-completing-read:
;; Change initial-input to a cons with 0 position if icicle-init-value-flag is *-start.
;; icicle-lisp-vanilla-completing-read: Set position to end of initial-input, by default.
;; Convert zero-based position to one-based.
;; 2008/02/22 dadams
;; icicle-completing-read:
;; For all alist candidates (not just multi-completion):
;; Copy the car and replace the cdr with the whole candidate.
;; icicle-get-alist-candidate: Get and return just whole icicle-whole-candidate property.
;; icicle-completion-setup-function (for Emacs 20):
;; minibuffer-prompt-end -> icicle-minibuffer-prompt-end.
;; 2008/02/16 dadams
;; icicle-get-alist-candidate:
;; Reconstitute whole candidate, by consing string onto data, which is only the cdr now.
;; icicle-completing-read: Use icicle-put-alist-candidate to put candidate data onto string.
;; Added: icicle-put-alist-candidate. Put only the cdr (data), not whole, onto the string.
;; 2008/02/14 dadams
;; Added: icicle-substring-no-properties.
;; 2008/02/11 dadams
;; icicle-read-string-completing: Moved save-match-data so replace-match can use match data.
;; 2008/02/06 dadams
;; icicle-highlight-input-noncompletion:
;; Wait icicle-highlight-input-completion-failure-delay before highlighting.
;; Don't highlight if past icicle-highlight-input-completion-failure-threshold.
;; Combined input-pending test with highlighting test, and moved it before file-name test.
;; Conditionalized face removal.
;; Return nil when input within delay preempts highlighting.
;; icicle-highlight-initial-whitespace: Removed only vestigial whitespace highlighting.
;; icicle-read-number: Moved save-match-data outside cond.
;; 2008/02/03 dadams
;; icicle-choose-completion-string:
;; Go to point-max before insert choice. Respect icicle-dir-candidate-can-exit-p.
;; icicle-completion-setup-function:
;; Set default dir only if this is a completion cmd or not *-comp-base-is-default-dir-p.
;; If icicle-comp-base-is-default-dir-p, set completion-base-size to default-dir length.
;; icicle-read-file-name: Bind ffap vars to prevent slowing down ffap-guesser.
;; 2008/01/29 dadams
;; Added: icicle-(apropos|prefix)-any(-file-name)-candidates-p,
;; icicle-subst-envvar-in-file-name, icicle-highlight-input-noncompletion-rest,
;; icicle-any-candidates-p, icicle-file-remote-p.
;; icicle-minibuffer-contents-from-minibuffer: Use icicle-subst-envvar-in-file-name.
;; icicle-call-then-update-Completions:
;; Reinitialize icicle-input-fail-pos to nil.
;; If we know input is a remote file name from failure highlighting, skip remote test.
;; Use icicle-file-remote-p, not file-remote-p.
;; icicle-highlight-input-noncompletion: Rewrote.
;; Takes no args now.
;; Do nothing if input pending or input is empty.
;; Use icicle-file-remote-p, not file-remote-p. Return value indicating remote file name.
;; Use new values of icicle-highlight-input-completion-failure, including always.
;; First check through last two chars, then icicle-highlight-input-noncompletion-rest.
;; icicle-highlight-input-noncompletion-rest (was in icicle-highlight-input-noncompletion):
;; No longer use icicle-max-chars-noncompletion-highlight.
;; Use icicle-any-candidates-p, so don't compute candidate lists.
;; 2008/01/15 dadams
;; icicle-command-abbrev-save: Added condition-case with message in case of error.
;; icicle-control-reminder-prompt: Added message.
;; 2008/01/13 dadams
;; icicle-read-face-name: Use icicle-transform-multi-completion.
;; icicle-next-candidate: Do not use icicle-transform-multi-completion.
;; icicle-next-candidate, icicle-save-or-restore-input: Do not treat handle-switch-frame.
;; 2008/01/08 dadams
;; Renamed icicle-expanded-common-match to icicle-expanded-common-match-1.
;; New icicle-expanded-common-match uses longest of two tries.
;; icicle-expanded-common-match-1, first loop: Match ecm only up to orig-match-end.
;; icicle-read-file-name: Use icicle-var-is-of-type-p for proxy candidates.
;; icicle-choose-completion-string, icicle-strip-ignored-files-and-sort,
;; icicle-filter-wo-input, icicle-first-matching-candidate,
;; icicle-(proxy-candidate|prefix-keys)-first-p, icicle-var-(matches|inherits)-type-p,
;; icicle-read-(number|face-name|file-name|string-completing),
;; icicle-unsorted(-file-name)-prefix-candidates, icicle-expanded-common-match-1,
;; icicle-next-candidate, icicle-remove-dots: Wrap string-match in save-match-data.
;; icicle-display-candidates-in-Completions: Moved save-match-data locations.
;; 2008/01/05 dadams
;; icicle-next-candidate: Don't refresh Completions if last-command = handle-switch-frame.
;; 2008/01/04 dadams
;; icicle-insert-candidates: Put property icicle-keep-newline on final \n of candidate.
;; 2007/12/31 dadams
;; icicle-choose-completion-string: In minibuffer, delete all input before inserting.
;; 2007/12/27 dadams
;; icicle-unsorted(-file-name)-apropos-candidates:
;; Use null *-apropos-*-match-fn, not function-valued TABLE to inhibit input match.
;; 2007/12/26 dadams
;; icicle-next-candidate: Raise *Completions* frame at the end.
;; 2007/12/24 dadams
;; icicle-unsorted(-file-name)-apropos-candidates:
;; Don't match input regexp if minibuffer-completion-table is a function.
;; icicle-var-inherits-type-p:
;; Recheck var-type match after set var-type to its car.
;; Handle string (regexp) TYPES elements.
;; icicle-value-satisfies-type-p: Skip type check for string type (regexp).
;; icicle-var-is-of-type-p: Doc string. Use icicle-var-matches-type-p.
;; Added: icicle-var-matches-type-p, icicle-custom-type.
;; 2007/12/23 dadams
;; icicle-var-is-of-type-p:
;; Added MODE arg. Use icicle-var-inherits-type-p, icicle-var-val-satisfies-type-p.
;; Redefined as MODE choice, not just a simple or. Treat more cases.
;; Added: icicle-var-inherits-type-p, icicle-var-val-satisfies-type-p,
;; icicle-value-satisfies-type-p.
;; icicle-read-(number|char-exclusive|string-completing|face-name):
;; Don't fill icicle-proxy-candidates unless icicle-add-proxy-candidates-flag.
;; Corrected doc string to refer to icicle-add-proxy-candidates-flag.
;; 2007/12/22 dadams
;; icicle-var-is-of-type-p:
;; Check supertypes also. Use both :validate and :match.
;; Wrap type check in condition-case. Use widget-put instead of plist-put.
;; Added soft require of wid-edit+.el.
;; 2007/12/21 dadams
;; icicle-var-is-of-type-p: Use :validate, not :match, for the test.
;; 2007/12/19 dadams
;; icicle-display-candidates-in-Completions:
;; Ensure icicle-last-input is non-nil in (file-name-directory icicle-last-input).
;; 2007/12/14 dadams
;; icicle-fit-Completions-window:
;; Don't try to get a property if it's not a symbol. Thx to Mike Mattie.
;; 2007/12/11 dadams
;; Added: icicle-read-char-exclusive.
;; icicle-read-face-name: Include face-name vars as proxy candidates.
;; 2007/12/10 dadams
;; icicle-highlight-input-noncompletion: Use face icicle-input-completion-fail-lax also.
;; 2007/12/09 dadams
;; icicle-highlight-input-noncompletion: Respect icicle-max-chars-noncompletion-highlight.
;; 2007/12/08 dadams
;; icicle-read-file-name:
;; Include file-name variables as proxy candidates. Reset icicle-proxy-candidates at end.
;; icicle-read-number: float type is not defined before Emacs 22.
;; icicle-read-string-completing:
;; Set default to "" if nil, but only after completing-read.
;; Set car of hist to var value, replacing var name. Treat consp hist also.
;; 2007/12/03 dadams
;; Renamed icicle-longest-common-match to icicle-expanded-common-match.
;; 2007/12/02 dadams
;; Added: icicle-var-is-of-type-p.
;; icicle-read-(number|string-completing):
;; Use icicle-var-is-of-type-p, to handle compatible types.
;; 2007/11/30 dadams
;; icicle-read-file-name, icicle-read-(number|string-completing),
;; icicle-display-candidates-in-Completions, icicle-proxy-candidate-first-p:
;; Use only membership in icicle-proxy-candidates, not icicle-proxy-candidate property.
;; icicle-choose-completion-string:
;; Condition for exit: could be no minibuffer-completion-table if extra or proxy cands.
;; 2007/11/29 dadams
;; icicle-read-(number|string-completing):
;; Treat icicle-add-proxy-candidates-flag and icicle-proxy-candidates.
;; icicle-display-candidates-in-Completions: Treat empty icicle-completion-candidates.
;; 2007/11/27 dadams
;; Added: icicle-read-number, icicle-read-string-completing.
;; icicle-read-file-name: Remove icicle-proxy-candidate property in unwind-protect.
;; 2007/11/25 dadams
;; Added: icicle-command-abbrev(-save|-used-more-p).
;; 2007/11/24 dadams
;; icicle-longest-common-match, first loop: string-match -> not string-match.
;; len-first -> length of lcm.
;; Added: icicle-proxy-candidate-first-p.
;; 2007/11/18 dadams
;; icicle(-unsorted)(-file-name)-(apropos|prefix)-candidates:
;; Include also icicle-proxy-candidates.
;; Move special and proxy candidates inside match filtering.
;; icicle-display-candidates-in-Completions:
;; Don't expand directory when highlighting special candidate.
;; 2007/11/02 dadams
;; icicle-longest-common-match:
;; First loop: (1) match against at most len-first, (2) put the match into the and test.
;; 2007/10/28 dadams
;; icicle-display-candidates-in-Completions:
;; Always highlight longest common match for prefix completion.
;; icicle-unsorted(-file-name)-prefix-candidates, icicle-fuzzy-candidates:
;; Set icicle-common-match-string, regardless of icicle-expand-input-*-flag.
;; icicle-save-or-restore-input:
;; Update to lcm even if no input change, if completion mode changed.
;; Update to lcm if prefix completing, even if icicle-expand-input-*-flag is nil.
;; Save input for C-l even if this command is an icicle-completing-command (?).
;; Don't reset raw input to "" if cycling, so keep highlight in *Completions*.
;; icicle-longest-common-match: Test prefix through embedded input each time.
;; 2007/10/26 dadams
;; icicle-read-face-name (Emacs 22): Fix the treatment of default value.
;; 2007/10/22 dadams
;; icicle-display-candidates-in-Completions:
;; Highlight only regexp matching part of special candidates.
;; Highlight special cands regardless of icicle-highlight-historical-candidates-flag.
;; 2007/10/02 dadams
;; icicle-next-candidate:
;; Apply abbreviate-file-name to file-name input. Thx to Joonhwan Lee.
;; 2007/09/29 dadams
;; Added: icicle-fuzzy-candidates.
;; icicle-prefix-candidates: Treat fuzzy completion.
;; icicle-display-candidates-in-Completions:
;; For prefix completion, highlight literal input match in Completions.
;; 2007/09/26 dadams
;; icicle-read-from-minibuffer: Removed keep-all arg - see also 2006/06/01.
;; 2007/09/22 dadamms
;; icicle-completing-read, icicle-read-from-minibuffer:
;; Ensure that init arg is string when get it from default arg via icicle-init-*-flag.
;; 2007/09/18 dadams
;; icicle-call-then-update-Completions:
;; Test icicle-current-completion-mode, not icicle-last-completion-command.
;; 2007/09/16 dadams
;; icicle-call-then-update-Completions:
;; Don't complete if file-remote-p.
;; Highlight completion failure only if input > icicle-*-display-min-input-chars.
;; icicle-highlight-input-noncompletion:
;; Don't highlight unless also icicle-incremental-completion-flag.
;; Call icicle-file-name-*-candidates for file-name input.
;; Don't highlight if file-remote-p and reading file name. Instead, remove highlighting.
;; 2007/09/14 dadams
;; icicle-highlight-input-noncompletion, icicle-update-completions,
;; icicle-recompute-candidates:
;; Wrapped condition-case around candidates computation.
;; 2007/09/02 dadams
;; icicle-display-candidates-in-Completions:
;; Restore point and window point to start of candidates in *Completions*.
;; 2007/08/21 dadams
;; icicle-highlight-input-noncompletion: Remove any vestigial highlighting on matched part.
;; 2007/08/19 dadams
;; Added: icicle-lisp-vanilla-completing-read, icicle-highlight-input-noncompletion.
;; icicle-completing-read:
;; Allow reading and returning string candidates with properties:
;; bind minibuffer-allow-text-properties.
;; Put whole candidate on string as text property.
;; Use icicle-lisp-vanilla-completing-read, not old-completing-read.
;; icicle-call-then-update-Completions: Call icicle-highlight-input-noncompletion.
;; icicle-get-alist-candidate:
;; If icicle-whole-candidate-as-text-prop-p, try to get full candidate from text prop.
;; 2007/08/16 dadams
;; icicle-insert-candidates: Don't reset text props if endpos > point. Thx to Chris Hecker.
;; 2007/08/14 dadams
;; icicle-increment-cand-nb+signal-end: Removed audible bell - use visible bell only.
;; 2007/07/22 dadams
;; icicle-read-face-name (Emacs 22 version):
;; Revert multiple branch to not use icicle-make-face-candidate.
;; Moved here from icicles-mode.el: icicle-completing-p.
;; 2007/07/06 dadams
;; icicle-display-candidates-in-Completions: Leave cursor at start of candidates.
;; 2007/07/03 dadams
;; icicle-save-or-restore-input:
;; Add current-raw-input to icicle-previous(-non)-file-*-raw-inputs, respecting max len.
;; Don't save input if current command is C-l or C-L.
;; If don't save raw input, set it to empty string.
;; Added: icicle-put-at-head.
;; icicle-highlight-complete-input: Ensure no error treatment in call to search-forward.
;; icicle-display-candidates-in-Completions:
;; Ensure non-nil current(-raw)-input, for highlight.
;; 2007/06/23 dadams
;; Added: icicle-completing-read-history.
;; Moved here from icicles-cmd.el: icicle-read-from-minibuf-nil-default.
;; 2007/06/20 dadams
;; icicle-make-face-candidate, icicle-read-face-name:
;; Use new string value of icicle-WYSIWYG-Completions-flag.
;; 2007/06/19 dadams
;; icicle-read-face-name:
;; Use a multi-completion, depending on icicle-WYSIWYG-Completions-flag.
;; For Emacs 22, isolate the multiple case and do nothing for it.
;; icicle-make-face-candidate: Treat also whole-number value for icicle-WYSIWYG-*-flag.
;; 2007/06/17 dadams
;; icicle-make-face-candidate: Respect icicle-WYSIWYG-Completions-flag.
;; icicle-display-candidates-in-Completions: highlight saved candidates.
;; icicle-place-overlay: Added priority arg.
;; 2007/06/13 dadams
;; icicle-display-candidates-in-Completions:
;; Upgrade icicle-incremental-completion-p only if redisplaying. Thx Mark Elston.
;; 2007/06/10 dadams
;; Removed unconditional add-hook for icicle-fit-Completions-window.
;; 2007/06/09 dadams
;; icicle-insert-candidates: Don't mouse-face last char of candidate if it is a newline.
;; icicle-display-candidates-in-Completions: Treat icicle-candidate-properties-alist last.
;; 2007/06/07 dadams
;; icicle-read-face-name: Use (icicle-)face-name-history.
;; 2007/06/05 dadams
;; Added soft require of hexrgb.el, but only if window-system.
;; icicle-color*: Protected with featurep hexrgb and error message.
;; 2007/06/01 dadams
;; icicle-completing-read, icicle-read-from-minibuffer, icicle-read-string:
;; Use M@R%M=X!L$S+P&L^T*Z to avoid name capture by minibuffer-history-variable's value.
;; icicle-display-candidates-in-Completions, icicle-historical-alphabetic-p,
;; icicle-most-recent-first-p:
;; Ensure value of minibuffer-history-variable is bound.
;; 2007/05/29 dadams
;; icicle-call-then-update-Completions: Don't recomplete if only one candidate.
;; 2007/05/24 dadams
;; icicle-completing-read, icicle-read-file-name:
;; Fix length test for consp initial-input. Thx to Anupam Sengupta.
;; 2007/05/04 dadams
;; icicle-unsorted-*: C-g quits to top-level.
;; icicle-candidate-set-1, icicle-scroll-or-update-*, icicle-msg-maybe-in-minibuffer:
;; Move to minibuffer window for minibuffer-message.
;; icicle-display-candidates-in-Completions, icicle-highlight-initial-whitespace,
;; icicle-unsorted-file-name-*-candidates, icicle-longest-common-match,
;; icicle-next-candidate, icicle-place-cursor, icicle-highlight-complete-input,
;; icicle-special-candidates-first-p, icicle-case-string-less-p:
;; Use read-file-name-completion-ignore-case, if completing file name.
;; Moved mention of read-file-name-completion-ignore-case and
;; icicle-cycle-into-subdirs-flag from icicle-completing-read to icicle-read-file-name.
;; Added empty defvars for Emacs 22 standard vars, to quiet byte compiler.
;; 2007/04/29 dadams
;; Added: icicle-last-modified-first-p.
;; icicle-call-then-update-Completions: Delete icicle-complete-input-overlay.
;; 2007/04/08 dadams
;; Added: icicle-highlight-candidate-in-Completions, from code in icicle-next-candidate.
;; But changed to: 1) make Completions dedicated and 2) not bind case-fold-search.
;; icicle-next-candidate: Use icicle-highlight-candidate-in-Completions.
;; 2007/04/02 dadams
;; Moved here from icicles-cmd.el: icicle-filter-alist, icicle-first-matching-candidate.
;; 2007/04/01 dadams
;; icicle-insert-candidates: Don't fixup-whitespace if bolp.
;; 2007/03/30 dadams
;; icicle-fit-Completions-window: Don't resize *Completions* window if split horizontally.
;; icicle-insert-candidates:
;; Calculate nb of columns using max-candidate-len, not number of candidates.
;; Indent at least one colwidth, and leave less space between candidates.
;; 2007/03/26 dadams
;; icicle-completion-setup-function:
;; Protected minibuffer-completing-symbol with boundp (not define in Emacs 23).
;; 2007/03/23 dadams
;; icicle-completing-read, icicle-read-file-name:
;; Record require-match in icicle-require-match-p.
;; 2007/03/17 dadams
;; icicle-read-face-name: Undo Emacs 21+ brain-dead treatment of PROMPT arg.
;; 2007/03/14 dadams
;; icicle-fit-Completions-window:
;; Don't let *Completions* take over the frame, so don't lose other window.
;; Respect icicle-Completions-window-max-height property of top-level command.
;; 2007/03/12 dadams
;; Added: icicle-fit-Completions-window. Use in temp-buffer-show-hook.
;; icicle-display-completion-list:
;; Print help lines here, not in icicle-completion-setup-*, so window fit includes them.
;; Put face on string candidates intro string, Possible completions are:.
;; icicle-completion-setup-function:
;; Don't print the help lines here.
;; Updated wrt latest Emacs 22 CVS version.
;; icicle-insert-Completions-help-string: Remove second newline at end.
;; icicle-start-of-candidates-in-Completions: Advance 1 or 2 lines, not 0 or 3.
;; 2007/03/10 dadams
;; icicle-display-completion-list: Rewrote to adjust columns to window width.
;; Added: icicle-insert-candidates.
;; 2007/03/09 dadams
;; Moved icicle-get-alist-candidate here from icicles-cmd.el.
;; 2007/03/07 dadams
;; icicle-choose-completion-string, icicle-next-candidate:
;; Use 0, not t, as frame arg to get-buffer-window.
;; 2007/03/04 dadams
;; icicle-highlight-initial-whitespace: Removed unused local var input-start-position.
;; icicle-completing-read: Do not initialize icicle-candidates-alist.
;; 2007/03/03 dadams
;; icicle-reversible-sort: Don't display Sorting candidates message - too annoying.
;; 2007/03/02 dadams
;; icicle-completion-setup-function for Emacs 22: Don't use file-name-directory if nil.
;; 2007/03/01 dadams
;; icicle-completing-read: Initialize icicle-candidates-alist.
;; 2007/02/24 dadams
;; icicle-next-candidate:
;; Transform multi-completion icicle-last-completion-candidate.
;; If last-command is icicle(mouse)-remove-candidate don't reset common match string or
;; redisplay *Completions*.
;; icicle-recompute-candidates:
;; Don't recompute if icicle-last-completion-command is icicle-mouse-remove-candidate.
;; 2007/02/18 dadams
;; icicle-save-or-restore-input: Use "" if file-name-directory is nil. Thx Shreevatsa R.
;; 2007/02/17 dadams
;; icicle-reversible-sort: No Sorting... message if icicle-edit-update-p. Thx Shreevatsa.
;; 2007/02/05 dadams
;; icicle-completing-read: Added info about multi-completions to doc string.
;; 2007/02/04 dadams
;; icicle-display-candidates-in-Completions: Fixed composition of multiple faces.
;; 2007/02/03 dadams
;; Renamed icicle-icompleting-p to icicle-edit-update-p.
;; Require icicles-var.el. Removed eval-when-compile for require of icicles-opt.
;; 2007/02/02 dadams
;; icicle-case-string-less-p: Use var, not function, icicle-completing-p (else too slow).
;; icicle-reversible-sort: Added sorting progress message.
;; 2007/01/29 dadams
;; icicle-display-candidates-in-Completions:
;; Allow for consp proplist value of icicle-special-candidate.
;; icicle-special-candidates-first-p: Added neither-special case. Treat letter case.
;; Renamed: icicle-case-insensitive-string-lessp to icicle-case-insensitive-string-less-p.
;; Added: icicle-case-string-less-p.
;; icicle-historical-alphabetic-p, icicle-most-recent-first-p, icicle-dirs-last-p,
;; icicle-part-N-lessp, icicle-prefix-keys-first-p:
;; Use icicle-case-string-less-p, not string-lessp.
;; icicle-prefix-keys-first-p: Ignore case.
;; 2007/01/28 dadams
;; Added: icicle-command-names-alphabetic-p.
;; Moved here from icicles-cmd.el:
;; icicle-prefix-keys-first-p, icicle-special-candidates-first-p.
;; 2007/01/23 dadams
;; Added: icicle-read-face-name, icicle-make-face-candidate,
;; icicle-face-valid-attribute-values, icicle-color-name-w-bg.
;; icicle-choose-completion-string: Added Emacs 21 version.
;; icicle-display-candidates-in-Completions:
;; Only highlight past inputs if icicle-highlight-historical-candidates-flag.
;; 2007/01/22 dadams
;; icicle-part-N-lessp, icicle-color-*-lessp: Do nothing if strings are not multipart.
;; icicle-display-candidates-in-Completions:
;; Highlight past inputs after treat *-prop*-alist.
;; icicle-delete-whitespace-from-string: Added optional args.
;; 2007/01/21 dadams
;; Added: icicle-part-*-lessp, icicle-color-*-lessp.
;; 2007/01/20 dadams
;; Added: icicle-display-completion-list.
;; 2007/01/19 dadams
;; icicle-display-candidates-in-Completions: Treat icicle-candidate-properties-alist.
;; 2007/01/15 dadams
;; Added: icicle-reversible-sort. Use it where standard sort function was used.
;; Renamed: icicle-sort-and-strip-ignored to icicle-strip-ignored-files-and-sort,
;; icicle-sort-dirs-last to icicle-dirs-last-p,
;; icicle-sort-case-insensitively to icicle-case-insensitive-string-lessp.
;; Grouped sort functions together.
;; 2007/01/14 dadams
;; icicle-next-candidate: Use icicle-transform-multi-completion. Thx to Rubikitch.
;; icicle-transform-candidates: Updated doc string.
;; 2007/01/12 dadams
;; icicle-next-candidate: Use icicle-list-use-nth-parts. Thx to Rubikitch.
;; icicle-display-candidates-in-Completions: Added message when no-display-p.
;; 2007/01/07 dadams
;; icicle-completing-read: Updated doc string for Emacs 22.
;; 2007/01/06 dadams
;; Added: icicle-abbreviate-or-expand-file-name.
;; icicle-fix-default-directory: Use icicle-abbreviate-or-expand-file-name.
;; icicle-save-or-restore-input: expand-file-name -> icicle-abbreviate-or-expand-file-name.
;; icicle-completion-setup-function: Don't set default-directory to nil if minibuf empty.
;; icicle-read-file-name: Bug fix: Don't set initial-input to icicle-initial-value if "".
;; 2007/01/05 dadams
;; icicle-completing-read, icicle-read-file-name:
;; Use existing string value of icicle-initial-value. Thx to rubikitch for suggestion.
;; 2007/01/01 dadams
;; Added assq-delete-all for Emacs 20 (moved here from icicles-mode.el).
;; Added: icicle-assoc-delete-all.
;; 2006/12/25 dadams
;; Added: icicle-most-recent-first-p.
;; icicle-update-completions: Added optional no-display arg.
;; Moved here from icicles-opt.el: icicle-historical-alphabetic-p.
;; 2006/11/10 dadams
;; icicle-completing-read, icicle-read-file-name: Prefix prompt by + if a multi-command.
;; 2006/10/15 dadams
;; icicle-save-or-restore-input:
;; Change test from cmd is same as last to input is same as last.
;; icicle-rebind-completion-maps:
;; When turn off, bind C-M-mouse-2 and C-down-mouse-2 to nil.
;; icicle-display-candidates-in-Completions: Accumulate (merge) highlight faces.
;; Moved to icicles-mode.el:
;; icicle-bind-isearch-keys, icicle-rebind-completion-maps,
;; icicle-(redefine|restore)-standard-(commands|options),
;; icicle-(redefine|restore)-std-completion-fns), icicle-(re|un)map,
;; icicle-(bind|restore)-completion-keys, icicle-minibuffer-setup,
;; icicle-cancel-*Help*-redirection, icicle-activate-mark,
;; icicle-run-icicle-(pre|post)-command-hook, icicle-set-calling-cmd,
;; icicle-undo-std-completion-faces, icicle-update-ignored-extensions-regexp,
;; icicle-completing-p, icicle-restore-region-face.
;; Removed eval-when-compile of *-face, *-var, *-mac, *-cmd.
;; Removed some defvars for quieting byte compiler.
;; 2006/10/05 dadams
;; icicle-display-candidates-in-Completions: Highlight candidates that are special.
;; 2006/10/03 dadams
;; icicle-display-candidates-in-Completions:
;; Removed predicate filtering, as the pred doesn't necessarily apply to the candidate.
;; This has been in the code forever, so commented it out, in case it is needed ;-).
;; 2006/10/01 dadams
;; icicle-alternative-sort -> icicle-toggle-alternative-sorting.
;; icicle-update-completions: Treat icicle-prefix-word-complete case too.
;; 2006/09/30 dadams
;; Added: icicle-key-description.
;; icicle-(bind|restore)-completion-keys:
;; Bind icicle-candidate-set-(save|retrieve) to C-M-(<|>), not C-(<|>).
;; Bind icicle-toggle-angle-brackets to C-<.
;; No longer remap help-command to icicle-completion-help.
;; Bind icicle-completion-help to C-?.
;; Rename [menu-bar minibuf C-h] to [menu-bar minibuf completion-help].
;; icicle-completing-p: Bug fix: Use where-is-internal, not minibuffer-completion-table.
;; 2006/09/22 dadams
;; icicle-minibuffer-setup:
;; Apropos-complete, don't prefix-complete, when icicle-show-Completions-initially-flag.
;; 2006/09/17 dadams
;; icicle-completing-p: Ensure minibuffer is active too.
;; 2006/09/16 dadams
;; Bound icicle-insert-key-description to M-q.
;; icicle-completing-read:
;; Use icicle-list-join-string only to join parts of candidate (alist key).
;; Append icicle-list-end-string instead.
;; icicle-msg-maybe-in-minibuffer: Fixed doc string (active -> inactive).
;; 2006/09/12 dadams
;; icicle-minibuffer-setup: Set icicle-pre-minibuffer-buffer.
;; Renamed icicle-switch-to-minibuffer to icicle-insert-completion.
;; 2006/09/03 dadams
;; Renamed icicle-show-Completions-help to icicle-show-Completions-help-flag.
;; 2006/08/27 dadams
;; Bind Quit in Minibuf menu to icicle-abort-minibuffer-input.
;; 2006/08/22 dadams
;; icicle-save-or-restore-input: If icicle-last-completion-candidate is nil, don't try to restore.
;; 2006/08/18 dadams
;; icicle-minibuffer-setup: Reset icicle-last-completion-candidate to nil.
;; icicle-rebind-completion-maps: Added icicle-Info-goto-node to icicle-completion-help-string.
;; 2006/08/15 dadams
;; icicle-(bind|restore)-completion-keys:
;; Bind icicle-help-on-(previous|next)-(apropos|prefix)-candidate.
;; Reorder bindings. Bind C-mouse-2 to 'ignore, not nil.
;; icicle-rebind-completion-maps: Bind icicle-help-on-* in completion-list-mode-map.
;; Added: icicle-barf-if-outside-Completions-and-minibuffer.
;; 2006/08/13 dadams
;; icicle-completing-read, icicle-read-file-name: Use icicle-completing*-prompt-prefix.
;; 2006/08/04 dadams
;; icicle-call-then-update-Completions:
;; Call icicle-last-completion-command, not just prefix or apropos (so prefix-word too).
;; icicle-completing-read, icicle-read-file-name, icicle-next-candidate,
;; icicle-recompute-candidates, icicle-call-then-update-Completions:
;; Use icicle-remove-Completions-window.
;; icicle-(bind|restore)-completion-keys: Bound icicle-pp-eval-expression to M-:.
;; 2006/08/03 dadams
;; icicle-completion-setup-function: Removed useless highlighting code at end (Emacs 20).
;; icicle-rebind-completion-maps: Updated icicle-completion-help-string.
;; 2006/07/30 dadams
;; icicle-call-then-update-Completions: save match-data.
;; 2006/07/29 dadams
;; icicle-activate-mark: Do it only if icicle-completing-p. Thx to Le Wang.
;; icicle-rebind-completion-maps:
;; Updated to use icicle-dispatch-C-..
;; Added icicle-toggle-search-cleanup to icicle-completion-help-string.
;; icicle-bind-completion-keys:
;; Use icicle-dispatch-C-. instead of icicle-toggle-ignored-extensions.
;; 2006/07/28 dadams
;; icicle-longest-common-match: Treat special case of input such as "$" or "\\>$".
;; 2006/07/24 dadams
;; icicle-call-then-update-Completions: Deactivate mark at the end. Thx to Le Wang.
;; 2006/07/23 dadams
;; Added: icicle-transform-candidates.
;; icicle-rebind-completion-maps, icicle-(bind|restore)-completion-keys:
;; Added icicle-toggle-transforming.
;; icicle-unsorted(-file-name)-*-candidates: Use icicle-transform-candidates.
;; 2006/07/20 dadams
;; Renamed icicle-arrows-respect-* to icicle-cycling-respects-completion-mode-flag.
;; 2006/07/19 dadams
;; Applied patch from Damien Elmes <emacs@repose.cx>:
;; Added icicle-insert-help-string, icicle-start-of-completions (factored from existing).
;; icicle-completion-setup-function: Use icicle-insert-help-string.
;; icicle-display-candidates-in-Completions:
;; Use icicle-start-of-completions, and adjust loop accordingly.
;; icicle-minibuffer-setup:
;; Reset icicle-current-completion-type.
;; Bind (up|down) to icicle-*-context-candidate, not (previous|next)-history-element.
;; icicle-next-candidate: Use icicle-start-of-completions.
;; icicle-scroll-or-update-Completions: Use icicle-scroll-completions.
;; Renamed: icicle-start-of-completions to icicle-start-of-candidates-in-Completions,
;; icicle-insert-help-string to icicle-insert-Completions-help-string,
;; icicle-current-completion-type to icicle-current-completion-mode,
;; icicle-*-context-candidate to icicle-(next|previous)-candidate-per-mode,
;; icicle-scroll-completions to icicle-scroll-Completions.
;; icicle-minibuffer-setup:
;; Replaced icicle-display-Completions with icicle-prefix-complete, to get initial highlight.
;; 2006/07/18 dadams
;; icicle-call-then-update-Completions:
;; Delete *Completions* window, depending on icicle-Completions-display-min-input-chars.
;; Thx to Damien Elmes.
;; icicle-rebind-completion-maps: Add icicle-toggle-case-sensitivity to help list.
;; icicle-bind-completion-keys: Bind icicle-toggle-case-sensitivity to S-C-a (i.e. C-A).
;; 2006/07/17 dadams
;; icicle-call-then-update-Completions: sit-for delay if no candidates. Thx Damien Elmes.
;; 2006/07/09 dadams
;; icicle-save-or-restore-input:
;; Put back test: current input differs from last cycling candidate (user has edited it).
;; icicle-next-candidate: Removed filtering with predicate (vestigial cruft).
;; 2006/07/08 dadams
;; icicle-save-or-restore-input: Restore if currently cycling, not if not completing.
;; 2006/07/07 dadams
;; icicle-display-candidates-in-Completions: Fixed test for historical candidate.
;; Bound icicle-alternative-sort to M-,. Updated icicle-completion-help-string.
;; 2006/07/05 dadams
;; icicle-save-or-restore-input:
;; For restoring: 1) No longer test if current input = *-last-completion-candidate.
;; 2) No longer test if current input = icicle-initial-value.
;; No longer save icicle-current-input as icicle-last-completion-candidate.
;; Simplified the code.
;; icicle-call-then-update-Completions: Do not set this-command or last-command.
;; Renamed: icicle-current-regexp-input to icicle-current-raw-input.
;; 2006/07/04 dadams
;; icicle-unsorted(-file-name)-prefix-candidates: Update icicle-common-match-string.
;; icicle-unsorted-file-name-prefix-candidates:
;; If prefix matches an empty directory, then use that directory as the sole completion.
;; icicle-next-candidate: Use icicle-*-cycling-command properties.
;; Removed regexp-p arg in calls to icicle-save-or-restore-input.
;; icicle-save-or-restore-input:
;; Update icicle-common-*-string and icicle-current-regexp-input even if not regexp-p.
;; Removed optional regexp-p argument.
;; Do not update icicle-last-completion-candidate.
;; Use icicle-*-*ing-command properties.
;; icicle-recompute-candidates: Use icicle-*-cycling-command properties.
;; 2006/07/03 dadams
;; Bug fixes -
;; icicle-next-candidate:
;; Don't reset icicle-common-match-string if this is an apropos cycling command
;; and last command was an apropos command (cycling or completing).
;; Do icicle-save-or-restore-input a second time, after recompute candidates,
;; to pick up the common match.
;; Always pass icicle-current-input to icicle-place-cursor.
;; icicle-save-or-restore-input:
;; Don't do anything if last command was a cycling command.
;; Don't save input as regexp for C-l if this command is a cycling command,
;; unless it is the first or it follows a completion command.
;; 2006/07/02 dadams
;; icicle-place-cursor: position point & mark at least past prompt. Thx to Peter Povinec.
;; 2006/06/09 dadams
;; icicle(-file-name)-(apropos|prefix)-candidates: Reset icicle-candidate-nb to nil.
;; icicle-recompute-candidates: Don't reset icicle-candidate-nb to nil.
;; icicle-place-cursor: Prevent error on search-forward.
;; 2006/06/08 dadams
;; icicle-save-or-restore-input: Do not restore if current command is completion.
;; Added: icicle-expand-file-name.
;; icicle-next-candidate: Don't pass NTH arg to icicle-display-candidates-in-Completions.
;; 2006/06/06 dadams
;; icicle-control-reminder-prompt: condition-case, since it's on kill-emacs-hook.
;; 2006/06/01 dadams
;; icicle-read-from-minibuffer: Emacs 22 removed the keep-all arg it had added.
;; 2006/05/31 dadams
;; icicle-barf-if-outside*: Simplified.
;; 2006/05/30 dadams
;; Bind icicle-erase-minibuffer-or-history to M-k also in non-completion minibuffer maps.
;; 2006/05/26 dadams
;; Bind icicle-erase-minibuffer-or-history to M-k.
;; Do not remap (or unmap) kill-sentence (it is on M-k in global map).
;; 2006/05/19 dadams
;; Added: icicle-control-reminder-prompt.
;; icicle-reminder-*-flag, icicle-read-file-name: Treat new values of icicle-reminder*.
;; Renamed icicle-inhibit-reminder* to icicle-reminder*.
;; 2006/05/16 dadams
;; icicle-recompute-candidates: Add new saved-last-input arg (replaces icicle-last-input).
;; icicle-next-candidate: Pass saved old last input to icicle-recompute-candidates.
;; 2006/05/15 dadams
;; Reverted change to icicle-unsorted(-file-name)-apropos-candidates,
;; icicle-display-Completions: Use icicle-completion-nospace-flag, not nil.
;; Renamed: icicle-completion-nospace-flag to icicle-ignore-space-prefix-flag.
;; icicle-toggle-incremental-completion: C-#, icicle-toggle-ignored-space-prefix: C-^.
;; 2006/05/13 dadams
;; icicle-unsorted(-file-name)-apropos-candidates, icicle-display-Completions:
;; Use nil, not icicle-completion-nospace-flag.
;; 2006/05/12 dadams
;; icicle-completion-help-string: Added faces and commands. Cleanup.
;; Moved from icicles-cmd.el: icicle-barf-if-outside-*.
;; 2006/05/09 dadams
;; icicle-display-*: Only issue Displaying... message when more candidates than threshold.
;; 2006/05/01 dadams
;; icicle-save-or-restore-input: No-restore test is non-nil, not non-"", icicle-last-input.
;; icicle-minibuffer-setup: Reset icicle-last-input to nil, not "".
;; icicle-next-candidate: Highlight initial whitespace before underline root.
;; 2006/04/28 dadams
;; icicle-save-or-restore-input:
;; Restore empty input if it is not a file name.
;; Don't expand empty common-match-string file-name input (it would lose trailing /).
;; Added: icicle-highlight-initial-whitespace.
;; icicle-next-candidate, icicle-call-then-update-Completions:
;; Use icicle-highlight-initial-whitespace.
;; 2006/04/14 dadams
;; icicle-call-then-update-Completions: Call icicle-update-input-hook.
;; Bound icicle-insert-string-from-variable to C-=. Update icicle-completion-help-string.
;; 2006/04/09 dadams
;; icicle-bind-completion-keys, icicle-minibuffer-setup:
;; Deal with icicle-arrows-respect-completion-type-flag.
;; icicle-display-candidates-in-Completions:
;; Bug fix: regexp-quote common match when highlighting it.
;; icicle-clear-minibuffer: Remove interactive spec.
;; Moved to icicles-cmd.el: icicle-customize-apropos*, icicle-repeat-complex-command.
;; 2006/04/02 dadams
;; Bound icicle-toggle-regexp-quote.
;; 2006/03/31 dadams
;; icicle-next-candidate:
;; Apply icicle-place-cursor to icicle-current-regexp-input if regexp-p.
;; icicle-save-or-restore-input:
;; Don't set icicle-current-regexp-input if this is a next-candidate action.
;; 2006/03/27 dadams
;; icicle-place-overlay: Made generic: added args overlay, face, buffer, properties.
;; 2006/03/25 dadams
;; icicle-call-then-update-Completions: Corrected use of icicle-incremental-completion*.
;; 2006/03/24 dadams
;; Renamed icicle-expand-input-to-common-match to icicle-longest-common-match. Rewrote it.
;; icicle-call-then-update-Completions:
;; Use icicle-incremental-completion-delay and -threshold.
;; Mapped icicle-delete-char.
;; 2006/03/23 dadams
;; icicle-expand-input-to-common-match:
;; Return the longest common match. Don't set icicle-common-match-string here.
;; icicle-unsorted-*apropos-candidates: Set icicle-common-match-string here explicitly.
;; Added: icicle-maybe-sort-and-strip-candidates. Use in icicle-candidate-set-1.
;; 2006/03/22 dadams
;; icicle-display-candidates-in-Completions:
;; Removed root arg (always use icicle-current-input).
;; Always highlight normal match part.
;; Highlight common-match part if icicle-expand-input-to-common-match-flag.
;; icicle-save-or-restore-input:
;; Update regexp even if not icicle-expand-input-to-common-match-flag.
;; icicle-recompute-candidates: If no candidates, then delete *Completions* window.
;; icicle-next-candidate: Set default-directory only if icicle-file-name-input-p.
;; Applied renamings of icicle-match-* faces.
;; 2006/03/21 dadams
;; icicle-expand-input-to-common-match:
;; Bug fixes:
;; If no overlap between first and second candidates, then no common match.
;; If no match with another candidate, then no common match.
;; Input must match computed common match.
;; When checking others, check only the added (pre|suf)fix, and reduce those as needed.
;; icicle-save-or-restore-input:
;; Bug fixes:
;; When icicle-expand-input-to-common-match-flag, expand using directory from the
;; input, not the default-directory. Thx to cacher3.ericsson.net for report.
;; Do test for case-only difference only when case-fold-search.
;; If input is a directory (with slash), then use it as is.
;; Save icicle-current-regexp-input if no icicle-common-match-string too.
;; icicle-display-candidates-in-Completions: Use icicle-common-match-highlight-Completions.
;; 2006/03/20 dadams
;; icicle-save-or-restore-input: Set icicle-current-regexp-input too.
;; Corrected letter-case test.
;; 2006/03/19 dadams
;; Added: icicle-expand-input-to-common-match.
;; icicle-unsorted*-apropos-candidates:
;; Set icicle-common-match-string if icicle-expand-input-to-common-match-flag.
;; icicle-save-or-restore-input:
;; Added regexp-p arg. Update input to icicle-common-match-string if appropriate.
;; icicle-next-candidate: Reset icicle-common-match-string.
;; 2006/03/17 dadams
;; icicle-file-(read|writ)able-p: Put non-empty string condition first.
;; Added: icicle-delete-whitespace-from-string.
;; icicle-files-within: Moved here from icicle-cmd.el.
;; 2006/03/14 dadams
;; Removed: icicle-reset-icicle-completing-p.
;; icicle-completing-read, icicle-read-file-name: Removed icicle-icicle-completing-p.
;; icicle-display-*: Added Displaying... message.
;; 2006/03/13 dadams
;; Added: icicle-file-(read|writ)able-p. Bound them to C-{ and C-} in minibuffer.
;; icicle-rebind-completion-maps, icicle-bind-completion-keys: Added the new commands.
;; icicle-recompute-candidates: Forgot icicle-keep-only-past-inputs in other branch.
;; 2006/03/10 dadams
;; icicle-save-or-restore-input: Bug fix (thx Toby Cubitt) - Not relative to default dir.
;; Use directory-file-name, so don't include /.
;; Use file-name-nondirectory, not file-relative-name if not cycling into subdirs.
;; Renamed icicle-minibuffer-contents to icicle-minibuffer-contents-from-minibuffer.
;; Added new icicle-minibuffer-contents, which can be called outside minibuffer.
;; 2006/03/08 dadams
;; icicle-place-overlay: Use new face, icicle-current-candidate-highlight.
;; 2006/03/05 dadams
;; Bound icicle-toggle-incremental-completion to C-^ in minibuffer.
;; Updated icicle-completion-help-string with C-^ binding.
;; icicle-display-candidates-in-Completions:
;; Allow for on-the-fly changes to icicle-incremental-completion-flag.
;; 2006/03/01 dadams
;; Added: icicle-clear-minibuffer. Use in icicle-next-candidate.
;; 2006/02/27 dadams
;; icicle-call-then-update-Completions: Set last-command to fn arg.
;;;(@* "CHANGE LOG FOR `icicles-mac.el'")
;;
;; ****************************************************************************************************
;; NOTE: If you byte-compile Icicles (recommended), then WHENEVER `icicles-mac.el' is updated, you
;; must load `icicles-mac.el' (not just `icicles-mac.elc'), then compile it, then RECOMPILE *ALL*
;; of the other Icicles source files as well. This is normal for Lisp: code that depends on
;; macros needs to be byte-compiled anew after loading the updated macros.
;; ****************************************************************************************************
;;
;; 2018/10/15 dadams
;; icicle-buffer-bindings, icicle-file-bindings:
;; Always set icicle-sort-comparer to icicle-(buffer|file)-sort.
;; Do not use icicle-(buffer|file)-sort-first-time-p.
;; 2018/06/01 dadams
;; icicle-(buffer|file)-bindings:
;; Bind icicle-sort-comparer, since set it to icicle-(buffer|file)-sort.
;; 2017/12/10 dadams
;; icicle-buffer-bindings:
;; Bind icicle-pref-arg and use it, not current-prefix-arg.
;; Do not bind icicle-buffer-complete-fn (prevented prefix-arg filtering in icicle-kill-buffer).
;; Added case for prefix arg = -, for modified buffers.
;; For non use-default case, corrected to use cadr, not cdr (not dotted).
;; 2015/01/21 dadams
;; icicle-define-sort-command: Removed extra %s in call to message.
;; 2014/11/07 dadams
;; Added: icicle-with-icy-mode-OFF, icicle-with-icy-mode-ON.
;; 2014/08/24 dadams
;; icicle-define-search-bookmark-command: Better prompt for context regexp.
;; 2014/08/23 dadams
;; icicle-define(-file)-command:
;; Hopefully fixed pb introduced on 2013-12-01: lost ici*-*-list return from interactive specs.
;; Use icicle-condition-case-no-debug, not unwind-protect. Put LAST-SEXP inside catch.
;; 2014/08/22 dadams
;; icicle-define(-file)-command: Added unwind-protect, so LAST-SEXP is always evaluated.
;; (C-g in content-searching was sometimes not killing some buffers.)
;; 2014/08/10 dadams
;; icicle-(buffer|file)-bindings: Bind icicle-(buffer|file)-completing-p.
;; icicle-define-bookmark-command-1, icicle-define-search-bookmark-command:
;; Bind icicle-multi-completing-p, icicle-bookmark-completing-p.
;; 2014/05/17 dadams
;; Added: icicle-with-help-window.
;; 2014/04/28 dadams
;; icicle-define(-file)-command: Fix pb introduced 2013/12/01: If icicle-top-level not called...
;; 2014/04/05 dadams
;; Added: icicle-menu-bar-make-toggle - same as bmkp-menu-bar-make-toggle in bookmark+-mac.el.
;; 2014/04/01 dadams
;; icicle-define-bookmark-command-1:
;; Faces icicle-annotation & icicle-msg-emphasis, not file-name-shadow & bookmark-menu-heading.
;; 2014/03/08 dadams
;; icicle-define(-file)-command:
;; Use generated let-var CHOICE for (CMD|FILE)-CHOICE.
;; Handle hiding common match, incremental completion and icomplete mode per command properties.
;; 2013/12/01 dadams
;; icicle-define-command, icicle-define-file-command:
;; Wrap FIRST-SEXP, minibuf read (with UNDO-SEXP), and LAST-SEXP in a catch, to ensure LAST-SEXP.
;; This is important for progressive completion, to, e.g., remove temporarily created buffers.
;; 2013/04/17 dadams
;; icicle-buffer-bindings: For icicle-bufflist: use icicle-buffer-prefix-arg-filtering.
;; 2013/04/15 dadams
;; icicle-buffer-bindings: (New) C-u C-u C-u means invisible buffers only.
;; 2013/03/31 dadams
;; icicle-buffer-bindings: (New) C-u C-u means visible buffers only.
;; 2013/03/07 dadams
;; Added: icicle-user-error.
;; icicle-define(-search)-bookmark-command(-1): Use icicle-user-error.
;; 2013/01/26 dadams
;; icicle-define-file-command: Ensure non-nil icicle-last-input before apply directory-file-name.
;; 2012/12/06 dadams
;; Removed minibuffer-with-setup-hook - moved to icicles-fn.el (and removed eval-when-compile).
;; 2012/12/01 dadams
;; Moved to icicles-opt.el: icicle-kbd, icicle-edmacro-parse-keys, icicle-read-kbd-macro.
;; 2012/10/08 dadams
;; icicle-define-sort-command: alphabetically -> alphabetical in doc string.
;; 2012/10/06 dadams
;; Added: minibuffer-with-setup-hook for code byte-compiled using Emacs < 22.
;; 2012/10/04 dadams
;; icicle-define-file-command:
;; When call expand-file-name, wrap i-last-input with directory-file-name, to use parent dir.
;; 2012/09/28 dadams
;; naked-edmacro-parse-keys:
;; Better fix for M-TAB. Do not assume that function keys are lowercase.
;; Handle angle brackets even if ANGLES is nil. But keep vanilla bug #12535 if non-nil.
;; 2012/09/27 dadams
;; icicle-edmacro-parse-keys: Fix handling of M-TAB. Function keys are lowercase.
;; So M-TAB returns [134217737], but M-tab returns [M-tab].
;; 2012/09/24 dadams
;; icicle-file-bindings: Pass non-nil NO-ERROR-P arg to icicle-describe-file.
;; 2012/09/11 dadams
;; icicle-buffer-bindings: Remove minibuffers from icicle-bufflist.
;; 2012/09/08 dadams
;; icicle-buffer-bindings:
;; Bind icicle-buffer-complete-fn to internal-complete-buffer for Emacs 22+.
;; Bind icicle-buffer-name-input-p to t.
;; Remove bindings of icicle-ignore-space-prefix-flag and bufflist.
;; (bufflist used icicle-ignore-space-prefix-flag to remove SPC buffers.)
;; icicle-define-command:
;; If icicle-buffer-name-input-p then use icicle-read-buffer (it is new), not completing-read.
;; 2012/07/24 dadams
;; icicle-buffer-bindings: If icicle-ignore-space-prefix-flag & VANILLA then remove internal bufs.
;; 2012/07/19 dadams
;; icicle-buffer-bindings: Positive prefix arg now includes Dired buffers, along with file bufs.
;; 2012/07/05 dadams
;; Removed #' from lambdas.
;; 2012/04/22 dadams
;; icicle-buffer-bindings: C-u keeps only derived-mode buffers.
;; Use backquote for lambda to handle free var THIS-MODE.
;; 2012/03/10 dadams
;; icicle-define-bookmark-command-1, icicle-define-search-bookmark-command:
;; First code, last code: When autofile, call icicle-(un)bind-file-candidate-keys.
;; Use icicle-make-bookmark-candidate (new) to define icicle-candidates-alist.
;; Bind icicle-full-cand-fn to icicle-make-bookmark-candidate, for icicle-autofile-action.
;; 2012/01/20 dadams
;; icicle-define-bookmark-command-1: Added info about refreshing tags to doc string of tags cmds.
;; 2011/11/27 dadams
;; icicle-define-bookmark-command-1:
;; Calculate the alist first, before binding things like icicle-list-use-nth-parts, that are
;; inappropriate for the completing-read used to define the alist (in specific-file|buffer case).
;; 2011/10/21 dadams
;; icicle-define-sort-command: Use icicle-propertize.
;; 2011/10/12 dadams
;; Moved the Miscellaneous stuff to icicles.el: indent & font-lock for macros etc.
;; eval-when-compile require cl.el, even for later Emacs versions (incf).
;; 2011/10/10 dadams
;; Removed all autoload cookies.
;; Moved icicle(-search)-define-bookmark*-command* here from icicles-cmd2.el.
;; icicle-byte-compile-eval-after-load-flag: Moved to icicles.el.
;; icicle-maybe-byte-compile-after-load: Moved to icicles-face.el and icicles-cmd2.el.
;; icicle-try-switch-buffer, select-frame-set-input-focus: Moved to icicles-fn.el.
;; icicle-assoc-delete-all, icicle-remove-if: Copied to icicles-fn.el.
;; 2011/10/08 dadams
;; Added: icicle-kbd
;; Moved here from icicles-cmd2.el: icicle-read-kbd-macro, icicle-edmacro-parse-keys.
;; icicle-read-kbd-macro: Changed NO-ANGLES to ANGLES, and made it the prefix arg.
;; icicle-edmacro-parse-keys: Changed NO-ANGLES to ANGLES. Updated to match Emacs 24.
;; Changed regexp for non-angles match to use non-whitespace.
;; Use characterp or char-valid-p, depending on Emacs version.
;; 2011/09/08 dadams
;; font-lock-add-keywords - Use font-lock-keyword-face for icicle-condition-case-no-debug.
;; 2011/08/27 dadams
;; icicle-condition-case-no-debug: Redefined so it respects debug-on-quit and keeps other handlers.
;; 2011/08/24 dadams
;; Added top-level puts for common-lisp-indent-function.
;; icicle-condition-case-no-debug, icicle-with-selected-window: Removed declare declaration.
;; 2011/08/22 dadams
;; icicle-maybe-byte-compile-after-load: Require bytecomp.el.
;; font-lock-add-keywords: Quote font-lock-function-name-face, for Emacs 20.
;; 2011/08/21 dadams
;; Added: icicle-condition-case-no-debug. Thx to Michael Heerdegen.
;; icicle-define(-file)-command: Use icicle-condition-case-no-debug.
;; 2011/08/16 dadams
;; Added: icicle-maybe-byte-compile-after-load, icicle-byte-compile-eval-after-load-flag.
;; icicle-(buffer|file)-bindings: Use append, not backquote syntax.
;; 2011/08/12 dadams
;; icicle-file-bindings: Removed binding of icicle-ignore-space-prefix-flag (to *-buffer-ignore-*).
;; 2011/05/22 dadams
;; icicle-define(-file)-command: Use #',FUNCTION instead of ',FUNCTION.
;; icicle-with-selected-window, icicle-(buffer|file)-bindings:
;; Use #' with lambdas (not really needed).
;; 2011/05/03 dadams
;; icicle-buffer-bindings, icicle-file-bindings:
;; Had to revert definition for Emacs > 20, but keep it for Emacs 20. Thx to Michael Heerdegen.
;; 2011/04/29 dadams
;; icicle-buffer-bindings, icicle-file-bindings:
;; Do not bind icicle-sort-comparer. Instead, set it the first time
;; (per icicle-(buffer|file)-sort-first-time-p).
;; No side effects to icicle-sort-orders-alist.
;; If icicle-(buffer|file)-sort is non-nil then put it at the beginning.
;; Use old backquote syntax for post-bindings - needed because of vanilla Emacs 20 bug.
;; 2011/04/25 dadams
;; icicle-file-bindings: Bind icicle-candidate-help-fn to icicle-describe-file w/ curr pref arg.
;; 2011/04/12 dadams
;; icicle-buffer-bindings, icicle-file-bindings: Added optional POST-BINDINGS arg.
;; 2011/04/02 dadams
;; icicle-buffer-bindings: Bind (new) icicle-bufflist, not bufflist.
;; 2011/03/29 dadams
;; Renamed: orig-(buff|window) to icicle-orig-(buff|window).
;; 2011/01/17 dadams
;; Require cl.el at compile time for Emacs 20.
;; 2011/01/06 dadams
;; icicle-buffer-bindings: Zero prefix arg limits candidates to buffers with same mode as current.
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/12/18 dadams
;; icicle-assoc-delete-all: Moved here from icicles-fn.el, since used here.
;; Added autoload cookies.
;; 2010/10/25 dadams
;; icicle-(buffer|file)-bindings:
;; Use icicle-must-pass-after-match-predicate, not icicle-must-pass-predicate
;; 2010/10/09 dadams
;; icicle-define(-file)-command: Update generated doc: down/up for modal, end/home for prefix.
;; 2010/06/05 dadams
;; icicle-file-bindings: Put back non-insertion for non-ido-like case.
;; 2010/06/04 dadams
;; icicle-(buffer|file)-bindings: Bind vars that depend on icicle-(buffers|files)-ido-like-flag.
;; 2010/03/03 dadams
;; Applied renamings: icicle-sort-function to icicle-sort-comparer,
;; icicle-sort-functions-alist to icicle-sort-orders-alist.
;; 2009/12/21 dadams
;; fset -> defalias.
;; 2009/12/13 dadams
;; icicle-define-sort-command: Add REVERSED to msg if reversed.
;; 2009/10/22 dadams
;; icicle-define-file-command: Use icicle-file-name-directory, not file-name-directory.
;; 2009/09/17 dadams
;; Added: icicle-file-bindings.
;; 2009/09/16 dadams
;; Added: icicle-buffer-bindings.
;; icicle-define(-file)-command: Macroexpand bindings, (e.g. to use icicle-buffer-bindings).
;; 2009/04/28 dadams
;; Moved icicle-choose-action-for-type to icicles-fn.el and changed to a function.
;; 2009/04/26 dadams
;; Added: icicle-choose-action-for-type, icicle-with-selected-window.
;; 2008/08/31 dadams
;; icicle-define(-file)-command: Select window before call select-frame-set-input-focus.
;; 2008/08/18 dadams
;; icicle-try-switch-buffer: Do nothing if icicle-inhibit-try-switch-buffer is non-nil.
;; Use renaming from icicles-fn.el: icicle-complete-again-update.
;; 2008/03/29 dadams
;; icicle-define(-file)-command: Do not call icicle-highlight-lighter.
;; 2008/03/09 dadams
;; icicle-define(-file)-command: Call icicle-highlight-lighter.
;; 2007/11/25 dadams
;; icicle-define(-file)-command:
;; Bound minibuffer variables, so they are restored after action function
;; (in case it uses minibuffer for completion).
;; Return nil after, not before select-frame-set-input-focus.
;; Added optional arg not-interactive-p.
;; Quiet the byte compiler for Emacs versions before 22.
;; 2007/10/14 dadams
;; icicle-define(-file)-command: Updated generated doc to reflect icicle-act-before-cycle-flag.
;; 2007/05/01 dadams
;; icicle-define(-file)-command: Reset icicle-candidate-action-fn after reading input.
;; 2007/04/15 dadams
;; icicle-define(-file)-command:
;; Simplified action fn: Removed unwind-protect and outer condition-case,
;; so don't return error msg now, and only set minibuf focus if succeed.
;; icicle-define(-file)-command, icicle-try-switch-buffer: Removed "%s" from handlers.
;; 2007/02/06 dadams
;; icicle-define(-file)-command: Mention mouse bindings in command doc strings.
;; 2007/01/15 dadams
;; Added: icicle-define-sort-command.
;; Updated font-lock-add-keywords. Added lisp-indentation-hack (commented out).
;; 2007/01/06 dadams
;; font-lock-add-keywords: 2 or 3, not 1 or 2, is index after add icicle-define-add-to-*.
;; Use lax matching, so no error if no match.
;; 2007/01/01 dadams
;; Added: icicle-define-add-to-alist-command.
;; Removed compile-time require of icicles-var.el.
;; font-lock-add-keywords:
;; "\\>[ \t'\(]*\\(\\sw+\\)?", not "\\s-+\\(\\sw\\(\\sw\\|\\s_\\)+\\)".
;; Added icicle-define-add-to-alist-command.
;; 2006/10/14 dadams
;; Require icicles-var.el.
;; Moved conditional eval-when-compile to top level.
;; 2006/09/24 dadams
;; icicle-define(-file)-command: Corrected bindings mentioned in doc strings.
;; 2006/08/27 dadams
;; icicle-define(-file)-command: Ensure orig-window is live before using it.
;; 2006/08/23 dadams
;; Added: icicle-try-switch-buffer. Use it in icicle-define(-file)-command.
;; 2006/08/03 dadams
;; icicle-define(-file)-command:
;; (error (error-message-string...)) -> (error "%s" (error-message-string...)).
;; 2006/05/16 dadams
;; icicle-define(-file)-command: Treat cases where user wiped out orig-buff or orig-window.
;; 2006/03/31 dadams
;; icicle-define(-file)-command: Wrap action fn in unwind-protect to select minibuf frame.
;; 2006/03/11 dadams
;; icicle-define-file-command: Expand file in directory of icicle-last-input.
;; 2006/03/08 dadams
;; icicle-define(-file)-command: Bug fix (thx to TobyCubitt):
;; Make sure icicle-candidate-action-fn runs FUNCTION in original buffer and window.
;; 2006/03/07 dadams
;; icicle-define(-file)-command: Mention in doc string that BINDINGS are not in effect
;; within icicle-candidate-action-fn.
;;;(@* "CHANGE LOG FOR `icicles-mcmd.el'")
;;
;; 2022/11/03 dadams
;; icicle-display-candidates-in-Completions: Check hist-cand membership with abs filename.
;; Code for Emacs 20 crash is just for hist cand.
;; icicle-describe-file: Like diredp-describe-file today: File Type -> File type.
;; 2022/06/23 dadams
;; icicle-search-define-replacement: Added missing nil args to completing-read.
;; 2021/03/17 dadams
;; Use buffer-string, not buffer-substring, for whole buffer.
;; 2020/08/14 dadams
;; icicle-help-string-completion: mouse-choose-completion is obsolete (removed).
;; icicle-choose-completion, icicle-current-completion-in-Completions,
;; icicle-mouse-candidate-read-fn-invoke, icicle-Completions-mouse-3-menu,
;; icicle-mouse-save/unsave-candidate: completion-base-size is obsolete (removed).
;; 2020/02/03 dadams
;; icicle-candidate-set-truncate: Use icicle-read-number if available.
;; 2019/12/10 dadams
;; icicle-change-sort-order: Changed indication of default value in prompt: NOW was misleading.
;; 2019/06/15 dadams
;; icicle-abort-recursive-edit:
;; Call 1on1-fit-minibuffer-frame with RESETP arg only if (= (minibuffer-depth) 1)
;; icicle-delete-windows-on: At the end, refocus and select the originally selected frame.
;; 2018/10/17 dadams
;; icicle-change-sort-order: Last occurrence of ORDER-NAMES should be icicle-sort-orders-alist.
;; 2018/10/15 dadams
;; icicle-change-sort-order:
;; Use original icicle-sort-orders-alist (local var ORDERS) for candidates, before changing it.
;; Pass ORDERS to icicle-current-sort-functions.
;; For completion: Bind icicle-sort-comparer to a string comparison only.
;; Bind icicle-sort-orders-alist to nil - provide no change in sort order.
;; icicle-current-sort-functions: Added optional arg ORDERS-ALIST.
;; 2018/04/02 dadams
;; icicle-sit-for, 3rd cond clause: do it also if defining-kbd-macro.
;; Thx to Charles Roelli. Same fix as for Emacs bug#21329.
;; 2018/03/02 dadams
;; Added: icicle-keep/remove-buffer-cands-for-indirect, icicle-keep-only-buffer-cands-for-indirect,
;; icicle-remove-buffer-cands-for-indirect.
;; 2018/01/15 dadams
;; icicle-display-candidates-in-Completions:
;; Added highlighting for icicle-SPC-scatter-match.
;; Applied renaming icicle-scatter -> icicle-scatter-re.
;; 2017/10/29 dadams
;; icicle-delete-windows-on:
;; Simpler test for whether frame has the active minibuffer window.
;; (Emacs 26.1 changed meaning of frame parameter minibuffer - bug #28978.)
;; 2017/10/22 dadams
;; icicle-delete-windows-on: Removed second arg to icicle-frames-on.
;; 2017/07/04 dadams
;; icicle-add/update-saved-completion-set: By default, use last set name and its file.
;; 2017/06/25 dadams
;; Added: icicle-toggle-completion-mode-keys.
;; icicle-help-string-completion: Added icicle-toggle-completion-mode-keys.
;; 2017/05/22 dadams
;; Added: icicle-keep-buffer-cands-for-modified, icicle-remove-buffer-cands-for-modified,
;; icicle-keep/remove-buffer-cands-for-modified.
;; 2017/01/15 dadams
;; icicle-delete-windows-on:
;; Do not prevent deletion if no minibuffer frame parameter and minibuffer is not active.
;; 2016/08/30 dadams
;; icicle-input-is-a-completion-p:
;; Do not remove directory part if not icicle-file-name-input-p (e.g. for abs file names).
;; 2016/06/10 dadams
;; icicle-display-candidates-in-Completions:
;; Respect icicle-reverse-sort-p even if icicle-sort-comparer is nil.
;; 2016/02/28 dadams
;; icicle-help-on-candidate: Use new option icicle-complete-keys-separator, not its default value.
;; 2015/12/31 dadams
;; Renamed: icicle-chars-(after|before) to icicle-string-(after|before)-p.
;; icicle-string-(after|before)-p: Use code suggested by Martin Rudalics in Emacs bug #17284.
;; icicle-backward-delete-char-untabify-magic, icicle-delete-backward-char-magic,
;; icicle-delete-char-magic:
;; Applied renamings.
;; 2015/10/11 dadams
;; icicle-help-on-candidate:
;; Call icicle-raise-Completions-frame, so respect icicle-move-Completions-frame.
;; 2015/09/20 dadams
;; Added: icicle-sort-by-flx-score, if can soft-require flx.el (Emacs 24.3+).
;; http://emacs.stackexchange.com/a/16522/105.
;; 2015/08/21 dadams
;; icicle-display-candidates-in-Completions:
;; Use icicle-mru-window-for-buffer (Emacs 24+).
;; Do the font-family remapping even if 1on1-display-*Completions*-frame, because Icicles calls
;; i-d-c-i-C repeatedly, and it does with-output-to-help-buffer, which kills local vars,
;; including the face-remapping var. IOW, cannot depend on 1on1-display-*Completions*-frame,
;; since that is called only once, when the frame is created.
;; 2015/08/20 dadams
;; icicle-display-candidates-in-Completions, icicle-remove-Completions-window:
;; Use face remapping (face-remap-(add|remove)-relative) instead of set-face-* for Emacs 23+.
;; Thx to Jonathan H (PythonNut).
;; 2015/07/05 dadams
;; Added: icicle-next-completion-style-set, alias cycle-icicle-completion-style-set,
;; icicle-choose-completion-style-set.
;; icicle-display-candidates-in-Completions: Show completion-styles in msgs for method vanilla.
;; icicle-help-string-completion: Show icicle-completion-style-set.
;; icicle-prefix-complete-1:
;; Initialize icicle-completion-style-set if necessary. Bind completion-styles.
;; Show completion-styles in msg for vanilla.
;; 2015/04/16 dadams
;; icicle-search-define-replacement: Added 3rd & 4th args to completing-read for reading function.
;; 2015/04/11 dadams
;; icicle-dispatch-M-comma: Added prefix arg - pass it to the function.
;; icicle-search-define-replacement: Added prefix arg, which means read a function name.
;; 2015/04/03 dadams
;; Renamed and rewrote: icicle-looking(-back)-at-literally-p to icicle-chars-(after|before).
;; 2015/02/20 dadams
;; icicle-candidate-set-complement: If null icicle-completion-candidates, remove *Completions*.
;; 2015/02/19 dadams
;; icicle-delete-candidate-object: Bind enable-recursive-minibuffers for ALLP confirmation prompt.
;; 2015/01/21 dadams
;; icicle-choose-completion (Emacs 23.2+):
;; Wrap icicle-choose-completion-string in with-current-buffer, per vanilla.
;; 2014/12/23 dadams
;; icicle-forward-char-magic:
;; Narrow & ignore errors. C-t in empty minibuffer: "Invalid search bound (wrong side of point)"
;; 2014/10/19 dadams
;; icicle-display-candidates-in-Completions: Moved here from icicles-fn.el.
;; 2014/09/18 dadams
;; icicle-mouse-candidate-read-fn-invoke, icicle-Completions-mouse-3-menu:
;; Removed unused bindings for POSN-(COLfrom|ROW) from posn-col-row.
;; 2014/009/10 dadams
;; Added: icicle-looking-at-literally-p.
;; Renamed: icicle-looking-back-at-p to icicle-looking-back-at-literally-p.
;; icicle-backward-delete-char-untabify-magic, icicle-delete-backward-char-magic:
;; Use icicle-looking-back-at-literally-p, not icicle-looking-back-at-p.
;; icicle-delete-char-magic: Use icicle-looking-at-literally-p, not icicle-looking-at-p.
;; 2014/08/22 dadams
;; icicle-narrow-candidates-with-predicate:
;; Must also match current candidates (incorporate M-*).
;; Use same code as icicle-narrow-candidates, and just bind icicle-must-pass-predicate, instead
;; of setting minibuffer-completion-predicate or read-file-name-predicate.
;; So this is no longer the same logic as for icicle-remove-cand-from-lists.
;; icicle-narrow-candidates:
;; For cons, obarray, etc. case: use ICICLE-CANDS-TO-NARROW, not icicle-completion-candidates.
;; icicle-apropos-complete-and-narrow: Added prefix arg, to do predicate narrowing.
;; icicle-looking-at-p: Redefined to use defalias or looking-at.
;; 2014/08/16 dadams
;; icicle-narrow-candidates-with-predicate: Bind icicle-must-pass-after-match-predicate to nil.
;; 2014/08/10 dadams
;; Added: icicle-cand-preds (var and fn).
;; icicle-narrow-candidates-with-predicate:
;; Rewrote to provide completion against predefined predicates (Emacs 24+).
;; Added prefix arg, ALLP.
;; 2014/07/27 dadams
;; Updated delete-selection PUT for icicle-self-insert per Emacs 24.4+.
;; 2014/06/21 dadams
;; icicle-candidate-set-retrieve-1: Mention whether added or restored in msg.
;; 2014/06/07 dadams
;; icicle-switch-to/from-minibuffer:
;; Test for non icicle-pre-minibuffer-buffer, not for eq minibuf win.
;; Call icicle-msg-maybe-in-minibuffer before buffer switch.
;; Reduce minibuffer-message-timeout to 1.
;; 2014/05/17 dadams
;; icicle-minibuffer-help, icicle-all-candidates-action-1, icicle-describe-file:
;; with-output-to-temp-buffer -> icicle-with-help-window.
;; 2014/05/14 dadams
;; icicle-prefix-complete-1: Bind temp-buffer-window-show-hook to nil also (Emacs 24.4+).
;; 2014/04/23 dadams
;; Use cl-flet if available.
;; Typo: icicle-toggle-show-image-file-thumbnail -> icicle-cycle-image-file-thumbnail.
;; 2014/04/20 dadams
;; icicle-(prefix|apropos)-complete-1:
;; Removed cond clause about not not expanding in minibuffer - it prevented cycling etc.
;; icicle-(prefix|apropos)-complete-2:
;; Moved the no-expand input logic here: Do nothing if not expanding input.
;; Added NO-DISPLAY-P arg: do nothing if non-nil.
;; icicle-toggle-icomplete-mode: Call icomplete-exhibit (unless < Emacs 23).
;; icicle-change-sort-order: Added note to doc string about auto on/off.
;; 2014/03/08 dadams
;; Added: icicle-toggle-icomplete-mode.
;; 2014/03/06 dadams
;; icicle-change-sort-order: Set icicle-last-sort-comparer to current comparer, before changing.
;; 2014/02/09 dadams
;; icicle-make-directory: Restore completion candidates after reading new dir name.
;; 2014/02/08 dadams
;; icicle-(prefix|apropos)-complete-1:
;; Applied renaming of icicle-file-directory-p to icicle-looks-like-dir-name-p.
;; 2014/02/07 dadams
;; icicle-history: Use icicle-unlist (new).
;; 2014/01/18 dadams
;; icicle-(prefix|apropos)-complete-1: Respect new icicle-keep-Completions-for-sole-dir behavior.
;; 2014/01/05 dadams
;; Added: icicle-recomplete-from-original-domain.
;; 2014/01/04 dadams
;; icicle-help-string-completion: Added C-M-~: icicle-toggle-search-complementing-domain.
;; 2014/01/02 dadams
;; icicle-unbind-buffer-candidate-keys: Unbind (bind to nil), not bind!
;; 2014/01/01 dadams
;; icicle-(prefix|apropos)-complete-1: Sole completion case, for file name: Respect NO-DISPLAY-P.
;; 2013/12/31 dadams
;; icicle-universal-argument--mode: Use set-transient-map, if defined.
;; 2013/12/26 dadams
;; icicle-narrow-candidates: Get back original candidates, via text property icicle-orig-cand.
;; 2013/12/01 dadams
;; icicle-top-level: Throw to the catch icicle-top-level, which is now defined for multi-commands.
;; 2013/09/21 dadams
;; Added: icicle-universal-argument--mode.
;; icicle-(digit|negative|universal)-argument, : Updated for Emacs 24.4 (snapshot of 9/20).
;; Define only for Emacs < 24.4: icicle-universal-argument-other-key, universal-argument--mode.
;; 2013/08/15 dadams
;; icicle-change-sort-order: Provide current as default and add to prompt when asking for new one.
;; 2013/08/03 dadams
;; Added: icicle-sort-by-last-use, icicle-sort-by-last-use\,-dirs-first.
;; Applied renamings: icicle-*-first-p.
;; 2013/08/02 dadams
;; Added: icicle-complete-current-candidate-as-input, icicle-dispatch-C-M-/,
;; icicle-toggle-expand-directory.
;; icicle-change-sort-order: Bind icicle-show-Completions-initially-flag to t.
;; icicle-help-string-completion: Added entry for icicle-toggle-expand-directory.
;; 2013/08/01 dadams
;; icicle-choose-completion: Use icicle-choose-completion-string, not choose-completion-string.
;; 2013/07/24 dadams
;; icicle-resolve-file-name, icicle-mouse-candidate-set-save(-more|-selected-1),
;; icicle-regexp-quote-input:
;; Use better nonempty region test.
;; 2013/07/06 dadams
;; icicle-switch-to/from-minibuffer:
;; Added minibuffer messages.
;; Message, not error, if minibuffer not active.
;; 2013/07/04 dadams
;; Use icicle-read-regexp, not read-string, for reading all regexps.
;; 2013/06/22 dadams
;; icicle-(prefix|apropos)-complete-1: Apply renaming to icicle-keep-Completions-for-sole-dir-flag.
;; Does not affect absolute file names (no drill-down).
;; 2013/06/20 dadams
;; icicle-(prefix|apropos)-complete-1: Revert change of 2012/05/11:
;; Do not set icicle-next-prefix-complete-cycles-p unless input did not change, because
;; if first (S-)TAB completes to dir that is sole candidate then second should not cycle.
;; Sole dir cand: If not icicle-remove-Completions-when-sole-dir-flag, then update *Completions*
;; instead of removing it.
;; icicle-apropos-complete-1: Corrected: Do not remove *Completions* if *-edit-update-p etc.
;; 2013/06/18 dadams
;; icicle-abort-recursive-edit: If region is active in delete-selection-mode, just deactivate it.
;; icicle-minibuffer-help: Added icicle-toggle-WYSIWYG-Completions.
;; Fixed intro line layout when icicle-completing-p.
;; toggle-icicle-WYSIWYG-Completions: Mention C-S-pause binding (new) in doc string.
;; 2013/06/15 dadams
;; icicle-doremi-zoom-Completions+: No-op if no Completions window.
;; 2013/05/13 dadams
;; icicle-change-sort-order: Handle integer value for icicle-change-sort-order-completion.
;; 2013/04/24 dadams
;; icicle-minibuffer-help: Better intro for completion cases.
;; 2013/04/18 dadams
;; icicle-(un)bind-buffer-candidate-keys:
;; Rewrote to use (new) option icicle-buffer-candidate-key-bindings.
;; 2013/04/08 dadams
;; icicle-choose-completion: Added version for Emacs 23.2+. Return completion number now.
;; icicle-mouse-choose-completion: Do not define for Emacs 23.2+ (uses icicle-choose-completion).
;; 2013/04/01 dadams
;; Added: icicle-top-level.
;; 2013/03/31 dadams
;; Added: icicle-(keep-only|remove|keep/remove)-buffer-cands-for-visible.
;; icicle-(un)bind-buffer-candidate-keys: Bind/unbind C-x v +/-.
;; 2013/03/26 dadams
;; icicle-candidate-set-complement:
;; When icicle-must-pass-predicate, e.g., after narrowing, filter display candidates using it.
;; Added code from icicle-candidate-set-retrieve-1 to recomplete (can cycle immediately etc.).
;; 2013/03/16 dadams
;; icicle(-complete-and)-(widen|narrow)-candidates, icicle-regexp-quote-input:
;; Put properties icicle(-apropos)-completing-command.
;; 2013/03/07 dadams
;; Updated to use icicle-user-error where appropriate.
;; icicle(mouse)-choose-completion: Added live-buffer test, per Emacs 24.
;; 2013/02/04 dadams
;; Removed all autoload cookies.
;; 2013/02/03 dadams
;; Added: icicle-isearch-history-complete, icicle-isearch-history-insert.
;; Moved here from icicles-fn.el: icicle-isearch-complete-past-string.
;; 2013/01/30 dadams
;; icicle-insert-history-element: Do not clear minibuffer.
;; icicle-multi-inputs-act: Raise error if no action function defined.
;; 2013/01/26 dadams
;; Added: icicle-multi-inputs-save (to be bound to M-S), icicle-roundup (to be bound to M-r),
;; icicle-multi-inputs-act (to be bound to M-R), icicle-insert-candidate-action,
;; icicle-split-input.
;; icicle-insert-history-element: Define as a multi-command.
;; icicle-insert-candidate-action: Do nothing if CAND is nil or "".
;; icicle-help-string-(non-)completion: Updated for new commands/keys.
;; 2013/01/11 dadams
;; icicle-help-string(-non)-completion: Removed M-s, M-r.
;; 2013/01/06 dadams
;; icicle-autofile-action: Updated calls to bmkp-*, to add nil NO-UPDATE-P argument.
;; 2013/01/05 dadams
;; Added: icicle-file-all-tags-narrow, icicle-file-all-tags-regexp-narrow,
;; icicle-file-some-tags-narrow, icicle-file-some-tags-regexp-narrow,
;; icicle-(un)bind-(buffer|file)-candidate-keys: Factored.
;; icicle-(un)bind-file-candidate-keys: Added: *-file-(all|some)-tags(-regexp)-narrow.
;; icicle-remove-cand-from-lists, icicle-narrow-candidates-with-predicate:
;; Handle Emacs > 23.1 correctly: it no longer uses read-file-name-predicate.
;; 2013/01/01 dadams
;; icicle-change-sort-order: completion--flush-all-sorted-completions, so Icomplete+ updates order.
;; 2012/12/31 dadams
;; icicle-successive-action, icicle-insert-completion, icicle-candidate-set-retrieve-1,
;; icicle-keep-only-past-inputs:
;; Set icicle-mode-line-help instead of using icicle-show-help-in-mode-line.
;; icicle-insert-completion: Use icicle-current-completion-in-Completions and
;; icicle-nb-of-cand-at-Completions-pos only if in *Completions*.
;; icicle-(prefix|apropos)-complete-1:
;; Replace local var mode-line-help with icicle-mode-line-help.
;; Do not call icicle-show-help-in-mode-line (using icicle-post-command-hook now).
;; 2012/12/20 dadams
;; icicle-(prefix|apropos)-complete-1: Handle new option icicle-TAB/S-TAB-only-completes-flag.
;; 2012/12/15 dadams
;; icicle-narrow-candidates:
;; Rename current-candidates to icicle-cands-to-narrow (now a global var, but bound only here).
;; Bind icicle-narrow-regexp if icicle-compute-narrowing-regexp-p.
;; 2012/12/12 dadams
;; icicle-narrow-candidates:
;; Use icicle-must-pass-predicate, not icicle-must-pass-after-match-predicate.
;; Added a cond clause for function-valued minibuffer-completion-table other than file input.
;; icicle-apropos-complete-and-widen: Updated when condition wrt *-apropos-complete-and-narrow.
;; 2012/11/28 dadams
;; icicle-toggle-transforming: Rewrote to be more useful when both are useful functions.
;; 2012/11/08 dadams
;; icicle-digit-argument, icicle-successive-action, icicle-(prefix|apropos)-complete-1,
;; icicle-switch-to-Completions-buf, icicle-keep-only-past-inputs,
;; icicle-remove-buffer-cands-for-mode:
;; Use icicle-get-safe.
;; 2012/11/07 dadams
;; icicle-successive-action, icicle-(prefix|apropos)-complete-1, icicle-switch-to-Completions-buf:
;; Protect calls to get with symbolp.
;; 2012/10/27 dadams
;; Added: icicle-toggle-annotation.
;; icicle-help-string-completion: Added icicle-toggle-annotation.
;; icicle-toggle-transforming: Use new variable icicle-toggle-transforming-message.
;; 2012/10/22 dadams
;; icicle-(un)bind-buffer-candidate-keys: Remove soft-require conditions for C-x F and C-x R.
;; 2012/10/21 dadams
;; Added: icicle-toggle-include-cached-files, icicle-toggle-include-recent-files.
;; icicle-(un)bind-buffer-candidate-keys:
;; Bind icicle-toggle-include-(cached|recent)-files to C-x F and C-x R.
;; 2012/10/10 dadams
;; icicle-doremi-increment-max-candidates+:
;; C-u sets to RESET, not nil, so icicle-maybe-sort-maybe-truncate can reset lighter.
;; 2012/10/09 dadams
;; icicle-prefix-complete-1: When icicle-multi-completing-p and match join string, show warning.
;; 2012/10/05 dadams
;; icicle-(prefix|apropos)-complete-(1|2), icicle(-mouse)-candidate-action-1:
;; Removed setting of icicle-default-directory (unused).
;; 2012/10/02 dadams
;; Added: icicle-looking-at-p, icicle-looking-back-at-p.
;; Removed: icicle-looking(-back)-at-anychar-regexp-p.
;; icicle(-delete)-(forward|backward)(-delete)-char(-untabify)-dots, icicle-transpose-chars-dots:
;; Rewrote and renamed *-dots to *-magic, to handle join string too.
;; 2012/09/24 dadams
;; Added: icicle-sort-by-last-file-access-time.
;; icicle-describe-file: Added optional arg NO-ERROR-P.
;; icicle-current-sort-functions: Use file comparison also if icicle-abs-file-candidates.
;; icicle-help-on-candidate(-symbol): Pass non-nil NO-ERROR-P arg to icicle-describe-file.
;; 2012/09/17 dadams
;; icicle(-help-on)-(next|previous)-(prefix-|apropos-)candidate(-per-mode)((-alt)-action|-help):
;; NTH is prefix arg. Plain C-u means use first candidate.
;; icicle-(next|previous)-line:
;; Move to (next|previous) line when CURR-COL is 1 (fixes bug for multi-line candidates).
;; 2012/09/08 dadams
;; icicle-dispatch-M-_: Call icicle-toggle-ignored-space-prefix normally, not interactively.
;; icicle-help-string-completion: *-buffer-ignore-space-prefix-flag, not *-ignore-space-prefix*.
;; icicle-candidate-set-complement:
;; Ensure icicle-buffer-name-input-p to pass icicle-buffer-ignore-space-prefix-flag arg.
;; icicle-toggle-ignored-space-prefix: Removed optional arg BUFFER-INSTEAD-P.
;; It now toggles icicle-buffer-ignore-space-prefix-flag, not icicle-ignore-space-prefix-flag.
;; 2012/09/06 dadams
;; Use icicle-string-match-p.
;; 2012/09/03 dadams
;; icicle-history: Let first TAB or S-TAB cycle, depending on icicle-default-cycling-mode.
;; Put properties icicle(-prefix|-apropos)-completing-command on it.
;; Set icicle-last-completion-command per icicle-default-cycling-mode. Use instead of apropos.
;; Do not set last-command to icicle-history.
;; 2012/09/02 dadams
;; icicle-(prefix|apropos)-complete-1:
;; Non-nil icicle-show-Completions-initially-flag means consider this is the second (S-)TAB.
;; 2012/08/27 dadams
;; icicle-make-directory:
;; Use (icicle-file-name-directory-w-default (icicle-input-from-minibuffer)) as default dir-name.
;; 2012/08/21 dadams
;; icicle-resolve-file-name: Call tap-put-thing-at-point-props after load thingatpt+.el.
;; 2012/08/18 dadams
;; icicle-resolve-file-name: Call tap-define-aliases-wo-prefix.
;; bounds-of-thing-at-point -> icicle-bounds-of-thing-at-point.
;; 2012/08/14 dadams
;; icicle-abort-recursive-edit: Call 1on1-fit-minibuffer-frame.
;; 2012/08/06 dadams
;; Renamed old-* to icicle-ORIG-*:
;; icicle-ORIG-choose-completion, icicle-ORIG-exit-minibuffer,
;; icicle-ORIG-minibuffer-complete-and-exit, icicle-ORIG-mouse-choose-completion,
;; icicle-ORIG-next-history-element, icicle-ORIG-sit-for, icicle-ORIG-switch-to-completions.
;; 2012/08/05 dadams
;; icicle-exit-minibuffer: If no faces to keep then remove all faces (they are Icicles faces).
;; 2012/07/24 dadams
;; icicle-toggle-ignored-space-prefix: Added prefix arg, so you can toggle buffer option.
;; 2012/07/21 dadams
;; icicle-help-on-candidate(-symbol): If available, use describe-buffer for buffers.
;; 2012/07/17 dadams
;; Removed: icicle-maybe-byte-compile-after-load (macro),
;; icicle-byte-compile-eval-after-load-flag (option).
;; Removed all calls to icicle-maybe-byte-compile-after-load.
;; 2012/07/14 dadams
;; icicle-mouse-candidate-action-1: Fix for Emacs 24. Use code similar to i*-candidate-action-1:
;; Set icicle-last-input, not icicle-last-completion-candidate, to choice.
;; Update default-directory. Remove candidate only if choice = icicle-last-completion-candidate.
;; icicle-(prefix|apropos)-complete-1: Do not use icicle-transform-sole-candidate.
;; 2012/07/13 dadams
;; Added: icicle-toggle-network-drives-as-remote.
;; icicle-help-string-completion: Added icicle-toggle-network-drives-as-remote.
;; 2012/07/12 dadams
;; icicle-help-string-completion: Better representation of option values.
;; 2012/07/10 dadams
;; icicle-other-history: Updated doc - now available for any minibuffer input, not just completion.
;; 2012/07/02 dadams
;; Moved here (since loaded first) from icicles-cmd2.el: icicle-byte-compile-eval-after-load-flag.
;; 2012/06/29 dadams
;; icicle-current-sort-functions: Do not exclude if PRED is icicle-allowed-sort-predicate.
;; icicle-help-on-candidate-symbol: select-frame-set-input-focus after apropos-command regexp.
;; Removed #' from lambdas.
;; 2012/06/27 dadams
;; icicle-retrieve-previous-input:
;; icicle-highlight-initial-whitespace and icicle-place-cursor.
;; Update icicle-current-raw-input unconditionally, so can continue to cycle.
;; 2012/06/25 dadams
;; icicle-describe-file: Removed extra space in format line File Type. Thx to Christopher Schmidt.
;; 2012/06/24 dadams
;; icicle-previous-line: Hitting up key on 1st cand looped in vertical mode bc of extra \n at eob.
;; 2012/06/17 dadams
;; icicle-narrow-candidates:
;; Use read-file-name with icicle-must-pass-after-match-predicate for all Emacs Versions.
;; Thx to Michael Heerdegen. Use backquote+comma to eliminate free var in lambda.
;; 2012/06/09 dadams
;; icicle-choose-completion, icicle-nb-of-cand-in-Completions-horiz, icicle-insert-dot,
;; icicle-switch-to-Completions-buf, icicle-current-completion-in-Completions,
;; icicle-move-to-next-completion:
;; Use point-min if 1- point is less.
;; icicle-move-to-next-completion:
;; Adjust use of icicle-show-Completions-help-flag. Wrap when bobp. When wrap to end, back up
;; over final space, which has no mouse-face, else previous-single-property-change DTWT.
;; icicle-previous-line: Handle new behavior of nil icicle-show-Completions-help-flag.
;; 2012/06/08 dadams
;; Added macro icicle-maybe-byte-compile-after-load here too (for next).
;; icicle-yank-secondary: Use eval-after-load of second-sel.el instead of fboundp yank-secondary
;; (for arbitrary load order). Added icicle-maybe-byte-compile-after-load.
;; 2012/06/03 dadams
;; icicle-(next|previous)-(prefix|apropos)-candidate-action:
;; Put non-nil value on icicle-action-command, so M-x avoids key reminder for multi-command use.
;; 2012/05/22 dadams
;; icicle-help-on-candidate(-symbol):
;; Test with icicle-file-remote-p before file-exists-p, to avoid Tramp.
;; 2012/05/14 dadams
;; icicle-help-on-candidate:
;; Do not use transform multi-completion candidate before passiting it to *-candidate-help-fn.
;; 2012/05/13 dadams
;; icicle-candidate-set-save-1: Use icicle-saved-completion-candidates as default variable.
;; 2012/05/11 dadams
;; icicle-sit-for: Bind inhibit-quit to t so C-g is handled as icicle-abort-recursive-edit.
;; icicle-(prefix|apropos)-complete-1:
;; Set icicle-next-(prefix|apropos)-complete-cycles-p to t unconditionally (except for WORD-P).
;; 2012/04/22 dadams
;; Added: icicle-(un)bind-buffer-candidate-keys,
;; icicle-(remove|keep-only)-buffer-cands-for(-derived)-mode.
;; 2012/04/09 dadams
;; Changed last-command-char to last-command-event.
;; Fixed typos: double single-quotes in autoload cookies.
;; 2012/04/08 dadams
;; Make autoload cookies for commands load icicles[.el] explicitly.
;; 2012/03/31 dadams
;; Removed soft-require of pp+.el (not used directly, but used by icicles-opt.el if available).
;; 2012/03/28 dadams
;; Changed FILE arg in autoloads by removing .el, so .elc will be loaded if available.
;; 2012/03/10 dadams
;; icicle-autofile-action:
;; Bind/restore completion vars around reading tags.
;; Re-complete at end, instead of icicle-update-and-next, so can see updates.
;; icicle-mouse-candidate-action-1:
;; No need to call icicle-update-and-next if called icicle-remove-candidate-display-others.
;; 2012/02/28 dadams
;; Reverted last change - it broke completion (called from *-prefix-*).
;; Trying a thoughtless hack: If INPUT then do not recompute completions.
;; 2012/02/27 dadams
;; icicle-input-is-a-completion-p: If icicle-last-completion-candidate is nil, compute candidates.
;; Fix for bug: entering a candidate without hitting (S-)TAB.
;; 2012/02/14 dadams
;; icicle-candidate-set-save-1:
;; Distinguish in-minibuffer use from top-level use. Raise error if user cancels fileset create.
;; 2012/02/13 dadams
;; icicle-candidate-set-save-1, icicle-add-file-to-fileset:
;; Use (list ...), not '(...), so get a new cons cell.
;; 2012/02/11 dadams
;; Support for new values of icicle-expand-input-to-common-match (no expansion etc.).
;; Added: icicle-cycle-expand-to-common-match.
;; icicle-help-string-completion: Added icicle-cycle-expand-to-common-match.
;; icicle-retrieve-last-input: Handle both prefix (3) and apropos (4) incremental expansion.
;; icicle-(prefix|apropos)-complete-1:
;; Handle all cases of icicle-expand-input-to-common-match: 0,1 (display only) vs 2 vs 3,4.
;; icicle-toggle-expand-to-common-match: Swap with icicle-expand-input-to-common-match-alt (new).
;; Doc strings: Applied renamings and key changes.
;; icicle-widen-candidates, icicle-regexp-quote-input:
;; Do not turn off icicle-expand-input-to-common-match. Just bind it while apropos-complete.
;; icicle-widen-candidates: Remove directory from raw input (bug fix).
;; icicle-apropos-complete-and-narrow: Use function, not var, icicle-current-TAB-method (bug fix).
;; icicle-candidate-set-save-1: Prompt to create new fileset if fileset entered does not exist.
;; 2012/02/08 dadams
;; Renamed: icicle-add/remove-tags-and-refresh to icicle-autofile-action.
;; icicle-autofile-action: Handle create/set case too. not just add and remove.
;; icicle-(un)bind-file-candidate-keys: Bind C-x a a to icicle-autofile-action for create/set.
;; 2012/02/02 dadams
;; Added aliases: cycle-icicle-(incremental-completion|sort-order|(S)-TAB-completion-method).
;; icicle-apropos-complete-and-exit: Removed binding of icicle-expand-input-to-common-match-flag.
;; icicle-toggle-dot: Do not call icicle-barf-if-outside-minibuffer.
;; icicle-cycle-image-file-thumbnail, icicle-next-(S-)TAB-completion-method,
;; icicle-change-sort-order:
;; Minibuffer message mentions also the next (following) value.
;; 2012/01/31 dadams
;; icicle-retrieve-previous-input:
;; Do not invoke icicle-call-then-update-Completions when inserting. IOW, do not re-complete.
;; icicle-(prefix|apropos)-complete-1: Reverted change for sole-completion: Expand (complete) it.
;; icicle-apropos-complete-1, multi-match case for file names:
;; Do not apply icicle-file-name-directory to icicle-last-input if it is nil.
;; icicle-remove-cand-from-lists: Fixed for Emacs 22 file names: compare CAND with just MCT-CAND.
;; Fixed for Emacs 23+: use minibuffer-completion-predicate always.
;; 2012/01/27 dadams
;; icicle-(prefix|apropos)-complete-1:
;; Reverted part of 2012-01-20 chg, for mult matches: it picked up mult keys hit with no delay.
;; 2012/01/24 dadams
;; Added: icicle-toggle-completions-format.
;; icicle-help-string-completion: Updated to add icicle-toggle-completions-format.
;; 2012/01/20 dadams
;; Renamed icicle-toggle-incremental-completion to icicle-cycle-incremental-completion.
;; icicle-apropos-complete-and-exit:
;; Bind icicle-expand-input-to-common-match-flag and icicle-prefix-complete-and-exit-p also.
;; Complete based on icicle-current-completion-mode, not just apropos.
;; Use icicle-candidates-alist if appropriate.
;; icicle-cycle-incremental-completion: cycle among t, nil, and always, instead of toggle t & nil.
;; icicle-retrieve-previous-input: Just use icicle-call-then-update-Completions.
;; icicle-(prefix|apropos)-complete-1:
;; When sole cand, icicle-edit-update-p and not icicle-expand-input-*, show cand in Completions.
;; icicle-apropos-complete-2:
;; Removed arg and setting it. Return input-sans-dir needed for setting real mode-line help.
;; 2012/01/19 dadams
;; icicle-prefix-complete-2:
;; Removed first arg and setting it. Return condition needed for setting real mode-line help.
;; icicle-prefix-complete-1:
;; Conditionally set mode-line help, using return value of icicle-prefix-complete-2.
;; 2012/01/17 dadams
;; icicle-mouse-choose-completion, icicle-mouse-candidate-action-1, icicle-mouse-remove-candidate,
;; icicle-current-completion-in-Completions:
;; No longer add back a newline if property icicle-keep-newline. Thx to Michael Heerdegen.
;; 2012/01/13 dadams
;; icicle-(un)bind-file-candidate-keys: Corrected to handle also minibuffer-local-must-match-map.
;; 2012/01/08 dadams
;; icicle-(prefix|apropos)-complete-1: Protect icicle-ido-like-mode with boundp for Emacs 20.
;; 2011/12/31 dadams
;; icicle-apropos-complete-1: Remove extra icicle-edit-update-p (typo) in condition.
;; 2011/12/29 dadams
;; Added: icicle-(prefix|apropos)-complete-2.
;; icicle-(prefix|apropos)-complete-1:
;; When completing initially or icicle-incremental-completion-flag is non-nil & non-t, expand
;; input to common match.
;; 2011/12/28 dadams
;; icicle-(prefix|apropos)-complete-1:
;; If icicle-ido-like-mode and icicle-top-level-when-sole-completion-flag do not throw to top
;; if sole candidate is a directory.
;; 2011/12/19 dadams
;; icicle-(next|previous)-line: Use line-end-position, not end-of-line + point.
;; 2011/12/15 dadams
;; icicle-keep-only-past-inputs: For file-name candidates, expand file names before comparing.
;; 2011/11/05 dadams
;; icicle-nb-Completions-cols: Ensure return value is at least 1. Thx to Michael Heerdegen.
;; 2011/10/21 dadams
;; icicle-all-candidates-action-1: Bind icicle-minibuffer-message-ok-p to non-nil for LISTP.
;; icicle-erase-minibuffer-or-history-element, icicle-(change|reverse)-sort-order,
;; icicle-toggle-(ignoring-comments|dot|WYSIWYG-Completions|~-for-home-dir|C-for-actions),
;; icicle-toggle-((-alternative)-sorting|angle-brackets|proxy-candidates|transforming),
;; icicle-toggle-(incremental-completion|expand-to-common-match|remote-file-testing),
;; icicle-toggle-(highlight-all-current|hiding-(common-match|non-matching-lines)),
;; icicle-toggle-(show-multi-completion|ignored-space-prefix|regexp-quote|literal-replacement),
;; icicle-toggle-(highlight-(historical|saved)-candidates|ignored-extensions),
;; icicle-toggle-search-replace-(common-match|whole-word)),
;; icicle-toggle-search-(cleanup|complementing-domain), icicle-toggle-case-sensitivity,
;; icicle-cycle-image-file-thumbnail, icicle-next(-S)-TAB-completion-method:
;; Use icicle-propertize.
;; icicle-toggle-dot: Barf if not in minibuffer.
;; 2011/10/18 dadams
;; icicle-(apropos|prefix)-complete-1:
;; Simplify sole-candidate case and correct it for nil *-expand-input-to-common-*.
;; Thx to Michael Heerdegen.
;; 2011/10/08 dadams
;; icicle-next-TAB-completion-method, icicle-read+insert-file-name,
;; icicle-(un)bind-file-candidate-keys:
;; Use icicle-kbd.
;; icicle-insert-key-description: Made it OK for Emacs 20 too.
;; icicle-toggle-angle-brackets: Added no-op message for Emacs 20.
;; icicle-mouse-candidate-action-1: Wrap icicle-help-on-candidate with with-current-buffer.
;; For key-completion cand, use current buffer if no i*-orig-buff.
;; 2011/09/21 dadams
;; icicle-(prefix|apropos)-complete-1: Use file-name-as-directory instead of concat with /.
;; 2011/09/09 dadams
;; icicle-switch-to-Completions-buf:
;; Do not set icicle-current-input to minibuffer content. Use that content sans dir, locally.
;; If icicle-candidate-nb is defined, use it: just call icicle-move-to-next-completion.
;; icicle-insert-completion:
;; Set icicle-last-completion-candidate to COMPLETION.
;; Set icicle-candidate-nb to icicle-nb-of-cand-at-Completions-pos (point).
;; Use icicle-insert-cand-in-minibuffer COMPLETION, not just insert of directory + COMPLETION.
;; Set icicle-last-input to icicle-current-input. Set icicle-cycling-p to t.
;; Call icicle-show-help-in-mode-line.
;; 2011/09/07 dadams
;; icicle-erase-minibuffer-or-history-element, icicle-prefix-complete-1,
;; icicle-apropos-complete(-1|-no-display), icicle-all-candidates-action-1, icicle-describe-file,
;; icicle-apply-to-saved-candidate, icicle-narrow-candidates(-with-predicate):
;; Use icicle-condition-case-no-debug instead of condition-case. Thx to Michael Heerdegen.
;; 2011/09/06 dadams
;; Added: icicle-resolve-file-name.
;; icicle-minibuffer-help: Call help-setup-xref, for back/forward buttons.
;; 2011/09/05 dadams
;; Added: icicle-dispatch-C-x., icicle-toggle-hiding-non-matching-lines.
;; icicle-help-string-completion: Added hiding no-match lines. Use icicle-dispatch-C-x..
;; 2011/08/30 dadams
;; icicle-backward-delete-char-untabify, icicle-delete(-backward)-char:
;; Put delete-selection prop, so region is deleted.
;; 2011/08/26 dadams
;; Make sure to pass format string as first arg to calls to functions error and message.
;; icicle-candidate-set-save-1: Use %s, not %S, in error format string.
;; 2011/08/19 dadams
;; Fix C-u in minibuffer for Emacs 24:
;; Don't bother to define icicle-ensure-overriding-map-is-bound for Emacs 24+.
;; icicle-(universal|digit|negative)-argument:
;; Use save&set-overriding-map, not icicle-ensure-*, for Emacs 24.
;; 2011/08/15 dadams
;; icicle-candidate-set-complement:
;; Apply icicle-must-pass-after-match-predicate to correct the initial domain subtracting from.
;; Use icicle-all-completions instead of its definition inline.
;; 2011/08/13 dadams
;; Added: icicle-toggle-search-complementing-domain, toggle-icicle-search-complementing-domain.
;; icicle-insert-string-from-variable: Completion candidates now include all string-valued vars.
;; 2011/08/12 dadams
;; Added: icicle-add/remove-tags-and-refresh, icicle-(un)bind-file-candidate-keys.
;; 2011/08/07 dadams
;; icicle-help-on-candidate: For icicle-candidate-help-fn case: icicle-transform-multi-completion.
;; 2011/07/27 dadams
;; Use icicle-completions-format everywhere, not icicle-completions-format-internal (removed).
;; 2011/07/21 dadams
;; Renamed: icicle-nb-of-candidate-in-Completions to icicle-nb-of-cand-at-Completions-pos.
;; 2011/07/06 dadams
;; Applied renaming of icicle-Completions-frame-at-right-flag to icicle-move-Completions-frame.
;; icicle-raise-Completions-frame: Handle left value of icicle-move-Completions-frame also.
;; 2011/06/26 dadams
;; icicle-minibuffer-help: Use insert, not princ, with icicle-help-string-completion.
;; icicle-minibuffer-help, icicle-help-string-completion:
;; Use help-commands-to-key-buttons, not substitute-command-keys, if available.
;; Soft-require help-fns+.el for help-commands-to-key-buttons.
;; 2011/06/03 dadams
;; icicle-next-candidate-per-mode:
;; Set this-command according to direction, per NTH. If NTH is nil set it to 1. For Icomplete+.
;; Replace icicle-help-in-mode-line-flag by icicle-help-in-mode-line-delay everywhere.
;; 2011/05/22 dadams
;; Added defvars for free vars to quiet byte compiler.
;; 2011/05/10 dadams
;; icicle-toggle-ignoring-comments: Toggle also ignore-comments-flag from thing-cmds.el.
;; 2011/05/07 dadams
;; Added: icicle-toggle-ignoring-comments. Bound to C-M-;.
;; Changed key for icicle-regexp-quote-input from C-M-; to M-% everywhere.
;; 2011/05/04 dadams
;; icicle-transform-sole-candidate: Do nothing if for some reason icicle-current-input is nil.
;; 2011/05/03 dadams
;; Added: icicle-plus-saved-sort, icicle-toggle-highlight-saved-candidates.
;; icicle-help-string-completion: Mention icicle-toggle-highlight-saved-candidates.
;; 2011/04/29 dadams
;; icicle-help-string-completion: Corrected current values shown for sort comparers.
;; 2011/04/25 dadams
;; icicle-describe-file: Sync'd with help-fns+.el - include autofile bookmark info.
;; icicle-help-on-candidate(-symbol): Add current-prefix-arg to call to icicle-describe-file.
;; 2011/04/02 dadams
;; icicle-search-define-replacement: Use (new) icicle-scan-fn-or-regexp, not scan-fn-or-regexp.
;; 2011/03/29 dadams
;; Added: icicle-scroll-(back|for)ward.
;; Renamed: icicle-scroll-Completions(-up) to icicle-scroll-Completions-(back|for)ward.
;; orig-buf(f) -> icicle-orig-buff.
;; icicle-help-on-candidate: Removed boundp condition for icicle-completing-keys-p.
;; Applied renaming: icicle-scroll-Completions-backward-p to icicle-scroll-Completions-reverse-p.
;; 2011/03/20 dadams
;; icicle-help-on-candidate-symbol: Don't bind help-xref-following. Thx to Michael Heerdegen.
;; 2011/03/17 dadams
;; icicle-candidate-set-complement:
;; Added condition-case: Emacs 23.2+ all-completions has no 4th arg.
;; icicle-delete-backward-char-dots, icicle-replace-input-w-parent-dir:
;; Use delete-char, not delete-backward-char (Emacs 23.2+ changed it to interactive only).
;; Added soft require of filesets.el when byte-compile.
;; 2011/03/15 dadams
;; icicle-describe-file: Added thumbnails for image files.
;; 2011/03/04 dadams
;; icicle-remove-cand-from-lists, icicle-narrow-candidates-with-predicate:
;; Corrected code for updating the predicate.
;; Test using emacs version, not boundp of read-file-name-predicate (since Icicles binds it now).
;; 2011/03/02 dadams
;; Added: icicle-all-exif-data.
;; icicle-describe-file: Show all EXIF data, using icicle-all-exif-data.
;; 2011/02/26 dadams
;; Added: icicle-Completions-popup-choice(-1), icicle-substitute-keymap-vars.
;; icicle-Completions-mouse-3-menu:
;; Rewrote to use option icicle-Completions-mouse-3-menu-entries instead of hard-coding menus.
;; icicle-candidate-set-define (cosmetic): Use when, not if, to raise error.
;; icicle-candidate-set-(difference|union|intersection|complement), : Added start-progress message.
;; 2011/02/23 dadams
;; icicle-help-string-completion, icicle-Completions-mouse-3-menu:
;; Add icicle-cycle-image-file-thumbnail.
;; icicle-Completions-mouse-3-menu: Handle prefix args (change menu items to reflect).
;; 2011/02/22 dadams
;; Added: icicle-cycle-image-file-thumbnail.
;; icicle-describe-file: Show also EXIF data for an image file.
;; icicle-remove-Completions-window:
;; No-op if Completions is selected or minibuf is selected and Completions was last selected.
;; 2011/02/20 dadams
;; icicle-history: If history is command-history, convert its entries to strings for completion.
;; icicle-history, icicle-keep-only-past-inputs: Clarify doc: current completion mode is kept.
;; 2011/01/20 dadams
;; icicle-read+insert-file-name: Bind icicle-must-pass-after-match-predicate to nil.
;; icicle-insert-string-at-point:
;; A numeric prefix arg when use ALTERNATIVES means evaluate grabbed sexp and insert the value.
;; 2011/01/17 dadams
;; icicle-remove-Completions-window: Bury buffer.
;; icicle-toggle-highlight-all-current: barf if not in minibuf or Completions.
;; icicle-dispatch-C-^: Use icicle-searching-p.
;; 2011/01/05 dadams
;; Added: icicle-sort-by-file-type.
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/12/18 dadams
;; Added more autoload cookies for commands. Thx to Richard Kim.
;; Specify command and file for commands defined by Icicles macros.
;; 2010/12/17 dadams
;; icicle-remove-Completions-window: Added FORCE arg. Remove if FORCE or interactive.
;; icicle-abort-recursive-edit: Call icicle-remove-Completions-window with FORCE arg.
;; 2010/12/14 dadams
;; icicle-retrieve-previous-input:
;; Added optional arg ALLOW-EMPTY-P (not used yet in calls).
;; Remove "" systematically, unless ALLOW-EMPTY-P.
;; Non-interactively, use last-recorded if current try is "" (unless ALLOW-EMPTY-P).
;; icicle-toggle-highlight-all-current: Turn off incremental completion while erase minibuffer.
;; icicle-insert-input: Apply renaming: icicle-expand-file-name to icicle-expand-file-or-dir-name.
;; 2010/12/02 dadams
;; icicle-retrieve-previous-input: Exclude "" from past-input cycling.
;; 2010/11/30 dadams
;; icicle-mouse-save-then-kill: If soft-require of mouse3.el, then use a simpler definition.
;; 2010/11/27 dadams
;; icicle-insert-list-join-string, icicle-pp-eval-expression-in-minibuffer:
;; Protect with 1on1-fit-minibuffer-frame-flag and soft-require of fit-frame.el.
;; icicle-(apropos|prefix)-complete-1: Soft-require of fit-frame.el for 1on1-fit-minibuffer-frame.
;; 2010/11/23 dadams
;; icicle-minibuffer-help:
;; Don't switch to minibuf window unless start in minibuf or *Completions*. Thx to M. Heerdegen.
;; 2010/11/08 dadams
;; icicle-next-TAB-completion-method, icicle-next-S-TAB-completion-method:
;; Set the icicle-last-top-level-command property only when set the first temporary method.
;; 2010/11/07 dadams
;; icicle-apply-to-saved-candidate: Do not sit-for if icicle-all-candidates-action.
;; Applied renaming of icicle-all-candidates-action-p to icicle-all-candidates-action.
;; 2010/11/06 dadams
;; icicle-apropos-complete-and-narrow: Do not regexp-quote if non-basic prefix completion.
;; icicle-next-TAB-completion-method, icicle-next-S-TAB-completion-method:
;; Prefix arg now means the new method is only for the current top-level command.
;; Put properties on icicle-last-top-level-command to implement this.
;; icicle-candidate-set-retrieve-1: Do icicle-apropos-complete-no-display if that was the last one.
;; 2010/11/05 dadams
;; icicle-mouse-save-then-kill: Redefined for Emacs 24 (they changed mouse-save-then-kill).
;; icicle-candidate-set-retrieve-1: Call icicle-apropos-complete upon minibuffer setup.
;; 2010/11/04 dadams
;; icicle-nb-of-candidate-in-Completions: Treat nil value the same as horizontal value.
;; 2010/10/24 dadams
;; icicle-insert-string-from-variable, icicle(-mouse)-candidate-read-fn-invoke,
;; icicle-narrow-candidates, icicle-save-predicate-to-variable:
;; Use icicle-must-pass-after-match-predicate, not PREDICATE arg.
;; 2010/10/09 dadams
;; icicle-minibuffer-help, icicle-help-string-completion, icicle-help-on-candidate (doc string):
;; Updated for change toward modal cycling. Fix for swank bindings and M-_ toggle.
;; Applied renaming of icicle-cycling-respects-completion-mode to icicle-default-cycling-mode.
;; icicle-toggle-search-replace-whole: Corrected toggle binding in doc string.
;; 2010/10/08 dadams
;; icicle-narrow-candidates: Set icicle-current-completion-mode to apropos.
;; icicle-apropos-complete-and-narrow:
;; Protect regexp-quote by ensuring non-nil icicle-last-input. Removed yesterday's change.
;; 2010/10/07 dadams
;; icicle-next-TAB-completion-method:
;; If icicle-current-TAB-method is nil, set to first one. member -> memq.
;; Use icicle-current-TAB-method function, not variable, everywhere else.
;; icicle-apropos-complete-and-narrow:
;; If completion mode is prefix, then prefix-complete first. Thx to Michael Heerdegen.
;; 2010/10/06 dadams
;; icicle-next-TAB-completion-method:
;; Use car of icicle-TAB-completion-methods, not basic, as default. Thx to Michael Heerdegen.
;; 2010/10/04 dadams
;; directory-sep-char -> ?/ (It was removed from Emacs 24.)
;; 2010/09/26 dadams
;; icicle-regexp-quote-input:
;; Handle no mark in minibuffer. Use end of prompt, not point-min. Thx to Michael Heerdegen.
;; icicle-column-wise-cand-nb: Bound NB (missing let binding).
;; 2010/06/18 dadams
;; icicle-nb-of-candidate-in-Completions(-horiz), icicle-move-to-next-completion:
;; Replace icicle-completions-format by icicle-completions-format-internal.
;; icicle-scroll-Completions: Do nothing if *Completions* is not displayed.
;; 2010/06/16 dadams
;; Added: icicle-col-wise-cand-nb.
;; Renamed icicle-nb-of-candidate-in-Completions to icicle-nb-of-cand-in-Completions-horiz.
;; Rewrote icicle-nb-of-candidate-in-Completions to handle vertical format also.
;; icicle-candidate-set-save-selected-1:
;; After setting BEG to next face chg, if BEG > END then raise error.
;; After setting END to previous fact chg, BEG > END then swap.
;; After extending, if BEG > END then swap.
;; 2010/06/14 dadams
;; icicle-narrow-candidates: Handle Emacs 23.2+: Use completing-read with read-file-name-internal.
;; icicle-search-define-replacement:
;; Wrap *-remove-Completions-window in save-selected-window. Thx to M. Heerdegen.
;; icicle-help-on-candidate-symbol: Show combined help for fns, vars, and faces (Emacs 22+).
;; 2010/06/11 dadams
;; Added: icicle-make-directory.
;; icicle-read+insert-file-name: Bind icicle-make-directory to C-c +.
;; 2010/06/08 dadams
;; icicle-doremi-increment-max-candidates+: Plain C-u resets icicle-max-candidates to nil.
;; 2010/06/07 dadams
;; icicle-exit-minibuffer: Do not fiddle with faces if not in minibuffer. Thx to M. Heerdegen.
;; icicle-prefix-complete-1:
;; Sole completion case: Move removal of *Completions* before the top-level throw.
;; 2010/06/04 dadams
;; Added: icicle-doremi-increment-max-candidates+.
;; Renamed by adding +: icicle-doremi-increment-swank-(timeout|prefix-length).
;; icicle-help-string-completion: Mention missing doremi toggle keys.
;; icicle-doremi-zoom-Completions+: Show *Completions* if not shown.
;; 2010/05/15 dadams
;; icicle-all-candidates-action-1: Bind *-minibuffer-message-ok-p, *-help-in-mode-line-flag to nil.
;; 2010/05/09 dadams
;; Added: icicle-dispatch-M-_.
;; Removed: icicle-dispatch-C-comma.
;; icicle-help-string-completion:
;; Removed extra arg to format (icicle-key-descriptions-use-<>-flag). Corrected arg order.
;; Updated to reflect binding changes.
;; icicle-toggle-highlight-all-current: Focus to minibuffer before show msg.
;; 2010/05/04 dadams
;; icicle-change-sort-order: Use save-selected-window. Thx to Michael Heerdegen.
;; icicle-apply-to-saved-candidate:
;; Only call sit-for if current-message. Added TYPE arg. Thx to Michael H.
;; 2010/05/03 dadams
;; icicle-toggle-remote-file-testing: Updated for Emacs 23.2+ Thx to Michael Albinus.
;; 2010/04/30 dadams
;; icicle-(apropos|prefix)-complete-1: Run icicle-no-match-hook when no candidates.
;; 2010/04/28 dadams
;; icicle-remove-cand-from-lists: Fix pred a la icicle-mctize-all. Thx to M. Heerdegen.
;; 2010/04/27 dadams
;; icicle-apply-to-saved-candidate: Added sit-for for non-C-u case, to see any msg displayed.
;; icicle-help-on-candidate: Test value, not just boundp, of icicle-completing-keys-p.
;; 2010/04/26 dadams
;; icicle-toggle-highlight-all-current:
;; Save/restore cand nb. Re-complete, rehighlight. Go to current cand only if it is defined.
;; 2010/04/21 dadams
;; Added: icicle-sit-for (Emacs 23+), so user input interrupts sit-for after C-u in minibuffer.
;; 2010/04/20 dadams
;; Added: icicle-sort-by-directories-first.
;; icicle-nb-of-candidate-in-Completions:
;; Bind icicle-completions-format to nil (for calls to *-move-to-next-*). Thx to M. Heerdegen.
;; 2010/04/13 dadams
;; icicle-(apropos|prefix)-complete-1: Fixed recent file-name completion bugs.
;; When icicle-whole-candidate-as-text-prop-p is t and icicle-expand-input-to-common-match-flag
;; is nil, expand the input, unless it is a directory.
;; Expand file-name input to the common match for the current candidate.
;; 2010/04/11 dadams
;; icicle-(apropos|prefix)-complete-1: Fix last fix:
;; Put whole-cand prop on sole candidate only if not a dir, and use icicle-expanded-common-match.
;; 2010/04/09 dadams
;; icicle-(apropos|prefix)-complete-1: When sole candidate, set icicle-current-input to it.
;; Needed, in order to get icicle-whole-candidate property when
;; icicle-expand-input-to-common-match-flag is nil. Thx to Michael Heerdegen.
;; 2010/03/13 dadams
;; Added: icicle-toggle-show-multi-completion.
;; 2010/03/03 dadams
;; Applied renamings: icicle-sort-function to icicle-sort-comparer
;; icicle-sort-functions-alist to icicle-sort-orders-alist,
;; icicle-alternative-sort-function to icicle-alternative-sort-comparer,
;; icicle-last-sort-function to icicle-last-sort-comparer.
;; 2010/03/02 dadams
;; icicle-remove-Completions-window: Do nothing unless *Completions* is shown.
;; icicle-delete-windows-on: Do nothing unless buffer is visible.
;; Do not delete frame if it is the only one.
;; 2010/01/12 dadams
;; icicle-mouse-choose-completion, icicle-insert-string-at-point,
;; icicle-mouse-candidate-action-1, icicle-mouse-remove-candidate,
;; icicle-mouse-candidate-read-fn-invoke, icicle-Completions-mouse-3-menu,
;; icicle-mouse-save/unsave-candidate:
;; set-buffer -> with-current-buffer.
;; icicle-mouse-candidate-read-fn-invoke, icicle-Completions-mouse-3-menu,
;; icicle-mouse-save/unsave-candidate:
;; Removed unused local var BUFFER.
;; icicle-mouse-choose-completion: Removed unused local var ORIG-BUFFER.
;; 2009/12/21 dadams
;; icicle-narrow-candidates:
;; Add fn to minibuffer-setup-hook to make the reference buffer be the new minibuffer.
;; fset -> defalias.
;; 2009/12/13 dadams
;; icicle-change-sort-order: Add REVERSED to msg when reversed.
;; 2009/11/27 dadams
;; Added: icicle-doremi-increment-swank-(prefix-length|timeout).
;; *-next-TAB-completion-method, *-prefix-complete-1: Handle swank completions too.
;; *-next-TAB-completion-method: Bind icicle-doremi-increment-swank-(prefix-length|timeout).
;; 2009/11/26 dadams
;; icicle-next-TAB-completion-method: Do not set icicle-inhibit-sort-p to t for fuzzy.
;; 2009/11/25 dadams
;; Added: icicle-completions-format, icicle-row-wise-cand-nb.
;; icicle-move-to-next-completion: Handle completions laid out vertically.
;; 2009/11/07 dadams
;; Renamed Icicles doremi cmds (added +). Applied other doremi cmd renamings (added +).
;; 2009/10/25 dadams
;; icicle-prefix-complete-1: When sole cand, use the candidate, but without any dir.
;; Renamed: icicle-next-apropos-match-function to icicle-next-S-TAB-completion-method,
;; icicle-toggle-fuzzy-completion to icicle-next-TAB-completion-method (rewrote).
;; icicle-(prefix|apropos)-complete-1: Updated no/sole msgs per new completion methods.
;; icicle-Completions-mouse-3-menu: Updated with the new command names.
;; Updated icicle-help-string-completion.
;; 2009/10/24 dadams
;; icicle-(apropos|prefix)-complete-1:
;; Removed code treating empty dir via *-any-*-p and ("").
;; When only one candidate, set *-last-completion-candidate to:
;; If file-name completion:
;; If empty input, the input; if dir candidate, input + /; else the sole candidate.
;; Else the sole candidate.
;; 2009/10/22 dadams
;; icicle-insert-input, icicle-candidate-action-1, icicle-keep-only-past-inputs,
;; icicle-apropos-complete-and-(narrow|widen):
;; Use icicle-file-name-directory, not file-name-directory.
;; 2009/10/21 dadams
;; icicle-prefix-complete-1:
;; For empty dir we use "" as pseudo-cand. Ensure not "" when later test for / last char.
;; 2009/10/12 dadams
;; Added: icicle-input-is-a-completion-p.
;; icicle-minibuffer-complete-and-exit, icicle-input-is-a-completion-p:
;; Use icicle-input-is-a-completion-p.
;; icicle-prefix-complete-1:
;; For file-name input: Set, and use, current input without substituting env vars.
;; When sole candidate ends in /, add a / to current input also.
;; 2009/09/26 dadams
;; icicle-narrow-candidates(-with-predicate): Bind icicle-progressive-completing-p to t.
;; 2009/09/25 dadams
;; icicle-prefix-complete-1, icicle-transform-sole-candidate:
;; Use icicle-current-input, not (car icicle-completion-candidates).
;; Don't set icicle-current-input to (car icicle-completion-candidates) if no-catch.
;; 2009/09/12 dadams
;; icicle-delete-candidate-object: Message if no candidates, in non-ALLP case also.
;; icicle-delete-candidate-object-1: Bind icicle-completion-candidates to save & restore it.
;; icicle-candidate-action-1, icicle-remove-candidate-display-others,
;; icicle-delete-candidate-object, icicle-help-on-candidate,
;; icicle-candidate-read-fn-invoke:
;; Bind icicle-help-in-mode-line-flag to nil, to avoid help-display delay.
;; icicle-update-and-next: Do nothing if user hit another key and there are more candidates.
;; 2009/09/05 dadams
;; icicle-narrow-candidates: Don't raise an error if no candidates. E.g. C-~.
;; Use backward and forward as the values of icicle-cycling-command prop for nav commands.
;; Apply renaming of icicle-acting-on-next/prev (removed -p).
;; icicle-successive-action: Bind it to value of icicle-cycling-command (nav direction).
;; icicle-all-candidates-list-alt-action: Raise error if null icicle-completion-candidates.
;; icicle-search-define-replacement: Prevent immediate incremental completion kicking in.
;; icicle-(widen|narrow)-candidates(-with-predicate):
;; Use literal text for (S-)TAB in error message, to avoid S-iso-*.
;; 2009/09/02 dadams
;; icicle-(prefix|apropos)-complete-1, icicle-narrow-candidates(-with-predicate):
;; Impose icicle-top-level-when-sole-completion-delay when *-flag is non-nil.
;; 2009/08/27 dadams
;; icicle-goto/kill-failed-input: Do nothing if the overlay is nowhere.
;; icicle-mouse-yank-secondary: If yank-secondary is defined, then pass prefix arg also.
;; 2009/08/23 dadams
;; icicle-narrow-candidates-with-predicate: Added optional arg PREDICATE.
;; 2009/08/20 dadams
;; icicle-successive-action: Don't call icicle-show-help-in-mode-line unless string arg.
;; 2009/08/11 dadams
;; icicle-all-candidates-action-1: Added ALTP arg. Use in call to *-candidate-action-1.
;; icicle-all-candidates(-list)-alt-action: Use new ALTP arg in call with *-alt-action-fn.
;; icicle-successive-action: Bind icicle-acting-on-next/prev-p around call to action fn.
;; icicle(-mouse)-candidate-action-1:
;; No longer bind icicle-* to selves. You must do it in the action fn if you need it.
;; icicle-help-string-completion: C-| -> M-| for Replace all.
;; icicle-change-history-variable: Protect with boundp: *-populate-interactive-history-flag.
;; Wrap require of icicles-var.el in eval-and-compile.
;; 2009/08/01 dadams
;; icicle-change-history-variable:
;; Add icicle-interactive-history to choices only if *-populate-interactive-history-flag.
;; 2009/07/29 dadams
;; icicle-other-history:
;; Call icicle-use-interactive-command-history only if Emacs 23+ and non-nil history.
;; 2009/07/27 dadams
;; icicle-help-string-completion: Mention icicle-other-history.
;; 2009/07/26 dadams
;; Added: icicle-change-history-variable, icicle-other-history,
;; icicle-use-interactive-command-history.
;; icicle-history:
;; Use icicle-cycling-p instead of get icicle-cycling-command, to avoid completion cmds.
;; 2009/07/02 dadams
;; icicle-candidate-set-save-1: If icicle-get-alist-candidate-function returns nil, use CAND
;; 2009/06/26 dadams
;; icicle-doremi-zoom-Completions, icicle-doremi-candidate-width-factor:
;; Use new key-list options, doremi-...-keys (not -key). You will need the latest DoReMi.
;; 2009/06/18 dadams
;; doremi-buffer-font-size: Changed increment (doremi-*-key) bindings to =, -, M-=, M-i.
;; icicle-help-string-completion: Added icicle-doremi-zoom-Completions.
;; 2009/06/17 dadams
;; Added: icicle-doremi-zoom-Completions.
;; icicle-doremi-candidate-width-factor: If no candidates, show message; don't use colors.
;; 2009/06/07 dadams
;; icicle-get-alist-candidate -> funcall icicle-get-alist-candidate-function.
;; 2009/05/27 dadams
;; icicle-minibuffer-complete-and-exit:
;; Don't exit if any completion is done, unless icicle-require-match-p is t.
;; 2009/05/22 dadams
;; Require icicles-mac.el if load-library doesn't find it.
;; 2009/05/18 dadams
;; icicle-candidate-set-save-selected-1: If empty inactive region and MOREP, raise error.
;; 2009/05/17 dadams
;; icicle-toggle-C-for-actions: Use icicle-toggle-icicle-mode-twice, not icy-mode calls.
;; 2009/05/15 dadams
;; icicle-(prefix|apropos)-complete-1: Fit minibuffer frame after inserting current input.
;; 2009/05/11 dadams
;; icicle-upcase-if-ignore-case, icicle-next-apropos-match-function: Use icicle-upcase.
;; 2009/05/09 dadams
;; Added: icicle-looking(-back)-at-anychar-regexp-p, icicle-(forward|backward)-char-dots,
;; icicle-backward-delete-char-untabify-dots, icicle-delete-backward-char-dots,
;; icicle-delete-char-dots, icicle-transpose-chars-dots. icicle-insert-dot(-command),
;; icicle-anychar-regexp, icicle-toggle-dot, icicle-convert-dots.
;; icicle-backward-delete-char-untabify, icicle-delete-backward-char, icicle-delete-char,
;; icicle-transpose-chars: Handle dots.
;; icicle-prefix-complete: Convert dots and set icicle-dot-string-internal.
;; icicle-goto/kill-failed-input: Use overlay.
;; icicle-help-string-completion, icicle-Completions-mouse-3-menu:
;; Added dot toggling. Changed binding for icicle-toggle-hiding-common-match.
;; 2009/05/08 dadams
;; icicle-(prefix|apropos)-complete-1: Fixed typo introduced 2009-05-05.
;; 2009/05/07 dadams
;; icicle-retrieve-(previous|last)-input: Call icicle-place-cursor with optional second arg.
;; 2009/05/05 dadams
;; toggle-icicle-case-sensitivity: Treat read-buffer-completion-ignore-case also (Emacs 23).
;; 2009/05/03 dadams
;; icicle-(prefix|apropos)-complete-1:
;; Don't stop cycling if last command was an action (treat as if it was a cycling cmd).
;; icicle-all-candidates(-list)(-alt)-action, icicle(-mouse)-candidate(-alt)-action,
;; icicle-delete-candidate-object, icicle(-mouse)-help-on-candidate:
;; Put property icicle-action-command.
;; 2009/05/02 dadams
;; icicle-candidate-alt-action: Respect icicle-alternative-actions-alist.
;; icicle-minibuffer-help: Corrected wrt alt action-for-all keys.
;; 2009/04/30 dadams
;; icicle-next-(prefix|apropos)-candidate, icicle-(prefix|apropos)-complete-1,
;; icicle-successive-action:
;; Reset icicle-next-(apropos|prefix)-complete-cycles-p to nil, as appropriate.
;; icicle-prefix-complete-1: Show mode-line help only at very end, and even after cycling.
;; 2009/04/29 dadams
;; icicle-apply-to-saved-candidate:
;; Pass no-error-no-msg to icicle-get-alist-candidate function.
;; If icicle-get-alist-candidate finds no function, get function from car of entry.
;; icicle-apropos-complete-and-(narrow|widen): Handle icicle-apropos-complete-no-display.
;; 2009/04/27 dadams
;; icicle-(prefix|apropos)-complete-1:
;; Set icicle-last-completion-command to icicle-*-complete-no-display if arg NO-DISPLAY.
;; icicle-history: If icicle-last-completion-command is nil, call icicle-apropos-complete.
;; 2009/04/26 dadams
;; Wrap load of icicles-mac in eval-when-compile, and use load-library, not require.
;; Require icicles-opt before icicles-var (not important).
;; 2009/04/20 dadams
;; Added: icicle-(previous|next)-candidate-per-mode-alt-action.
;; 2009/03/19 dadams
;; mouse-choose-completion: Don't fset unless standard function is defined.
;; Use when/unless instead of or for fset's. (cosmetic)
;; 2009/04/15 dadams
;; Added: icicle-(next|previous)-candidate-per-mode-help.
;; icicle-successive-action: Set mode only if known. Leave it alone for per-mode functions.
;; icicle-(apropos|prefix)-complete-1:
;; Don't show help in mode-line when icicle-top-level-when-sole-completion-flag = t.
;; 2009/04/12 dadams
;; icicle-successive-action: Inhibit help in mode line until after action is finished.
;; 2009/04/06 dadams
;; icicle-(prefix|apropos)-complete-1, icicle-candidate-set-retrieve-1,
;; icicle-keep-only-past-inputs:
;; Call icicle-show-help-in-mode-line for completed input.
;; icicle-(prefix|apropos)-complete-1:
;; Don't highlight complete input or show help if icicle-*-complete-and-exit-p is bound.
;; 2009/04/04 dadams
;; Renamed: icicle-sort-by-last-use to icicle-sort-by-last-use-as-input.
;; icicle-change-sort-order: Purge any nil entries from icicle-sort-functions-alist.
;; icicle-current-sort-functions: Respect icicle-buffer-name-sort-predicate.
;; icicle-reverse-sort-order: Echo icicle-current-sort-order.
;; 2009/03/16 dadams
;; icicle-candidate-action-1: Respect icicle-use-candidates-only-once-alt-p.
;; 2009/03/10 dadams
;; icicle-remove-Completions-window: Wrap with condition-case, to ignore "Attempt..." error.
;; 2009/03/01 dadams
;; Added: icicle-completing-read+insert, icicle-read+insert-file-name.
;; 2009/02/28 dadams
;; No soft require of subr-21.el now, since provide replace-regexp-in-string for Emacs 20.
;; 2009/02/23 dadams
;; icicle-mouse-choose-completion, icicle-(prefix|apropos)-complete-1,
;; icicle-insert-completion, icicle-mouse-candidate-action-1, icicle-update-and-next,
;; icicle-narrow-candidates(-with-predicate), icicle-keep-only-past-inputs,
;; icicle-insert-input:
;; Protect dir insertion with icicle-extra-candidates-dir-insert-p.
;; icicle-choose-completion: Use icicle-extra-candidates-dir-insert-p to reset base-size=0.
;; 2009/02/20 dadams
;; Added: icicle-sort-extra-candidates-first.
;; icicle-candidate-action-1: Use function icicle-require-match-p, not variable.
;; 2009/02/17 dadams
;; icicle-exit-minibuffer: Don't put nil face property on input. Thx to Daniel Clemente.
;; 2009/02/04 dadams
;; icicle-(prefix|apropos)-complete-1:
;; Do not set icicle-current-input to icicle-last-input unless also icicle-cycling-p.
;; Do not cycle unless also was already cycling or icicle-next-*-complete-cycles-p.
;; Set icicle-next-*-complete-cycles-p, at end, to save whether input was completed some.
;; 2009/02/01 dadams
;; Added: icicle-up-directory, icicle-replace-input-w-parent-dir.
;; 2009/01/24 dadams
;; icicle-narrow-candidates(-with-predicate):
;; Bind icicle-apropos-complete-match-fn to icicle-last-apropos-complete-match-fn.
;; icicle-next-apropos-match-function: Save new value as *-last-apropos-complete-match-fn.
;; 2009/01/18 dadams
;; icicle-(prefix|apropos)-complete-1:
;; Don't set icicle-current-input to icicle-last-input if icicle-edit-update-p.
;; 2009/01/17 dadams
;; icicle-next-apropos-match-function:
;; Add Levenshtein distance in message: (1).
;; Don't do icicle-complete-again-update - too slow.
;; 2009/01/14 dadams
;; icicle-remove-cand-from-lists: Treat icicle-remove-dups-if-extras also.
;; 2009/01/13 dadams
;; icicle-delete-windows-on: Delete frame even if it has a minibuffer, if it's not active.
;; 2008/12/26 dadams
;; Added: icicle-widen-candidates, icicle-apropos-complete-and-widen.
;; Added icicle-widen-candidates to icicle-Completions-mouse-3-menu.
;; 2008/12/25 dadams
;; icicle-retrieve-previous-input: Corrected logic following cycling.
;; Remember whether repeated C-l calls follow cycling: local var was-cycling-p.
;; If so, then use current raw input for second C-l. Otherwise use previous raw input.
;; Use icicle-cycling-p instead of testing if this command is a cycling command.
;; Handle case of "" raw input, which is never in list of saved raw inputs.
;; Restore current raw input after re-completing.
;; icicle-(prefix|apropos)-complete-1: Reset icicle-cycling-p (new var) to nil.
;; icicle-regexp-quote-input: Reset icicle-expand-input-to-common-match-flag to nil.
;; 2008/12/22 dadams
;; Added: icicle-regexp-quote-input.
;; Added it to icicle-help-string-completion, icicle-Completions-mouse-3-menu.
;; 2008/12/21 dadams
;; icicle-minibuffer-complete-and-exit:
;; Rewrote to fit new Emacs 23 behavior. Thx to Daniel Clemente.
;; Test minibuffer-completion-confirm first, before we auto-complete.
;; icicle-last-input -> icicle-current-input (bug fix bc of call to *-no-display).
;; icicle-prefix-complete-1: Bind free var word-complete-input.
;; icicle-(apropos|prefix)-complete-1: No messages if NO-DISPLAY-P is 'no-msg.
;; 2008/12/20 dadams
;; icicle-(apropos|prefix)-complete-1, icicle-narrow-candidates(-with-predicate):
;; Expand file-name choice if thrown to icicle-read-top.
;; 2008/12/10 dadams
;; icicle-(apropos|prefix)-complete-1: Don't pick up icicle-last-input unless also:
;; (1) same completion mode, (2) icicle-completion-candidates is not nil.
;; icicle-prefix-complete-1: If WORD-P, don't pick up icicle-last-input unless same command.
;; Bind minibuffer-message-timeout to 0 during minibuffer-complete-word.
;; icicle-apropos-complete-1:
;; Typo in last cond clause: prefix -> apropos, in i-apropos-completing-command.
;; 2008/12/06 dadams
;; icicle-prefix-complete-1: Fixes for word completion.
;; Don't initialize *-current-input to *-last-input if word-p and icicle-edit-update-p.
;; Recompute candidates after word complete also if editing or didn't repeat last command.
;; Cycle if last command was not a prefix completion and input doesn't end in `-'.
;; 2008/12/05 dadams
;; Let repeated completion commands cycle. Thx to Andrey Zhdanov for the suggestion.
;; icicle-(apropos| prefix)-complete-1:
;; Call icicle-next-candidate, not scroll, when repeated. Special treatment for word.
;; icicle-(apropos|prefix)-complete*:
;; Put icicle(-apropos|-prefix)-cycling-command property on command symbols.
;; 2008/12/02 dadams
;; icicle-minibuffer-complete-and-exit:
;; Updated for Emacs 23's minibuffer-confirm-exit-commands.
;; 2008/11/29 dadams
;; icicle-prefix-word-complete:
;; Redefined to use (new) icicle-prefix-complete-1.
;; Put property icicle-completing-command.
;; icicle-prefix-complete-1:
;; Useful now also for icicle-prefix-word-complete. Added arg word-p.
;; icicle-(prefix|apropos)-complete-1, icicle-switch-to-Completions-buf:
;; Test property icicle-prefix-completing-command, not eq cmds.
;; icicle-(prefix|apropos)(-word)-complete(-no-display):
;; Put property icicle-(prefix|apropos)-completing-command.
;; icicle-next-candidate-per-mode: Use case, not cond.
;; icicle-end-of-line+: Bind inhibit-field-text-motion, call end-of-line to get past prompt.
;; 2008/11/18 dadams
;; icicle-minibuffer-complete-and-exit: Allow exit if input matches a current candidate.
;; icicle-exit-minibuffer: Remove all Icicles minibuffer faces, but only those.
;; 2008/11/14 dadams
;; Added: icicle-toggle-hiding-common-match.
;; icicle-help-string-completion, icicle-Completions-mouse-3-menu: Mention it.
;; 2008/11/10 dadams
;; icicle-minibuffer-complete-and-exit:
;; Use icicle-exit-minibuffer, not old-exit-minibuffer, so remove *Completions*.
;; 2008/11/09 dadams
;; icicle-maybe-multi-completion-completing-p, icicle-transform-sole-candidate:
;; Don't test icicle-list-join-string (always non-nil).
;; 2008/11/03 dadams
;; icicle-(apropos|prefix)-complete-1: Added message Computing completion candidates...
;; 2008/11/02 dadams
;; icicle-upcase-if-ignore-case: condition-case, to prevent error on bad chars (Emacs 20).
;; 2008/10/27 dadams
;; Added: icicle-upcase-if-ignore-case.
;; icicle-minibuffer-complete-and-exit, icicle-(prefix|apropos)-complete-1:
;; Use icicle-upcase-if-ignore-case.
;; 2008/10/24 dadams
;; icicle-minibuffer-complete-and-exit: If icicle-candidates-alist, then just filter it.
;; 2008/10/18 dadams
;; Replaced customize-save-variable by funcall icicle-customize-save-variable-function.
;; 2008/10/14 dadams
;; Added: icicle-help-string(-non)-completion.
;; icicle-help-string-completion:
;; Renamed from icicle-update-help-string in icicles-mode.el.
;; Moved common part to icicles-var.el as icicle-general-help-string.
;; Renamed: icicle-completion-help to icicle-minibuffer-help.
;; icicle-minibuffer-help: If not completing, use icicle-help-string-non-completion.
;; Move Send an Icicles bug report to the bottom.
;; 2008/10/11 dadams
;; icicle-(next|previous)-line: Fixed so it highlights also candidates in first column.
;; icicle-kill-failed-input: Made it two-stage. Renamed to icicle-goto/kill-failed-input.
;; 2008/10/10 dadams
;; Added: icicle-(next|previous)-candidate-per-mode-action.
;; 2008/10/09 dadams
;; Updated icicle-Completions-mouse-3-menu for C-<.
;; 2008/10/08 dadams
;; Added: icicle-candidate-set-retrieve-more, icicle-candidate-set-retrieve-1.
;; icicle-candidate-set-retrieve: Use icicle-candidate-set-retrieve-1.
;; icicle-insert-string-at-point:
;; Use icicle-pre-minibuffer-buffer, not (cadr (buffer-list)). Thx to Andrey Zhdanov.
;; icicle-beginning-of-line+: Don't move into prompt. Thx to Andrey Zhdanov.
;; 2008/10/06 dadams
;; icicle-self-insert: Do self-insert-command if executing-kbd-macro. Thx to Tomer Levin.
;; 2008/10/01 dadams
;; icicle-completion-help: Use icicle-update-help-string, not icicle-completion-help-string.
;; 2008/09/30 dadams
;; Renamed icicle-isearch-complete-1 to icicle-isearch-complete-past-string and moved it
;; to icicles-fn.el.
;; 2008/09/20 dadams
;; icicle-toggle-ignored-extensions: Append $ to each extension.
;; icicle-dispatch-C-.: Use icicle-searching-p as the condition, not *-file-name-input-p.
;; 2008/09/14 dadams
;; icicle-(minibuffer|apropos)-complete-and-exit: Set icicle-last-input to current input.
;; icicle-minibuffer-complete-and-exit: Use apropos completion if that's the current mode.
;; 2008/09/13 dadams
;; icicle-candidate-set-save-1: Save to fileset if zero prefix arg.
;; icicle-candidate-set-retrieve: Retrieve also from a fileset.
;; No default value for completing-read.
;; Added: icicle-add-file-to-fileset.
;; Renamed:
;; icicle-candidate-set-save-to-cache-file to icicle-candidate-set-save-persistently,
;; icicle-candidate-set-retrieve-from-cache-file to *-candidate-set-retrieve-persistent.
;; icicle-candidate-set-save-persistently: Added arg FILESETP.
;; icicle-add/update-saved-completion-set: No default value for completing-read.
;; icicle-retrieve-candidates-from-set:
;; Factored out code as icicle-get-candidates-from-saved-set - use it. Don't return name.
;; Moved to icicles-fn.el: icicle-readable-to-markers.
;; 2008/09/09 dadams
;; icicle-candidate-set-save(-selected-1): Added NO-ERROR-P arg.
;; icicle-candidate-set-save-selected: Call *-save-selected-1 with NO-ERROR-P arg.
;; icicle-candidate-set-save-1: Raise error if set to save is empty and not NO-ERROR-P.
;; 2008/09/08 dadams
;; icicle-apropos-complete-and-narrow:
;; If currently prefix completing, escape current input before apropos completing.
;; 2008/09/07 dadams
;; icicle-minibuffer-complete-and-exit:
;; Use *-prefix-complete-no-display and *-display-candidates-in-Completions when needed.
;; 2008/09/06 dadams
;; icicle-minibuffer-complete-and-exit: Rewrote, based on icicle-apropos-complete-and-exit.
;; icicle-prefix-complete-1:
;; Wrap most of single-candidate case in (boundp 'icicle-prefix-complete-and-exit-p).
;; 2008/09/04 dadams
;; icicle-minibuffer-complete-and-exit: Temporary bug workaround.
;; 2008/08/31 dadams
;; icicle-completion-help, icicle-pp-eval-expression-in-minibuffer,
;; icicle-delete-candidate-object-1, icicle-apply-to-saved-candidate,
;; icicle-toggle-highlight-all-current:
;; Select window before call select-frame-set-input-focus.
;; 2008/08/29 dadams
;; icicle-minibuffer-complete-and-exit: Update icicle-last-input to minibuffer contents.
;; 2008/08/28 dadams
;; icicle-(apropos|prefix)-complete-1, icicle-narrow-candidates(-with-predicate):
;; Update minibuffer-history-variable before throw result.
;; icicle-help-on-candidate: Renamed alacarte-menu-items-alist to lacarte-menu-items-alist.
;; 2008/08/27 dadams
;; icicle-kill-failed-input: Reverted mistaken change to use start of *Completions* (duh).
;; 2008/08/25 dadams
;; icicle-minibuffer-complete-and-exit: Call icicle-prefix-complete-no-display with no-msg
;; arg, instead of binding minibuffer-message-timeout to 0.
;; icicle-(apropos|prefix)-complete-no-display: Added optional NO-MSG-P arg.
;; 2008/08/24 dadams
;; icicle-minibuffer-complete-and-exit: Rewrote to not call original Emacs version.
;; Use today's renamings from icicles-fn.el.
;; icicle-raise-Completions-frame: Don't do anything unless one-window-p and option = t.
;; icicle-choose-completion, *-kill-failed-input, *-current-completion-in-Completions:
;; Check point wrt candidates start position, not bobp.
;; icicle-current-completion-in-Completions:
;; "No completion here" error after, not before, we set beg wrt mouse-face change.
;; icicle-mouse-candidate-action-1: Call icicle-update-and-next if there are still cands.
;; 2008/08/21 dadams
;; icicle-candidate-set-retrieve: If completing files, remove directory from candidates.
;; 2008/08/20 dadams
;; icicle-mouse-candidate-action-1: Remove mouse-face property from choice.
;; 2008/08/19 dadams
;; icicle-mouse-remove-candidate:
;; Set icicle-last-completion-candidate. Needed for *-remove-candidate-display-others.
;; icicle-mouse-candidate-action-1: Removed unused vars: buffer, base-size.
;; Added: icicle-delete-candidate-object-1, with explicit CAND arg and NO-DISPLAY-P option.
;; icicle-delete-candidate-object: Added optional ALLP arg.
;; icicle-delete-current-candidate-object: Added optional CAND arg.
;; icicle-update-and-next: Don't try to move to cand in *Completions* if number not known.
;; 2008/08/18 dadams
;; Added: icicle-remove-cand-from-lists, icicle-update-and-next.
;; icicle-narrow-candidates-with-predicate: Update predicate correctly, with lexical-let.
;; icicle-remove-candidate, icicle-delete(-current)-candidate-object:
;; Removed stuff from doc string about removing all that match.
;; icicle-delete-candidate-object, icicle-remove-candidate-display-others:
;; Use icicle-remove-cand-from-lists (with mctized candidate) and icicle-update-and-next.
;; icicle-delete-current-candidate-object: Changed first condition:
;; (and icicle-candidates-alist (consp (car val))) to
;; (or icicle-whole-candidate-as-text-prop-p icicle-candidates-alist)
;; icicle-remove-candidate-display-others:
;; Added optional ALLP arg.
;; Reinitialize icicle-last-completion-candidate properly (as elsewhere).
;; icicle(-mouse)-candidate-action-1: Use ALLP arg for *-remove-candidate-display-others.
;; icicle-history: Don't set minibuffer-completion-predicate if it is nil.
;; Use renamings from icicles-fn.el:
;; icicle-complete-again-update, icicle-remove-if, icicle-put-whole-cand-prop.
;; icicle-narrow-candidates: Do not bind icicle-whole-candidate-as-text-prop-p to nil.
;; icicle-Completions-mouse-3-menu: Removed icicle-scroll-Completions from menu.
;; 2008/08/17 dadams
;; icicle-narrow-candidates-with-predicate:
;; (read-file-name|minibuffer-completion)-predicate: Removed `, in front.
;; icicle-scroll-Completions: Added optional arg (for mouse wheel reversal).
;; Added: icicle-scroll-Completions-up.
;; 2008/08/03 dadams
;; Added: icicle-all-candidates-list(-alt)-action.
;; icicle-all-candidates(-alt)-action:
;; Act on saved candidates, if any. Use list function, if normal is nil.
;; icicle-all-candidates-action-1:
;; Use icicle-candidate-action-1 (with cand arg (new)), not funcall, to apply fn-var.
;; Act on saved candidates, if any.
;; Do not call icicle-abort-recursive-edit at the end.
;; icicle-candidate-action-1:
;; Added optional CAND arg.
;; Save stuff before funcall, in case FN-VAR does its own completion.
;; icicle-mouse-candidate-action-1: Save stuff before funcall, in case FN-VAR completes.
;; icicle-remove-candidate-display-others:
;; When no candidates left, just call icicle-abort-recursive-edit.
;; icicle-help-on-candidate: Added optional CAND arg.
;; Renamed: icicle-candidate-alternative-action-fn to icicle-candidate-alt-action-fn.
;; 2008/07/27 dadams
;; Added: icicle-sort-by-2nd-parts-alphabetically, icicle-maybe-multi-completion-*.
;; icicle-current-sort-functions: Treat icicle-multi-completion-sort-predicate property.
;; icicle-dispatch-C-comma: Call icicle-change-sort-order interactively (bug fix).
;; icicle-reverse-sort-order: Display candidates, possibly in reverse order (bug fix).
;; Moved from here to icicles-fn.el: icicle-transform-multi-completion.
;; 2008/07/16 dadams
;; icicle-mouse-choose-completion: No error if minibuffer is not active.
;; icicle-completion-help and top-level: Don't require help-mode.el unless Emacs 22+.
;; eval-when-compile require's of fit-frame.el, linkd.el.
;; 2008/06/24 dadams
;; icicle-narrow-candidates: Emacs < 22: Set minibuffer-completing-file-name to nil.
;; 2008/06/21 dadams
;; icicle(-mouse)-choose-completion, icicle-current-completion-in-Completions,
;; icicle-mouse-candidate-action-1:
;; buffer-substring-no-properties -> buffer-substring.
;; *NOTE*: THIS REVERSES A FIX made on 2008/02/03. Dunno why that fix was made.
;; 2008/06/03 dadams
;; Added: icicle-toggle-C-for-actions.
;; icicle-Completions-mouse-3-menu: Added icicle-toggle-C-for-actions.
;; 2008/06/01 dadams
;; Added: icicle-current-sort-functions. Predicate tests various contexts using properties.
;; icicle-change-sort-order: Use icicle-current-sort-functions.
;; Added new sort order, defining function icicle-sort-special-candidates-first.
;; 2008/05/27 dadams
;; icicle-isearch-complete-1: Use ring symbols, not their values.
;; 2008/05/25 dadams
;; icicle-isearch-complete: Rewrote. Handle minibuffer search.
;; Added: icicle-isearch-complete-1, from stuff in icicle-isearch-complete.
;; Treat string case. Allow recursive minibuffers. Don't use icicle-isearch-resume.
;; Removed: icicle-isearch-resume.
;; 2008/05/22 dadams
;; icicle-toggle-case-sensitivity: Added prefix arg and update lighter.
;; 2008/05/03 dadams
;; icicle-history: Bind minibuffer-completing-file-name to nil.
;; 2008/05/02 dadams
;; (put 'icicle(-mouse)-yank-secondary 'delete-selection 'yank)
;; 2008/04/25 dadams
;; Added: icicle-toggle-remote-file-testing.
;; icicle-Completions-mouse-3-menu:
;; Added icicle-toggle-remote-file-testing (C-^).
;; icicle-toggle-ignored-space-prefix is now bound to M-_, not C-^.
;; icicle-dispatch-C-^:
;; icicle-toggle-remote-file-testing, not icicle-toggle-ignored-space-prefix.
;; 2008/04/18 dadams
;; Renamed icicle-init-value-flag to icicle-default-value.
;; 2008/04/13 dadams
;; icicle-pp-eval-expression-in-minibuffer: Treat prefix arg (added optional arg).
;; icicle-apply-to-saved-candidate: Use icicle-pp-eval-expression, not pp-eval-expression.
;; 2008/04/02 dadams
;; icicle-apropos-complete-and-narrow: No longer bind icicle-top-level-when-*-flag to t.
;; 2008/03/31 dadams
;; icicle-apropos-complete-1: Allow for no completion type, for No completion msg.
;; 2008/03/29 dadams
;; icicle-pp-eval-expression-in-minibuffer, icicle-narrow-candidates(-with-predicate):
;; Removed binding of icicle-reminder-prompt-flag.
;; 2008/03/25 dadams
;; icicle-(apropos|prefix)-complete-1:
;; When not regexp-matching, use substitute-in-file-name on input, to convert \ to /.
;; 2008/03/23 dadams
;; icicle-scroll-Completions: Respect and update icicle-scroll-Completions-backward-p.
;; 2008/03/19 dadams
;; Added: icicle-insert-newline-in-minibuffer.
;; Renamed i*-pp-eval-expression to *-in-minibuffer. Calls new icicle-pp-eval-expression.
;; 2008/03/12 dadams
;; icicle-completion-help: Add buttons for Commentary (icicles-doc*.el).
;; 2008/03/11 dadams
;; icicle-add/update-saved-completion-set: Clarify error msg for unwritable file.
;; 2008/03/07 dadams
;; Renamed icicle-abort-minibuffer-input to icicle-abort-recursive-edit.
;; 2008/03/02 dadams
;; icicle-describe-file:
;; Use default dir if arg is nil. Error if no readable file. Removed save-excursion.
;; 2008/02/24 dadams
;; icicle-apropos-complete-1: Use icicle-apropos-match-fns-alist lookup for message.
;; icicle-Completions-mouse-3-menu: Added item for icicle-next-apropos-match-function.
;; Added: icicle-next-apropos-match-function.
;; 2008/02/22 dadams
;; icicle-retrieve-candidates-from-set:
;; Like logic for alist in icicle-completing-read:
;; Do icicle-readable-to-markers, then copy car and replace cdr with whole candidate.
;; Removed RAW arg from call to find-file-noselect.
;; Wrap Lisp read in condition-case.
;; Renamed, added un: icicle(-mouse)-save-candidate to icicle(-mouse)-save/unsave-candidate.
;; icicle-add/update-saved-completion-set: Changed default name to just add .icy.
;; icicle-candidate-set-save-1, icicle-retrieve-candidates-from-set:
;; Wrap write/read to/from cache file in condition-case.
;; 2008/02/16 dadams
;; icicle-retrieve-candidates-from-set:
;; Convert alist cands to propertized strings, using i*-put-alist-* and i*-readable-to-*.
;; Set icicle-candidates-alist to reconstituted retrieved candidates.
;; icicle-candidate-set-save-1:
;; Convert to readable alist from propertized text, using i*-markers-to-*, i*-get-alist-*.
;; Added: icicle-readable-to-markers, icicle-markers-to-readable.
;; 2008/02/15 dadams
;; icicle-delete-windows-on:
;; Enable recursive minibuffers for interactive use. Thx to Simon Marshall.
;; 2008/02/14 dadams
;; icicle-add/update-saved-completion-set: Remove properties from completion-set string.
;; icicle-change-sort-order, icicle-retrieve-previous-input,
;; icicle-insert-string-from-variable, icicle(-mouse)-candidate-read-fn-invoke,
;; icicle-narrow-candidates, icicle-save-predicate-to-variable,
;; icicle-candidate-set-retrieve, icicle-candidate-set-save-1,
;; icicle-add/update-saved-completion-set, icicle-isearch-complete:
;; Bind icicle-whole-candidate-as-text-prop-p to nil.
;; 2008/02/07 dadams
;; icicle-delete-windows-on:
;; Delete frame if one-window-p and not a standalone minibuffer. Thx to Simon Marshall.
;; 2008/02/03 dadams
;; icicle-mouse-choose-completion:
;; Use absolute file name for choice and prepend dir in minibuffer. Set base-size to 0.
;; Don't remove *Completions* window.
;; icicle-mouse-candidate-action-1: Use absolute file name for choice.
;; icicle-mouse-choose-completion, icicle-mouse-candidate-action-1,
;; icicle-current-completion-in-Completions: buffer-substring -> *-no-properties.
;; icicle-nb-of-candidate-in-Completions: Update last-nb before the test, in loop.
;; icicle-prefix-complete-1: If input matches empty dir, use that dir as sole completion.
;; Don't remove *Completions* window until after minibuffer msg.
;; icicle-move-to-next-completion: Use icicle-show-Completions-help-flag, not hard-coded 3.
;; icicle-candidate-action-1: For require-match case also, remove cand and display others.
;; Added: icicle-choose-completion.
;; 2008/01/30 dadams
;; Added: icicle-yank-secondary, icicle-mouse-yank-secondary.
;; 2008/01/29 dadams
;; icicle-(apropos|prefix)-complete-1:
;; If icicle-incremental-completion-flag is explicit*, treat like incremental completion.
;; icicle-apropos-complete-1:
;; Distinguish non-existent dir from empty dir: icicle-apropos-any-file-name-candidates-p.
;; icicle-highlight-input-noncompletion takes no args now.
;; 2008/01/13 dadams
;; icicle-mouse-choose-completion, icicle-insert-completion,
;; icicle-mouse-candidate-action-1, icicle-mouse-save-candidate:
;; Do not use icicle-transform-multi-completion.
;; icicle-retrieve-last-input, icicle-(apropos|prefix)-complete-1:
;; Do not treat handle-switch-frame.
;; icicle-mouse-candidate-action-1: Add back \n only if it has property icicle-keep-newline.
;; icicle-mouse-remove-candidate: Removed cruft.
;; icicle-remove-candidate-display-others: save-selected-window around Completions display.
;; icicle-help-on-candidate: Rewrote.
;; Do not use icicle-transform-multi-completion except where appropriate.
;; Always use icicle-candidate-help-fn as first priority, if defined.
;; Give help for prefix keys too during key completion.
;; icicle-help-on-candidate-symbol: No call to icicle-candidate-help-fn here.
;; 2008/01/04 dadams
;; icicle-mouse-choose-completion, icicle-current-completion-in-Completions:
;; Add candidate's final \n only if it has property icicle-keep-newline.
;; 2007/01/01 dadams
;; icicle-narrow-candidates: For Emacs < 22, don't tack dir onto file name if absolute.
;; icicle-candidate-set-save-1: Only redisplay candidates if *Completions* was displayed.
;; 2007/12/31 dadams
;; icicle-mouse-choose-completion, icicle-mouse-candidate-action-1:
;; Add back candidate's final \n that is missing mouse-face.
;; Return icicle-candidate-nb, as doc string says.
;; icicle-mouse-candidate-action-1: Delete current input from minibuffer before acting.
;; Added: icicle-insert-list-join-string.
;; Don't mention that C-o is bound to icicle-candidate-action.
;; 2007/12/26 dadams
;; icicle-transform-multi-completion: Empty input after join string means empty part.
;; icicle-help-on-candidate: Don't call icicle-raise-Completions-frame.
;; 2007/12/11 dadams
;; icicle-change-sort-order:
;; Don't include icicle-proxy-candidate-first-p unless icicle-add-proxy-candidates-flag.
;; 2007/12/10 dadams
;; icicle-exit-minibuffer, icicle-kill-failed-input:
;; Face icicle-input-completion-fail-lax also.
;; 2007/12/09 dadams
;; icicle-exit-minibuffer: Remove icicle-input-completion-fail face from input.
;; icicle-kill-failed-input: Rehighlight after deleting highlighted part.
;; 2007/12/08 dadams
;; icicle-(next|previous)-line: Rewrote for variable number of columns.
;; Added: , icicle-(beginning|end)-of-line+.
;; 2007/12/03 dadams
;; Renamed longest common match (lcm) to expanded common match (ecm).
;; 2007/11/30 dadams
;; icicle-help-on-candidate-symbol:
;; Use fboundp, not functionp, to get describe-function for macros too.
;; 2007/11/28 dadams
;; Renamed describe-bindings-in-map to describe-keymap.
;; icicle-toggle-proxy-candidates: Swap values for saved and unsaved.
;; 2007/11/25 dadams
;; Added: icicle-sort-by-abbrev-frequency.
;; icicle-help-on-candidate-symbol: Treat command abbrevs via apropos for their commands.
;; 2007/11/24 dadams
;; Added: icicle-sort-proxy-candidates-first.
;; 2007/11/22 dadams
;; icicle-help-on-candidate-symbol: Use describe-bindings-in-map for a keymap.
;; 2007/11/17 dadams
;; Added: icicle-toggle-proxy-candidates. Added to icicle-Completions-mouse-3-menu also.
;; 2007/11/04 dadams
;; Require subr-21 if replace-regexp-in-string is not defined.
;; Require icicles-mac (don't wrap in eval-when-compile).
;; icicle-Completions-mouse-3-menu: Added the latest toggle commands.
;; 2007/10/28 dadams
;; Added: icicle-toggle-expand-to-common-match, icicle-toggle-search-replace-common-match.
;; icicle-retrieve-last-input:
;; Treat prefix completion like non-nil expand-input-to-common-match-flag.
;; icicle-search-define-replacement: Bind icicle-update-input-hook to nil.
;; icicle-toggle-highlight-all-current:
;; Save icicle-candidate-nb around rehighlighting.
;; Call icicle-search-action to get back to current candidate and highlight it.
;; 2007/10/27 dadams
;; icicle-search-define-replacement:
;; Bind candidates, input, and cand #, to restore after read replacement string.
;; 2007/10/26 dadams
;; icicle-toggle-highlight-all-current: select-frame-set-input-focus to minibuffer.
;; 2007/10/22 dadams
;; icicle-doremi-*: Use 4 arrows - one command hands off to the other.
;; 2007/10/21 dadams
;; Added: icicle-doremi-inter-candidates-min-spaces, icicle-doremi-candidate-width-factor.
;; 2007/10/14 dadams
;; Updated doc strings to reflect icicle-act-before-cycle-flag.
;; 2007/10/13 dadams
;; icicle-candidate-action-1:
;; Don't set icicle-last-completion-candidate if string. Used for repeated C-next.
;; icicle-remove-candidate-display-others, icicle-history:
;; Treat also the case where cand is a string, not a consp.
;; 2007/10/07 dadams
;; icicle-delete-candidate-object: Respect icicle-deletion-action-flag.
;; 2007/10/02 dadams
;; icicle-(apropos|prefix)-complete-1:
;; Apply abbreviate-file-name to file-name input. Thx to Joonhwan Lee.
;; icicle-toggle-fuzzy-completion: Removed soft require of fuzzy-match+.el.
;; 2007/09/29 dadams
;; Added: icicle-toggle-fuzzy-completion.
;; icicle-Completions-mouse-3-menu: Added icicle-toggle-fuzzy-completion.
;; icicle-prefix-complete-1: Adjust feedback messages for fuzzy completion.
;; icicle-(apropos|prefix)-complete-1:
;; Only set icicle-default-directory if (icicle-file-name-input-p).
;; 2007/09/25 dadams
;; icicle-narrow-candidates: Treat icicle-whole-candidate-as-text-prop-p case.
;; icicle-kill-failed-input: Rewrote.
;; 2007/09/21 dadams
;; icicle-narrow-candidates:
;; Emacs<22, file-name completion: Append directory to each candidate. Thx Ian Perryman.
;; 2007/09/14 dadams
;; icicle-(apropos|prefix)-complete-1, icicle-prefix-word-complete:
;; Wrapped condition-case around candidates computation.
;; 2007/08/25 dadams
;; icicle-mouse-candidate-action-1: Use buffer-substring, not buffer-*-no-properties.
;; 2007/08/21 dadams
;; icicle-(apropos|prefix)-complete-1:
;; Reset icicle-input-fail-pos. Call icicle-highlight-input-noncompletion when no match.
;; 2007/08/19 dadams
;; Added: icicle-kill-failed-input.
;; 2007/08/18 dadams
;; icicle-previous-apropos-candidate-alt-action: Fixed typo. Thx to Hadron Quark.
;; 2007/07/29 dadams
;; icicle-apply-to-saved-candidate:
;; Added use-icicle-candidates-alist-p arg. Use icicle-get-alist-candidate.
;; Report original error message also.
;; icicle-candidate-action-1: Do nothing if icicle-last-completion-candidate not a string.
;; 2007/07/27 dadams
;; icicle-successive-action:
;; icicle-act-first-then-navigate-p -> icicle-act-before-cycle-flag.
;; 2007/07/08 dadams
;; icicle-all-candidates(-alt)-action:
;; Use icicle-all-candidates(-alternative)-action-fn if defined.
;; icicle-all-candidates-action-1: Added listp arg.
;; icicle-mouse-save-candidate:
;; Deactivate mark and redisplay completions, to show save highlight.
;; 2007/07/07 dadams
;; Added: icicle-candidate-set-save(-more)-selected(-1),
;; icicle-mouse-candidate-set-save(-more), icicle-mouse-save-then-kill.
;; icicle-insert-completion: If no current completion, return to minibuffer anyway.
;; Update icicle-current-input with inserted candidate.
;; icicle-Completions-mouse-3-menu:
;; Added icicle-candidate-set-save-(more(-selected)|-selected).
;; icicle-save-candidate: If no defined icicle-candidate-nb, then just display message.
;; icicle-candidate-set-save(-more):
;; Use icicle-candidate-set-save-1: Intern variable in standard obarray also. Redisplay
;; candidates and reselect minibuffer after reading file/var name. Put eof error in
;; minibuf. Deactivate mark and redisplay completions. Separate msg if reset.
;; icicle-candidate-set-retrieve: If nothing to restore, don't restore nothing.
;; If single candidate to restore, no *Completions* display.
;; Else, update candidate display.
;; 2007/07/04 dadams
;; icicle-Completions-mouse-3-menu: Added icicle-retrieve-(next|\previous)-input.
;; 2007/07/03 dadams
;; Added: icicle-insert-history-element, icicle-retrieve-(next|previous)-input.
;; icicle-history, icicle-keep-only-past-inputs:
;; Don't retrieve last input unless following a cycling command.
;; icicle-history:
;; Do an initial icicle-apropos-complete unless icicle-last-completion-command.
;; If not following a cycling command, call icicle-last-completion-command (don't set it
;; to empty string) and reset icicle-last-input to nil.
;; icicle-Completions-mouse-3-menu:
;; icicle-retrieve-(next|previous)-input, not icicle-retrieve-last-input.
;; Redefined next-history-element, instead of using defadvice.
;; 2007/06/23 dadams
;; icicle-search-define-replacement: Use icicle-completing-read-history, not read-string.
;; Use icicle-search-replacement-history.
;; 2007/06/17 dadams
;; Added: icicle-toggle-WYSIWYG-Completions.
;; icicle-switch-to-Completions-buf, icicle-move-to-next-completion:
;; Added priority in call to icicle-place-overlay.
;; 2007/06/13 dadams
;; Added: icicle-candidate-set-save-more.
;; icicle-candidate-set-save: Unify messages.
;; 2007/06/12 dadams
;; Added: icicle(-mouse)-save-candidate.
;; icicle-candidate-set-retrieve: Insert candidate if there is only one retrieved.
;; icicle-insert-completion: Added optional completion arg for non-interactive insertion.
;; 2007/06/10 dadams
;; icicle-candidate-action-1: Treat icicle-require-match-p.
;; 2007/06/09 dadams
;; icicle-candidate-action-1, icicle-mouse-candidate-action-1:
;; Remove candidate if icicle-use-candidates-only-once-flag.
;; icicle-candidate-action-1:
;; Let users act on non-candidate too (arbitrary input).
;; 2007/06/07 dadams
;; Renamed: icicle-function-history to icicle-function-name-history,
;; icicle-variable-history to icicle-variable-name-history.
;; Use standard history variable if bound, else use Icicles history variable:
;; function-name-history, variable-name-history
;; 2007/06/01 dadams
;; icicle-erase-minibuffer-or-history-element, icicle-history:
;; Ensure value of minibuffer-history-variable is bound.
;; icicle-keep-only-past-inputs: If value of minibuffer-history-variable unbound, set nil.
;; icicle-keep-only-past-inputs, icicle-history:
;; Assume value of minibuffer-history-variable is a symbol - don't test that.
;; 2007/05/29 dadams
;; icicle-insert-thing: Added optional arg no-replace-p. Make sure end points are defined.
;; icicle-insert-string-from-variable: Call icicle-insert-thing with no-replace-p arg.
;; icicle-minibuffer-complete-and-exit: Set window-point to end of minibuffer.
;; 2007/05/15 dadams
;; icicle-completion-help and top level:
;; Soft require help-mode, not (featurep 'help-mode) and (fboundp 'define-button-type).
;; 2007/05/08 dadams
;; Added: icicle-save-predicate-to-variable.
;; icicle-Completions-mouse-3-menu: Added icicle-save-predicate-to-variable to menu.
;; icicle-narrow-candidates-with-predicate: Quoted the predicate that is read.
;; 2007/05/07 dadams
;; Added: icicle-narrow-candidates-with-predicate.
;; icicle-Completions-mouse-3-menu: Added icicle-narrow-candidates-with-predicate (M-&).
;; 2007/05/06 dadams
;; icicle-completion-help: Updated text at top of help buffer.
;; icicle-customize-button: Capitalized group Icicles.
;; Changed S-C- to C-S- and M-C- to C-M- in doc.
;; 2007/05/04 dadams
;; icicle-candidate-read-fn-invoke, icicle-keep-only-*-inputs, icicle-retrieve-last-input,
;; icicle-candidate-set-(retrieve|save|swap|difference|union|intersection|complement),
;; icicle-all-candidates(-alt)-action, icicle-pp-eval-expression,
;; icicle-insert-string-from-variable:
;; Can call from *Completions* too, so can choose from mouse-3 menu during multi-command.
;; icicle-candidate-set-save, icicle-retrieve-last-input, icicle-insert-*-from-variable:
;; Select minibuffer window.
;; icicle-toggle-case-sensitivity: Use setq-default for case-fold-search.
;; icicle-switch-to-Completions-buf:
;; Use read-file-name-completion-ignore-case, if completing file name.
;; Added empty defvars for Emacs 22 standard vars, to quiet byte compiler.
;; 2007/05/02 dadams
;; Added: icicle-dispatch-M-q, icicle-toggle-search-whole-word.
;; Removed: icicle-dispatch-C-backquote.
;; 2007/04/29 dadams
;; Added: icicle-sort-by-last-file-modification-time (sort order).
;; 2007/04/19 dadams
;; icicle-successive-action: No longer interactive. Moved barfing to calling commands.
;; 2007/04/17 dadams
;; Added: icicle-dispatch-M-comma, icicle-search-define-replacement,
;; icicle-dispatch-C-backquote, icicle-toggle-literal-replacement.
;; 2007/04/08 dadams
;; Added: icicle-all-candidates-alt-action, icicle-all-candidates-action-1.
;; icicle-candidate-action-1, icicle-delete-candidate-object, icicle-help-on-candidate,
;; icicle-candidate-read-fn-invoke:
;; Use negative test for prefix mode, not positive test for apropos.
;; 2007/04/07 dadams
;; Added: icicle-successive-action, icicle-toggle-search-replace-whole,
;; icicle-dispatch-C-comma.
;; Defined navigating action and help functions using icicle-successive-action.
;; 2007/03/31 dadams
;; icicle-(apropos|prefix)-complete-1:
;; Accept sole completion if icicle-top-level-when-sole-completion-flag.
;; icicle-narrow-candidates:
;; Use read-file-name only for Emacs 22 or later.
;; Accept sole completion only if icicle-top-level-when-sole-completion-flag.
;; icicle-apropos-complete-and-narrow: Bind icicle-top-level-when-*-flag to t.
;; 2007/03/30 dadams
;; icicle-narrow-candidates: Suppress sole-completion minibuffer-message.
;; 2007/03/23 dadams
;; Added: icicle-apropos-complete-and-narrow. Thx to Marian Schubert for the suggestion.
;; icicle-narrow-candidates: Use icicle-require-match-p as REQUIRE-MATCH arg.
;; 2007/03/09 dadams
;; Changed require to eval-when-compile require for icicles-mac.el.
;; 2007/03/08 dadams
;; icicle-delete-current-candidate-object: Rewrote.
;; Value of var can be an arbitrary alist, a list of strings, or a list of symbols.
;; icicle-remove-candidate-display-others: Rewrote.
;; Set icicle-last-completion-candidate based on icicle-candidate-nb or 0.
;; Delete icicle-last-completion-candidate completely from icicle-completion-candidates.
;; Update minibuffer-completion-predicate or read-file-name-predicate to remove for
;; completion.
;; Use with-current-buffer, not save-window-excursion, to visit *Completions*.
;; icicle-remove-candidate:
;; Updated doc string to mention Emacs < 22 limitation for file-name candidates.
;; icicle-retrieve-last-input: Don't reset icicle-last-completion-command if interactive.
;; 2007/03/07 dadams
;; icicle-switch-to-Completions-buf, icicle-remove-candidate-display-others,
;; icicle-help-on-candidate, icicle-delete-windows-on:
;; Use 0, not t, as frame arg to get-buffer-window.
;; 2007/03/06 dadams
;; icicle-remove-candidate: Don't reset to first cand matching input if no last cand.
;; icicle-change(alternative)-sort-order, icicle-reverse-sort-order,
;; icicle-keep-only-past-inputs, icicle-toggle-sorting: Respect icicle-inhibit-sort-p.
;; Renamed icicle-get-current-candidate to icicle-get-alist-candidate.
;; 2007/03/04 dadams
;; icicle-remove-candidate-display-others:
;; Use local var for cand-nb, because icicle-candidate-nb can change.
;; If no last candidate, reset to first candidate matching input.
;; Allow for icicle-candidate-nb not being defined here:
;; Use icicle-get-current-candidate. Move to next completion only if cand-nb defined.
;; Use mapconcat only when delete multi-completion.
;; Move to next completion in *Completions* only if icicle-candidate-nb was defined.
;; Insert default-directory too, if icicle-file-name-input-p.
;; icicle-insert-completion: Insert default-directory too, if icicle-file-name-input-p.
;; icicle-(apropos|prefix)-complete-1, icicle-keep-only-past-inputs:
;; Don't include directory when set icicle-last-completion-candidate.
;; icicle-(apropos|prefix)-complete-1:
;; Don't include directory when testing input membership in icicle-completion-candidates.
;; 2007/03/02 dadams
;; icicle-delete-candidate-object:
;; Corrected message target (object). Added sit-for.
;; Use local var for cand-nb, because icicle-candidate-nb can change.
;; 2007/02/27 dadams
;; icicle-delete-candidate-object: Added message.
;; icicle-delete-current-candidate-object: Don't erase minibuffer or update completions.
;; 2007/02/24 dadams
;; Added: icicle(-mouse)-candidate-alt-action, icicle(-mouse)-candidate-action-1,
;; icicle-(previous|next)-(apropos|prefix)-candidate-alt-action,
;; icicle(-mouse)-remove-candidate, icicle-remove-candidate-display-others,
;; icicle-delete-candidate-object, icicle-delete-current-candidate-object.
;; icicle-insert-completion:
;; Invoke icicle-transform-multi-completion. Use with-current-buffer (window-buffer).
;; icicle(-mouse)-candidate-action: Use icicle(-mouse)-candidate-action-1.
;; 2007/02/06 dadams
;; icicle-completion-help: Added extra help if completing and if multi-command.
;; 2007/02/03 dadams
;; Renamed icicle-icompleting-p to icicle-edit-update-p.
;; 2007/02/02 dadams
;; Updated doc strings of toggle commands to mention the minibuffer bindings.
;; 2007/01/29 dadams
;; icicle-change-sort-order: Don't sort icicle-sort-functions-alist entries for use.
;; Define alphabetical sort order using icicle-case-string-less-p, not string-lessp.
;; 2007/01/23 dadams
;; Added: icicle-toggle-highlight-historical-candidates.
;; icicle-Completions-mouse-3-menu: Updated wrt toggles.
;; 2007/01/21 dadams
;; icicle-narrow-candidates:
;; Use minibuffer-history-variable, not regexp-history. Thx to Jost for bug report.
;; 2007/01/20 dadams
;; icicle-mouse-(choose-completion|candidate-action): Use icicle-transform-multi-completion.
;; 2007/01/15 dadams
;; Added: icicle-change(-alternative)-sort-order, icicle-reverse-sort-order,
;; icicle-current-sort-order, icicle-sort-*.
;; icicle-transform-sole-candidate: Set icicle-last-*-candidate to transformed cand.
;; icicle-help-on-candidate: Use icicle-transform-multi-completion.
;; icicle-Completions-mouse-3-menu: Updated with new sort-order bindings.
;; icicle-toggle-alternative-sorting: Better message.
;; Require icicles-mac.el.
;; 2007/01/14 dadams
;; Added: icicle-transform-multi-completion, icicle-transform-sole-candidate.
;; icicle-(apropos|prefix)-complete-1: Use icicle-transform-sole-candidate. Thx Rubikitch.
;; icicle-help-on-candidate(-symbol):
;; Use with-current-buffer to describe mode in Emacs 20 also.
;; 2007/01/13 dadams
;; Added: icicle-describe-file, icicle-help-on-candidate-symbol.
;; icicle-help-on-candidate:
;; If existing symbol, describe it. Else if buffer or file, describe it. Else, convert
;; string to symbol and describe it. Use icicle-help-on-candidate-symbol.
;; 2007/01/10 dadams
;; icicle-switch-to/from-minibuffer: Error message if minibuffer is not active.
;; 2007/01/06 dadams
;; icicle-(apropos|prefix)-complete-1:
;; expand-file-name -> icicle-abbreviate-or-expand-file-name.
;; Added: icicle-toggle-~-for-home-dir.
;; icicle-prefix-complete-1:
;; Set icicle-default-directory only if also icicle-file-name-input-p.
;; 2007/01/01 dadams
;; icicle-add/update-saved-completion-set: Use icicle-assoc-delete-all, not delete of assoc.
;; Runtime, not compile-time, require of icicles-var.el, icicles-opt.el.
;; 2006/12/29 dadams
;; icicle-insert-string-at-point:
;; Treat nil return of alternative text-grabbing function.
;; Echo the text-grabbing function when icicle-default-thing-insertion = alternatives.
;; icicle-ensure-overriding-map-is-bound: Separate treatment for diff Emacs versions.
;; 2006/12/25 dadams
;; icicle-keep-only-past-inputs:
;; Added optional recent-first arg: Use icicle-most-recent-first-p as sort function.
;; Update cands list if repeat. Do not scroll Completions; update it unconditionally.
;; Added: icicle-candidate-set-truncate.
;; Uncommented describe-mode code, since RMS fixed Emacs bug that caused infinite recursion.
;; 2006/12/24 dadams
;; Added: icicle-Completions-mouse-3-menu.
;; 2006/12/23 dadams
;; icicle-narrow-candidates: Bug fix: Treat file-name completion with read-file-name.
;; icicle-help-on-candidate: Call non-nil icicle-candidate-help-fn on candidate.
;; 2006/12/18 dadams
;; icicle-apply-to-saved-candidate: Remove print arg and use current-prefix-arg instead.
;; icicle-ensure-overriding-map-is-bound: Protect overriding-map-is-bound with boundp.
;; Bug fix for Emacs 21: protect help-xref with get type button-category-symbol.
;; 2006/12/17 dadams
;; Added: icicle(-mouse)-candidate-read-fn-invoke, icicle-apply-to-saved-candidate.
;; 2006/12/10 dadams
;; Created from minibuffer and *Completions* commands in icicles-cmd.el.
;;;(@* "CHANGE LOG FOR `icicles-mode.el'")
;;
;; 2017/11/25 dadams
;; icicle-last-non-minibuffer-buffer: Exclude killed buffers.
;; 2017/06/25 dadams
;; icicle-options-toggle-menu-map: Added icicle-toggle-completion-mode-keys.
;; 2017/04/09 dadams
;; icicle-define-icicle-maps: Updated for new Dired+ names:
;; diredp-menu-bar-multiple-menu, diredp-menu-bar-dir-menu.
;; 2016/03/27 dadams
;; icicle-(bind|restore)-completion-keys: Bind M-i to icicle-toggle-map and restore to nil.
;; 2016/02/28 dadams
;; icicle-show-help-in-mode-line: Use new option icicle-complete-keys-separator.
;; 2015/08/20 dadams
;; Applied renaming of icicle-region-face-remapping to icicle-face-remapping-region.
;; 2015/08/19 dadams
;; icicle-minibuffer-setup, icicle-restore-region-face:
;; Use face remapping (face-remap-(add|remove)-relative) instead of set-face-* for Emacs 23+.
;; Thx to Jonathan H (PythonNut).
;; 2015/07/05 dadams
;; icicle-top-level-prep: Reset icicle-completion-style-set (new) also.
;; 2014/11/28 dadams
;; icicle-define-icicle-maps:
;; Added entry for icicle-goto-any-marker.
;; Check global-mark-ring for :enable - do not call icicle-markers.
;; icicle-show-help-in-mode-line: No-op if last command exited minibuffer.
;; 2014/11/15 dadams
;; Moved here from icicles-fn.el: icicle-help-line-buffer, icicle-help-line-file,
;; icicle-show-help-in-mode-line, icicle-show-in-mode-line.
;; 2014/08/23 dadams
;; describe-face (advice): face-at-point arity is different for Emacs 24 < 24.4.
;; 2014/08/10 dadams
;; describe-face (advice): Bind icicle-face-completing-p.
;; icicle-minibuffer-setup: Do not exclude completing during progressive completion - e.g. for M-&.
;; 2014/07/27 dadams
;; Added icicle-ORIG-complete (original def of command complete from completion.el).
;; 2014/06/07 dadams
;; Added: icicle-last-non-minibuffer-buffer.
;; icicle-minibuffer-setup: Use icicle-last-non-minibuffer-buffer for icicle-pre-minibuffer-buffer.
;; 2014/04/23 dadams
;; Use cl-flet if available.
;; 2014/04/21 dadams
;; describe-face (defadvice): First arg depends on Emacs version.
;; 2014/04/20 dadams
;; icicle-minibuffer-setup:
;; Do not set icicle-last-icomplete-mode-value here. Done in icicle-insert-candidates now.
;; Reset icicle-auto-no-icomplete-mode-p to nil here.
;; icicle-options-choose-menu-map: Added icicle-cycle-expand-to-common-match entry.
;; 2014/04/13 dadams
;; icicle-minibuffer-setup: Initialize/reset icicle-auto-no-sort-p to nil.
;; 2014/04/06 dadams
;; Require icicles-mac.el, for icicle-menu-bar-make-toggle.
;; 2014/04/05 dadams
;; Removed: icicle-search-tags-menu-map.
;; Renamed: icicle-search-goto-menu-map to icicle-goto-menu-map,
;; icicle-search-goto-imenu-menu-map to icicle-goto-imenu-menu-map.
;; icicle-search-menu-map: Renamed submenu from Search to Icicles Search. Reordered.
;; icicle-tags-search: Renamed Tagged to Emacs Tagged.
;; icicle-goto-imenu-menu-map: Renamed submenu from Definition to Definition (Imenu).
;; icicle-goto-menu-map: Moved Emacs TAGS stuff here (from deleted icicle-search-tags-menu-map).
;; icicle-options-toggle-menu-map:
;; Use icicle-menu-bar-make-toggle (new) for
;; icicle-toggle-(~-for-home-dir|search-replace-common-match|search-replace-whole
;; |search-whole-word|WYSIWYG-Completions),
;; Corrected :help and :keys for icicle-toggle-completions-format (typo).
;; Moved Frames menu after Customize menu.
;; icicle-custom-menu-map, icicle-apropos-menu-map: Added `+ ' prefix for multi-command menu items.
;; 2014/04/04 dadams
;; Added: icicle-options-choose-menu-map, icicle-options-toggle-menu-map.
;; icicle-options-menu-map: Added submenus Choose and Toggle. Renamed items, removing Toggle etc.
;; Changed :visible to :enable for Do Re Mi, swank, etc.
;; icicle-define-icicle-maps:
;; Put Icicles bookmark jump commands on Icicles menu, wherever it might be. Use `+ ' prefix.
;; Added commands icicle-find-file-tagged-other-window and icicle-bookmark-tagged-other-window.
;; 2014/04/02 dadams
;; icicle-define-icicle-maps:
;; Without touche-pas and without Bookmark+: do not define icicle-bookmark-with-tags-menu-map.
;; With touchs-pas and without Bookmark+: use icicle-search-goto-menu-map.
;; With touche-pas and with Bookmark+: just copy Bookmark+ keymaps.
;; Unless Bookmark+, add icicle-bookmark-other-window to Icicles submap.
;; Removed all of the replacement menu items for Bookmark+ case - ineffective, since copy-keymap.
;; (Typos) icicle-search-menu-map -> icicle-search-goto-menu-map; [search] -> [goto].
;; 2014/03/08 dadams
;; icicle-top-level-prep:
;; Test minibuffer-depth, not recursion-depth. Do not set icicle-last-top-level-command for
;; commands: (icicle)-minibuffer-complete-and-exit, (icicle-)exit-minibuffer.
;; icicle-define-icicle-maps: Added icicle-toggle-icomplete-mode.
;; icicle-minibuffer-setup: Reinitialize icicle-last-icomplete-mode-value.
;; Added defadvice for interactive icomplete-mode, to reset icicle-last-icomplete-mode-value.
;; 2014/02/24 dadams
;; icicle-define-icicle-maps, icicle-define-minibuffer-maps, icicle-bind-completion-keys:
;; Added menu item Show Available Keys (icicle-complete-keys).
;; 2014/01/23 dadams
;; For BBDB: Determine older version not just by presence of old name but also by absence of new.
;; 2014/01/05 dadams
;; Put icicle-recomplete-from-original-domain on icicle-menu-map and on Minibuf menu.
;; icicle-(bind|restore)-other-keymap-keys:
;; Bind icicle-next-font-lock-keywords-repeat, icicle-font-lock-keyword in facemenu-keymap.
;; 2013/11/19 dadams
;; icicle-(redefine|restore)-std-completion-fns:
;; Remove use of icicle-read-file-name-default and icicle-ORIG-read-file-name-default.
;; 2013/11/17 dadams
;; icicle-define-icicle-maps:
;; Add icicle-(search|occur)-dired-marked to menus.
;; Bind icicle-visit-marked-file-of-content-other-window to C-M-F, not C-S-o.
;; Bind icicle-occur-dired-marked to C-S-o and icicle-search-dired-marked to C-S-s.
;; Bind icicle-search-dired-marked-recursive to M-+ C-S-s.
;; Bind icicle-occur-dired-marked-recursive to M-+ C-S-o and to M-s M-s M.
;; Bind icicle-visit-marked-file-of-content-recursive-other-window to M-+ C-M-S-f, not C-S-o.
;; 2013/11/03 dadams
;; Added icicle-visit-marked-file-of-content-recursive(-other-window) to
;; icicle-dired-recursive-marked-menu-map.
;; Bound icicle-visit-marked-file-of-content-recursive(-other-window) to M-+ C-F, M-+ C-O.
;; 2013/06/18 dadams
;; icicle-define-icicle-maps: Moved icicle-toggle-WYSIWYG-Completions. Added :keys.
;; 2013/04/24 dadams
;; Fixed define-key-after sexps for older Emacs versions that do not allow multi-event KEY.
;; 2013/04/23 dadams
;; Added: icicle-minibuf-(act-on-all|candidate-set|edit|history|save-retrieve)-menu-map,
;; Minibuf menu: Factored with submenus:
;; Act on All Candidates, Candidate Set, Edit, History, Save/Retrieve Candidates.
;; icicle-define-icicle-maps: Put buffer stuff on Buffers > Icicles, not File > Icicles > Buffers.
;; 2013/04/08 dadams
;; icicle-(redefine|restore)-std-completion-fns:
;; icicle-mouse-choose-completion is only for Emacs < 23.2.
;; 2013/04/05 dadams
;; icicle-mode: Call ad-activate for all enabled advice.
;; 2013/04/04 dadams
;; Added: defadvice for ess-completing-read.
;; icicle-mode: Turn that defadvice on/off.
;; 2013/04/03 dadams
;; Added: defadvice for ess-* completion functions.
;; icicle-mode: Turn that defadvice on/off.
;; 2013/04/02 dadams
;; icicle-define-minibuffer-maps: Bind C-M-T to icicle-top-level in completion-list-mode-map.
;; 2013/02/28 dadams
;; icicle-(redefine|restore)-(standard-functions|std-completion-fns),
;; eval-after-load (comint|ess-site|gud|info|bbdb-com|dired-aux|dired-x|recentf|icicles-mode):
;; Use fset, not defalias. Thx to Michael Heerdegen.
;; 2013/02/16 dadams
;; icicle-mode: Removed list of commands from doc string - just refer to file headers.
;; 2013/02/09 dadams
;; Moved autoload cookies for icicle-mode, icy-mode to icicles.el (with full doc string).
;; 2013/02/04 dadams
;; Removed all autoload cookies, except for icicle-mode, icy-mode.
;; 2013/02/03 dadams
;; Renamed: *-(bind|restore)-custom-completion-keys to *-(bind|restore)-custom-minibuffer-keys.
;; icicle-(un)bind-isearch-keys: (Un)Bind keys of new option icicle-isearch-history-insert-keys.
;; icicle-define-minibuffer-maps:
;; Use icicle-(bind|restore)-custom-minibuffer-keys instead of individual define-keys.
;; icicle-(bind|restore)-custom-minibuffer-keys:
;; Added parameter OPTION, instead of just hard-coding icicle-completion-key-bindings.
;; 2013/01/26 dadams
;; icicle-define-minibuffer-maps:
;; Bind icicle-multi-inputs-act (M-R), icicle-multi-inputs-save (M-S).
;; Add to menus: icicle-multi-inputs-act, icicle-multi-inputs-save, icicle-roundup.
;; icicle-bind-completion-keys:
;; Add to menus: icicle-multi-inputs-act, icicle-multi-inputs-save, icicle-roundup.
;; 2013/01/04 dadams
;; icicle-define-minibuffer-maps: Undefine/restore M-s, M-r for minibuffer-local(-ns|-isearch)-map.
;; 2012/12/31 dadams
;; Added: icicle-show-current-help-in-mode-line.
;; icicle-mode: Add/remove icicle-show-current-help-in-mode-line to/from icicle-post-command-hook.
;; icicle-minibuffer-setup: Initialize icicle-mode-line-help to nil.
;; 2012/12/02 dadams
;; icicle-(redefine|restore)-std-completion-fns: Added icicle(-ORIG)-read-file-name-default.
;; 2012/12/01 dadams
;; Added: icicle-bind-custom-completion-keys, icicle-restore-custom-completion-keys (factored out).
;; Removed load of icicles-mac.el (icicle-kbd is now a function in icicles-opt.el).
;; icicle-(bind|restore)-completion-keys: Use icicle-(bind|restore)-custom-completion-keys.
;; Escape semicolon (;) in icicle-kbd string args (just for Emacs 20 M-; in Lisp code).
;; 2012/11/27 dadams
;; icicle-define-icicle-maps: Added icicle-apropos-value to icicle-apropos-menu-map.
;; 2012/11/20 dadams
;; icicle-bind-completion-keys: Fixed typos for M-; and C-M-; introduced by M-; or C-M-q, Emacs 20.
;; 2012/10/27 dadams
;; Handle new BBDB version also.
;; icicle-define-icicle-maps: Added icicle-toggle-annotation.
;; icicle-(bind|restore)-completion-keys: Bind icicle-toggle-annotation to C-x C-a.
;; icicle-mode: Added icicle-toggle-annotation to doc string.
;; 2012/10/05 dadams
;; icicle-minibuffer-setup: Removed binding of icicle-default-directory (unused).
;; 2012/10/01 dadams
;; icicle-define-icicle-maps: Protect dired-get-marked-files with condition-case.
;; 2012/09/15 dadams
;; icicle-define-icicle-maps, icicle-(bind|restore)-other-keymap-keys:
;; Added icicle-visit-marked-file-of-content(-other-window).
;; 2012/09/08 dadams
;; icicle-define-icicle-maps: *-buffer-ignore-space-prefix-flag, not *-ignore-space-prefix-flag.
;; icicle-(redefine|restore)-std-completion-fns: Added icicle(-ORIG)-read-buffer.
;; 2012/08/06 dadams
;; Renamed old-* to icicle-ORIG-*:
;; icicle-ORIG-bbdb-complete-name, icicle-ORIG-comint-dynamic-complete,
;; icicle-ORIG-comint-dynamic-complete-filename,
;; icicle-ORIG-comint-replace-by-expanded-filename,
;; icicle-ORIG-dired-read-shell-command, icicle-ORIG-ess-complete-object-name,
;; icicle-ORIG-gud-gdb-complete-command, icicle-ORIG-read-file-name,
;; icicle-ORIG-read-shell-command, icicle-ORIG-crm-local-completion-map,
;; icicle-ORIG-crm-local-must-match-map.
;; icicle-(redefine|restore)-standard-(functions|widgets|completion-fns):
;; Use new prefix, icicle-ORIG-, not old-.
;; icicle-(redefine|restore)-std-completion-fns:
;; Applied renaming to new: icicle-orig-read-file-name-fn.
;; Top level aliasing to save originals: Use new prefix, icicle-ORIG-, not old-.
;; 2012/08/03 dadams
;; icicle-(un)bind-key-completion-keys-(for-map-var|in-keymaps-from): Added optional arg KEYS.
;; icicle-(bind|restore)-other-keymap-keys:
;; (Un-)bind icicle-key-complete-keys-for-minibuffer in minibuffer-local-map, for key completion.
;; 2012/07/31 dadams
;; Added: icicle-(redefine|restore)-standard-widgets.
;; icicle-mode: Added call to icicle-(redefine|restore)-standard-widgets.
;; 2012/07/13 dadams
;; icicle-(bind|restore)-completion-keys: Bind icicle-toggle-network-drives-as-remote to C-x :.
;; 2012/07/10 dadams
;; icicle-define-minibuffer-maps, icicle-(bind|restore)-completion-keys:
;; Bind C-M-pause in all minibuffer maps, not just completion maps.
;; 2012/07/08 dadams
;; Defalias old-comint-completion-at-point for Emacs 24+. Thx to Christopher Schmidt, M. Heerdegen.
;; 2012/06/08 dadams
;; icicle-define-minibuffer-maps: fboundp of icicle-yank-secondary, not yank-secondary.
;; 2012/05/25 dadams
;; Added icicle-dired-insert-as-subdir to menu icicle-dired-dir-menu-map.
;; 2012/05/15 dadams
;; Added to and reorg'd Search, Go To menus. Added submenus Bookmarks & Definitions.
;; Added to menus: icicle-search-define-replacement, icicle-search-w-isearch-string,
;; icicle-search-(overlay|char), icicle-imenu-*, icicle-search-THINGs, icicle-search-*-marked,
;; icicle-search-*-bookmark.
;; icicle-dired-multiple-menu-map: Added icicle-dired-save-marked-to-variable.
;; 2012/05/13 dadams
;; Added: icicle-dired-recursive-marked-menu-map. Put *-recursive commands on it.
;; Bind *recursive commands to same keys as non-recursive, but on M-+ prefix key.
;; 2012/05/10 dadams
;; Corrected guard condition for diredp-menu-bar-recursive-marked-menu.
;; 2012/05/07 dadams
;; Applied renaming of icicle-search-dired-marked to icicle-search-dired-marked-recursive.
;; 2012/05/06 dadams
;; Put icicle-search-dired-marked also on diredp-menu-bar-recursive-marked-menu, if available.
;; 2012/04/23 dadams
;; Enable icicle-search-dired-marked in icicle-dired-multiple-menu-map only if Dired+ is loaded.
;; Bind icicle-search-dired-marked in dired-mode-map only if Dired+ is loaded.
;; Removed :enable conditions for icicle-bookmark+-menu-map - it is always in bookmark-bmenu-mode.
;; 2012/04/21 dadams
;; (put 'icicle-mode 'custom-mode-group 'Icicles), so `C-u customize-mode icicle-mode' works.
;; icicle-mode: Change :group to Icicles from Icicles-Miscellaneous.
;; Updated list of top-level commands in doc string, and moved it to the end.
;; 2012/04/09 dadams
;; Fixed typo: double single-quotes in autoload cookie.
;; 2012/04/08 dadams
;; Make autoload cookies for commands load icicles[.el] explicitly.
;; Removed autoload cookie from icicle-bind-isearch-keys (non-interactive).
;; 2012/04/06 dadams
;; Replaced C-? with M-? as the binding for icicle-minibuffer-help (works for terminals also).
;; 2012/04/04 dadams
;; Added to menus: *-w-*-satisfying, icicle-apropos-options-of-type. Changed item names a bit.
;; 2012/04/02 dadams
;; icicle-mode: Propertize ON / OFF.
;; 2012/03/01 dadams
;; icicle-unbind-key-completion-keys-in-keymaps-from: Corrected last fix: follow symbol first.
;; 2012/02/29 dadams
;; icicle-unbind-key-completion-keys-in-keymaps-from: Skip autoload keymaps.
;; 2012/02/28 dadams
;; icicle-unbind-key-completion-keys-in-keymaps-from: Handle symbol keymaps: follow until a list.
;; 2012/02/26 dadams
;; Update to reflect Bookmark+ changes (bindings etc.).
;; icicle-bookmark-menu-map: Major changes.
;; Added items:
;; *-bookmark-(file-this-dir|autofile)-(all|some)-tags(-regexp),
;; *-bookmark-(temporary|autofile), *-bookmark(-autonamed)(-this-buffer),
;; *-bookmark-specific-(files|buffers), *-bookmark-(image|bookmark-file).
;; For icicle-touche-pas-aux-menus-flag case also: put bookmarks items on a submenu now.
;; Share the submenus - write only once.
;; Reuse (copy of) bmkp-* menu items, so Icicles cmds replace similar Bookmark+ cmds, in place.
;; icicle-define-icicle-maps: Reordered.
;; 2012/02/11 dadams
;; Bind icicle-toggle-expand-to-common-match to C-", not C-;.
;; Bind icicle-cycle-expand-to-common-match (new) to C-M-".
;; Doc strings: Applied renamings and key changes.
;; 2012/01/31 dadams
;; icicle-define-icicle-maps: Added: icicle-cycle-image-file-thumbnail.
;; Corrected typo for icicle-toggle-completions-format.
;; 2012/01/24 dadams
;; icicle-mode doc string: Added icicle-toggle-completions-format.
;; icicle-define-icicle-maps: Add icicle-toggle-completions-format to menus.
;; icicle-(bind|restore)-completion-keys: Bind icicle-toggle-completions-format to C-M-^.
;; 2012/01/20 dadams
;; Bind icicle-apropos-complete-and-exit in all completion maps, not just must-match map.
;; Apply renaming of icicle-toggle-incremental-completion to *-cycle-*.
;; 2011/10/21 dadams
;; icicle-(bind|restore)-completion-keys: Typo: M-g -> M-q, for icicle-dispatch-M-q.
;; 2011/10/08 dadams
;; eval-when-compile icicles-mac.el.
;; icicle-define-minibuffer-maps: Use new option icicle-candidate-help-keys.
;; icicle-(bind|restore)-completion-keys: Use new options icicle-candidate-(action|help)-keys.
;; icicle-bind-other-keymap-keys, icicle-(un)bind-isearch-keys, icicle-restore-other-keymap-keys,
;; icicle-define-minibuffer-maps, icicle-(bind|restore)-completion-keys:
;; Use icicle-kbd (and do not use kbd).
;; icicle-define-icicle-maps: Do not include icicle-toggle-angle-brackets for Emacs 20.
;; 2011/10/04 dadams
;; icicle-define-icicle-maps: Put all search commands on icicle-search-key-prefix.
;; icicle-(bind|restore)-other-keymap-keys: Mode-specific search cmds are on M-s M-s m, not M-s i.
;; 2011/09/08 dadams
;; icicle-bind-isearch-keys: Replace lambda with icicle-search-w-isearch-string.
;; 2011/09/06 dadams
;; icicle-define-minibuffer-maps, icicle-(bind|restore)-completion-keys:
;; Bind icicle-resolve-file-name to C-x C-f.
;; 2011/09/05 dadams
;; icicle-mode: Update doc string: icicle-toggle-hiding-non-matching-lines.
;; icicle-define-icicle-maps: Added icicle-toggle-hiding-non-matching-lines to menus.
;; icicle-bind-completion-keys: Bind C-x . to icicle-dispatch-C-x. (new).
;; 2011/09/02 dadams
;; icicle-(bind|restore)-other-keymap-keys:
;; Test fn memq in icicle-functions-to-redefine, not just non-nil icicle-functions-to-redefine.
;; Removed remap/unmap of Info commands.
;; Restore completion-at-point, not comint-dynamic-complete, for Emacs 24.
;; At end: defalias old-Info commands (instead of remapping in icicle-(bind|restore)-*-keys).
;; 2011/08/13 dadams
;; Bound icicle-toggle-search-complementing-domain to C-M-~ and added to menus.
;; 2011/08/12 dadams
;; icicle-define-minibuffer-maps: Removed code that binds C-x m, C-backspace, C-c +.
;; Do that in icicle-bind-file-candidate-keys now.
;; 2011/08/07 dadams
;; icicle-mode: Updated doc string for bookmark commands.
;; 2011/05/22 dadams
;; Added defvars for free vars to quiet byte compiler.
;; 2011/05/07 dadams
;; Changed key for icicle-regexp-quote-input from C-M-; to M-% everywhere.
;; Bound icicle-toggle-ignoring-comments to C-M-;.
;; icicle-mode doc string, icicle(-options)-menu-map: Added icicle-toggle-ignoring-comments.
;; 2011/05/03 dadams
;; icicle-define-icicle-maps: Add icicle-toggle-highlight-saved-candidates to menus.
;; icicle-(bind|restore)-completion-keys: Bind icicle-plus-saved-sort to C-M-+.
;; Bind icicle-toggle-highlight-saved-candidates to S-pause.
;; icicle-mode doc string: Mention icicle-toggle-highlight-saved-candidates.
;; 2011/04/12 dadams
;; icicle-define-icicle-maps: Added Icicles submenu for Bookmark+ menu.
;; icicle-(bind|restore)-other-keymap-keys:
;; Bound icicle-bookmark-save-marked-files(-as-project|-more) in bookmark-bmenu-mode-map.
;; 2011/03/29 dadams
;; icicle-define-minibuffer-maps, icicle-bind-completion-keys:
;; Bound C-M-(v|V) to icicle-scroll-(forward|backward).
;; Applied renaming: icicle-scroll-Completions(-up) to icicle-scroll-Completions-(back|for)ward.
;; 2011/03/26 dadams
;; icicle-define-icicle-maps: Added tags commands.
;; 2011/03/06 dadams
;; icicle-define-icicle-maps:
;; Added to Options (sub)menu: icicle-toggle-search-whole-word.
;; Removed from Options: icicle-toggle-highlight-all-current, icicle-regexp-quote-input.
;; Removed redundant :visible icicle-mode's for icicle-menu-map.
;; Added :help entries.
;; Corrected: icicle-bookmark-bookmark-list, icicle-bookmark-desktop: not other-window.
;; icicle-define-minibuffer-maps, icicle-(bind|restore)-completion-keys:
;; Added: icicle-toggle-highlight-all-current, icicle-regexp-quote-input,
;; icicle-erase-minibuffer-or-history-element (2), icicle-insert-list-join-string,
;; icicle-insert-key-description, icicle-insert-string-from-variable (2),
;; icicle-insert-string-at-point.
;; 2011/02/22 dadams
;; icicle-(bind|restore)-completion-keys: Bind C-x t to icicle-cycle-image-file-thumbnail.
;; icicle-mode: Do not add icicle-fit-completions-window to temp-buffer-show-hook.
;; Do it explicitly in icicle-display-candidates-in-Completions now.
;; Renamed: icicle-*-standard-commands to icicle-(redefine|restore)-standard-functions.
;; And rewrote them to just use new option icicle-functions-to-redefine.
;; Replaced: icicle-redefine-standard-commands-flag with icicle-functions-to-redefine everywhere.
;; Added: old-comint-dynamic-complete-filename.
;; 2011/02/17 dadams
;; icicle-(redefine|restore)-standard-commands: Use icicle-read-color for read-color.
;; 2011/01/20 dadams
;; icicle-define-minibuffer-maps, icicle-(bind|restore)-completion-keys:
;; Bind/restore keys C-M-S-[cf] (*-completing-read+insert-keys, *-read+insert-file-name-keys).
;; 2011/01/18 dadams
;; Require advice.el.
;; 2011/01/01 dadams
;; icicle-define-icicle-maps: Typo: icicle-search-tags-menu-map -> icicle-menu-map. Thx Le Wang.
;; 2010/12/26 dadams
;; Added autoload cookies to load icicles.el when command icicle-mode is invoked.
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/12/18 dadams
;; Added more autoload cookies for commands. Thx to Richard Kim.
;; 2010/11/23 dadams
;; icicle-define-icicle-maps: Added "in minibuf" to :key for C-?. Thx to Michael Heerdegen.
;; 2010/11/21 dadams
;; icicle-(redefine|restore)-standard-commands:
;; defalias lisp-complete-symbol unconditionally (it's still needed in some places for Emacs 23).
;; 2010/11/20 dadams
;; For eval-after-load's:
;; Protect eval of icicle-mode with boundp.
;; If the library is already loaded, then add the eval-after-load to icicles-mode.el instead.
;; Uncommented the code for simple.el for Emacs 23+.
;; dolist eval-after-load at end: Removed test for icicles-mode feature.
;; 2010/11/10 dadams
;; Define lisp-completion-at-point to return Icicles fn (don't defalias). Thx to M. Heerdegen.
;; 2010/11/06 dadams
;; icicle-top-level-prep: Reset current TAB and S-TAB methods, if temporary.
;; 2010/11/03 dadams
;; icicle-(redefine|restore)-standard-commands:
;; Updated for Emacs 23.2+: defalias lisp-completion-at-point instead. Thx to Michael Heerdegen.
;; 2010/10/21 dadams
;; icicle-minibuffer-setup:: Revert last change: this must NOT be local.
;; 2010/10/19 dadams
;; icicle-minibuffer-setup: Use non-nil LOCAL arg to add-hook for icicle-top-level-prep.
;; 2010/10/09 dadams
;; icicle-define-cycling-keys:
;; Define modal keys uncondiationally (no icicle-cycling-respects-completion-mode).
;; Define modal keys first, then non-modal. Remove no bindings (make no bindings to nil).
;; Removed hard-coded bindings for mouse wheel - handled by vars now, as before.
;; icicle-define-minibuffer-maps:
;; Hard-code down/up in completion-list-mode-map - do not reuse prefix completion keys.
;; Applied renaming of icicle-cycling-respects-completion-mode to icicle-default-cycling-mode.
;; 2010/10/08 dadams
;; icicle-minibuffer-setup: Do not set icicle-current-completion-mode in recursive minibuffer.
;; icicle-define-cycling-keys: Unconditionally define mouse wheel for modal cycling.
;; 2010/10/07 dadams
;; Use icicle-current-TAB-method function, not variable, everywhere.
;; 2010/10/06 dadams
;; icicle-define-cycling-keys: Let all non-conflicting non-modal keys remain: modal just
;; overwrites the conflicting non-modal. Thx to Michael Heerdegen.
;; 2010/07/17 dadams
;; w3m - > url. Add URL jump bindings. Replace w3m by url otherwise.
;; 2010/06/11 dadams
;; icicle-define-minibuffer-maps: Bind/restore C-c + to icicle-make-directory in file-name maps.
;; 2010/06/04 dadams
;; icicle-mode doc string: Mention missing doremi commands.
;; icicle-define-icicle-maps: Added Swank items and Max # of Completions, :visible for separator.
;; icicle-(bind|restore)-completion-keys: Bind icicle-doremi-increment-max-candidates+ to C-x #.
;; Apply renamings of icicle-doremi* (added +).
;; 2010/05/26 dadams
;; Add to command-history only if an interned symbol. Thx to Michael Heerdegen.
;; 2010/05/22 dadams
;; icicle-(bind|restore)-completion-keys: Bind icicle-candidate-read-fn-invoke to ESC C-m also.
;; 2010/05/17 dadams
;; icicle-define-icicle-maps: Changed :enable conditions for *-goto*-marker. Thx to M. Heerdegen.
;; 2010/05/15 dadams
;; icicle-mode: Updated doc string for bookmark commands.
;; 2010/05/09 dadams
;; Key-binding changes: icicle-change-sort-order is C-, icicle-dispatch-M-_ is M-_.
;; 2010/04/21 dadams
;; icicle-(redefine|restore)-std-completion-fns: Added icicle-sit-for for Emacs 23.
;; 2010/04/02 dadams
;; icicle-mode: Updated doc string: list of commands.
;; 2010/04/02 dadams
;; icicle-mode: Update doc string for change from regions to bookmarks.
;; icicle-define-icicle-maps:
;; Remove Icicles region stuff from menus.
;; Added to menus: icicle-search-bookmarks-together, icicle-search-bookmark,
;; icicle-select-bookmarked-region.
;; 2010/03/28 dadams
;; Applied renaming: icicle-search-all-regions to icicle-search-region.
;; Use icicle-search-region-bookmark in menus.
;; 2010/03/14 dadams
;; icicle-define-minibuffer-maps: Use featurep, not soft-require, for bookmark+.el.
;; Added bookmark+ to final dolist for eval-after-load.
;; 2010/03/13 dadams
;; icicle-define-icicle-maps:
;; Bound icicle-toggle-show-multi-completion to M-m in minibuffer, and added to menus.
;; Applied renaming of icicle-add-buffer-name-flag to icicle-show-multi-completion-flag.
;; 2010/02/17 dadams
;; Applied rename of icicl-redefined-functions to icicle-inhibit-advice-functions.
;; 2010/02/13 dadams
;; icicle-mode:
;; Fill icicle-advice-info-list from advised fns among icicle-redefined-functions.
;; Reactivate advised fns (in icicle-advice-info-list) when turn mode off.
;; Added to doc string: icicle-bookmark-(dired|desktop|bookmark-list|man)-other-window.
;; icicle-define-icicle-maps: Use (featurep 'recentf) instead of soft-requiring it.
;; icicle(-bookmark)-menu-map: Added type-specific bookmark jump commands.
;; eval-after-load's: Add (when (featurep 'icicles-mode)...) to ensure this file was loaded.
;; 2010/01/28 dadams
;; icicle-define-minibuffer-maps, icicle-restore-completion-keys:
;; Restore C-g correctly if delete-selection-mode.
;; 2009/12/25 dadams
;; icicle-mode: Call completion-ignored-build-disable to disable the advice.
;; 2009/12/21 dadams
;; Final dolist: Move loaded-library test outside of eval-after-load.
;; Update the test for Emacs 22+ (not just assoc). Thx to Kevin Ryde.
;; Combine eval-after-load's for dired-x. Remove eval-after-load for simple.el (preloaded).
;; fset -> defalias.
;; 2009/12/13 dadams
;; icicle-define-minibuffer-maps:
;; Bind C-x m to icicle-bookmark-file-other-window in file-name completion maps.
;; 2009/11/29 dadams
;; Don't reference minibuffer-local-must-match-filename-map unless bound (obsolete in 23.2).
;; 2009/11/27 dadams
;; icicle-(bind|restore)-completion-keys: Bind/restore C-x 1, C-x 2.
;; 2009/11/07 dadams
;; Applied doremi cmd renamings (added +).
;; 2009/10/25 dadams
;; icicle-mode, icicle-define-icicle-maps, icicle-bind-completion-keys:
;; Updated doc string, menus, keys for completion-method command renamings.
;; 2009/09/26 dadams
;; icicle-minibuffer-setup: Do not complete if icicle-progressive-completing-p.
;; 2009/09/16 dadams
;; icy-mode: Add icicle-insert-buffer to doc string.
;; icicle-define-icicle-maps: Added icicle-insert-buffer to icicle-menu-map.
;; 2009/09/10 dadams
;; icicle-bind-key-completion-keys-in-keymaps-from: Don't exclude menu maps.
;; 2009/09/03 dadams
;; icicle-add-menu-item-to-cmd-history: Wrap in condition-case, since on pre-command-hook.
;; 2009/08/18 dadams
;; icicle-add-menu-item-to-cmd-history:
;; Ensure this-command-keys-vector is not empty. Thx to Kai Tetzlaff and Lennart Borgman.
;; 2009/08/09 dadams
;; icicle-minibuffer-setup: Set region background for recursive minibuffers too.
;; icicle-restore-region-face: Do not restore unless going back to top level.
;; 2009/08/01 dadams
;; Added: icicle-add-menu-item-to-cmd-history. Thx to Lennart Borgman.
;; icy-mode: add/remove pre-command-hook, respecting icicle-menu-items-to-history-flag.
;; call-interactively defadvice: Do not save let savehist save icicle-interactive-history.
;; 2009/07/29 dadams
;; Change advice for call-interactively:
;; Use it only for Emacs 23+. Disable it to begin with.
;; Add only (non-mouse command) symbols to history.
;; icy-mode (Emacs 23+):
;; Enable/disable advice icicle-save-to-history when mode is turned on/off.
;; Enable the advice only if non-nil icicle-populate-interactive-history-flag.
;; icy-mode (Emacs 20-21): Remove advice icicle-save-to-history.
;; 2009/07/26 dadams
;; Advise call-interactively to save command to icicle-interactive-history.
;; icicle-(bind|restore)-completion-keys: Bind/restore C-M-pause as icicle-other-history.
;; 2009/07/13 dadams
;; Emacs 22+:
;; Added describe-face defadvice (icicle-respect-WYSIWYG). icicle-mode: (de)activate it.
;; 2009/06/18 dadams
;; icicle-mode: Added icicle-doremi-zoom-Completions to doc string.
;; 2009/06/17 dadams
;; icicle-(bind|restore)-completion-keys: Bind icicle-doremi-zoom-Completions to C-x -.
;; icicle-define-icicle-maps:
;; Add icicle-doremi-zoom-Completions to Options menu.
;; Change visible condition for all doremi stuff to ensure *Completions* is showing.
;; 2009/05/27 dadams
;; icicle-retrieve-(next|previous)-input: Removed unused (always nil) arg DONT-COMPLETE-P.
;; 2009/05/22 dadams
;; icicle-define-icicle-maps: Added icicle-Info-virtual-book to menu.
;; Require icicles-cmd[12].el.
;; 2009/05/17 dadams
;; dolist eval-after-load at end: Use icicle-toggle-icicle-mode-twice, not icy-mode calls.
;; 2009/05/09 dadams
;; icicle-define-icicle-maps: Added icicle-toggle-dot to options menu. Updated C-x . key.
;; icicle-(bind|restore)-completion-keys:
;; Bind *-toggle-dot to C-M-., *-toggle-hiding-common-match to C-x .,
;; *-insert-dot-command to ..
;; icy-mode: Mention icicle-toggle-dot in doc string.
;; 2009/05/02 dadams
;; icicle-minibuffer-setup: Set icicle-cmd-reading-input to this-command.
;; 2009/04/30 dadams
;; icicle-minibuffer-setup: Reset icicle-next-(prefix|apropos)-complete-cycles-p to nil.
;; 2009/04/20 dadams
;; icicle-bind-completion-keys: Don't bind C-S-(up|down|next|prior) explicitly.
;; icicle-restore-completion-keys:
;; Restore: icicle-(prefix|apropos)-cycle-(previous|next)-alt-action-keys,
;; icicle-modal-cycle-(up|down)-alt-action-keys.
;; Don't restore C-S-(up|down|next|prior) explicitly.
;; icicle-define-cycling-keys:
;; Bind/Restore: icicle-(prefix|apropos)-cycle-(previous|next)-alt-action-keys,
;; icicle-modal-cycle-(up|down)-alt-action-keys.
;; 2009/04/19 dadams
;; icicle-redefine-standard-commands: Added defalias for customize-apropos-options-of-type.
;; eval-after-loads: Use when/unless instead of and/or for fset's. (cosmetic)
;; 2009/04/18 dadams
;; icicle-mode: Mention in doc string: you might want to customize keys if no window mgr.
;; 2009/04/16 dadams
;; icicle-restore-completion-keys, icicle-define-cycling-keys:
;; Use icicle-(prefix|apropos)-cycle-(previous|next)-help-keys.
;; 2009/04/15 dadams
;; icicle-bind-completion-keys: Removed bindings for C-M-(up|down|prior|next).
;; icicle-restore-completion-keys: Unbind icicle-modal-cycle-(up|down)-help-keys.
;; icicle-define-cycling-keys: Bind/unbind all help keys (including modal ones).
;; 2009/03/27 dadams
;; icicle-(redefine|restore)-standard-commands:
;; Added icicle-minibuffer-default-add-completions.
;; 2009/03/16 dadams
;; icicle-define-icicle-maps: Use :visible for Icicle submenus themselves.
;; icicle-(redefine|restore)-standard-commands: Added icicle-recentf-make-menu-items.
;; Added eval-after load for recentf.el.
;; 2009/03/15 dadams
;; icicle-mode: Added to doc string: icicle-recompute-shell-command-candidates,
;; icicle-remove-file-from-recentf-list.
;; icicle-define-icicle-maps: Added icicle-remove-file-from-recentf-list to menus.
;; 2009/03/10 dadams
;; icicle-mode: Don't reset icicle-shell-*-cache if icicle-guess-commands-in-path is load.
;; Applied renaming: icicle-shell-command-candidates to *-cache
;; 2009/03/01 dadams
;; icicle-define-minibuffer-maps:
;; Bind icicle-completing-read+insert, icicle-read+insert-file-name. Add to Minibuf menu.
;; 2009/02/28 dadams
;; fset old-dired-smart-shell-command after load Dired-X.
;; 2009/02/20 dadams
;; icicle-mode: Reset icicle-shell-command-candidates to nil.
;; icicle-minibuffer-setup:
;; Use function icicle-require-match-p, not var.
;; Do not reset icicle-completing-p to nil (reset by icicle-require-match-p).
;; icicle-(redefine|restore)-standard-commands:
;; Redefine dired-read-shell-command, not dired-guess-shell-command.
;; Redefine: dired-smart-shell-command, shell-command(-on-region).
;; Added eval-after load for dired-read-shell-command for dired-aux.el (and for dired-x.el).
;; eval-after-load for read-shell-command: Don't do it only when mailcap can be loaded.
;; 2009/02/01 dadams
;; icicle-define-minibuffer-maps: Bind C-backspace to icicle-up-directory.
;; 2009/01/25 dadams
;; icicle-(redefine|restore)-standard-commands:
;; Aliases for dired-guess-shell-command, read-shell-command. Also eval-after-load's.
;; 2009/01/23 dadams
;; icicle-(bind|restore)-other-keymap-keys:
;; For sh-mode-map, remap comint-dynamic-complete, don't (un)bind TAB. Thx to Seb Luque.
;; 2009/01/18 dadams
;; Renamed Open Dired for Saved Completion Candidates to Open Dired for Chosen Files.
;; 2009/01/06 dadams
;; Added to dolist of eval-after-load's: net-utils, rlogin, idlw-shell.
;; 2009/01/05 dadams
;; icicle-(bind|restore)-other-keymap-keys: Treat keys for Shell Script, Ielm, Tcl, and GUD.
;; icicle-(redefine|restore)-standard-commands:
;; Handle: comint-dynamic-complete-filename, gud-gdb-complete-command.
;; Added eval-after-load for gud.
;; Added to dolist of eval-after-load's: ielm, gud, sh-script, tcl.
;; 2009/01/04 dadams
;; Added ESS support:
;; icicle-(redefine|restore)-standard-commands:
;; Added: (icicle|old)-comint-replace-by-expanded-filename,
;; (icicle|old)-ess-complete-object-name.
;; Added eval-after-load for ess-site and for old-comint-replace-by-expanded-filename.
;; Thx to Sebastian Luque.
;; 2008/12/30 dadams
;; icicle-mode: Don't add/remove hook icicle-shell-hook-fn.
;; Don't call icicle-(un)bind-isearch-keys.
;; Renamed: icicle-rebind-other-keymap-keys to icicle-bind-other-keymap-keys.
;; icicle-(bind|restore)-other-keymap-keys:
;; Call icicle-(un)bind-isearch-keys here.
;; Bind/restore icicle-comint-command here.
;; Don't use eval-after-load. Instead, define keys if the maps are defined.
;; Bind/restore shell keys only if icicle-redefine-standard-commands-flag is true.
;; icicle-minibuffer-setup:
;; Remove redundant code that calls icicle-define-cycling-keys for each minibuffer map.
;; icicle-define-minibuffer-maps:
;; Restore C-g to abort-recursive-edit in minibuffer-local-must-match-map.
;; icicle-(redefine|restore)-standard-commands:
;; Test fboundp of old-*, not *, for bbdb and comint.
;; Do not defalias comint-dynamic-complete-filename or shell-dynamic-complete-*.
;; icicle-remap: Moved to icicles-opt.el.
;; At end of file:
;; eval-after-load comint and bbdb: Turn off icy-mode before fset old-*.
;; eval-after-load each of the other keymap libraries: Toggle icy-mode.
;; 2008/12/26 dadams
;; Bind icicle-widen-candidates to M-+, and add it to Minibuf menu.
;; Bind icicle-apropos-complete-and-widen to S-backspace.
;; 2008/12/22 dadams
;; Forgot to add/remove icicle-shell-hook-fn to shell-mode-hook for Emacs 20.
;; icicle-bind-completion-keys, icicle-define-icicle-maps: Added icicle-regexp-quote-input.
;; 2008/12/21 dadams
;; icicle-(redefine|restore)-standard-commands: Added comint-*, shell-*.
;; Renamed *-(rebind|restore)-non-completion-keys to *-(rebind|restore)-other-keymap-keys.
;; icy-mode: Add/remove icicle-shell-hook-fn to shell-mode-hook.
;; icicle--(rebind|restore)-other-keymap-keys:
;; Don't rebind Info keys unless icicle-redefine-standard-commands-flag.
;; Wrap Dired key bindings in eval-after-load.
;; icicle-restore-other-keymap-keys: Corrected (updated) Dired keys.
;; 2008/12/07 dadams
;; icicle-minibuffer-setup:
;; Add completing prompt prefix here, using icicle-completion-prompt-overlay.
;; Removed icicle-prompt.
;; 2008/12/05 dadams
;; icicle-(bind|restore)-completion-keys: Bind C-v, M-v to scroll *Completions* window.
;; 2008/11/14 dadams
;; icicle-toggle-hiding-common-match:
;; icy-mode: Mention it in doc string, icicle-define-icicle-maps: Add it to menus.
;; icicle-bind-completion-keys: Bind it to C-M-.
;; icicle-minibuffer-setup:
;; Use (cadr (buffer-list)), not other-buffer, for icicle-pre-minibuffer-buffer
;; 2008/11/04 dadams
;; icicle-define-icicle-maps: No longer bind icicle-generic-S-tab keys (obsolete).
;; Renamed:
;; *-(un)bind-S-TAB-in-keymaps-from to *-(un)bind-key-completion-keys-in-keymaps-from,
;; *-(un)bind-S-TAB-for-map-variable to *-(un)bind-key-completion-keys-for-map-var.
;; icicle-(un)bind-key-completion-keys-in-keymaps-from:
;; icicle-generic-S-tab-keys -> icicle-key-complete-keys.
;; Respect icicle-complete-key-anyway-flag.
;; icicle-define-minibuffer-maps: *-generic-S-tab-keys -> *-previous-candidate-keys.
;; icicle-(bind|restore)-completion-keys: *-generic-S-tab-keys -> *-apropos-complete-keys.
;; icicle-(un)bind-isearch-keys: *-generic-S-tab-keys -> *-search-from-isearch-keys.
;; 2008/11/03 dadams
;; Applied renamings from icicles-cmd.el.
;; 2008/11/01 dadams
;; Require cl.el at compile time for all Emacs versions, not just 20.
;; 2008/10/14 dadams
;; icy-mode: No longer call icicle-update-help-string.
;; Renamed: *-update-help-string to *-help-string-completion and moved to icicles-mcmd.el.
;; Renamed: icicle-rebind-completion-maps to icicle-define-minibuffer-maps.
;; Applied renaming from icicles-mcmd.el: icicle-completion-help to icicle-minibuffer-help.
;; icicle-define-minibuffer-maps:
;; Bound icicle-minibuffer-help also in non-completion minibuffer maps and *Completions*.
;; Bound icicle-yank-secondary in minibuffer-local-isearch-map also.
;; icicle-(bind|restore)-completion-keys: Only bind icicle-minibuffer-help if not inherited.
;; 2008/10/12 dadams
;; icicle-rebind-non-completion-keys (and undo in icicle-restore-non-completion-keys):
;; Ibuffer mode: Bind M-s i to icicle-search-ibuffer-marked and add to Operate menu.
;; Buffer Menu mode: Bind M-s i to icicle-search-buff-menu-marked.
;; Dired mode: Change binding of icicle-search-dired-marked from M-s to M-s i.
;; Removed vestigial binding to C-M-r.
;; Make eval-after-load for "info" unconditional.
;; 2008/10/11 dadams
;; icicle-update-help-string, icicle-(bind|restore)-completion-keys:
;; icicle-kill-failed-input -> icicle-goto/kill-failed-input.
;; icicle-define-cycling-keys: Typo: icicle-apropos-cycle-previous-keys -> *-action*.
;; 2008/10/10 dadams
;; icicle-minibuffer-setup:
;; Make icicle-current-completion-mode respect *-cycling-respects-completion-mode-flag.
;; Initial *Completions* display respects icicle-cycling-respects-completion-mode-flag.
;; icicle-minibuffer-setup, icicle-bind-completion-keys: Use icicle-define-cycling-keys.
;; icicle-restore-completion-keys: Restore (C-)up, (C-)down, (C-)next, (C-)prior.
;; Added: icicle-define-cycling-keys.
;; 2008/10/08 dadams
;; icicle-bind-completion-keys:
;; Bind icicle-candidate-set-retrieve-more to C-<. Add to Minibuf menu.
;; icicle-define-icicle-maps, icicle-update-help-string: Remove C-< for angle brackets.
;; icicle-minibuffer-setup:
;; Set icicle-pre-minibuffer-buffer to (other-buffer nil t), not (cadr (buffer-list).
;; 2008/10/04 dadams
;; icicle-(redefine|restore)-std-completion-fns:
;; Substitute Icicles version of completing-read-multiple and maps. Thx to Per Nordlow.
;; icy-mode doc string: Typo - thx to Richard Kim.
;; 2008/10/01 dadams
;; icicle-update-help-string: Added current values for toggles. Moved toggles near top.
;; Added: icicle-S-iso-lefttab-to-S-TAB.
;; 2008/09/30 dadams
;; icicle-bind-isearch-keys: For icicle-generic-S-tab-keys, read the search string using
;; icicle-isearch-complete-past-string.
;; 2008/09/13 dadams
;; Use renamings from icicles-mcmd.el:
;; icicle-candidate-set-save-to-cache-file to icicle-candidate-set-save-persistently,
;; icicle-candidate-set-retrieve-from-cache-file to *-candidate-set-retrieve-persistent.
;; 2008/09/11 dadams
;; icicle-define-icicle-maps: Added icicle-grep-saved-file-candidates to menus.
;; 2008/09/09 dadams
;; Use renamings from icicles-cmd.el:
;; icicle-candidate-set-dired-marked-save-* to icicle-dired-save-marked-*.
;; Bind: icicle-dired-save-marked-* to C(-M)->, not C(-M)-),
;; icicle-dired-saved-file-candidates-other-window to C-M-<, not C-M-r,
;; icicle-dired-save-marked-(to-variable|as-project) to C-M-}, C-},
;; icicle-dired-project-other-window to C-{.
;; Add to Dired > Multiple (or Operate) > Icicles menu: icicle-dired-save-marked-as-project.
;; Add to Dired > Dir and File > Icicles menus: icicle-dired-project-other-window.
;; Removed from File > Icicles menu: icicle-dired-saved-file-candidates.
;; 2008/08/22 dadams
;; icicle-update-help-string: Removed mention of icicle-Completions-window-default-width.
;; 2008/08/21 dadams
;; icicle-define-icicle-maps: Replace icicle-find-file(-*) with icicle-file.
;; icicle-mode doc string, icicle-update-help-string: Updated for new cmds icicle-file etc.
;; Define BBDB aliase only if BBDB is loaded.
;; 2008/08/17 dadams
;; icicle-rebind-completion-maps: Bind mouse wheel for completion-list-mode-map.
;; 2008/08/12 dadams
;; icicle-define-icicle-maps: Add :keys for icicle-goto(-global)-marker.
;; 2008/08/08 dadams
;; icicle-define-icicle-maps:
;; Added icicle-goto(-global)-marker to icicle-(bookmark|search)-menu-map.
;; Soft require of menu-bar+.el, instead of just eval-when-compile.
;; 2008/08/07 dadams
;; icicle-(redefine|restore)-*: Don't use symbol-function for target of defalias.
;; 2008/08/04 dadams
;; Use condition-case when require mb-depth+.el.
;; icicle-(rebind|restore)-completion-maps, icicle-bind-completion-keys:
;; Updated Minibuf menu to add icicle-clear-current-history.
;; icicle-restore-completion-keys:
;; Added: (alt-)action(-list)-all, icicle-save-predicate-to-variable.
;; 2008/08/03 dadams
;; icicle-mode: Updated doc string.
;; icicle-update-help-string: Added clear-history stuff and changed bindings.
;; icicle-rebind-completion-maps: Added binding: icicle-clear-current-history (M-i).
;; icicle-bind-completion-keys:
;; Added to Minibuf menu: icicle-all-candidates(-list)(-alt)-action.
;; Added bindings: icicle-all-candidates-list-action (M-!),
;; icicle-all-candidates-list-alt-action (M-|),
;; icicle-clear-current-history (M-i).
;; Changed bindings:
;; icicle-all-candidates-alt-action (C-S-insert to C-|)
;; icicle-toggle-expand-to-common-match (C-| to C-;),
;; icicle-toggle-search-replace-common-match (C-M-| to M-;),
;;
;; 2008/08/01 dadams
;; icicle-mode: Std mb-depth.el renamed *-indicate-depth-mode to *-depth-indicate-mode.
;; 2008/07/30 dadams
;; icicle-update-help-string: Make C-M-) more obvious for clearing saved candidates.
;; 2008/07/23 dadams
;; Renamed: icicle-map to icicle-apply.
;; 2008/07/21 dadams
;; icicle-(redefine|restore)-standard-commands: Added icicle-bbdb-complete.
;; 2008/06/03 dadams
;; icy-mode: Added icicle-toggle-C-for-actions to doc string.
;; icicle-define-icicle-maps: Added icicle-toggle-C-for-actions to menus.
;; icicle-update-help-string:
;; Mention icicle-insert-history-element, icicle-toggle-C-for-actions.
;; icicle-bind-completion-keys: Bindings according to icicle-use-C-for-actions-flag.
;; icicle-(bind|restore)-completion-keys: Bind/unbind M-g.
;; 2008/05/27 dadams
;; Renamed: icicle-(un)bind-isearch-completion-keys to icicle-(un)bind-isearch-keys.
;; icicle-bind-isearch-keys: Bind S-TAB to icicle-search, C-o to isearch-(m)occur.
;; Likewise, icicle-unbind-isearch-keys.
;; 2008/05/25 dadams
;; Renamed: icicle-bind-isearch-keys to icicle-bind-isearch-completion-keys.
;; Added: icicle-unbind-isearch-completion-keys.
;; icy-mode: icicle-(un)bind-isearch-completion-keys instead of updating isearch-mode-hook.
;; icicle-bind-isearch-completion-keys:
;; Don't bind anything in minibuffer-local-isearch-map (overridden by icicle-mode-map).
;; 2008/05/22 dadams
;; icicle-update-help-string: Mention C-u for read-file-name-completion-ignore-case.
;; 2008/05/11 dadams
;; Moved icicle-bind-top-level-commands to icicles-opt.el (and added optional arg).
;; Renamed icicle-fit-Completions-window to icicle-fit-completions-window.
;; 2008/05/10 dadams
;; Renamed: icicle-bind-top-level-commands-alist to icicle-top-level-key-bindings.
;; icicle-bind-top-level-commands: Don't eval the key (binding).
;; 2008/05/07 dadams
;; icicle-define-icicle-maps: Use icicle-bind-top-level-commands instead of hard-coding.
;; icicle-update-help-string: icicle-bind-*-flag -> icicle-bind-*-alist.
;; 2008/04/25 dadams
;; icicle-(redefine|restore)-std-completion-fns:
;; Never set icicle-old-read-file-name-fn to icicle-read-file-name.
;; Thx to Alexey Romanov and Per Nordlow.
;; icicle-define-icicle-maps, icicle-(bind|restore)-completion-keys:
;; Bound icicle-toggle-remote-file-testing (C-^).
;; icicle-toggle-ignored-space-prefix is now bound to M-_, not C-^.
;; icicle-update-help-string: Updated bindings accordingly.
;; 2008/04/18 dadams
;; Renamed icicle-init-value-flag to icicle-default-value.
;; 2008/03/30 dadams
;; icicle-(redefine|restore)-std-completion-fns:
;; Set and swap read-file-name-function and icicle-old-read-file-name-fn for Emacs 22+.
;; Top-level:
;; Moved fset old-read-file-name here, renamed it orig-read-file-name. Not for Emacs 22.
;; 2008/03/29 dadams
;; icicle-mode: No longer use icicle-control-reminder-prompt on kill-emacs-hook.
;; icicle-update-help-string:
;; Removed: icicle-completing(-mustmatch)-prompt-prefix, icicle-reminder-prompt-flag.
;; icicle-rebind-completion-maps: Remove code setting icicle-prompt-suffix (removed).
;; 2008/03/26 dadams
;; Added icicle-Info-menu to icicle-mode doc string and icicle-update-help-string.
;; icicle-define-icicle-maps: Added icicle-Info-menu to menus.
;; icicle-(rebind|restore)-non-completion-keys: Bind/restore icicle-Info-menu-cmd.
;; 2008/03/23 dadams
;; Added: icicle-handle-switch-frame.
;; icicle-(rebind|restore)-non-completion-keys:
;; Bind switch-frame to icicle-handle-switch-frame globally, and restore.
;; 2008/03/19 dadams
;; Remap (pp-)eval-expression to new icicle-pp-eval-expression.
;; Replace lambdas by icicle-pp-eval-expression-in-minibuffer.
;; Use icicle-pp-eval-expression-in-minibuffer (new) in help string.
;; icicle-rebind-completion-maps: Bind M-: to icicle-pp-eval-expression-in-minibuffer.
;; Bind icicle-insert-newline-in-minibuffer in all minibuffer maps (likewise, non-icy).
;; Bind C-g in minibuffer-local-must-match-map, even if inherit.
;; icicle-bind-completion-keys: Don't bind in must-match if it inherits:
;; C-a, C-e, C-=, M-k, M-o, M-., M-:, C-M-y, M-S-(backspace|delete)
;; 2008/03/09 dadams
;; icicle-mode: Add icicle-unhighlight-lighter to minibuffer-exit-hook.
;; 2008/03/07 dadams
;; icicle-abort-minibuffer-input: Thx to Damon Permezel.
;; Make it always call abort-recursive-edit. Renamed to icicle-abort-recursive-edit.
;; 2008/02/28 dadams
;; icicle-define-icicle-maps: Don't bind pop-tag-mark (M-*) in icicle-mode-map for Emacs 21.
;; 2008/02/26 dadams
;; Remapped where-is to icicle-where-is.
;; Added to Describe > Icicles menu: icicle-describe-option-of-type, icicle-where-is.
;; Bound icicle-select-frame to C-x 5 o in Icicle mode.
;; 2008/02/24 dadams
;; icicle-define-icicle-maps: Bound icicle-next-apropos-match-function to M-(.
;; Add icicle-next-apropos-match-function to icicle-update-help-string and mode doc string.
;; 2008/02/23 dadams
;; Renamed: icicle-search-tag to icicle-find-tag,
;; icicle-find-tag(-other-window) to icicle-find-first-tag(-other-window).
;; icicle-define-icicle-maps: Added icicle-tags-search to Tags menu and Search menu.
;; 2008/02/22 dadams
;; Renamed: icicle(-mouse)-save-candidate to icicle(-mouse)-save/unsave-candidate.
;; 2008/02/13 dadams
;; Remapped: find-tag (M-.) to icicle-search-tag, instead of icicle-find-tag
;; pop-tag-mark (M-*) to icicle-pop-tag-mark.
;; icicle-define-icicle-maps:
;; Added icicle-search-tag and icicle-pop-tag-mark to menus.
;; Removed icicle-find-tag from menu. Renamed icicle-find-tag-other-window menu item.
;; 2008/02/07 dadams
;; icicle-(redefine|restore)-std-completion-fns: Protect read-number with fboundp.
;; 2008/02/03 dadams
;; icicle-(redefine|restore)-std-completion-fns: Added (icicle|old)-choose-completion.
;; 2008/01/30 dadams
;; Bound icicle-yank-secondary and icicle-mouse-yank-secondary.
;; 2008/01/15 dadams
;; Require dired.el. Soft-require dired+.el. Thx to Fabrice Knevez.
;; 2008/01/13 dadams
;; icicle-(rebind|restore)-non-completion-keys:
;; Bound [handle-switch-frame] to icicle-skip-this-command globally.
;; Added: icicle-skip-this-command.
;; 2008/01/02 dadams
;; icicle-(rebind|restore)-non-completion-keys: Bound icicle-search-dired-marked to M-s.
;; icicle-define-icicle-maps: Added icicle-search-dired-marked to Dired>Multiple>Icicles.
;; 2008/01/01 dadams
;; icicle-*-non-completion-keys: Bound icicle-candidate-set-dired-marked-save(-more).
;; icicle-define-icicle-maps: Added Icicles submenu for Dired > Multiple (Operate) menu.
;; 2007/12/31 dadams
;; Bound icicle-insert-list-join-string to C-M-j. Update icicle-update-help-string.
;; 2007/12/24 dadams
;; icicle-rebind-completion-maps: Bound C-j to also refit the minibuffer frame.
;; 2007/12/20 dadams
;; Bound icicle-dired-saved-file-candidates-other-window in Dired to C-M-r.
;; Bound icicle-describe-option-of-type to C-h C-o, not C-h M-o.
;; 2007/12/18 dadams
;; icicle-define-icicle-maps: Bind icicle-describe-option-of-type to C-h M-o.
;; 2007/12/14 dadams
;; icicle-mode: Only add to kill-emacs-hook if icicle-customize-save-flag is non-nil.
;; 2007/12/13 dadams
;; icicle-update-help-string: spell out options, don't abbreviate using *.
;; 2007/12/08 dadams
;; Bound icicle-(beginning|end)-of-line+.
;; 2007/12/07 dadams
;; icicle-rebind-completion-maps: Removed obsolete stuff from doc string.
;; 2007/12/03 dadams
;; Renamed longest common match (lcm) to expanded common match (ecm).
;; 2007/11/29 dadams
;; icicle-minibuffer-setup: If icicle-add-proxy-candidates-flag is nil, swap candidate sets.
;; Reset icicle-saved-proxy-candidates to nil.
;; 2007/11/27 dadams
;; icicle-(redefine|restore)-std-completion-fns: Added read-number.
;; 2007/11/25 dadams
;; icicle-define-icicle-maps: Bound icicle-command-abbrev to C-x SPC.
;; icicle-mode: Use icicle-command-abbrev-save on kill-emacs-hook.
;; Changed binding of icicle-doremi-inter-candidates-min-spaces from C-x SPC to C-x |.
;; 2007/11/23 dadams
;; icicle-rebind-completion-maps:
;; Use icicle-prefix-cycle-(next|previous)-keys, instead of hardcoding.
;; icicle-(bind|restore)-completion-keys:
;; Use icicle-(apropos|prefix)-cycle-(next|previous)-keys, instead of hardcoding.
;; Restore explicit vanilla bindings last.
;; 2007/11/22 dadams
;; icicle-(bind|restore)-completion-keys:
;; Explicitly bind/restore (C-)up, (C-)down, (C-)next, (C-)(C-)prior, instead of
;; remapping next-line etc.
;; 2007/11/21 dadams
;; icicle-rebind-completion-maps: Explicitly bind C-j to icicle-self-insert.
;; icicle-(bind|restore)-completion-keys, icicle-update-help-string:
;; Removed C-o binding for icicle-candidate-action.
;; 2007/11/17 dadams
;; Added doc, menus, bindings (C-M-_): icicle-toggle--proxy-candidates.
;; 2007/11/05 dadams
;; icicle-define-icicle-maps: Moved [Icy] items to Icicles submenus.
;; Added: icicle-(bookmark|custom|describe|edit|file|frames|info|search(-tags))-menu-map.
;; 2007/11/03 dadams
;; icicle-define-icicle-maps, icicle-bind-S-TAB-in-keymaps-from,
;; icicle-unbind-S-TAB-in-keymaps-from, icicle-rebind-completion-maps,
;; icicle-bind-completion-keys:
;; Bind icicle-generic-S-tab-keys instead of hard-coded S-(iso-left)tab.
;; icicle-(bind|restore)-completion-keys:
;; Bind/restore icicle-prefix-complete-keys,
;; icicle-(apropos|prefix)-complete-keys-no-display, not hard-coded keys.
;; icicle-bind-isearch-keys: Bind icicle-isearch-complete-keys, not hard-coded.
;; Renamed icicle-modal-cycle-(up|down)-key to icicle-modal-cycle-(up|down)-keys,
;; icicle-word-completion-key to icicle-word-completion-keys.
;; 2007/10/31 dadams
;; icicle-define-icicle-maps:
;; Moved options to new Icicles submenu of Options menu, and removed [Icy]. Added :keys.
;; Added: icicle-options-menu-map.
;; 2007/10/28 dadams
;; Added doc, menus, bindings (C-|, C-M-|):
;; icicle-toggle-(expand-to-common-match|search-replace-common-match).
;; 2007/10/21 dadams
;; icicle-(bind|restore)-completion-keys: Bind C-x w and C-x SPC.
;; icicle-define-icicle-maps: Add Do Re Mi items.
;; icicle-mode, icicle-update-help-string: Mention C-x w and C-x SPC.
;; 2007/09/29 dadams
;; icicle-mode, icicle-define-icicle-maps, icicle-update-help-string:
;; Added icicle-toggle-fuzzy-completion (and icicle-fuzzy-completion-flag to help string).
;; icicle-(bind|restore)-completion-keys: Bind/unbind icicle-toggle-fuzzy-completion to C-(.
;; 2007/09/20 dadams
;; icicle-(bind|restore)-completion-keys: Bind C-j to icicle-self-insert / exit-minibuffer.
;; 2007/09/18 dadams
;; Added: icicle-update-help-string. Use in icy-mode, not in icicle-rebind-completion-maps.
;; Removed icicle-toggle-WYSIWYG-Completions (it has no minibuffer binding).
;; 2007/08/25 dadams
;; icy-mode, icicle-completion-help-string:
;; icicle-clear-option -> clear-option. Added toggle alias.
;; 2007/08/21 dadams
;; icicle-completion-help-string: Mention C-M-l.
;; 2007/08/19 dadams
;; icicle-minibuffer-setup: Reset icicle-input-fail-pos.
;; icicle-(bind|restore)-completion-keys:
;; (Re|un)map reposition-window to icicle-kill-failed-input.
;; 2007/08/03 dadams
;; icicle-mode: Remove icicle* hooks from local, not global, hooks.
;; 2007/07/22 dadams
;; icicle-(redefine|restore)-standard-commands: Added customize-face(-other-window).
;; Moved icicle-completing-p to icicles-fn.el.
;; Require icicles-cmd.el.
;; 2007/07/06 dadams
;; icicle-rebind-completion-maps:
;; Moved icicle-Completions-mouse-3-menu to C-mouse-3.
;; Added icicle(-mouse)-candidate-set-save(-more)-selected, icicle-candidate-set-retrieve,
;; icicle-retrieve-previous-input.
;; icicle-completion-help-string: Added icicle-candidate-set-save(-more)-selected.
;; icicle-bind-completion-maps:
;; Removed icicle-insert-history-element (inherited).
;; Added: icicle-candidate-set-save-more(-selected), icicle-mouse-save-then-kill.
;; 2007/07/04 dadams
;; icicle-rebind-completion-maps, icicle-(bind|restore)-completion-keys:
;; Added icicle-insert-history-element to Minibuf menu.
;; icicle-(bind|restore)-completion-keys:
;; Added icicle-retrieve-(next|previous)-input to Minibuf menu.
;; 2007/07/03 dadams
;; icicle-rebind-completion-maps, icicle-bind-completion-keys:
;; Bind icicle-insert-history-element to M-o in all minibuffer maps.
;; icicle-bind-completion-keys, icicle-completion-help-string:
;; icicle-retrieve-(next|previous)-input, not icicle-retrieve-last-input.
;; icicle-(redefine|restore)-std-completion-fns:
;; defalias next-history-element to icicle-next-history-element.
;; Removed defadvice for next-history-element. Redefine in icicles-mcmd.el instead.
;; 2007/06/22 dadams
;; Bound icicle-search-keywords and added to menus and help strings.
;; 2007/06/20 dadams
;; Removed M-o binding for icicle-toggle-WYSIWYG-Completions.
;; 2007/06/19 dadams
;; icicle-bind-completion-keys: Add icicle-save-predicate-to-variable to menus.
;; icicle-completion-help-string:
;; Mention icicle-save-predicate-to-variable and icicle-insert-string-from-variable.
;; 2007/06/18 dadams
;; icy-mode doc string, icicle-completion-help-string: Added icicle-customize-face.
;; icicle-define-icicle-maps: Added icicle-customize-face to menus.
;; 2007/06/17 dadams
;; Bound icicle-toggle-WYSIWYG-Completions to M-o.
;; icicle-minibuffer-setup: Reinitialize icicle-saved-candidate-overlays.
;; 2007/06/16 dadams
;; icicle-(bind|restore)-completion-keys: Bound C-M-(help|f1).
;; 2007/06/15 dadams
;; icicle-completion-help-string: Added and cleaned up set stuff.
;; icicle-(bind|restore)-completion-keys: Cleanup. Added menu items.
;; 2007/06/14 dadams
;; Swap bindings for C-insert and insert.
;; 2007/06/13 dadams
;; Bound C-insert and C-> to icicle-save-candidate and icicle-candidate-set-save-more.
;; 2007/06/12 dadams
;; icicle-rebind-completion-maps: Bound icicle-mouse-save-candidate to M-S-mouse-2.
;; 2007/06/10 dadams
;; icicle-mode: comint-mode-hook, compilation(-minor)-mode-hook, temp-buffer-show-hook.
;; 2007/06/08 dadams
;; icy-mode: Added icicle-find-tag* to doc string.
;; icicle-define-icicle-maps:
;; Added icicle-find-tag*. Remap find-tag* to icicle-find-tag*.
;; Corrected Info menu.
;; icicle-completion-help-string: Added icicle-find-tag*.
;; 2007/05/28 dadams
;; icicle-restore-non-completion-keys: Unbind S-tab.
;; Added: icicle-unbind-S-TAB-for-map-variable, icicle-unbind-S-TAB-in-keymaps-from.
;; icicle-bind-S-TAB-in-keymaps-from: Treat S-tab and S-iso-lefftab separately.
;; icicle-define-icicle-maps: Added icicle-imenu-* to Icicles/Search menus.
;; 2007/05/22 dadams
;; Make [Icy] menu items invisible when not in Icicle mode. Add :keys where appropriate.
;; icicle-define-icicle-maps, icicle-rebind-completion-maps,
;; icicle-(bind|restore)-completion-keys:
;; icicle-menu-item-any-version -> menu-item. Explicit put of enable property -> :enable.
;; Don't require icicles-mac.el.
;; icicle-bind-completion-keys: Added icicle-narrow-candidates, and corrected :enable forms.
;; 2007/05/21 dadams
;; icicle-define-icicle-maps:
;; Remap minibuffer-keyboard-quit to icicle-abort-minibuffer-input. Needed, even though
;; local-must-match inherits from local-completion in Emacs 22, because delsel.el binds
;; C-g to minibuffer-keyboard-quit in minibuffer maps.
;; menu-item-any-version -> icicle-menu-item-any-version.
;; Added Icicles/Search menu items:
;; Search (Buffer|File|Saved Region|All Saved Regions|Definition|Text Property).
;; Renamed: Search a Region -> Search Saved Region, Choose a Region -> Choose Saved Region,
;; Add Current Region to List -> Save Current Region.
;; 2007/05/20 dadams
;; Enable menu-bar Minibuf:
;; icicle-rebind-completion-maps:
;; Use menu-item-any-version.
;; Don't define menu for maps if it is defined by parent map.
;; Add Enter and Help items for *-local-map.
;; Add Enter, Help and Quit items for *-local-(ns|isearch)-map.
;; icicle-bind-completion-keys:
;; Use menu-item-any-version.
;; Add Enter item for *-local-completion-map, unless defined by parent map.
;; icicle-restore-completion-keys:
;; Use menu-item-any-version.
;; Add Enter and Quit items for *-local-completion-map, unless defined by parent map.
;; Do not unmap kill-region(-wimpy).
;; Bind [(control pause)] to nil.
;; 2007/05/13 dadams
;; icicle-restore-completion-keys: Restore some forgotten minibuf menu items.
;; 2007/05/08 dadams
;; Bound icicle-save-predicate-to-variable to C-M-&.
;; 2007/05/06 dadams
;; icicle-rebind-completion-maps: Updated icicle-completion-help-string.
;; Added defvars to quiet byte compiler.
;; Changed S-C- to C-S- and M-C- to C-M- in doc.
;; 2007/05/03 dadams
;; Remap icicle-yank-function, not yank.
;; icicle-define-icicle-maps: Bind icicle-search-word.
;; icicle-mode, icicle-completion-help-string: Add icicle-search-word to doc.
;; 2007/05/02 dadams
;; Bound M-q to icicle-dispatch-M-q, not to icicle-insert-key-description.
;; Bound C-` to icicle-toggle-regexp-quote, not to icicle-dispatch-C-backquote.
;; Bound C-M-` to icicle-toggle-literal-replacement.
;; Update icicle-completion-help-string.
;; 2007/04/20 dadams
;; icicle-minibuffer-setup: Don't reset icicle-search-context-level here.
;; 2007/04/17 dadams
;; Bound M-, to icicle-dispatch-M-comma, not to icicle-change-alternative-sort-order.
;; Bound C-` to icicle-dispatch-C-backquote, not to icicle-toggle-regexp-quote.
;; 2007/04/10 dadams
;; icicle-minibuffer-setup: Initialize icicle-search-context-level.
;; 2007/04/09 dadams
;; Bound icicle-imenu to C-c =.
;; 2007/04/08 dadams
;; Bound icicle-all-candidates-alt-action to C-S-insert.
;; 2007/04/07 dadams
;; icicle-completion-help-string: Updated.
;; Bound icicle-dispatch-C-comma to C-,.
;; Bound in menu: icicle-toggle-search-replace-whole.
;; Bound icicle-(next|previous)-(apropos|prefix)-candidate-alt-action (forgot).
;; 2007/04/02 dadams
;; Bound icicle-search-text-property to C-c ". Added it to icicle-completion-help-string.
;; 2007/03/23 dadams
;; Bound icicle-apropos-complete-and-narrow to S-SPC. Mention in *-completion-help-string.
;; 2007/03/14 dadams
;; Added: icicle-top-level-prep.
;; Removed: icicle-reset-candidates-alist.
;; Do top-level stuff in icicle-minibuffer-setup, not in icicle-mode.
;; icicle-minibuffer-setup: Add icicle-top-level-prep to pre-command-hook.
;; icicle-mode: Remove icicle-top-level-prep from pre-command-hook.
;; 2007/03/07 dadams
;; icicle-cancel-Help-redirection: Use 0, not t, as frame arg to get-buffer-window.
;; 2007/03/02 dadams
;; icicle-bind-S-TAB-in-keymaps-from: Bound S-iso-lefttab also.
;; 2007/03/02 dadams
;; icicle-define-icicle-maps:
;; Bound S-iso-lefttab also to icicle-generic-S-tab. Thx to Shreevatsa R.
;; 2007/02/28 dadams
;; Added: icicle-reset-candidates-alist.
;; icicle-mode: Use icicle-reset-candidates-alist.
;; 2007/02/27 dadams
;; icicle-minibuffer-setup: Wait icicle-incremental-completion-delay before initial display.
;; 2007/02/24 dadams
;; Bound: delete, S-mouse-2 to icicle(-mouse)-remove-candidate,
;; C-S-RET, C-S-mouse-2 to icicle(-mouse)-candidate-alt-action,
;; S-delete to icicle-delete-candidate-object.
;; Don't remap icicle-kill-region(-wimpy) to delete key.
;; 2007/02/17 dadams
;; Added: icicle-bind-S-TAB-in-keymaps-from, icicle-bind-S-TAB-for-map-variable.
;; icicle-rebind-non-completion-keys:
;; Bind S-TAB to keymaps in icicle-keymaps-for-key-completion.
;; 2007/02/02 dadams
;; icicle-completing-p: Cache the value in variable icicle-completing-p.
;; icicle-minibuffer-setup: Reset icicle-completing-p to nil.
;; icicle-activate-mark: Use var, not function, icicle-completing-p, but after minibuf test.
;; 2007/01/23 dadams
;; icicle-(redefine|restore)-std-completion-fns:
;; Added icicle-read-face-name, icicle-face-valid-attribute-values.
;; icicle-define-icicle-maps, icicle-rebind-completion-maps:
;; Updated wrt toggles. Added icicle*-highlight-historical-candidates*.
;; icicle-bind-completion-keys: Added icicle-toggle-highlight-historical-candidates.
;; 2007/01/22 dadams
;; Renamed icicle-regions to icicle-region-alist (forgot occurrences here).
;; 2007/01/20 dadams
;; icicle-(redefine|restore)-std-completion-fns: Added icicle-display-completion-list.
;; 2007/01/15 dadams
;; Moved C-, binding from icicle-toggle-sorting to icicle-change-sort-order.
;; Moved icicle-toggle-alternative-sorting from M-, to C-M-,.
;; Bound icicle-change-alternative-sort-order to M-,.
;; Updated list of options in icicle-completion-help-string.
;; 2007/01/12 dadams
;; Removed: icicle-override-maps-w-minibuffer-map, icicle-restore-overriding-local-map.
;; Not used in minibuffer hooks.
;; Removed [pause] bindings from minibuffer maps.
;; Removed remap of yank in minibuffer maps.
;; No longer bind icicle-remove-Completions-window in minibuffer maps.
;; 2007/01/11 dadams
;; Renamed: icicle-define-icicle-mode-map to icicle-define-icicle-maps.
;; icicle-define-icicle-maps: Use icicle-menu-map. Don't recreate it.
;; Bound [pause] to icicle-switch-to/from-minibuffer in all minibuffer maps.
;; 2007/01/10 dadams
;; Added: icicle-override-maps-w-minibuffer-map, icicle-restore-overriding-local-map,
;; icicle-(rebind|restore)-non-completion-keys.
;; Added: icicle-rebind-global: This used to be called icicle-remap.
;; icicle-(remap|unmap): Different purpose and use now. Redefined to use remapping when
;; available (as was done before for self-insert-command).
;; icicle-mode:
;; Add, remove as minibuffer setup and exit hooks: icicle-override-maps-w-minibuffer-map,
;; icicle-restore-overriding-local-map.
;; Call icicle-(rebind|restore)-non-completion-keys.
;; icicle-define-icicle-mode-map:
;; Use icicle-remap where previously used substitute-key-definition for top-level cmds.
;; Moved to icicle-(rebind|restore)-non-completion-keys:
;; binding of Info commands in Info map and S-tab in all keymaps (to *-rebind-* only).
;; icicle-(bind|restore)-completion-keys: Use new icicle-(remap|unmap) where possible.
;; Use icicle-rebind-global and substitute-key-definition for keys defined in vanilla
;; completion maps.
;; 2007/01/06 dadams
;; icicle-mode: Update doc and bind icicle-toggle-~-for-home-dir to M-~.
;; 2007/01/01 dadams
;; Moved assq-delete-all to icicles-fn.el.
;; Require at runtime, not compile-time: icicles-var.el, icicles-fn.el.
;; 2006-12-31 dadams
;; icicle-define-icicle-mode-map: Delete icicle-mode entry from minor-mode-map-alist.
;; icicle-mode: Unbind icicle-mode-map when the mode is turned off.
;; Added assq-delete-all for Emacs 20.
;; Use current-global-map function, not global-map variable.
;; 2006/12/25 dadams
;; Bound icicle-candidate-set-truncate to M-$.
;; 2006/12/24 dadams
;; icicle-bind-completion-keys: transpose-yank(-pop) -> yank(-pop): typo.
;; Bound mouse-3 to icicle-Completions-mouse-3-menu in completion-list-mode-map.
;; 2006/12/22 dadams
;; Bound icicle-exchange-point-and-mark.
;; :group 'icicles -> :group 'Icicles-Miscellaneous.
;; 2006/12/17 dadams
;; Bound icicle(-mouse)-candidate-read-fn-invoke.
;; 2006/12/16 dadams
;; icicle-define-icicle-mode-map: Protect icicle-kmacro with fboundp.
;; 2006/12/12 dadams
;; Added icicle-customize-*-group, icicle-kill-buffer, icicle-delete-windows to I. menu.
;; Added + to multi-command menu items.
;; 2006/12/11 dadams
;; Added icicle-customize-apropos* and icicle-Info-* to menu-bar menus.
;; 2006/12/10 dadams
;; Updated user options list in icicle-completion-help-string.
;; Updated list of icicle-opt stuff used here.
;; 2006/12/06
;; icicle-select-minibuffer-contents:
;; Use icicle-minibuffer-prompt-end, not point-min. Thx to Erik Postma.
;; 2006/11/26 dadams
;; Added icicle-regions stuff.
;; 2006/11/24 dadams
;; icicle-redefine-standard-options: Treat icicle-kmacro-ring-max.
;; Bind icicle-kmacro to f5
;; Replaced icicle-select-window-or-frame by icicle-other-window-or-frame.
;; Removed binding of icicle-select-frame.
;; Do not require mb-depth+.el for Emacs 21 (do it only for Emacs 22).
;; 2006/11/23 dadams
;; Bound icicle-execute-named-keyboard-macro to C-x M-e.
;; 2006/11/18 dadams
;; Soft require mb-depth+.el instead of minibuf-depth.el.
;; 2006/11/17 dadams
;; Bind icicle-select-window-or-frame to whatever other-window(-or-frame) is bound to.
;; Bind icicle-select-frame to whatever other-frame is bound to.
;; 2006/11/09 dadams
;; Bind icicle-dispatch-C-^, not icicle-toggle-ignored-space-prefix, to C-^.
;; icicle-rebind-completion-maps: Updated doc string for icicle-dispatch-C-^.
;; 2006/11/05 dadams
;; Bound icicle-occur to C-c '. Added it to menu-bar menus.
;; 2006/10/18 dadams
;; icy-mode: Invoke icicle-define-icicle-mode-map unconditionally, not just first time.
;; 2006/10/16 dadams
;; icicle-define-icicle-mode-map: Try to avoid binding S-TAB to menu maps.
;; 2006/10/15 dadams
;; icicle-define-icicle-mode-map: Simplified, corrected binding of S-TAB for key completion.
;; Use a separate map for the menu bar.
;; Moved here from icicles-fn.el:
;; icicle-bind-isearch-keys, icicle-rebind-completion-maps,
;; icicle-(redefine|restore)-standard-(commands|options),
;; icicle-(redefine|restore)-std-completion-fns, icicle-(re|un)map,
;; icicle-(bind|restore)-completion-keys, icicle-minibuffer-setup,
;; icicle-cancel-*Help*-redirection, icicle-activate-mark,
;; icicle-run-icicle-(pre|post)-command-hook, icicle-set-calling-cmd,
;; icicle-undo-std-completion-faces icicle-update-ignored-extensions-regexp,
;; icicle-completing-p, icicle-restore-region-face.
;; Renamed: icicle-cancel-*Help*-redirection to icicle-cancel-Help-redirection.
;; Moved here from icicles-cmd.el: icicle-select-minibuffer-contents, next-history-element.
;; Moved to icicles-cmd.el: icicle-generic-S-tab.
;; Require icicles-opt.el.
;; Added eval-when-compile's and defvars to quite byte compiler.
;; 2006/09/23 dadams
;; icicle-define-icicle-mode-map: Corrected binding of icicle-yank-insert.
;; 2006/09/22 dadams
;; icicle-minibuffer-setup: Set this-command and last-command, for scrolling *Completions*.
;; 2006/09/18 dadams
;; icicle-mode: Picked up all global prefixes for S-TAB.
;; 2006/09/17 dadams
;; Added: icicle-generic-S-tab. Bound to S-TAB.
;; icicle-mode:
;; Bound icicle-complete-keys to prefix keys followed by S-TAB.
;; Added run-hooks for Emacs 22 version.
;; 2006/09/12 dadams
;; Bound icicle-switch-to/from-minibuffer to [pause].
;; 2006/08/27 dadams
;; Bound icicle-abort-minibuffer-input to what abort-recursive-edit is normally bound to.
;; And add it to Icicle menu.
;; 2006/08/23 dadams
;; Bound icicle-delete-window to what delete-window and delete-windows-for are normally
;; bound to.
;; Put use of Info-mode-map inside an eval-after-load.
;; 2006/08/18 dadams
;; Added icicle-Info-goto-node-cmd to icicle-mode doc string.
;; Substitute it for Info-goto-node binding.
;; 2006/08/13 dadams
;; Added icicle-Info-index-cmd to icicle-mode doc string.
;; Substitute it for Info-index binding.
;; 2006/08/04 dadams
;; Added icicle-plist to menus.
;; icicle-doc treats faces too now.
;; 2006/08/03 dadams
;; Bound icicle-insert-yank to what yank is normally bound to.
;; icicle-mode: Updated doc string.
;; 2006/07/29 dadams
;; icy-mode, icicle-define-icicle-mode-map: Added missing toggle commands.
;; 2006/07/22 dadams
;; Changed binding of C-c C-s for icicle-search to C-c ` for icicle-search-generic.
;; Removed: add-hooks for icicle-compilation-search - see icicles-cmd.el.
;; 2006/06/08 dadams
;; Converted global bindings in icicles-keys.el to icicle-mode-map bindings here.
;; Added f10 binding for icicle-execute-menu-command.
;; 2006/05/19 dadams
;; icicle-mode: (add-hook 'kill-emacs-hook 'icicle-control-reminder-prompt).
;; 2006/05/18 dadams
;; Change :init-value to nil, per new Emacs convention.
;; 2006/05/13 dadams
;; icicle-mode: Updated doc string.
;; 2006/05/10 dadams
;; icicle-define-icicle-mode-map: Added menu item Send Bug Report.
;; 2006/04/03 dadams
;; icicle-define-icicle-mode-map: Added icicle-toggle-(regexp-quote|incremental-completion).
;; 2006/03/16 dadams
;; icicle-mode: Turn on minibuffer-indicate-depth-mode (Emacs 22 only).
;; Added soft require of minibuf-depth.el for Emacs 22.
;; 2006/03/14 dadams
;; Do not use icicle-reset-icicle-completing-p as minibuffer-exit-hook.
;; 2006/03/07 dadams
;; Corrected menu items for icicle-doc (no name regexp input, just doc regexp).
;; 2006/03/05 dadams
;; Moved here from icicle-opt.el: icicle-mode, icicle-mode-hook.
;; Moved here from icicle-fn.el: icicle-mode-map.
;; Added: icicle-define-icicle-mode-map.
;;;(@* "CHANGE LOG FOR `icicles-opt.el'")
;;
;; 2022/06/26 dadams
;; icicle-default-value: Minor doc-string fixes.
;; 2022/05/22 dadams
;; Added icicle-characterp as an alias for Emacs < 23, since they've removed char-valid-p.
;; icicle-edmacro-parse-keys: Use icicle-characterp.
;; 2021/04/10 dadams
;; Added icicle-wrap-around-cycling-flag.
;; 2018/03/02 dadams
;; icicle-buffer-candidate-key-bindings: Added icicle-(keep|remove)-buffer-cands-for-indirect.
;; 2018/02/13 dadams
;; Removed (Emacs 23-25 only now): icicle-read-char-by-name-multi-completion-flag,
;; icicle-zap-to-char-candidates.
;; icicle-functions-to-redefine: Removed read-char-by-name (Emacs 23-25 only now).
;; icicle-top-level-key-bindings: Removed zap-to-char (Emacs 23-25 only now).
;; 2018/01/15 dadams
;; icicle-S-TAB-completion-methods-(alist|per-command): Added icicle-SPC-scatter-match.
;; icicle-S-TAB-completion-methods-(alist|per-command),
;; icicle-TAB-completion-methods(-per-command):
;; Mention in doc string that they don't apply to icicle-buffer and icicle-file etc.
;; 2017/12/10 dadams
;; icicle-buffer-prefix-arg-filtering: Updated doc string for modified case (-).
;; 2017/06/25 dadams
;; icicle-Completions-toggle-submenu: Added: icicle-toggle-completion-mode-keys.
;; icicle-completion-key-bindings: Bind icicle-toggle-completion-mode-keys to C-S-TAB.
;; icicle-kmacro-ring-max: Soft-require kmacro.el.
;; 2017/06/09 dadams
;; Added: icicle-file-search-dir-as-dired-flag.
;; 2017/05/22 dadams
;; icicle-buffer-candidate-key-bindings: Added C-x * +, C-x * - (keep/remove modified).
;; Require cl.el when compile (for incf).
;; 2017/02/17 dadams
;; icicle-top-level-key-bindings: Changed binding of icicle-command-abbrev to M-ESC C-x.
;; 2016/12/21 dadams
;; Added: icicle-ffap-max-region-size, icicle-ffap-guesser.
;; icicle-thing-at-point-functions: Use icicle-ffap-guesser, not ffap-guesser.
;; 2016/10/12 dadams
;; icicle-functions-to-redefine: Added completion-pcm--all-completions (fix for Emacs bug #24676).
;; 2016/06/12 dadams
;; Added: icicle-auto-complete-key-delay.
;; 2016/03/27 dadams
;; icicle-completion-key-bindings, icicle-minibuffer-key-bindings:
;; Changed icicle-clear-current-history from M-i to M-K.
;; icicle-keymaps-for-key-completion: Added icicle-toggle-map.
;; 2016/03/01 dadams
;; icicle-search-replace-common-match-flag: Qualify toggle keys as being for Icicles search.
;; 2016/02/28 dadams
;; Added: icicle-complete-keys-separator.
;; 2015/08/01 dadams
;; Added: icicle-hide-whitespace-before-comment-flag.
;; 2015/07/05 dadams
;; Added: icicle-completion-style-sets (Emacs 23+).
;; icicle-completion-key-bindings: Bind C-M-( to icicle-next-completion-style-set (Emacs 23+).
;; icicle-TAB-completion-methods: Reorder to put vanilla first, not basic.
;; 2015/05/29 dadams
;; icicle-keymaps-for-key-completion: Added apropos-mode-map and help-mode-map.
;; 2014/12/15 dadams
;; icicle-cand-preds-for-bookmark: Added icicle-bookmark-non-dir-file-p.
;; 2014/10/27 dadams
;; Added: icicle-read-char-by-name-multi-completion-flag.
;; 2014/10/26 dadams
;; icicle-functions-to-redefine: For Emacs 25+, use elisp-completion-at-point.
;; 2014/10/19 dadams
;; Added: icicle-Info-highlight-visited-nodes (replaces icicle-Info-visited-max-candidates).
;; Removed: icicle-Info-visited-max-candidates.
;; icicle-completion-key-bindings: Bind icicle-display-candidates-in-Completions to C-x C-M-l.
;; 2014/10/17 dadams
;; icicle-key-complete-keys-for-minibuffer: Added [ESC backtab].
;; 2014/09/24 dadams
;; icicle-custom-themes-update-flag: Added missing :type and :group.
;; 2014/09/15 dadams
;; icicle-top-level-key-bindings: Do not bind icicle-dired* if Dired+ is loaded (it has better).
;; 2014/08/29 dadams
;; icicle-file-skip-functions, icicle-cand-preds-for-file: Added icicle-file-elc-p.
;; 2014/08/22 dadams
;; icicle-cand-preds-for-file: Added icicle-file-desktop-p.
;; 2014/08/21 dadams
;; icicle-cand-preds-for-bookmark: Added icicle-bookmark-annotated-p.
;; 2014/08/19 dadams
;; icicle-cand-preds-for-bookmark: Updated list (removed 3, added 1 today).
;; 2014/08/17 dadams
;; Moved here from icicles-fn.el: icicle-color-defined-p.
;; 2014/08/11 dadams
;; icicle-cand-preds-for-(buffer|file): Added :group for buffers|files.
;; 2014/08/10 dadams
;; Added: icicle-cand-preds-all, icicle-cand-preds-for-bookmark, icicle-cand-preds-for-buffer,
;; icicle-cand-preds-for-color, icicle-cand-preds-for-face, icicle-cand-preds-for-file,
;; icicle-cand-preds-for-frame, icicle-cand-preds-for-misc, icicle-cand-preds-for-package,
;; icicle-cand-preds-for-symbol, icicle-cand-preds-for-variable,
;; icicle-cand-preds-for-window.
;; Moved icicle-image-file-p to icicles-fn.el.
;; icicle-top-level-key-bindings: Added icicle-describe-package.
;; 2014/07/27 dadams
;; Added: icicle-cmpl-include-cdabbrev-flag, icicle-cmpl-max-candidates-to-cycle.
;; icicle-functions-to-redefine: Added complete to the list of functions.
;; 2014/06/21 dadams
;; icicle-completion-key-bindings:
;; Added bindings for bmkp-(set|retrieve(-more)-icicle-search-hits-bookmark.
;; 2014/05/16 dadams
;; icicle-default-value: Updated doc string for change to t value behavior.
;; 2014/04/29 dadams
;; Added: icicle-image-preview-in-tooltip.
;; 2014/04/25 dadams
;; icicle-top-level-key-bindings:
;; Added binding for apropos-user-option (Emacs 24.4). Adjust condition for apropos-variable.
;; icicle-image-files-in-Completions: Typo in doc string: image-only, not image.
;; 2014/04/20 dadams
;; Moved here from icicles-opt.el (this is loaded first):
;; icicle-current-TAB-method, icicle-delete-candidate-object.
;; Removed commented out icicle-list-end-string (cleanup).
;; 2014/04/01 dadams
;; icicle-top-level-key-bindings: Bind icicle-bookmark-tagged(-other-window) to C-x (4) j t j.
;; 2014/03/08 dadams
;; icicle-Completions-toggle-submenu: Added icicle-toggle-icomplete-mode.
;; icicle-completion-key-bindings: Bind icicle-toggle-icomplete-mode to C-M-#.
;; 2014/03/06 dadams
;; Added: icicle-icomplete-mode-max-candidates, icicle-sorting-max-candidates.
;; 2014/02/24 dadams
;; icicle-complete-keys-ignored-prefix-keys: Init value is now ([menu-bar icicles]).
;; 2014/02/07 dadams
;; Added: icicle-complete-keys-ignored-prefix-keys.
;; 2014/02/05 dadams
;; icicle-S-TAB-completion-methods-per-command: Corrected :group - capitalized.
;; 2014/02/02 dadams
;; icicle-buffer-prefix-arg-filtering: Corrected example in doc string.
;; 2014/01/25 dadams
;; icicle-functions-to-redefine: Commented out bbdb-complete-name (obsolete in BBDB).
;; 2014/01/18 dadams
;; Renamed: icicle-keep-Completions-for-sole-dir-flag to icicle-keep-Completions-for-sole-dir.
;; icicle-keep-Completions-for-sole-dir: Added pop-up value. Default behavior now: do not pop up.
;; 2014/01/05 dadams
;; icicle-completion-key-bindings: Added icicle-recomplete-from-original-domain == C-x C-0.
;; 2013/12/24 dadams
;; icicle-top-level-key-bindings: Added icicle-load-library (but not bound to a key, by default).
;; 2013/12/09 dadams
;; Renamed: icicle-buffer-skip-hook to icicle-buffer-skip-functions,
;; icicle-find-file-of-content-skip-hook to icicle-file-skip-functions.
;; 2013/12/01 dadams
;; Added: icicle-image-file-p.
;; icicle-find-file-of-content-skip-hook: Use icicle-image-file-p, not nil, as default.
;; 2013/10/29 dadams
;; icicle-top-level-key-bindings: Remap bmkp-bookmark-set-confirm-overwrite to icicle-bookmark-cmd
;; 2013/10/27 dadams
;; Added: icicle-custom-themes, icicle-custom-themes-accumulate-flag,
;; icicle-custom-themes-update-flag. (All for Emacs 24+ only.)
;; 2013/09/02 dadams
;; icicle-top-level-key-bindings:
;; Reverted change of 2013/03/18: icicle-dabbrev-completion is for Emacs 24 too now.
;; 2013/08/03 dadams
;; icicle-file-sort: Updated doc string per renamings.
;; 2013/08/02 dadams
;; Added: icicle-find-file-expand-directory-flag.
;; icicle-Completions-toggle-submenu, icicle-completion-key-bindings:
;; Added binding for icicle-toggle-expand-directory.
;; icicle-top-level-key-bindings: Bind C-M-/ to icicle-dispatch-C-M-/.
;; icicle-completion-key-bindings: Do not bind C-M-/ (overridden by icicle-mode binding anyway).
;; 2013/07/09 dadams
;; icicle-top-level-key-bindings: Bind S-f10 to icicle-complete-menu-bar (new).
;; 2013/07/04 dadams
;; icicle-buffer-prefix-arg-filtering: Typo: Removed ' from const value.
;; icicle-search-highlight-threshold, icicle(-alternative)-sort-comparer,
;; icicle(-no)-buffer-match-regexp, icicle-buffer-predicate, icicle-buffer-prefix-arg-filtering,
;; icicle-buffer-sort, icicle-comint-dynamic-complete-replacements, icicle-file-no-match-regexp,
;; icicle-file-predicate, icicle-file-sort, icicle-max-candidates, icicle-buffer-configs,
;; icicle-pp-eval-expression-print-(length|level), icicle-recenter,
;; icicle-thing-at-point-functions, icicle-zap-to-char-candidates:
;; Added :value.
;; icicle-alternative-sort-comparer: Corrected - needs same :type as icicle-sort-comparer.
;; 2013/06/22 dadams
;; Renamed and reversed: *-remove-Completions-when-* to icicle-keep-Completions-for-sole-dir-flag.
;; 2013/06/20 dadams
;; Added: icicle-remove-Completions-when-sole-dir-flag.
;; 2013/06/19 dadams
;; icicle-WYSIWYG-Completions-flag: Updated doc string - fonts too now.
;; 2013/06/18 dadams
;; icicle-completion-key-bindings: Added C-S-pause binding for icicle-toggle-WYSIWYG-Completions.
;; icicle-Completions-toggle-submenu: Moved icicle-toggle-WYSIWYG-Completions.
;; 2013/05/13 dadams
;; Renamed icicle-change-sort-order-completion-flag to icicle-change-sort-order-completion.
;; icicle-change-sort-order-completion: Can now be an integer.
;; icicle-Completions-sorting-submenu: Updated to reflect new icicle-change-sort-order-completion.
;; 2013/04/22 dadams
;; Reverted the change of 2012/02/28. Emacs does not DTRT for push if require only when compile.
;; Must use eval-and-compile to require cl.el, not eval-when-compile, for Emacs 20.
;; 2013/04/18 dadams
;; Added: icicle-buffer-candidate-key-bindings, icicle-buffer-prefix-arg-filtering.
;; *-completion-key-bindings, *-completion-list-key-bindings, *-minibuffer-key-bindings:
;; Removed C-? binding - use only M-?.
;; 2013/04/03 dadams
;; icicle-comint-dynamic-complete-replacements: Removed entries for ess-complete-*.
;; 2013/04/01 dadams
;; icicle-minibuffer-key-bindings: Added icicle-top-level binding (C-M-T).
;; 2013/03/18 dadams
;; icicle-top-level-key-bindings: Temporarily removed icicle-dabbrev-completion for Emacs 24+.
;; 2013/02/26 dadams
;; Added (put 'icicle-kbd 'pure t).
;; 2013/02/04 dadams
;; Removed all autoload cookies.
;; 2013/02/04 dadams
;; Removed autoload cookies for icicle-(minibuffer|completion(-list))-key-bindings
;; 2013/02/03 dadams
;; Added: icicle-completion-list-key-bindings, icicle-isearch-history-insert-keys,
;; icicle-minibuffer-key-bindings.
;; Removed: icicle-previous-candidate-keys.
;; icicle-apropos-complete-keys, icicle-search-from-isearch-keys: use backtab for Emacs 24+.
;; icicle-comint-dynamic-complete-replacements: Fixed :type - the first need not be a symbol.
;; Moved icicle-key-definition before first use, which is now icicle-completion-key-bindings.
;; icicle-(top-level|completion)-key-bindings: Fixed :type to be > Emacs 21, not > Emacs 20.
;; icicle-isearch-complete-keys: Removed M-o from the default value and adapted doc string.
;; 2013/01/26 dadams
;; icicle-completion-key-bindings: Added M-r binding for icicle-roundup.
;; 2013/01/18 dadams
;; No longer require icicles-face.el, since now need only hexrgb.el (see next).
;; icicle-region-background: Use hexrgb-increment*, not icicle-increment-*.
;; 2012/12/21 dadams
;; Added: icicle-buffer-skip-hook, icicle-find-file-of-content-skip-hook. Thx to C. Schmidt.
;; 2012/12/20 dadams
;; Added: icicle-TAB/S-TAB-only-completes-flag.
;; 2012/12/02 dadams
;; Removed autoload cookie from icicle-completion-key-bindings.
;; 2012/12/01 dadams
;; Added: icicle-completion-key-bindings.
;; Moved here from icicles-mac.el: icicle-kbd, icicle-edmacro-parse-keys, icicle-read-kbd-macro.
;; icicle-kbd: Now a function, not a macro.
;; 2012/11/28 dadams
;; Removed: icicle-transform-function - moved to icicles-var.el.
;; 2012/11/27 dadams
;; icicle-default-in-prompt-format-function:
;; Removed ": " from default value. Prepend instead of replace, now.
;; icicle-top-level-key-bindings: Added icicle-apropos-value.
;; 2012/11/26 dadams
;; Added: icicle-default-in-prompt-format-function.
;; 2012/11/21 dadams
;; icicle-image-files-in-Completions:
;; Do not test, here, whether display is graphic (for Emacs daemon). Thx to Christopher Schmidt.
;; 2012/11/18 dadams
;; icicle-default-value: Updated doc string to reflect adding def to prompt for value t.
;; 2012/11/08 dadams
;; icicle-widgets-to-redefine: Predicate makes sure it is also a symbol.
;; 2012/11/03 dadams
;; icicle-widgets-to-redefine: Fix to not include nil.
;; 2012/11/02 dadams
;; icicle-widgets-to-redefine: Include color widget only if can load wid-edit+.el.
;; icicle-functions-to-redefine: Added bbdb-complete-mail.
;; 2012/10/27 dadams
;; Added: icicle-show-annotations-flag.
;; 2012/10/26 dadams
;; icicle-search-replace-whole-candidate-flag: Correct key in doc string: M-_, not C-,.
;; 2012/10/21 dadams
;; Added: icicle-buffer-include-cached-files-nflag, icicle-buffer-include-recent-files-nflag.
;; 2012/10/10 dadams
;; icicle-shell-command-candidates-cache:
;; Removed autoload cookie due to default value dependency. Thx to Michael Heerdegen.
;; 2012/10/05 dadams
;; Added: icicle-kill-visited-buffers-flag.
;; 2012/10/02 dadams
;; icicle-list-join-string:
;; Make display prop cover whole string and display \n rather than just hide ^G part.
;; Important for cursor movement: join string acts like one char.
;; 2012/09/08 dadams
;; Removed: icicle-ignore-space-prefix-flag.
;; icicle-buffer-ignore-space-prefix-flag: Updated doc to be self-contained.
;; 2012/08/26 dadams
;; icicle-thing-at-point:
;; If SYNTAX-TABLE is nil, then do not use with-syntax-table. Removed SYNTAX-TABLE args.
;; 2012/08/21 dadams
;; Call tap-put-thing-at-point-props after load thingatpt+.el.
;; 2012/08/18 dadams
;; Added: icicle-thing-at-point.
;; Invoke tap-define-aliases-wo-prefix if thingatpt+.el is loaded.
;; thing-at-point -> icicle-thing-at-point.
;; 2012/08/06 dadams
;; icicle-functions-to-redefine: Updated doc string for new name prefix icicle-ORIG-.
;; 2012/08/05 dadams
;; icicle-widgets-to-redefine: Added color to the default value.
;; 2012/08/03 dadams
;; Added: icicle-key-complete-keys-for-minibuffer.
;; icicle-key-complete-keys: Updated default value, since Emacs bug #1281 was fixed.
;; 2012/07/31 dadams
;; Added: icicle-widgets-to-redefine, icicle-widgetp.
;; 2012/07/24 dadams
;; icicle-TAB-completion-methods-per-command: Fix bug when delete entries: set them to nil first.
;; icicle-buffer-ignore-space-prefix-flag: Updated doc string - C-u M-_ now toggles this.
;; 2012/07/21 dadams
;; icicle-comint-dynamic-complete-replacements:
;; Added entry for pcomplete and comint/shell file-name completion. Thx to C. Schmidt.
;; 2012/07/16 dadams
;; icicle-comint-dynamic-complete-replacements:
;; Added (shell-command-completion 'icicle-shell-dynamic-complete-command).
;; 2012/07/13 dadams
;; icicle-network-drive-means-remote-flag: Update doc string for toggle, C-x :.
;; 2012/07/08 dadams
;; icicle-functions-to-redefine: Updated comint stuff for Emacs 24: comint-completion-at-point.
;; Thx to Christopher Schmidt and Michael Heerdegen.
;; 2012/07/07 dadams
;; Added: icicle-Info-visited-max-candidates.
;; Added reminder about icicle-(increment|toggle)-option to doc strings for boolean|integer|number.
;; 2012/07/05 dadams
;; Removed #' from lambdas.
;; 2012/06/29 dadams
;; icicle-inhibit-advice-functions: Exclude commands that are not redefined in certain releases.
;; icicle-command-abbrev-alist: Added :tag strings.
;; 2012/06/09 dadams
;; icicle-show-Completions-help-flag: Do not defvaralias it to completion-show-help. Updated doc.
;; 2012/05/07 dadams
;; Applied renaming of icicle-search-dired-marked to icicle-search-dired-marked-recursive.
;; 2012/04/03 dadams
;; icicle-top-level-key-bindings: Protect icicle-complete-thesaurus-entry binding with fboundp.
;; icicle-top-level-when-sole-completion-delay: Increased default value from 0.7 to 1.0.
;; 2012/04/01 dadams
;; Moved to icicle-top-level-key-bindings from icicle-functions-to-redefine:
;; customize-*, dabbrev-completion, repeat-complex-command.
;; icicle-top-level-key-bindings: Added replacements for apropos* commands.
;; 2012/02/28 dadams
;; for Emacs 20: Use eval-when-compile, not eval-and-compile, to require cl.el.
;; 2012/02/26 dadams
;; icicle-top-level-key-bindings: Update to reflect Bookmark+ changes (bindings).
;; icicle-touche-pas-aux-menus-flag: Clarify doc string.
;; 2012/02/11 dadams
;; ** NOTE ** Incompatible renamings and value changes. Update any corresponding customizations.
;; Renamed: icicle-expand-input-to-common-match-flag to icicle-expand-input-to-common-match,
;; icicle-incremental-completion-flag to icicle-incremental-completion.
;; Added: icicle-expand-input-to-common-match-alt.
;; icicle-expand-input-to-common-match: Values are now 0 to 4 (split prefix and sole-match).
;; Doc strings: applied renamings and key changes.
;; 2012/01/31 dadams
;; Added: icicle-doremi-submenu. Added it to icicle-Completions-mouse-3-menu-entries.
;; icicle-Completions-toggle-submenu:
;; Added: remote-file-testing, ignoring-(space-prefix|comments), completions-format,
;; multi-completions, search-complementing-domain. Rearranged.
;; icicle-*-submenu: Added some missing key shortcuts.
;; 2012/01/17 dadams
;; Added: icicle-network-drive-means-remote-flag.
;; 2012/01/14 dadams
;; Added: icicle-zap-to-char-candidates.
;; icicle-top-level-key-bindings: Added entry for icicle-zap-to-char (M-z).
;; 2012/01/13 dadams
;; icicle-prefix-complete-keys: Added [?\t].
;; 2012/01/08 dadams
;; icicle-top-level-key-bindings: Added remappings to icicle-yank-pop-commands.
;; Typo: bmkp-autonamed-this-buffer-jump (name).
;; icicle-files-ido-like-flag: Mention in doc string that it has no effect for Emacs 20.
;; 2012/01/02 dadams
;; icicle-bind-top-level-commands:
;; Must be in Icicle mode, so icicle-mode-map is defined. Otherwise you cannot customize
;; icicle-top-level-key-bindings outside Icicle mode.
;; 2011/12/28 dadams
;; Removed obsolete option icicle-cycle-into-subdirs-flag and all mention of it.
;; 2011/12/24 dadams
;; Added: icicle-Completions-max-columns.
;; icicle-recenter: Changed the :value setting to -4 from nil.
;; 2011/12/14 dadams
;; icicle-top-level-key-bindings: Added icicle-bookmark-image(-other-window).
;; 2011/12/06 dadams
;; icicle-default-value: Updated doc wrt new behavior for icicle-read-from-minibuffer.
;; 2011/11/01 dadams
;; icicle-top-level-key-bindings: Added: icicle-bookmark-(autonamed(-this-buffer)|autofile|
;; bookmark-file|temporary)(-other-window).
;; 2011/10/10 dadams
;; Removed use of icicle-kbd in option values, because byte-compile of defcustom does not eval.
;; Removed eval-when-compile to load icicles-mac.
;; 2011/10/08 dadams
;; Added: icicle-candidate-(action|help)-keys.
;; eval-when-compile icicles-mac.el.
;; icicle-(apropos|prefix)-complete(-no-display)-keys, icicle-key-complete-keys,
;; icicle-apropos-cycle-(next|previous)((-alt)-action|help)-keys, icicle-isearch-complete-keys,
;; icicle-modal-cycle-(down|up)((-alt)-action|help)-keys, icicle-completing-read+insert-keys
;; icicle-previous-candidate-keys, icicle-read+insert-file-name-keys,
;; icicle-search-from-isearch-keys, icicle-top-level-key-bindings, icicle-word-completion-keys:
;; Use icicle-kbd (and do not use kbd).
;; 2011/10/04 dadams
;; Added: icicle-search-key-prefix.
;; 2011/10/02 dadams
;; icicle-functions-to-redefine: Added read-char-by-name to default value.
;; 2011/09/18 dadams
;; icicle-search-highlight-threshold: Added possibility of a t value.
;; icicle-image-files-in-Completions: Removed quote for image-only value.
;; 2011/09/05 dadams
;; Added: icicle-hide-non-matching-lines-flag.
;; icicle-Completions-toggle-submenu: Added icicle-toggle-hiding-non-matching-lines to menu.
;; icicle-hide-common-match-in-Completions-flag: Updated doc string (new toggle key).
;; 2011/09/04 dadams
;; Renamed: icicle-complete-keys-self-insert-flag to icicle-complete-keys-self-insert-ranges.
;; Define it only for Emacs 22+.
;; Made it an alist of char ranges, for Emacs 23+.
;; 2011/09/02 dadams
;; icicle-functions-to-redefine: Added: Info-goto-node, Info-index, Info-menu.
;; 2011/08/30 dadams
;; icicle-thing-at-point-functions:
;; symbol-name-nearest-point -> icicle-thing-at-point-functions
;; region-or-word-nearest-point -> word-nearest-point
;; 2011/08/13 dadams
;; icicle-top-level-key-bindings: Map bmkp-autofile-set to icicle-bookmark-a-file.
;; 2011/08/07 dadams
;; icicle-top-level-key-bindings: Bind icicle-find-file-tagged(-other-window) to C-x j t a a.
;; 2011/07/30 dadams
;; Moved icicle-increment-color-value to icicles-face.el.
;; Require icicles-face.el only if hexrgb.el has been loaded.
;; 2011/07/27 dadams
;; icicle-completions-format, icicle-search-whole-word-flag: Updated doc string.
;; 2011/07/26 dadams
;; Removed: icicle-list-end-string (no longer needed). Thx to Michael Heerdegen.
;; 2011/07/06 dadams
;; Renamed icicle-Completions-frame-at-right-flag to icicle-move-Completions-frame.
;; icicle-move-Completions-frame: Allow for moving frame to the left also.
;; 2011/06/03 dadams
;; Renamed icicle-help-in-mode-line-flag to icicle-help-in-mode-line-delay and changed to 5 secs.
;; 2011/05/24 dadams
;; icicle-functions-to-redefine: Removed (dired-)read-shell-command - turned off by default now.
;; 2011/05/22 dadams
;; icicle-init-value-flag/icicle-default-value: Added 3rd arg for make-obsolete-variable.
;; 2011/05/14 dadams
;; Removed: icicle-thing-types. Better to get the list dynamically.
;; 2011/05/13 dadams
;; Added: icicle-thing-types.
;; 2011/05/07 dadams
;; Added: icicle-ignore-comments-flag.
;; 2011/05/03 dadams
;; Added: icicle-highlight-saved-candidates-flag.
;; icicle-Completions-toggle-submenu: Added icicle-toggle-highlight-saved-candidates to menu.
;; 2011/04/26 dadams
;; icicle-top-level-key-bindings:
;; Added icicle-(un)tag-a-file, icicle-find-file-(all|some)-tags-*.
;; If you have customized it, re-customize it from scratch or you will miss the new bindings.
;; 2011/04/02 dadams
;; NOTE: IF you customized icicle-top-level-key-bindings and you use Bookmark+, then you will want
;; to REMOVE THAT CUSTOMIZATION AND CUSTOMIZE AGAIN. Otherwise, you will miss Icicles
;; multi-command versions of the new Bookmark+ commands.
;; icicle-top-level-key-bindings:
;; Added icicle-bookmark-file-this-dir-((all|some)-tags(-regexp))(-other-window).
;; 2011/03/31 dadams
;; Renamed icicle-target-window-recenter-amount to icicle-recenter & moved from icicles-var.el.
;; 2011/03/26 dadams
;; icicle-top-level-key-bindings:
;; Added: bmkp-file-(all|some)-tags(-regexp)-jump(-other-window).
;; Fixed typos: bmkp-(all|some)-tags-regexp-jump (forgot -regexp). Use fboundp, not featurep.
;; 2011/03/22 dadams
;; Added autoload cookies for defconsts.
;; 2011/02/26 dadams
;; Added: icicle-Completions-(misc|save/retrieve|sets|sorting|this-candidate|toggle)-submenu,
;; icicle-Completions-mouse-3-menu-entries.
;; 2011/02/22 dadams
;; Added: icicle-image-files-in-Completions, icicle-functions-to-redefine.
;; Removed: icicle-redefine-standard-commands-flag.
;; 2011/01/17 dadams
;; Added runtime require of cl.el for Emacs 20. (Emacs 20 does not handle defcustom well.)
;; 2011/01/12 dadams
;; Changed default value of icicle-Completions-text-scale-decrease from 0.66 to 0.75.
;; 2011/01/02 dadams
;; icicle-region-background:
;; Use frame param background-mode, not frame-background-mode. Thx to Le Wang.
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/12/18 dadams
;; Added some missing autoload cookies.
;; 2010/12/17 dadams
;; icicle-thing-at-point-functions: Added to default: list-nearest-point-as-string (1,2,3).
;; 2010/11/12 dadams
;; Added: icicle-(S-)TAB-completion-methods-per-command.
;; 2010/11/10 dadams
;; icicle-top-level-key-bindings: In :set, protect icicle-mode-map with boundp.
;; 2010/10/25 dadams
;; Removed: icicle-search-context-match-predicate (was not used).
;; icicle-(buffer|file)-predicate: Mention that they (now) apply after matching.
;; 2010/10/24 dadams
;; icicle-S-TAB-completion-methods-alist: Added ("Jaro-Winkler" . fuzzy-match).
;; 2010/10/09 dadams
;; Corrections per move to emphasize modal cycling:
;; Renamed: icicle-cycling-respects-completion-mode to icicle-default-cycling-mode.
;; icicle-default-cycling-mode: Default value is prefix, not nil. New value descriptions and doc.
;; icicle-modal-cycle-*-keys: Put back wheel keys. Removed mention of *-cycling-respects-*-mode.
;; icicle-prefix-cycle-*-keys: Use end/home, not down/up as default values.
;; No mention of being used also for *Completions*.
;; icicle-act-before-cycle-flag: Updated doc string.
;; 2010/10/08 dadams
;; icicle-modal-cycle-*-keys: Removed mouse-wheel keys - they are added systematically now.
;; 2010/10/07 dadams
;; icicle-TAB-completion-methods: Removed :set, :initialize (handle it differently now).
;; 2010/10/06 dadams
;; icicle-TAB-completion-methods: Added :set and :initialize. Thx to Michael Heerdegen.
;; icicle-modal-cycle-(up|down)((-alt)-action|-help)-keys: Bound mouse wheel also (Emacs 22+).
;; 2010/07/17 dadams
;; icicle-top-level-key-bindings: Added *url-jump(-other-window).
;; 2010/06/18 dadams
;; Renamed: bookmarkp-* to bmkp-*.
;; 2010/06/09 dadams
;; icicle-isearch-complete-keys:
;; Added [escape tab] to default binding (isearch bizarrie). Added C-M-TAB for all platforms.
;; 2010/06/08 dadams
;; icicle-bookmark-refresh-cache-flag: Changed the default value to t to avoid confusion.
;; 2010/06/05 dadams
;; Set icicle-top-level-when-sole-completion-delay to 0.7 from 0.0.
;; 2010/06/04 dadams
;; Added: icicle-(buffers|files)-ido-like-flag, icicle-max-candidates.
;; icicle-ignored-directories: Protect default value with boundp.
;; icicle-type-actions-alist: Added (maximize|restore|toggle-max)-frame(-horizontally|-vertically).
;; 2010/05/30 dadams
;; Added: icicle-ignored-directories.
;; 2010/05/15 dadams
;; icicle-top-level-key-bindings: Updated Icicles versions of bookmark jump commands.
;; icicle-keymaps-for-key-completion: Added bookmarkp-jump-map bookmarkp-jump-other-window-map.
;; 2010/04/30 dadams
;; Added: icicle-no-match-hook.
;; 2010/04/09 dadams
;; Remap find-file-read-only(-other-window) to icicle-find-file-read-only(-other-window).
;; 2010/04/02 dadams
;; Removed: icicle-region-alist, icicle-region-auto-open-files-flag,
;; icicle-region-bookmarks-flag, icicle-regions-name-length-max.
;; icicle-top-level-key-bindings: Removed bookmarkp-bookmark-list-jump-other-window.
;; bookmarkp*: Use condition (featurep 'bookmark+).
;; 2010/03/31 dadams
;; Removed extra code redefining some bookmark commands.
;; 2010/03/28 dadams
;; Removed: icicle-region-alist, icicle-region-auto-open-files-flag,
;; icicle-region-bookmarks-flag, icicle-regions-name-length-max.
;; 2010/03/14 dadams
;; Added: icicle-bookmark-refresh-cache-flag.
;; 2010/03/13 dadams
;; Renamed icicle-add-buffer-name-flag to icicle-show-multi-completion-flag. Doc string.
;; 2010/03/09 dadams
;; icicle-color-themes: Initialize to (). Do real init in cmd icicle-color-theme.
;; 2010/03/03 dadams
;; Renamed: icicle-sort-function to icicle-sort-comparer,
;; icicle-sort-functions-alist to icicle-sort-orders-alist
;; icicle-alternative-sort-function to icicle-alternative-sort-comparer.
;; Redefined to allow multi-sorting: icicle-sort-comparer, icicle-sort-orders-alist.
;; 2010/02/17 dadams
;; Moved icicle-redefined-functions here from icicles-var.el
;; and renamed to icicle-inhibit-advice-functions.
;; Moved to icicles-face.el: icicle-increment-color-(hue|saturation).
;; So now require icicles-face.el.
;; Corrected alphabetical order.
;; 2010/02/13 dadams
;; icicle-top-level-key-bindings: Bound icicle-bookmark-*-jump-other-window.
;; 2010/01/24 dadams
;; icicle-thing-at-point-functions:
;; Use region-or-word-nearest-point, not word-nearest-point. Change order.
;; 2010/01/17 dadams
;; icicle-top-level-key-bindings: Added Icicles remappings for bookmarkp-*-jump-other-*.
;; 2009/12/25 dadams
;; icicle-top-level-key-bindings: Bind ESC-M-x to lacarte-execute-command.
;; 2009/12/13 dadams
;; icicle-top-level-key-bindings: Map dired(-other-window) to icicle-dired(-other-window).
;; 2009/12/07 dadams
;; icicle-guess-commands-in-path: Changed default value to nil.
;; 2009/11/27 dadams
;; Added: icicle-swank-prefix-length, icicle-swank-timeout.
;; icicle-TAB-completion-methods: Treat swank method also.
;; 2009/11/24 dadams
;; Added: icicle-completions-format.
;; icicle-color-themes: Fix: delete singleton list with string, not symbol bury-buffer.
;; 2009/11/22 dadams
;; icicle-color-themes: Use color-theme-initialize instead of load-library, to load themes.
;; 2009/11/21 dadams
;; icicle-color-themes: (load-library "color-theme-library"), for color theme version 6.6.0.
;; 2009/10/25 dadams
;; Added: icicle-TAB-completion-methods.
;; Removed: icicle-fuzzy-completion-flag, icicle-prefix-completion-is-basic-flag.
;; Renamed: icicle-apropos-match-fns-alist to icicle-S-TAB-completion-methods-alist.
;; 2009/10/12 dadams
;; icicle-top-level-key-bindings: Added bindings for icicle-bookmark(-other-window).
;; icicle-prefix-completion-is-basic-flag: Make it a constant for pre-Emacs 23.
;; 2009/10/06 dadams
;; icicle-keymaps-for-key-completion: Added bookmark-bmenu-mode-map to default value.
;; icicle-sort-functions-alist: Use a separate defcustom for Emacs 20, since no :type alist.
;; 2009/09/25 dadams
;; Added: icicle-prefix-completion-is-basic-flag.
;; Changed default value of:
;; icicle-candidate-width-factor from 70 to 80
;; icicle-Completions-text-scale-decrease from 0.8 to 0.66.
;; 2009/09/16 dadams
;; icicle-top-level-key-bindings: Added remap for icicle-insert-buffer.
;; 2009/09/05 dadams
;; icicle-keymaps-for-key-completion: Added facemenu-keymap.
;; icicle-search-replace-common-match-flag: Fixed doc string: C-M-| -> M-;.
;; icicle-expand-input-to-common-match-flag: Fixed doc string: C-| -> C-;.
;; 2009/09/02 dadams
;; Added: icicle-region-bookmarks-flag, icicle-top-level-when-sole-completion-delay.
;; icicle-region-alist: Updated doc string. Added :group Icicles-Searching.
;; 2009/08/19 dadams
;; icicle-bookmark-name-length-max:
;; Changed default value from 40 to 70. It is now the total name length. Updated doc.
;; 2009/08/01 dadams
;; Added: icicle-menu-items-to-history-flag.
;; 2009/07/29 dadams
;; Added: icicle-populate-interactive-history-flag.
;; 2009/06/17 dadams
;; Added: icicle-Completions-text-scale-decrease.
;; 2009/05/20 dadams
;; icicle-keymaps-for-key-completion: Added prefix-key maps senator-mode-map,
;; srecode-mode-map, jde-mode-map, jde-jdb-mode-map. Thx to Daniel Clemente.
;; 2009/05/17 dadams
;; icicle-type-actions-alist: Updated to reflect thumb-frm.el name changes.
;; 2009/05/10 dadams
;; icicle-list-join-string: Don't set display property for Emacs 21 (Emacs bug).
;; 2009/05/09 dadams
;; Added: icicle-dot-string, icicle-dot-show-regexp-flag, icicle-anychar-regexp,
;; 2009/05/07 dadams
;; icicle-list-join-string: Use copy-sequence in default value, so users see original sexp.
;; 2009/05/02 dadams
;; Added: icicle-alternative-actions-alist.
;; 2009/05/01 dadams
;; Added function to icicle-type-actions-alist: icicle-shell-command-on-file.
;; 2009/04/26 dadams
;; Added: icicle-type-actions-alist, icicle-use-anything-candidates-flag.
;; 2009/04/20 dadams
;; Added: icicle-(prefix|apropos)-cycle-(next|previous)-alt-action-keys,
;; icicle-modal-cycle-(down|up)-alt-action-keys.
;; 2009/04/18 dadams
;; Soft-require hexrgb.el unconditionally, not just when there is a window-system.
;; icicle-region-background: If frame background is unspecified, consider it white.
;; Don't use frame background unless it is a valid color name.
;; Use region background if cannot compute saturation.
;; 2009/04/16 dadams
;; Added: icicle-(prefix|apropos)-cycle-(next|previous)-help-keys.
;; 2009/04/15 dadams
;; Added: icicle-modal-cycle-(up|down)-help-keys.
;; 2009/04/05 dadams
;; Added: icicle-help-in-mode-line-flag.
;; 2009/03/10 dadams
;; Moved here from icicles-fn.el: icicle-shell-command-candidates.
;; Moved here from icicles-var.el: icicle-shell-command-candidates.
;; Renamed: icicle-shell-command-candidates (fn) to icicle-compute-shell-command-candidates,
;; icicle-shell-command-candidates (var) to icicle-shell-command-candidates-cache,
;; icicle-guess-cmds-in-path-flag to icicle-guess-commands-in-path.
;; icicle-guess-commands-in-path: Boolean -> choice. Default is now first-use.
;; icicle-compute-shell-command-candidates: Don't update cache variable here.
;; icicle-shell-command-candidates-cache: Initialize per icicle-guess-commands-in-path.
;; 2009/03/08 dadams
;; Added: icicle-quote-shell-file-name-flag.
;; 2009/03/01 dadams
;; Added: icicle-completing-read+insert-keys, icicle-read+insert-file-name-keys.
;; Removed: icicle-complete-on-demand-keys.
;; 2009/02/20 dadams
;; Added: icicle-complete-on-demand-keys (not yet used).
;; Renamed: icicle-dired-guess-all-shell-cmds-flag to icicle-guess-cmds-in-path-flag.
;; 2009/01/25 dadams
;; Added: icicle-dired-guess-all-shell-cmds-flag.
;; 2009/01/17 dadams
;; Added: icicle-levenshtein-distance.
;; icicle-apropos-match-fns-alist: Added icicle-levenshtein(-strict)-match.
;; 2009/01/05 dadams
;; Added ess-complete-* to icicle-comint-dynamic-complete-replacements.
;; 2009/01/01 dadams
;; Added: icicle-comint-dynamic-complete-replacements.
;; 2008/12/30 dadams
;; Moved icicle-remap here from icicles-mode.el.
;; 2008/12/06 dadams
;; icicle-incremental-completion-flag: Changed :type to choice from boolean.
;; 2008/12/02 dadams
;; Removed: icicle-file-ignore-space-prefix-flag.
;; 2008/11/28 dadams
;; Moved here from icicles-var.el: icicle-apropos-match-fns-alist.
;; 2008/11/14 dadams
;; Added: icicle-hide-common-match-in-Completions-flag.
;; 2008/11/04 dadams
;; Removed: icicle-generic-S-tab-keys.
;; Added (split icicle-generic-S-tab-keys in 4):
;; icicle-apropos-complete-keys, icicle-key-complete-keys, icicle-previous-candidate-keys,
;; icicle-search-from-isearch-keys.
;; Added: icicle-complete-key-anyway-flag.
;; 2008/11/03 dadams
;; Applied renamings from icicles-cmd.el.
;; 2008/10/26 dadams
;; Added: icicle-file-*.
;; 2008/10/18 dadams
;; Added: icicle-customize-save-variable-function.
;; 2008/10/17 dadams
;; Added: icicle-bookmark-name-length-max.
;; icicle-top-level-key-bindings: Remapped bookmark-set to icicle-bookmark-cmd.
;; 2008/10/11 dadams
;; icicle-highlight-input-completion-failure: Updated doc string.
;; 2008/10/10 dadams
;; Added: icicle-(apropos|prefix)-cycle-(next|previous)-action-keys,
;; icicle-modal-cycle-(down|up)-action-keys.
;; icicle-cycling-respects-completion-mode-flag:
;; Renamed to icicle-cycling-respects-completion-mode.
;; It's now a choice of nil, t, apropos, prefix. Thx to Andrey Zhdanov.
;; 2008/09/30 dadams
;; icicle-highlight-input-completion-failure: Changed default value to implicit-strict.
;; 2008/09/13 dadams
;; Added: icicle-filesets-as-saved-completion-sets-flag.
;; 2008/08/28 dadams
;; icicle-top-level-key-bindings:
;; Renamed alacarte-execute-menu-command to lacarte-execute-menu-command.
;; 2008/08/22 dadams
;; Removed: icicle-Completions-window-default-width (obsolete).
;; 2008/08/21 dadams
;; icicle-top-level-key-bindings:
;; Replace icicle-find-file(-other-window) with icicle-file(-other-window).
;; icicle-generic-S-tab-keys: Mention bug workaround in doc string. Thx to Kevin Rodgers.
;; 2008/08/20 dadams
;; Added: icicle-inhibit-ding-flag.
;; 2008/08/12 dadams
;; icicle-top-level-key-bindings:
;; Remap set-mark-command (C-SPC) and pop-global-mark (C-x C-SPC).
;; 2008/08/11 dadams
;; icicle-key-definition, icicle-top-level-key-bindings:
;; Change :match-alternatives to (symbolp) from (commandp).
;; icicle-top-level-key-bindings: Added condition for minibuffer-keyboard-quit.
;; 2008/08/06 dadams
;; Bind icicle-kmacro to S-f4, not f5. Thx to Andrew Hyatt.
;; 2008/06/22 dadams
;; Added: icicle-unpropertize-completion-result-flag.
;; 2008/06/03 dadams
;; Added: icicle-use-C-for-actions-flag.
;; 2008/05/27 dadams
;; icicle-isearch-complete-keys: Removed S-TAB, added M-o.
;; 2008/05/25 dadams
;; icicle-isearch-complete-keys: Added M-TAB and C-M-TAB (if Windows).
;; Change [] notation to `' notation for keys in doc strings.
;; 2008/05/24 dadams
;; icicle-isearch-complete-keys: Use explicit ([S-tab] [S-iso-lefttab]) for Emacs < 22.
;; 2008/05/19 dadams
;; icicle-generic-S-tab-keys: Use explicit ([S-tab] [S-iso-lefttab]) for Emacs < 22.
;; 2008/05/11 dadams
;; icicle-top-level-key-bindings: Added :set and :initialize.
;; Moved icicle-bind-top-level-commands here from icicles-mode.el, and added optional arg.
;; 2008/05/10 dadams
;; Added widget icicle-key-definition (new custom type).
;; Renamed: icicle-bind-top-level-commands-alist to icicle-top-level-key-bindings.
;; icicle-top-level-key-bindings:
;; Redefined: New :type, using icicle-key-definition or choice of restricted-sexp.
;; Changed order of entry elements. Use kbd. No eval for command to be remapped.
;; Don't bind f5 unless have kmacro.
;; Moved icicle-yank-function before icicle-top-level-key-bindings (needed by it).
;; 2008/05/07 dadams
;; icicle-region-alist, icicle-sort-functions-alist:
;; Removed Emacs 20 version (alist works for Emacs 20 also).
;; Replaced icicle-bind-top-level-commands-flag with icicle-bind-top-level-commands-alist.
;; icicle-isearch-complete-keys:
;; Changed default value from ([S-tab] [S-iso-lefttab]) to ([backtab]).
;; 2008/05/05 dadams
;; icicle-generic-S-tab-keys:
;; Changed default value from ([S-tab] [S-iso-lefttab]) to ([backtab]).
;; 2008/04/26 dadams
;; Added: icicle-test-for-remote-files-flag. Updated C-^ to M-_
;; icicle-ignore-space-prefix-flag: Update doc string: M-_, not C-^.
;; 2008/04/18 dadams
;; Renamed icicle-init-value-flag to icicle-default-value.
;; icicle-default-value: Updated to reflect t value.
;; 2008/04/13 dadams
;; Added: icicle-pp-eval-expression-print-(length|level).
;; 2008/03/30 dadams
;; Added: icicle-highlight-lighter-flag.
;; 2008/03/29 dadams
;; Removed: icicle-completing(-mustmatch)-prompt-prefix, icicle-reminder-prompt-flag.
;; Updated doc string of icicle-customize-save-flag.
;; 2008/03/21 dadams
;; icicle-reminder-prompt-flag: Changed default value to nil.
;; 2008/02/23 dadams
;; icicle-init-value-flag: Added insert-start value. Renamed insert value to insert-end.
;; 2008/02/06 dadams
;; Added: icicle-highlight-input-completion-failure-(delay|threshold).
;; 2008/01/29 dadams
;; Removed: icicle-max-chars-noncompletion-highlight.
;; Renamed: icicle-*-input-completion-failure-flag to icicle-*-input-completion-failure.
;; icicle-*-input-completion-failure: Added values (implicit*, always) and renamed others.
;; 2007/12/31 dadams
;; icicle-list-join-string: Add display property to hide the ^G.
;; 2007/12/26 dadams
;; icicle-region-background:
;; Put initialization back inside defcustom.
;; Change test for color from Emacs version to widget test.
;; 2007/12/24 dadams
;; Added: icicle-option-type-prefix-arg-list.
;; 2007/12/14 dadams
;; Added: icicle-customize-save-flag.
;; 2007/12/09 dadams
;; Added: icicle-max-chars-noncompletion-highlight.
;; 2007/12/03 dadams
;; Renamed longest common match (lcm) to expanded common match (ecm).
;; 2007/11/25 dadams
;; Added: icicle-command-abbrev-(alist|match-all-parts-flag|priority-flag).
;; 2007/11/23 dadams
;; Added: icicle-(apropos|prefix)-cycle-(next|previous)-keys.
;; 2007/11/17 dadams
;; Added: icicle-add-proxy-candidates-flag.
;; 2007/11/02 dadams
;; Added: icicle-generic-S-tab-keys, icicle-prefix-complete-keys,
;; icicle-(apropos|prefix)-complete-no-display-keys, icicle-isearch-complete-keys.
;; Renamed icicle-modal-cycle-(up|down)-key to icicle-modal-cycle-(up|down)-keys,
;; icicle-word-completion-key to icicle-word-completion-keys.
;; 2007/10/29 dadams
;; icicle-define-alias-commands-flag, icicle-deletion-action-flag,
;; icicle-list-nth-parts-join-string: Added type and group.
;; 2007/10/28 dadams
;; Added: icicle-search-replace-common-match-flag.
;; 2007/10/23 dadams
;; icicle-highlight-input-initial-whitespace-flag:
;; Mention icicle-highlight-input-completion-failure-flag in doc string.
;; 2007/10/21 dadams
;; icicle-candidate-width-factor, icicle-inter-candidates-min-spaces: Mention Do Re Mi.
;; 2007/10/14 dadams
;; icicle-act-before-cycle-flag: Default value is now nil.
;; 2007/10/07 dadams
;; Added: icicle-deletion-action-flag.
;; 2007/09/28 dadams
;; Added: icicle-fuzzy-completion-flag.
;; 2007/08/25 dadams
;; Added: icicle-anything-transform-candidates-flag, icicle-define-alias-commands-flag.
;; 2007/08/19 dadams
;; Added: icicle-highlight-input-completion-failure-flag.
;; 2007/08/16 dadams
;; icicle-region-alist, icicle-sort-functions-alist: Use alist as :type for recent Emacs.
;; 2007/07/27 dadams
;; Added: Moved icicle-act-first-then-navigate-p here from icicles-var.el, as option *-flag.
;; Thx to Juri Linkov for suggestion.
;; 2007/07/03 dadams
;; Added: icicle-completion-history-max-length, icicle-C-l-uses-completion-flag.
;; icicle-expand-input-to-common-match-flag: Updated doc string accordingly.
;; 2007/06/20 dadams
;; icicle-WYSIWYG-Completions-flag: Use string value, not whole number, for sample text.
;; 2007/06/19 dadams
;; icicle-WYSIWYG-Completions-flag: Allow also a whole-number value, for separate swatch.
;; 2007/06/17 dadams
;; Added: icicle-WYSIWYG-Completions-flag.
;; 2007/06/12 dadams
;; icicle-region-background: Use different value for dark-background frames.
;; 2007/06/09 dadams
;; Added: icicle-use-candidates-only-once-flag.
;; 2007/06/05 dadams
;; Don't require hexrgb.el if no window system.
;; icicle-increment-color-*: Protected with featurep hexrgb and error message.
;; 2007/05/06 dadams
;; Added: icicle-search-context-match-predicate.
;; 2007/05/02 dadams
;; Added: icicle-search-whole-word-flag, icicle-yank-function.
;; icicle-regexp-quote-flag: Updated doc string to mention search.
;; 2007/04/20 dadams
;; Added: icicle-search-highlight-context-levels-flag, icicle-increment-color-saturation.
;; 2007/04/17 dadams
;; Added: icicle-search-replace-literally-flag.
;; 2007/04/15 dadams
;; icicle-search-replace-whole-candidate-flag: Changed default value to t.
;; 2007/04/07 dadams
;; Added: icicle-search-replace-whole-candidate-flag.
;; 2007/03/31 dadams
;; Added: icicle-top-level-when-sole-completion-flag.
;; icicle(-regexp)-search-ring-max: Default is 1/10th what it was.
;; 2007/03/30 dadams
;; Added: icicle-candidate-width-factor, icicle-inter-candidates-min-spaces.
;; 2007/03/12 dadams
;; Added: icicle-Completions-window-max-height.
;; icicle-show-Completions-help-flag: defvaralias it to completion-show-help (if bound).
;; 2007/03/10 dadams
;; Added: icicle-Completions-window-default-width.
;; 2007/02/27 dadams
;; Changed default value of icicle-incremental-completion-delay to 0.7.
;; 2007/02/22 dadams
;; icicle-buffer-sort: Use icicle-buffer-sort-*...*-last, not nil, as default value.
;; 2007/02/20 dadams
;; Changed icicle-region-auto-open-files-flag default value to nil.
;; 2007/02/19 dadams
;; icicle-region-alist: Added buffer's file to alist entry.
;; Added: icicle-region-auto-open-files-flag.
;; 2007/02/17 dadams
;; Added: icicle-keymaps-for-key-completion.
;; 2007/02/06 dadams
;; Added: icicle-add-buffer-name-flag.
;; 2007/01/29 dadams
;; icicle-sort-function: Use icicle-case-string-less-p as value, not string-lessp.
;; 2007/01/23 dadams
;; Added: icicle-highlight-historical-candidates-flag.
;; Updated doc strings of *-flag to mention toggles.
;; 2007/01/18 dadams
;; Renamed: icicle-regions to icicle-region-alist.
;; 2007/01/15 dadams
;; Added: icicle-change-sort-order-completion-flag, icicle-sort-functions-alist.
;; icicle-cycle-into-subdirs-flag, icicle-sort-function: Updated doc string.
;; 2007/01/14 dadams
;; Added: icicle-list-nth-parts-join-string.
;; 2007/01/08 dadams
;; icicle-reminder-prompt-flag: Reduced default value from 20 to 7 Emacs sessions.
;; 2007/01/06 dadams
;; Added: icicle-use-~-for-home-dir-flag. Thanks to Timothy Stotts for the suggestion.
;; 2006/12/29 dadams
;; icicle-thing-at-point-functions: Added ffap-guesser as first alternative text grabber.
;; icicle-default-thing-insertion: Changed default value to icicle-default-thing-insertion.
;; 2006/12/25 dadams
;; Moved to icicles-fn.el: icicle-historical-alphabetic-p.
;; 2006/12/22 dadams
;; Assigned Icicles subgroups, instead of group Icicles.
;; 2006/12/10 dadams
;; icicle-regions: Corrected (forgot repeat).
;; 2006/11/26 dadams
;; Added: icicle-regions(-name-length-max).
;; 2006/11/24 dadams
;; Added: icicle-kmacro-ring-max.
;; 2006/11/23 dadams
;; Added: icicle-TAB-shows-candidates-flag. Thx to Tamas Patrovics for the suggestion.
;; 2006/11/09 dadams
;; icicle-search-highlight-all-flag -> icicle-search-highlight-threshold.
;; Added: icicle-search-highlight-all-current-flag.
;; 2006/10/28 dadams
;; icicle-region-background: Changed :type to 'color for Emacs 21+.
;; icicle(-alternative)-sort-function, icicle-buffer-sort, icicle-transform-function:
;; function -> choice of nil or function.
;; icicle-buffer-configs: Added :tag's.
;; icicle-saved-completion-sets: Corrected doc string.
;; 2006/10/21 dadams
;; Added: icicle-complete-keys-self-insert-flag.
;; 2006/10/14 dadams
;; icicle-list-end-string: Added :type and :group.
;; Moved conditional eval-when-compile to top level.
;; 2006/10/04 dadams
;; Added: icicle-special-candidate-regexp.
;; 2006/10/03 dadams
;; icicle-list-join-string: Replaced ^G^J by \007\012, to be able to upload to Emacs Wiki.
;; 2006/10/01 dadams
;; icicle-alternative-sort-function: Updated doc string - it's now a general toggle.
;; 2006/09/30 dadams
;; Added: icicle-key-descriptions-use-*-flag.
;; 2006/09/16 dadams
;; Added: icicle-list-end-string.
;; 2006/09/03 dadams
;; Renamed icicle-show-Completions-help to icicle-show-Completions-help-flag.
;; 2006/08/13 dadams
;; Added: icicle-completing(-mustmatch)-prompt-prefix.
;; 2006/07/28 dadams
;; icicle-change-region-background-flag:
;; Default value takes no account of delete-selection mode. Improved doc string.
;; icicle-region-background:
;; Don't make region invisible if hexrgb.el was not loaded.
;; Change value, not hue, if grayscale frame background. Improved doc string.
;; 2006/07/23 dadams
;; Added: icicle-transform-function.
;; icicle-sort-function: Added Note to doc string.
;; 2006/07/20 dadams
;; Added: icicle-modal-cycle-(up|down)-key.
;; Renamed icicle-arrows-respect-* to icicle-cycling-respects-completion-mode-flag.
;; 2006/07/19 dadams
;; Applied patch from Damien Elmes <emacs@repose.cx>:
;; Added: icicle-show-completions-help. Renamed it to icicle-show-Completions-help.
;; 2006/07/18 dadams
;; Added: icicle-Completions-display-min-input-chars. Thx to Damien Elmes.
;; 2006/07/10 dadams
;; icicle-historical-alphabetic-p: Fallback directory if no previous input.
;; 2006/07/07 dadams
;; Added: icicle-alternative-sort-function, icicle-historical-alphabetic-p.
;; 2006/07/04 dadams
;; icicle-expand-input-to-common-match-flag: Updated doc string.
;; 2006/06/09 dadams
;; icicle-region-background: Use nil in defcustom. Initialize separately.
;; 2006/06/08 dadams
;; icicle-bind-top-level-commands-flag: Updated doc string.
;; 2006/05/19 dadams
;; Renamed icicle-inhibit-reminder* to icicle-reminder*.
;; Changed its functionality to use a countdown.
;; 2006/05/16 dadams
;; Added: icicle-bind-top-level-commands-flag.
;; 2006/05/15 dadams
;; Renamed: icicle-completion-nospace-flag to icicle-ignore-space-prefix-flag.
;; Added: icicle-buffer-ignore-space-prefix-flag.
;; icicle-ignore-space-prefix-flag: Changed default value to nil.
;; 2006/05/09 dadams
;; icicle-incremental-completion-threshold: Updated doc string (msg "Displaying...").
;; 2006/04/28 dadams
;; Added: icicle-highlight-input-initial-whitespace-flag.
;; 2006/04/14 dadams
;; Added: icicle-input-string, icicle-search-cleanup-flag, icicle-update-input-hook.
;; icicle-list-join-string: Added :type and :group.
;; 2006/04/09 dadams
;; Added: icicle-arrows-respect-completion-type-flag.
;; 2006/04/07 dadams
;; Added: icicle-search-highlight-all-flag.
;; 2006/04/02 dadams
;; Added: icicle-regexp-quote-flag.
;; 2006/03/24 dadams
;; Added: icicle-incremental-completion-(delay|threshold).
;; 2006/03/20 dadams
;; icicle-expand-input-to-common-match-flag: Changed default value to t.
;; 2006/03/19 dadams
;; Added: icicle-expand-input-to-common-match-flag.
;; 2006/03/17 dadams
;; Removed: icicle-cache-file.
;; Added: icicle-saved-completion-sets.
;; 2006/03/13 dadams
;; Added: icicle-cache-file.
;; 2006/03/08 dadams
;; icicle-default-thing-insertion: Use substitute-command-keys in :tag.
;; 2006/03/05 dadams
;; Moved from here to icicle-mode.el: icicle-mode, icicle-mode-hook.
;; Added: icicle-touche-pas-aux-menus-flag.
;; 2006/03/03 dadams
;; icicle-list-join-string: Changed value to ^G^J. Clarified doc string.
;;;(@* "CHANGE LOG FOR `icicles-var.el'")
;;
;; 2020/12/05 dadams
;; icicle-re-no-dot:
;; Changed value to be that of directory-files-no-dot-files-regexp. See comment in code.
;; This value is OK for use by directory-files, at least.
;; See https://lists.gnu.org/archive/html/emacs-devel/2020-04/msg00764.html and followups.
;; 2018/10/15 dadams
;; Removed icicle-(buffer|file)-sort-first-time-p.
;; 2018/02/13 dadams
;; Removed (Emacs 23-25 only now): icicle-read-char-history.
;; 2017/12/10 dadams
;; icicle-bufflist:
;; Changed default value to a non-list, to distinguish from () when this is not used.
;; icicle-bufflist, icicle-buffer-complete-fn: Improved doc strings.
;; 2017/06/25 dadams
;; icicle-toggle-map: Bind TAB to icicle-toggle-completion-mode-keys.
;; icicle-kmacro-alist, icicle-kmacro-history, icicle-saved-kmacro-ring-max: Soft-require kmacro.el
;; 2016/10/07 dadams
;; icicle-read-expression-map: Bind icicle-lisp-complete-symbol, not alias lisp-complete-symbol.
;; 2016/06/12 dadams
;; Added: icicle-auto-complete-key-idle-timer.
;; 2016/03/27 dadams
;; Added: icicle-toggle-map. Define its keys here too.
;; 2016/02/28 dadams
;; icicle-complete-keys-alist: Refer to new option icicle-complete-keys-separator.
;; 2015/08/22 dadams
;; Added: icicle-izones-var.
;; 2015/08/20 dadams
;; Added: icicle-face-remapping-Completions.
;; Renamed: icicle-region-face-remapping to icicle-face-remapping-region.
;; 2015/08/19 dadams
;; Added: icicle-region-face-remapping.
;; 2015/07/05 dadams
;; Added: icicle-completion-style-set.
;; 2015/04/11 dadams
;; icicle-search-in-context-fn: Update doc string to say the replacement arg can be a function.
;; 2014/08/10 dadams
;; Added: icicle-completion-map-vars.
;; 2014/08/04 dadams
;; icicle-read-expression-map: Typo introduced 2013/12/03: lisp-indent-line, not indent-lisp-line.
;; Use indent-sexp for Emacs 20-21 (no indent-pp-sexp).
;; 2014/06/06 dadams
;; Added: icicle-next-window-for-display-buffer.
;; 2014/04/20 dadams
;; Added: icicle-auto-no-icomplete-mode-p.
;; Moved to icicles-opt.el (which is loaded first):
;; icicle-current-TAB-method, icicle-delete-candidate-object.
;; icicle-general-help-string: Added icicle-expand-input-to-common-match-alt.
;; 2014/04/13 dadams
;; Added: icicle-auto-no-sort-p.
;; 2014/03/08 dadams
;; icicle-last-icomplete-mode-value: Use (featurep 'icomplete), not (boundp 'icomplete-mode).
;; 2014/03/06 dadams
;; Added: icicle-last-icomplete-mode-value.
;; 2014/01/05 dadams
;; Added: icicle-orig-font-lock-keywords, icicle-orig-minibuffer-completion-pred,
;; icicle-orig-minibuffer-completion-table, icicle-orig-must-match-regexp,
;; icicle-orig-must-not-match-regexp, icicle-orig-must-pass-predicate,
;; icicle-current-font-lock-part.
;; 2013/12/03 dadams
;; icicle-read-expression-map: Swap TAB and M-TAB, so TAB completes Lisp symbols.
;; 2013/11/19 dadams
;; Removed: icicle-read-file-name-internal-fn.
;; 2013/09/21 dadams
;; icicle-universal-argument-map: Updated for Emacs 24.4 (snapshot from 9/20).
;; 2013/05/13 dadams
;; icicle-general-help-string: Reflect renaming to icicle-change-sort-order-completion.
;; 2013/04/04 dadams
;; Added: icicle-ess-use-ido.
;; 2013/03/23 dadams
;; Added: icicle-Info-tag-table-posn.
;; 2013/03/07 dadams
;; Updated to use icicle-user-error where appropriate.
;; 2013/02/16 dadams
;; icicle-general-help-string: Removed list of commands - just refer to file headers.
;; 2013/02/03 dadams
;; icicle-general-help-string:
;; Updated for *-(minibuffer|completion(-list))-key-* (add), *-previous-candidate-keys (remove).
;; 2013/01/26 dadams
;; Added: icicle-multi-inputs-action-fn.
;; 2012/12/31 dadams
;; Added: icicle-mode-line-help.
;; 2012/12/15 dadams
;; Added: icicle-cands-to-narrow, icicle-compute-narrowing-regexp-p, icicle-narrow-regexp.
;; 2012/12/02 dadams
;; Added: icicle-read-file-name-internal-fn.
;; 2012/12/01 dadams
;; Removed load of icicles-mac.el (icicle-kbd is now a function in icicles-opt.el).
;; 2012/11/28 dadams
;; Added: icicle-transform-function - moved here from icicles-opt.el.
;; Removed: icicle-vardoc-last-initial-option-cand-set.
;; 2012/11/26 dadams
;; Added: icicle-apropos-value-last-initial-cand-set.
;; 2012/10/27 dadams
;; Added: icicle-toggle-transforming-message. Updated icicle-general-help-string.
;; 2012/10/22 dadams
;; Added: icicle-Info-index-cache.
;; 2012/10/18 dadams
;; Added: icicle-path-variables.
;; Added: icicle-exclude-default-proxies. (Used by *-directory-list to exclude non-file proxies.)
;; 2012/10/09 dadams
;; Added: icicle-multi-completing-p.
;; 2012/10/05 dadams
;; Removed: icicle-default-directory (unused).
;; 2012/09/08 dadams
;; Added: icicle-buffer-name-input-p, icicle-buffer-complete-fn.
;; icicle-general-help-string: Removed reference to icicle-ignore-space-prefix-flag.
;; 2012/08/06 dadams
;; Renamed: icicle-old-read-file-name-fn to icicle-orig-read-file-name-fn.
;; 2012/07/07 dadams
;; Added: icicle-file-name-completion-table. Thx to Michael Heerdegen.
;; 2012/06/29 dadams
;; Added: icicle-allowed-sort-predicate.
;; 2012/06/28 dadams
;; icicle-search-map: Bound icicle-grep-saved-file-candidates (M-s M-s g).
;; 2012/05/14 dadams
;; icicle-candidate-help-fn: Updated doc string to mention transforming multi-completion cands.
;; 2012/05/07 dadams
;; Applied renaming of icicle-search-dired-marked to icicle-search-dired-marked-recursive.
;; 2012/04/23 dadams
;; icicle-search-modes: Treat dired-mode like bookmark-bmenu-mode: error if no Dired+.
;; 2012/04/13 dadams
;; icicle-search-modes: For Dired, use icicle-search-dired-get-files, not dired-get-marked-files.
;; icicle-re-no-dot: Made it a defconst.
;; 2012/02/11 dadams
;; icicle-current-raw-input, icicle-general-help-string, icicle-incremental-completion-p:
;; Doc updates for input-expansion changes, including option name change (no -flag).
;; 2012/01/14 dadams
;; Added: icicle-read-char-history.
;; 2011/12/28 dadams
;; Removed mention of obsolete option icicle-cycle-into-subdirs-flag.
;; 2011/12/14 dadams
;; Added: icicle-bookmark-list-names-only-p.
;; 2011/10/14 dadams
;; icicle-search-map: Bound x and X to the XML-element search commands.
;; 2011/10/08 dadams
;; eval-when-compile icicles-mac.el.
;; icicle-read-expression-map, icicle-search-map, icicle-universal-argument-map: Use icicle-kbd.
;; 2011/10/04 dadams
;; Added: icicle-search-map.
;; 2011/09/27 dadams
;; Added: icicle-search-modes (var).
;; 2011/09/14 dadams
;; Added: icicle-hist-var.
;; icicle-prompt: Changed default value to nil from "".
;; 2011/09/05 dadams
;; icicle-general-help-string: Added icicle-hide-non-matching-lines-flag.
;; Removed -other-window from *-bookmark-(bookmark-list|desktop).
;; 2011/08/13 dadams
;; Added: icicle-search-complement-domain-p.
;; 2011/08/12 dadams
;; Added: icicle-full-cand-fn.
;; 2011/08/07 dadams
;; icicle-abs-file-candidates: Update doc string: now an alist (for COLLECTION arg).
;; 2011/07/27 dadams
;; Removed icicle-completions-format-internal.
;; 2011/07/26 dadams
;; Removed: icicle-list-end-string (no longer needed). Thx to Michael Heerdegen.
;; 2011/07/24 dadams
;; Updated icicle-general-help-string for new commands.
;; 2011/07/06 dadams
;; Applied renaming of icicle-Completions-frame-at-right-flag to icicle-move-Completions-frame.
;; 2011/05/03 dadams
;; icicle-general-help-string: Mention icicle-toggle-highlight-saved-candidates.
;; 2011/04/29 dadams
;; Added: icicle-buffer-sort-first-time-p, icicle-file-sort-first-time-p, icicle-new-last-cmd,
;; icicle-orig-must-pass-after-match-pred.
;; 2011/04/02 dadams
;; Added: icicle-bufflist, icicle-pref-arg, icicle-scan-fn-or-regexp.
;; Moved to icicles-cmd2.el:
;; icicle-orig-(buff|win)-key-complete, icicle-orig-extra-cands, icicle-orig-menu-bar,
;; icicle-orig-(font|frame|pixelsize|pointsize), icicle-orig-show-initially-flag,
;; icicle-orig-sort-orders-alist, icicle-this-cmd-keys.
;; 2011/03/31 dadams
;; Renamed icicle-target-window-recenter-amount to icicle-recenter & moved to icicles-opt.el.
;; 2011/03/29 dadams
;; Added: icicle-key-prefix-description, icicle-orig-(buff|window|font|frame|pixelsize|pointsize),
;; icicle-orig-(buff|win)-key-complete, icicle-completing-keys-p, icicle-prompt,
;; icicle-orig-(pt|win)-explore, icicle-orig-show-initially-flag, icicle-orig-extra-cands,
;; icicle-other-window, icicle-target-window-recenter-amount, icicle-this-cmd-keys.
;; Renamed: icicle-scroll-Completions-backward-p to icicle-scroll-Completions-reverse-p.
;; icicle-complete-keys-alist: Removed conditional definition (just don't use it before Emacs 22).
;; 2011/01/17 dadams
;; Removed compile-time require of cl.el.
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2010/11/07 dadams
;; Renamed: icicle-all-candidates-action-p to icicle-all-candidates-action. Now can cache action.
;; 2010/10/25 dadams
;; Removed mention of icicle-search-context-match-predicate (no longer exists).
;; 2010/10/24 adams
;; Added: icicle-must-pass-after-match-predicate.
;; icicle-must-pass-predicate: Clarified doc string.
;; 2010/10/09 dadams
;; icicle-general-help-string:
;; Applied renaming of icicle-cycling-respects-completion-mode to icicle-default-cycling-mode.
;; 2010/10/07 dadams
;; icicle-current-TAB-method: Use nil, not basic, as default value.
;; 2010/06/18 dadams
;; Added: icicle-completions-format-internal.
;; 2010/06/08 dadams
;; Added: icicle-nb-candidates-before-truncation.
;; 2010/06/04 dadams
;; Added: icicle-lighter-truncation.
;; icicle-general-help-string: Mention missing doremi commands.
;; 2010/04/29 dadams
;; Added: icicle-remove-icicles-props-p.
;; 2010/04/02 dadams
;; icicle-general-help-string: Updated.
;; 2010/04/02 dadams
;; Added: icicle-bookmark-types.
;; icicle-general-help-string: Updated to reflect move from saved regions to bookmarks.
;; 2010/03/13 dadams
;; Added: icicle-transform-before-sort-p.
;; Removed: icicle-sorted-bookmark-alist.
;; Applied renaming of icicle-add-buffer-name-flag to icicle-show-multi-completion-flag.
;; 2010/03/03 dadams
;; Added: icicle-sorted-bookmark-alist, icicle-reverse-multi-sort-p.
;; Renamed: icicle-last-sort-function to icicle-last-sort-comparer.
;; icicle-general-help-string: Applied renaming to icicle-sort-orders-alist.
;; Applied renamings: icicle-sort-function to icicle-sort-comparer,
;; icicle-sort-functions-alist to icicle-sort-orders-alist,
;; icicle-alternative-sort-function to icicle-alternative-sort-comparer.
;; 2010/02/17 dadams
;; Moved icicle-redefined-functions to icicles-opt.el
;; and renamed to icicle-inhibit-advice-functions
;; 2010/02/14 dadams
;; Added: icicle-advice-info-list, icicle-redefined-functions.
;; 2009/11/07 dadams
;; Applied doremi cmd renamings (added +) to help text.
;; 2009/10/25 dadams
;; Added: icicle-current-TAB-method.
;; Updated icicle-general-help-string with new command names.
;; 2009/09/26 dadams
;; Added: icicle-progressive-completing-p.
;; 2009/09/25 dadams
;; Removed: icicle-respect-completion-styles-p. See option *-TAB-respects-*-styles-flag.
;; 2009/09/05 dadams
;; Added: icicle-minibuffer-message-ok-p.
;; Renamed icicle-acting-on-next/prev-p to icicle-acting-on-next/prev.
;; 2009/07/26 dadams
;; Added: icicle-command-abbrev-history (belated), icicle-interactive-history.
;; 2009/05/17 dadams
;; icicle-predicate-types-alist: Updated to reflect thumb-frm.el name changes.
;; 2009/05/11 dadams
;; Added: icicle-hist-cands-no-highlight.
;; 2009/05/09 dadams
;; Added: *-input-completion-fail-overlay, *-anychar-regexp, *-dot-string-internal.
;; 2009/05/02 dadams
;; Added: icicle-cmd-reading-input.
;; 2009/04/28 dadams
;; Renamed: icicle-object-predicate-types to icicle-predicate-types-alist.
;; icicle-predicate-types-alist:
;; Converted to alist, with cdr's from icicle-type-actions-alist. Added more entries.
;; Removed: icicle-object-named-types.
;; 2009/04/03 dadams
;; Added: icicle-filtered-default-value.
;; 2009-03/16 dadams
;; Added: icicle-use-candidates-only-once-alt-p.
;; 2009/03/15 dadams
;; icicle-general-help-string: Added: icicle-recompute-shell-command-candidates,
;; icicle-remove-file-from-recentf-list.
;; 2009/03/10 dadams
;; Moved icicle-shell-command-candidates to icicles-opt.el and renamed: *-cache.
;; 2009/03/01 dadams
;; Added: icicle-completing-read+insert-candidates.
;; Removed: icicle-complete-on-demand-cmd.
;; 2009/02/23 dadams
;; Added: icicle-extra-candidates-dir-insert-p.
;; 2009/02/20 dadams
;; Added: icicle-shell-command-candidates, icicle-complete-on-demand-cmd.
;; 2009/02/04 dadams
;; Added: icicle-next-prefix-complete-cycles-p, icicle-next-apropos-complete-cycles-p.
;; 2009/01/24 dadams
;; Added: icicle-last-apropos-complete-match-fn.
;; 2009/01/13 dadams
;; Added: icicle-respect-completion-styles-p (internal var, for now).
;; 2008/12/25 dadams
;; Added: icicle-cycling-p.
;; 2008/12/07 dadams
;; Added: icicle-completion-prompt-overlay. Removed: icicle-prompt.
;; 2008/12/02 dadams
;; Added: icicle-confirm-exit-commands.
;; 2008/11/28 dadams
;; Moved to icicles-opt.el: icicle-apropos-match-fns-alist.
;; 2008/11/22 dadams
;; Added: icicle-fancy-candidates-p, icicle-fancy-cands-internal-p.
;; 2008/11/03 dadams
;; Applied renamings from icicles-cmd.el.
;; 2008/11/02 dadams
;; Added: icicle-(doc|vardoc|fundoc|plist)-last-initial(-option)-cand-set.
;; 2008/10/14 dadams
;; Added: icicle-general-help-string.
;; Removed: icicle-completion-help-string.
;; 2008/10/06 dadams
;; icicle-ms-windows-drive-hash: Set it to nil if make-hash-table is undefined.
;; 2008/09/30 dadams
;; Added: icicle-ms-windows-drive-hash.
;; 2008/09/20 dadams
;; icicle-ignored-extensions-regexp: Append $ to each extension.
;; Added: icicle-abs-file-candidates.
;; 2008/08/28 dadams
;; Renamed: alacarte-menu-items-alist to lacarte-menu-items-alist.
;; 2008/08/18 dadams
;; Added: icicle-inhibit-try-switch-buffer.
;; 2008/08/12 dadams
;; Added: icicle-apply-nomsg.
;; 2008/08/10 dadams
;; Added: icicle-explore-final-choice, icicle-explore-final-choice-full.
;; 2008/08/03 dadams
;; Added: icicle-all-candidates-list-alt-action-fn.
;; Renamed: icicle-all-candidates-action-fn to icicle-all-candidates-list-action-fn,
;; icicle-candidate-alternative-action-fn to icicle-candidate-alt-action-fn.
;; 2008/03/30 dadams
;; Added: icicle-old-read-file-name-fn.
;; 2008/03/29 dadams
;; Removed: icicle-prompt-suffix.
;; 2008/03/23 dadams
;; Added: icicle-scroll-Completions-backward-p.
;; 2008/03/19 dadams
;; Added: icicle-read-expression-map.
;; 2008/03/10 dadams
;; Added: icicle-frame-alist.
;; 2008/02/24 dadams
;; Added: icicle-apropos-match-fns-alist.
;; 2008/02/21 dadams
;; Added: icicle-Info-only-rest-of-book-p.
;; 2008/02/03 dadams
;; Added: icicle-comp-base-is-default-dir-p, icicle-dir-candidate-can-exit-p.
;; 2008/01/18 dadams
;; Moved icicle-complete-keys-alist here from icicles-cmd.el
;; 2008/01/04 dadams
;; Added: icicle-doc-history.
;; 2007/12/27 dadams
;; Added: icicle-apropos-complete-match-fn.
;; 2007/12/05 dadams
;; icicle-proxy-candidate-regexp: Removed * doc-string prefix.
;; 2007/11/25 dadams
;; Added: icicle-commands-for-abbrev.
;; 2007/11/17 dadams
;; Added: icicle(saved)-proxy-candidates, icicle-proxy-candidate-regexp.
;; 2007/10/06 dadams
;; icicle-object-named-types: Added file type.
;; 2007/08/19 dadams
;; Added: icicle-input-fail-pos.
;; 2007/08/18 dadams
;; Added: icicle-whole-candidate-as-text-prop-p.
;; 2007/07/29 dadams
;; Added: icicle-object-named-types, icicle-object-predicate-types.
;; 2007/07/27 dadams
;; Moved icicle-act-first-then-navigate-p to icicles-opt.el as icicle-act-before-cycle-flag.
;; 2007/07/08 dadams
;; Added: icicle-all-candidates(-alternative)-action-fn.
;; 2007/07/03 dadams
;; Added: icicle-previous-raw(-non)-file-name-inputs.
;; 2007/06/23 dadams
;; Added: icicle-search-replacement-history.
;; 2007/06/17 dadams
;; Added: icicle-saved-candidate-overlays.
;; 2007/06/07 dadams
;; Added: icicle-face-name-history.
;; Renamed: frame-name-history to icicle-frame-name-history,
;; icicle-font-history to icicle-font-name-history,
;; icicle-function-history to icicle-function-name-history,
;; icicle-variable-history to icicle-variable-name-history.
;; 2007/05/29 dadams
;; icicle-insert-string-at-pt-*: Initialize to nil, not 0.
;; 2007/05/25 dadams
;; Added: icicle-char-property-value-history.
;; 2007/05/06 dadams
;; Added defvars to quiet byte compiler.
;; 2007/04/28 dadams
;; Added: icicle-search-in-context-fn.
;; 2007/04/20 dadams
;; Added: icicle-search-level-overlays.
;; 2007/04/15 dadams
;; Added: icicle-search-context-regexp.
;; 2007/04/10 dadams
;; Added: icicle-search-context-level.
;; 2007/04/08 dadams
;; Added: icicle-all-candidates-action-p.
;; icicle-candidate-action-fn: Corrected doc string: reversed success and failure values.
;; 2007/04/07 dadams
;; Added: icicle-search-replacement, icicle-searching-p, icicle-act-first-then-navigate-p.
;; 2007/04/02 dadams
;; Added: icicle-text-property-value-history.
;; Added: icicle-text-properties-alist (commented out).
;; 2007/03/23 dadams
;; Added: icicle-require-match-p.
;; 2007/03/14 dadams
;; Added: icicle-last-top-level-command.
;; 2007/03/06 dadams
;; Added: icicle-inhibit-sort-p.
;; icicle-candidates-alist: Improved doc string.
;; 2007/02/20 dadams
;; Added: icicle-delete-candidate-object, icicle-candidate-alternative-action-fn.
;; 2007/02/03 dadams
;; Renamed icicle-icompleting-p to icicle-edit-update-p.
;; 2007/02/02 dadams
;; Added: icicle-completing-p.
;; 2007/01/29 dadams
;; icicle-last-sort-function: Use icicle-case-string-less-p, not string-lessp.
;; 2007/01/19 dadams
;; Added: icicle-candidate-properties-alist.
;; 2007/01/15 dadams
;; Added: icicle-reverse-sort-p.
;; 2007/01/14 dadams
;; icicle-list-use-nth-parts: Updated doc string for new icicle-list-nth-parts-join-string.
;; 2007/01/12 dadams
;; Added: icicle-list-use-nth-parts.
;; Removed icicle-saved-overriding-local-map.
;; 2007/01/11 dadams
;; Added: icicle-menu-map, icicle-minor-mode-map-entry.
;; 2007/01/10 dadams
;; Added: icicle-saved-overriding-local-map.
;; 2007/01/05 dadams
;; icicle-initial-value: Updated doc string to mention you can bind it.
;; 2006/12/25 dadams
;; Added: icicle-saved-completion-candidates-internal.
;; 2006/12/23 dadams
;; Added: icicle-candidate-help-fn.
;; 2006/12/17 dadams
;; Added: icicle-saved-completion-candidate.
;; 2006/11/24 dadams
;; Added: icicle-universal-argument-map, icicle-kmacro-alist, icicle-saved-kmacro-ring-max,
;; icicle-kmacro-history.
;; 2006/11/18 dadams
;; Added: frame-name-history, icicle-bookmark-history, icicle-buffer-config-history,
;; icicle-color-history, icicle-color-theme-history, icicle-completion-set-history,
;; icicle-dictionary-history, icicle-font-history, icicle-function-history,
;; icicle-kill-history, icicle-search-history, icicle-variable-history,
;; 2006/11/09 dadams
;; icicle-search-refined-overlays: Updated doc string: icicle-search-highlight-threshold.
;; 2006/10/14 dadams
;; Moved conditional eval-when-compile to top level.
;; 2006/09/24 dadams
;; icicle-last-transform-function: Corrected default value.
;; 2006/09/12 dadams
;; Added: icicle-pre-minibuffer-buffer.
;; 2006/08/20 dadams
;; icicle-current-completion-mode: Updated doc string.
;; 2006/08/04 dadams
;; Removed icicle-apropos-completing-p (not used).
;; 2006/07/23 dadams
;; Added: icicle-last-transform-function.
;; 2006/07/22 dadams
;; Added: icicle-search-command, icicle-search-final-choice.
;; 2006/07/20 dadams
;; Renamed icicle-arrows-respect-* to icicle-cycling-respects-completion-mode-flag.
;; 2006/07/19 dadams
;; Applied patch from Damien Elmes <emacs@repose.cx>: Added: icicle-current-completion-type.
;; Renamed: icicle-current-completion-type to icicle-current-completion-mode.
;; 2006/07/05 dadams
;; Renamed: icicle-current-regexp-input to icicle-current-raw-input.
;; 2006/06/18 dadams
;; Added: icicle-apropos-completing-p.
;; 2006/04/30 dadams
;; Added: icicle-candidate-entry-fn.
;; Renamed: icicle-search-candidates to icicle-candidates-alist.
;; 2006/04/14 dadams
;; Renamed icicle-search-refined-overlay to icicle-search-refined-overlays.
;; Added: icicle-search-candidates.
;; 2006/04/07 dadams
;; Added: icicle-search-overlays.
;; Renamed icicle-search-overlay to icicle-search-current-overlay.
;; 2006/03/27 dadams
;; Added: icicle-search-refined-overlay.
;; 2006/03/26 dadams
;; Added: icicle-search-overlay.
;; 2006/03/25 dadams
;; Added: icicle-saved-candidates-variables-obarray.
;; 2006/03/20 dadams
;; Added: icicle-common-match-string, icicle-current-regexp-input.
;; 2006/03/14 dadams
;; Removed: icicle-icicle-completing-p.
;; 2006/03/13 dadams
;; Added: icicle-re-no-dot.
;; 2006/03/05 dadams
;; Moved to icicles-mode.el: icicle-mode-map.
;; 2006/03/04 dadams
;; Moved options stuff to Options menu, when available.
;; Moved apropos stuff to Apropos menu, when available.
;; Moved describe stuff to Describe menu, when available.
;; 2006/03/03 dadams
;; Added to Icicles menu: icicle-complete-thesaurus-entry, icicle-apropos*,
;; option-setting cmds, buffer-config cmds icicle-(var|fun)doc.
;; Require apropos-fn+var.el.
;;;(@* "CHANGE LOG FOR `icicles.el'")
;;
;; 2023/07/27 dadams
;; Version 2023.07.27
;; 2022/01/26 dadams
;; Version 2022.01.26
;; 2020/01/03 dadams
;; Version 2020.01.04
;; 2018/10/15 dadams
;; Version 2018.10.15.
;; 2018/02/13 dadams
;; Version 2018.02.13.
;; 2018/01/15 dadams
;; Version 2018.01.15.
;; 2017/12/10 dadams
;; Version 2017.12.10.
;; 2017/07/26 dadams
;; Version 2017.07.26.
;; 2017/07/07 dadams
;; Version 2017.07.07.
;; 2016/12/21 dadams
;; Version 2016.12.21.
;; 2016/06/12 dadams
;; Version 2016.06.12.
;; 2016/03/04 dadams
;; Version 2016.03.04.
;; font-lock-add-keywords: Use index 7 for old Emacs versions.
;; 2015/07/05 dadams
;; Version 2015.07.05.
;; 2015/01/04 dadams
;; Version 2015.01.04.
;; 2014/08/10 dadams
;; New version, 2014.08.09: M-& completes.
;; 2014/05/17 dadams
;; icicle-with-help-window, icicle-with-selected-window: Added to font-lock-keywords.
;; icicle-with-help-window: Specified common-lisp-indent-function.
;; 2014/04/23 dadams
;; Put common-lisp-indent-function property on cl-flet.
;; 2014/04/06 dadams
;; New version - updated icicles-mac.el.
;; 2012/03/11 dadams
;; Font-lock keywords for emacs-lisp-mode, for all Emacs versions, 20-24.
;; 2013/03/10 dadams
;; Font-lock keywords for emacs-lisp-mode:
;; Changed \\>[ \t'\(]*\\(\\sw+\\)? to \\>[ \t'\(]*\\(\\(\\sw\\|\\s_\\)+\\)?
;; (see Emacs bug #13755).
;; Added for font-lock and common-lisp-indent-function:
;; icicle-define(-search)-bookmark(-other-window)-command.
;; 2013/03/07 dadams
;; Define font-lock-keywords for icicle-user-error.
;; 2013/02/16 dadams
;; icicle-mode: Removed list of commands from autoload doc string - just refer to file headers.
;; 2013/02/09 dadams
;; Added autoload cookies for icy-mode, icicle-mode, to provide full doc string for info.
;; 2012/08/06 dadams
;; Renamed old-* to icicle-ORIG-*:
;; icicle-ORIG-bbdb-complete-name, icicle-ORIG-choose-completion,
;; icicle-ORIG-choose-completion-string, icicle-ORIG-color, icicle-ORIG-comint-dynamic-complete,
;; icicle-ORIG-comint-dynamic-complete-filename, icicle-ORIG-comint-replace-by-expanded-filename,
;; icicle-ORIG-completing-read, icicle-ORIG-completing-read-multiple,
;; icicle-ORIG-completion-setup-function, icicle-ORIG-crm-local-completion-map,
;; icicle-ORIG-crm-local-must-match-map, icicle-ORIG-dired-read-shell-command,
;; icicle-ORIG-dired-smart-shell-command, icicle-ORIG-display-completion-list,
;; icicle-ORIG-ess-complete-object-name, icicle-ORIG-exit-minibuffer,
;; icicle-ORIG-face-valid-attribute-values, icicle-ORIG-file,
;; icicle-ORIG-gud-gdb-complete-command, icicle-ORIG-minibuffer-complete-and-exit,
;; icicle-ORIG-minibuffer-default-add-completions, icicle-ORIG-mouse-choose-completion,
;; icicle-ORIG-next-history-element, icicle-ORIG-read-char-by-name, icicle-ORIG-read-color,
;; icicle-ORIG-read-face-name, icicle-ORIG-read-file-name, icicle-orig-read-file-name-fn,
;; icicle-ORIG-read-from-minibuffer, icicle-ORIG-read-number, icicle-ORIG-shell-command,
;; icicle-ORIG-read-shell-command, icicle-ORIG-read-string, icicle-ORIG-shell-command-on-region,
;; icicle-ORIG-sit-for, icicle-ORIG-switch-to-completions, icicle-ORIG-widget-color-complete.
;; 2012/07/17 dadams
;; Removed: icicle-byte-compile-eval-after-load-flag.
;; 2012/02/28 dadams
;; Removed eval-when-compile for Emacs < 20.
;; 2011/12/11 dadams
;; Ensure icicles-mac is loaded if icicles.el is not byte-compiled, and is loaded when compiled.
;; 2011/10/12 dadams
;; Moved the Miscellaneous stuff here from icicles-mac.el: indent & font-lock for macros etc.
;; 2011/10/10 dadams
;; Moved here from icicles-mac.el: icicle-byte-compile-eval-after-load-flag.
;; Removed require of icicles-mac.el.
;; 2011/06-24 dadams
;; Updated load order: mac, face, opt, var, fn, mcmd, cmd1, cmd2, mode.
;; 2010/12/26 dadams
;; Removed autoload cookies except simple ones & ones with sexp on same line. Thx to Richard Kim.
;; 2009/05/22 dadams
;; Require icicles-cmd[12].
;; 2009/04/13 dadams
;; Removed the part of Thierry's text that mentioned emacsclient (no relation to Icicles).
;; 2008/12/02 dadams
;; Don't warn, if daemonp. Thx to Thierry Volpiatto.
;; 2007/07/22 dadams
;; Require icicles-cmd.el before icicles-mode.el.
;; 2007/06/07 dadams
;; Moved all doc to new files icicles-doc1.el and icicles-doc2.el.
;; 2007/05/12 dadams
;; Moved Search Enhancements subsections to top level: Isearch Completion,
;; Icicles Search Commands, Overview, Search and Replace.
;; 2007/05/06 dadams
;; Changed S-C- to C-S- and M-C- to C-M- in doc.
;; 2007/04/20 dadams
;; Require icicles-face.el after icicles-opt.el.
;; 2007/03/09 dadams
;; Renamed sections .*Removal of Duplicates to .*Removing Duplicates and
;; More on Multi-Commands to More About Multi-Commands.
;; 2007/02/24 dadams
;; Added section More on Multi-Commands.
;; Added subsection Chipping Away the Non-Elephant to Nutshell View.
;; 2007/02/03 dadams
;; Updated section Sorting Candidates and Removal of Duplicates.
;; 2007/01/28 dadams
;; Added: subsection Using Progressive ... Process of Elimination.
;; 2007/01/21 dadams
;; Added: section Text Properties in *Completions*.
;; 2007/01/19 dadams
;; Added: section Programming Multi-Completions.
;; 2007/01/16 dadams
;; Added linkd links. Cleanup.
;; 2007/01/15 dadams
;; Added: section Sorting Candidates and Removal of Duplicates.
;; Renamed:
;; icicle-sort-and-strip-ignored to icicle-strip-ignored-files-and-sort,
;; icicle-dirs-last-p to icicle-dirs-last-p,
;; icicle-sort-case-insensitively to *-case-insensitive-string-lessp.
;; 2007/01/12 dadams
;; Updated section Multi-Completions for icicle-list-use-nth-parts.
;; 2007/01/06 dadams
;; File-Name and Directory-Name Completion Tips: Mention icicle-use-~-for-home-dir-flag.
;; 2006/11/23 dadams
;; Added icicle-TAB-shows-candidates-flag.
;; 2006/11/10 dadams
;; Multi-Commands: Mention prompt prefix +.
;; 2006/11/05 dadams
;; icicle-occur is bound to C-c '. Search commands use multiple buffers.
;; Added Nutshell subsection Perform Multiple Operations In One Command.
;; 2006/10/19 dadams
;; Added Goggle Matching section.
;; 2006/10/16 dadams
;; Added key completion to Nutshell View.
;; 2006/10/14 dadams
;; Renamed: icicle-cancel-*Help*-* to icicle-cancel-Help-*.
;; Moved conditional eval-when-compile to top level.
;; 2006/10/01 dadams
;; Updated for new alternative-sort toggle:
;; History Enhancements, Key Completion, Customization *, Key Bindings.
;; 2006/09/30 dadams
;; Changed bindings of icicle-candidate-set-(save|retrieve) from C-<, C-> to C-M-<, C-M->.
;; Added icicle-key-descriptions-use-<>-flag in Customization section.
;; 2006/09/17 dadams
;; Added section Key Completion.
;; 2006/09/12 dadams
;; Added section Moving Between the Minibuffer and Other Buffers.
;; 2006/08/23 dadams
;; Added sections Icicles Mult M-x and Defining Icicles Multi M-x.
;; 2006/08/18 dadams
;; Added section Icicles Info Enhancements.
;; 2006/08/13 dadams
;; Documented icicle-completing(-mustmatch)-prompt-prefix.
;; 2006/06/17 dadams
;; Rewrote Multi-Commands, Defining Icicles Commands (Including Multi-Commands), and
;; Defining Multi-Commands the Hard Way.
;; Renamed: Defining Icicles Commands: + (Including Multi-Commands).
;; Defining Multi-Commands: + the Hard Way.
;; Added: Defining Multiple-Choice Menus.
;; 2006/06/08 dadams
;; Removed require of icicle-keys.el (obsolete).
;; 2006/05/26 dadams
;; Mention M-k as icicle-erase-minibuffer-or-history-element.
;; Don't mention M-S-backspace and M-S-delete any more.
;; 2006/05/19 dadams
;; Renamed icicle-inhibit-reminder* to icicle-reminder*.
;; Updated its doc to reflect new functionality.
;; 2006/05/18 dadams
;; Change install instructions to include turning on Icicle mode.
;; 2006/05/16 dadams
;; Require icicles-keys.el when icicle-bind-top-level-commands-flag.
;; Updated doc to reflect new library icicles-keys.el.
;; 2006/05/15 dadams
;; Renamed: ici*-nospace-flag to icicle-ignore-space-prefix-flag.
;; Updated doc of icicle-ignore-space-prefix-flag.
;; Added doc of icicle-buffer-ignore-space-prefix-flag.
;; 2006/04/14 dadams
;; Added section Inserting a Regexp from a Variable.
;; 2006/04/09 dadams
;; Added descriptions of icicle-arrows-respect-completion-type-flag.
;; 2006/03/19 dadams
;; Added description of icicle-expand-input-to-common-match-flag.
;; 2006/03/07 dadams
;; Correct the description of icicle-doc - match against only the doc, not the symbol name.
;; 2006/03/06 dadams
;; Reordered Commentary sections, putting Emacs-Lisp stuff later.
;; 2006/03/05 dadams
;; Mention icicle-touche-pas-aux-menus-flag.
;; 2006/03/03 dadams
;; Clarified Multi-Completions description.
;; 2006/03/01 dadams
;; Added: icicle-(complete|insert)-thesaurus-entry.
;; 2006/02/27 dadams
;; Split into multiple libraries: *-cmd, *-face, *-fn, *-mac, *-mode, *-opt, *-var.
;; 2006/02/25 dadams
;; Added: icicle-narrow-candidates (bound to M-*), icicle-icicle-completing-p,
;; icicle-set-calling-cmd, icicle-reset-icicle-completing-p,
;; icicle-run-icicle-(pre|post)-command-hook.
;; Add all hooks in icicle-mode only, except for minibuffer-local hooks (pre- and
;; post-command).
;; Remove all hooks when exit Icicle mode.
;; icicle-completing-read, icicle-read-file-name:
;; Add catch icicle-read-top. Set icicle-icicle-completing-p.
;; Separate case of not Icicle mode from other no-prompt cases.
;; Reordered some groups of functions.
;; 2006/02/24 dadams
;; icicle-candidate-set-1: Treat empty set.
;; 2006/02/21 dadams
;; icicle-prefix-complete: Implemented icompletion here, like icicle-apropos-complete-1.
;; icicle-call-then-update-Completions:
;; Use icicle-last-completion-command, not icicle-apropos-complete.
;; Renamed icicle-apropos-icompleting-p to icicle-icompleting-p.
;; Added: icicle-(kill|delete)(-backward)-*, icicle-yank etc. Bound them.
;; Added: icicle-call-then-update-Completions.
;; Added: icicle-incremental-completion-p.
;; Use instead of icicle-incremental-completion-flag everywhere.
;; Upgrade from t in icicle-display-candidates-in-Completions.
;; Reset in icicle-minibuffer-setup.
;; icicle-isearch-complete: Use search-ring symbol as history arg to completing-read.
;; icicle-display-candidates-in-Completions, icicle-keep-only-past-inputs, icicle-history:
;; Ensure that minibuffer-history-variable is a list.
;; Fixed typos: icicle-keep-past-inputs -> icicle-keep-only-past-inputs.
;; 2006/02/20 dadams
;; icicle-insert-string-at-point: Treat negative prefix arg.
;; Added: icicle-signum.
;; icicle-insert-thing: Remove text properties of string to insert.
;; 2006/02/19 dadams
;; icicle-thing-at-point-functions: Added function to grab successive text.
;; icicle-insert-string-at-point: Treat successive-grab fn and prefix arg.
;; Added: icicle-default-thing-insertion, icicle-default-thing-insertion-flipped-p,
;; icicle-insert-string-at-pt-(start|end), icicle-successive-grab-count,
;; icicle-insert-thing.
;; Renamed: icicle-insert-string-near-point to icicle-insert-string-at-point.
;; 2006/02/18 dadams
;; icicle-retrieve-last-input: Don't reset icicle-last-completion-command if not interactive
;; icicle-candidate-set-complement, icicle-keep-only-past-inputs:
;; Use icicle-retrieve-last-input.
;; icicle-keep-only-past-inputs:
;; Rewrote modeled on icicle-apropos-complete:
;; Take into account singleton and empty candidate set.
;; Provide input to icicle-display-ca*.
;; Set icicle-last-completion-command.
;; icicle-history: Force redisplay of *Completions*. Don't set this-command.
;; icicle-completing-read: Ensure icicle-initial-value is not nil.
;; icicle-save-or-restore-input: Don't restore empty input.
;; icicle-recompute-candidates:
;; Don't recompute if last completion cmd was icicle-keep-only-past-inputs.
;; Added: icicle-historical-candidate, icicle-keep-only-past-inputs.
;; icicle-display-candidates-in-Completions: Use icicle-historical-candidate.
;; Bind icicle-keep-only-past-inputs to M-pause in minibuffer completion maps.
;; 2006/02/17 dadams
;; Added: icicle-complete-input-overlay, icicle-highlight-complete-input,
;; icicle-complete-input.
;; icicle-(prefix|apropos)-complete(-1): Use icicle-highlight-complete-input.
;; Added icicle-inhibit-reminder-prompt-flag. Thx to Jonathan Simms for the suggestion.
;; icicle-completing-read, icicle-read-file-name: Use icicle-inhibit-reminder-prompt-flag.
;; 2006/02/12 dadams
;; icicle-read-string: Finished bug fix of 2/11. Thx to Andrey Zhdanov.
;; 2006/02/11 dadams
;; icicle-insert-string-near-point: Always start with first function.
;; read-from-minibuffer: Bug fix: don't use def if init is consp. Thx to Andrey Zhdanov.
;; 2006/02/09 dadams
;; Added: icicle-insert-string-near-point, icicle-thing-at-point-functions,
;; icicle-thing-at-pt-fns-pointer.
;; Bound icicle-insert-string-near-point.
;; Added Commentary section "Inserting Text Found Near the Cursor"
;; Require: thingatpt+.el, thingatpt.el.
;; Bug fix: icicle-execute-extended-command(-1): Take care of last-command and this-command.
;; 2006/02/08 dadams
;; icicle-completing-read: Treat consp case of initial-input.
;; icicle-read-file-name: Fixed bug introduced 02/02:
;; Don't ensure initial-input is not null.
;; 2006/02/07 dadams
;; Bug fix: Files menu find-file stuff was bound to *recent-file*.
;; 2006/02/03 dadams
;; icicle-init-value-flag: Use nil as the default value.
;; Added: icicle-read-from-minibuffer, icicle-read-string.
;; Use in icicle-(redefine|restore)-standard-commands.
;; 2006/02/02 dadams
;; icicle-completing-read, read-file-name:
;; Respect icicle-init-value-flag only if default value not nil.
;; read-file-name: Ensure initial-value is not null. Initialize icicle-initial-value.
;; Respect icicle-init-value-flag.
;; 2006/01/29 dadams
;; icicle-completing-read, icicle-read-file-name: Remove binding of ESC-TAB.
;; icicle-lisp-complete-symbol: Enable recursive minibuffers if in minibuffer.
;; Commentary: Combine lisp-complete-symbol with dabbrev.
;; Updated bindings listed in icicle-completion-help-string.
;; 2006/01/28 dadams
;; New feature: icicle-lisp-complete-symbol (added). Added to Commentary and moved section.
;; Corrected fix of 2005/12/14:
;; icicle-minibuffer-setup: Save region background at recursion level 1.
;; icicle-saved-region-background: defvar to nil.
;; Added: icicle-increment-color-hue. Use in icicle-region-background.
;; Added: icicle-(re)set-option-to-(nil|t), icicle-clear-option, icicle-toggle-option,
;; icicle-binary-option-p.
;; 2006/01/26 dadams
;; Added: icicle(-saved)(-regexp)-search-ring-max,
;; icicle-(redefine|restore)-standard-options.
;; icicle-mode: Use icicle-(redefine|restore)-standard-options.
;; Use icicle-(redefine|restore)-standard-commands for Emacs 21+ also (forgot?)
;; icicle-(redefine|restore)-*: Use defalias, not fset.
;; 2006/01/24 dadams
;; New feature: icicle-isearch-complete.
;; Added: icicle-isearch-complete, icicle-isearch-resume, icicle-bind-isearch-keys.
;; icicle-mode: add/remove isearch-mode-hook.
;; Minor bug fix: initial value was treated as icicle-last-completion-candidate.
;; Added: icicle-initial-value.
;; icicle-completing-read, icicle-read-file-name:
;; Set icicle-initial-value, not icicle-last-completion-candidate.
;; icicle-next-candidate:
;; Initialize icicle-last-completion-candidate to icicle-initial-value.
;; icicle-save-or-restore-input:
;; Don't change icicle-current-input if = icicle-initial-value
;; Renamed: icicle-init-value to icicle-init-value-flag.
;; 2006/01/23 dadams
;; Use command remapping for self-insert-command in Emacs 22.
;; Changed icicle-(re|un)map to defsubst.
;; Removed Commentary section on icicle-execute-extended-command.
;; icicle-apropos-complete-and-exit, icicle-apropos-complete-1:
;; Use flag icicle-apropos-complete-and-exit-p to suppress minibuffer-message.
;; 2006/01/22 dadams
;; Added: icicle-execute-extended-command*.
;; completing-read, icicle-read-file-name:
;; Corrected nil case for icicle-require-match-flag (bug fix).
;; Hard-code bindings, instead of using \\[...], so the simpler bindings are shown.
;; Changed C-o to C-RET for consistency (C-o still works too).
;; icicle-(bind|restore)-completion-keys: Added C-RET binding.
;; 2006/01/21 dadams
;; icicle-mouse-choose-completion:
;; Don't save selected window if it's *Completions*.
;; Added more Commentary about icicle-retrieve-last-input.
;; 2006/01/20 dadams
;; icicle-sort-and-strip-ignored: Don't ignore names if only ignored extensions match.
;; Added: icicle-apropos-complete-and-exit. Bound it in icicle-rebind-completion-maps.
;; icicle-minibuffer-setup: Don't reset icicle-require-match-flag.
;; icicle-apropos-complete: Return the list of candidates.
;; 2006/01/19 dadams
;; Added: icicle(-buffer)-require-match-flag. Thanks to Mathias Dahl for feedback.
;; Use in completing-read, read-file-name, and icicle-minibuffer-setup.
;; Re-alphabetized defcustoms.
;; 2006/01/07 dadams
;; Added :link.
;; 2005/12/31 dadams
;; Added: icicle-fix-default-directory.
;; icicle-read-file-name: Use icicle-fix-default-directory hack to fix bug.
;; 2005/12/26 dadams
;; Added icicle-sort-case-insensitively.
;; Added more parent groups for icicles group.
;; 2005/12/14 dadams
;; icicle-minibuffer-setup: Only save region background when at top level.
;; Added: icicle-Completions-frame-at-right-flag. Use in icicle-candidate-action.
;; Added: defvars for font-lock-keyword-face, font-lock-function-name-face.
;; 2005/12/09 dadams
;; Fontify icicle-define* in emacs-lisp-mode.
;; 2005/12/02 dadams
;; Added: icicle-customize-apropos*. Use in icicle-(redefine|restore)-standard-commands.
;; 2005/12/01 dadams
;; Added: icicle-repeat-complex-command, icicle-redefine-standard-commands-flag,
;; icicle-(redefine|restore)-standard-commands.
;; 2005/11/30 dadams
;; Added: icicle-apropos-zippy.
;; icicle-apropos-command, icicle-apropos-variable:
;; Corrected completing-read for do-all arg.
;; icicle-apropos-command, *-apropos-option: My version must not respect apropos-do-all.
;; 2005/11/29 dadams
;; Added: icicle-apropos*.
;; icicle-help-on-candidate: Treat plists. Message "No help" is the default.
;; 2005/11/25 dadams
;; Added: icicle-dabbrev-completion.
;; Renamed names with "*Completions*" to use "Completions", for coherence with XEmacs port.
;; 2005/11/24 dadams
;; icicle-mouse-choose-completion: Delete *Completions* window systematically.
;; 2005/11/21 dadams
;; icicle-delete-windows-on: Avoid error Attempt to delete minibuffer or sole ... window.
;; icicle-prefix-complete, icicle-apropos-complete-1, icicle-next-candidate:
;; Use icicle-delete-windows-on, not delete-window.
;; icicle-candidate-set-save: Use map in doc string.
;; icicle-compilation-search: Tidied up doc string.
;; Use #' for clarity.
;; 2005/11/20 dadams
;; icicle-completing-read: Added treatment of completions that are lists of strings.
;; Updated Commentary: new section on completions that are lists.
;; Added: icicle-list-join-string, icicle-doc, icicle-fundoc, icicle-vardoc.
;; 2005/11/15 dadams
;; Temporarily removed defadvice of next-history-element for Emacs 22. Bug reported.
;; icicle-minibuffer-prompt-end: Changed from defsubst to defun.
;; 2005/11/13 dadams
;; icicle-mouse-candidate-action: buffer-substring -> buffer-substring-no-properties.
;; icicle-completing-read: Bind, don't set, minibuffer-completion-table.
;; icicle-buffer*: Use other buffer for DEF, not INIT-VALUE.
;; Added: icicle-preselect-init-value-flag, icicle-(add|remove)-buffer-*,
;; icicle-read-from-minibuf-nil-default, icicle-buffer-list,
;; icicle-select-minibuffer-contents, icicle-completing-p.
;; icicle-minibuffer-setup:
;; Select minibuf contents if icicle-preselect-init-value-flag.
;; Only display *Completions* if icicle-completing-p.
;; Advised next-history-element.
;; 2005/11/11 dadams
;; Added: icicle-show-*Completions*-initially-flag, icicle-display-*Completions*.
;; icicle-minibuffer-setup: If icicle-show-*Completions*-initially-flag, display it.
;; 2005/11/09 dadams
;; Added: icicle-mouse-candidate-action. Bind in icicle-rebind-completion-maps.
;; icicle-buffer(-other-window): Use buffer-name-history as HIST arg to completing-read.
;; 2005/11/08 dadams
;; Add/remove hook icicle-cancel-*Help*-redirection in icicle-mode, not at top level.
;; Removed icicle-reset-icicle-menu-items-alist.
;; Reset icicle-menu-items-alist in icicle-execute-menu-command of icicles-menu.el.
;; 2005/11/06 dadams
;; Include minibuffer-local-filename-completion-map.
;; 2005/11/05 dadams
;; icicle-display-candidates-in-*Completions*: Don't try to highlight root if it is "".
;; icicle-help-on-candidate:
;; Test null, not boundp icicle-menu-items-alist.
;; If menu item's command is a lambda, set cand-symb to nil.
;; icicle-mode: Use icicle-reset-icicle-menu-items-alist on minibuffer-exit-hook.
;; Added: icicle-reset-icicle-menu-items-alist.
;; Added defvar for icicle-menu-items-alist.
;; Added byte-compiler comments and defvars to quiet byte-compile.
;; 2005/11/04 dadams
;; icicle-display-candidates-in-*Completions:
;; Bug fix - use (functionp minibuffer-completion-table), not (icicle-file-name-input-p).
;; 2005/11/03 dadams
;; Added: icicle-filter-wo-input and vars icicle-must-*, icicle-extra*, icicle-buffer-*,
;; icicle-buffer-config*, icicle-buffer-sort*.
;; icicle-unsorted-*: Use icicle-filter-wo-input and icicle-extra-candidates.
;; Added Commentary section Global Filters.
;; icicle-buffer* commands: Added filter bindings.
;; icicle-define(-file)-command: Minor bug fix: Ensure buffer is live before switching back.
;; 2005/11/01 dadams
;; Added: icicle-must(-not)-match-regexp. Use in icicle-unsorted-*-candidates.
;; 2005/10/31 dadams
;; Added: icicle-use-default-as-init-value-flag. Use in completing-read.
;; icicle-find-file*: Minor bug fix - REQUIRE-MATCH should be nil.
;; 2005/10/29 dadams
;; icicle-display-candidates-in-*Completions: Minor bug fix - wrap in save-window-excursion.
;; icicle-minibuffer-contents-from-minibuffer:
;; Minor bug fix - do nothing if file & user erased minibuffer.
;; Menu-bar menus:
;; Enable Icicles menu items only in Icicle mode. Put search
;; stuff on Search menu, if available. Use "[Icy]" prefix for
;; Icicles items in menus other than "Icicles".
;; 2005/10/28 dadams
;; Added: icicle-define-file-command.
;; Use it to define icicle-delete-file, icicle-find-file*.
;; icicle-(next|previous)-(apropos|prefix)-candidate-action:
;; Do action before moving to next|prev.
;; icicle-candidate-action: Raise *Completions* frame, to keep it on top.
;; 2005/10/27 dadams
;; Added: icicle-define-command, icicle-find-file*, select-frame-set-input-focus.
;; Redefined using icicle-define-command:
;; icicle-bookmark, icicle-buffer*, icicle-color-theme, icicle-delete-file,
;; icicle-find-file*, icicle-font, icicle-frame-*, icicle-recent-file*.
;; icicle-all-candidates-action: Report failures, not successes. Use error msg.
;; Added Commentary sections: Special-Character Conflicts, Defining Icicles Commands.
;; Commentary section Act on All Candidates: Added delete-one-or-more-files example.
;; Added icicle-find-file* to menu-bar menus.
;; Inactivated top-level menu items when minibuffer is active.
;; Renamed: icicle-delete-file-1 to icicle-delete-file-or-directory.
;; 2005/10/25 dadams
;; Thx to Lennart Borgman for suggestion about select-frame-set-input-focus.
;; 2005/10/24 dadams
;; icicle-search:
;; 1) Bug fix - need to have mouse-choose-completion set icicle-candidate-nb.
;; 2) Show error message.
;; Default value of icicle-candidate-nb is now nil, not -1.
;; Added: icicle-mouse-choose-completion, icicle-nb-of-candidate-in-*Completions*.
;; icicle-move-to-(next|previous)-completion, icicle-increment-cand-nb+signal-end:
;; Reset candidate number to 0 if nil.
;; icicle-(redefine|restore)-std-completion-fns: Use icicle-mouse-choose-completion.
;; 2005/10/23 dadams
;; Added: icicle-mode-map.
;; icicle-(bind|restore)-completion-keys: Updated menu-bar menu.
;; icicle-compilation-search: Error if not in a compilation buffer.
;; 2005/10/21 dadams
;; icicle-remove-duplicates: redefined.
;; 2005/10/18 dadams
;; icicle-file-name-input-p doc string:
;; Mention why don't use minibuffer-completing-file-name.
;; 2005/10/16 dadams
;; Added: icicle-compilation-search, icicle-search-hook.
;; icicle-search: Run icicle-search-hook. Added optional sit-for-period arg.
;; icicle-mode: Added list of top-level commands to doc string.
;; icicle-scroll-or-update-*Completions*: Added msg arg - only display msg if don't scroll.
;; 2005/10/14 dadams
;; Allow for multisets of candidates.
;; Added: icicle-search, icicle-completion-nospace-flag, icicle-candidate-nb,
;; icicle-filter-alist, icicle-increment-cand-nb+signal-end.
;; Commentary: Updated for icicle-search.
;; icicle-next-candidate: Major rewrite.
;; Uses icicle-candidate-nb, icicle-increment-cand-nb+signal-end,
;; icicle-move-to-next-completion.
;; Use icicle-completion-nospace-flag in calls to all-completions.
;; icicle-previous-(apropos|prefix)-candidate,
;; icicle-(next|previous)-(apropos|prefix)-candidate-action: Added optional arg.
;; icicle-apropos-complete-1, icicle-next-candidate, icicle-recompute-candidates:
;; Added *-action commands to memq test.
;; icicle-move-to-next-completion: Added optional no-minibuffer-follow-p arg.
;; icicle-scroll-or-update-*Completions*: Update display even if handle-switch-frame.
;; 2005/10/12 dadams
;; Added: icicle-redefine-std-completion-fns,
;; icicle-restore-std-completion-fns,
;; icicle-delete-windows-on, icicle-frames-on.
;; icicle-mode: Use icicle-redefine-std-completion-fns,
;; icicle-restore-std-completion-fns.
;; Renamed to use icicle- prefix: choose-completion-string,
;; completing-read, completion-setup-function, exit-minibuffer,
;; minibuffer-complete-and-exit, read-file-name,
;; switch-to-completions. Added these and also old- versions.
;; icicle-history: Treat file names also.
;; remove-windows-on -> icicle-delete-windows-on.
;; 2005/10/11 dadams
;; Added: icicle-history, icicle-scroll-or-update-*Completions*,
;; icicle-undo-std-completion-faces.
;; Minor bug fixes:
;; icicle-remove-dots: Also match against "." and ".." (lack of slash in Emacs 21+).
;; icicle-save-or-*: Don't reset to last input if icicle-last-completion-candidate is "".
;; Update icicle-last-completion-candidate also to use current input.
;; Reset icicle-last-input in icicle-minibuffer-setup, not in
;; completing-read and read-file-name.
;; icicle-display-candidates-in-*Completions*, icicle-next-candidate:
;; Put candidate in consp before applying predicate.
;; icicle-recompute-candidates: Don't recompute unless icicle-last-completion-command.
;; icicle-retrieve-last-input: Use icicle-current-input, not icicle-last-input.
;; icicle-self-insert: Update icicle-current-input and set this-command to
;; icicle-apropos-complete.
;; icicle-apropos-complete: Use error-message-string.
;; icicle-apropos-complete-1:
;; Protect icicle-file-directory-p with
;; icicle-file-name-input-p. Unconditionally update
;; icicle-last-completion-command.
;; Moved undoing of std completion faces to icicle-mode.
;; Use icicle-scroll-or-update-*Completions* in icicle-candidate-set-1.
;; 2005/10/06 dadams
;; icicle-prefix-complete, icicle-apropos-complete-1:
;; Removed vestigial slash cruft - should have been removed in 2005/09/01 fix.
;; Added: icicle-remove-dots. Use in icicle-save-or-restore-input.
;; 2005/10/05 dadams
;; icicle-msg-maybe-in-minibuffer: use format-string arg.
;; 2005/10/04 dadams
;; Replace use of minibuffer-completion-help by
;; icicle-apropos-complete.
;; Added: icicle-recent-file*, icicle-toggle-ignored-extensions,
;; icicle-update-completions, icicle-msg-maybe-in-minibuffer,
;; icicle-saved-ignored-extensions.
;; Bound icicle-toggle-*.
;; icicle-toggle-sorting: Use icicle-update-completions, icicle-msg-maybe-in-minibuffer.
;; icicle-sort-and-strip-ignored:
;; icicle-ignored-extensions-regexp nil => nothing is ignored.
;; Reorder key bindings, so prompt shows S-tab, not S-iso-lefttab.
;; icicle-next-candidate: Fixed code to highlight candidate in *Completions*: restriction.
;; 2005/10/03 dadams
;; Regexps can now use backslash (it is no longer a directory separator on MS Windows).
;; icicle-minibuffer-contents-from-minibuffer, icicle-file-name-directory-w-default:
;; Escape backslash, so not used as directory separator on MS Windows.
;; Added: icicle-apropos-complete-1, icicle-file-name-nondirectory.
;; icicle-apropos-complete: Use icicle-apropos-complete-1.
;; Treat regexp error via message.
;; Use icicle-file-name-nondirectory everywhere, instead of file-name-nondirectory.
;; Can now use "?" for regexps; it no longer shows completion list.
;; Do icicle-update-ignored-extensions-regexp inside icicle-minibuffer-setup.
;; Added and bound: icicle-retrieve-last-input.
;; Updated icicle-completion-help-string with recent bindings.
;; Renamed: icicle-last-command to icicle-last-completion-command.
;; icicle-candidate-set-restore to icicle-candidate-set-retrieve.
;; 2005/10/01 dadams
;; Added: icicle-candidate-set-(define|restore|swap).
;; Changed binding of icicle-candidate-set-save to C->.
;; Bound new commands.
;; 2005/10/01 dadams
;; Major rewrite to add set operations: complement, difference, union, intersection.
;; Added: icicle-completion-candidates, icicle-current-input, icicle-candidate-set-*,
;; icicle-set-*, icicle-save-or-restore-input, icicle-recompute-candidates.
;; Bound icicle-candidate-set*.
;; Added Commentary for Sets of Completion Candidates.
;; icicle-(apropos|prefix)-complete: Update icicle-completion-candidates, only as needed.
;; icicle-next-candidate:
;; Reverse candidates only if switched to opposite-direction command of same type.
;; Likewise, for refresh of *Completions*.
;; Protect put-text-property for root (e.g. no match for complement).
;; icicle-(apropos|prefix)-complete,
;; icicle-prefix-word-complete, icicle-next-candidate: Use icicle-completion-candidates.
;; icicle-all-candidates-action: Use icicle-completion-candidates, not *-apropos-complete.
;; icicle-display-candidates-in-*Completions*:
;; Removed first arg (candidates). Update icicle-completion-candidates.
;; icicle-all-candidates-action:
;; Use icicle-completion-candidates, so act on completions of either kind.
;; 2005/09/30 dadams
;; Commented out resetting of minibuffer-completion-table to nil for icompletion.
;; Thx to Andrey for bug report on M-x M-r problem.
;; 2005/09/27 dadams
;; icicle-(bind|restore)-completion-keys: Bound [S-iso-lefttab] like [S-tab].
;; 2005/09/26 dadams
;; Bug fix: Changed "\C-!" to [(control ?!)] (others similarly).
;; Bound [S-iso-lefttab] like [S-tab].
;; 2005/09/16 dadams
;; Added: icicle-all-candidates-action, icicle-delete-file*,
;; icicle-rebind-completion-maps: Bound icicle-all-candidates-action to C-!.
;; icicle-(apropos|prefix)-complete: Return candidates list.
;; icicle-bookmark, icicle-buffer*, icicle-color-theme,
;; icicle-font, icicle-frame*: Return t for success, nil for failure.
;; Commentary: Added section Choose All Completion Candidates.
;; 2005/09/14 dadams
;; icicle-rebind-completion-maps: Bound TAB and S-TAB for navigation.
;; icicle-move-to-(next|previous)-completion, icicle-(next|previous)-line: Wrap around.
;; 2005/09/13 dadams
;; Major rewrite of file treatment, to treat directory candidates similarly to files.
;; Added: icicle-default-directory, icicle-file-directory-p, icicle-sort-function,
;; icicle-toggle-sorting, toggle-icicle-sorting.
;; Use icicle-file-directory-p everywhere, except choose-completion-string.
;; Removed: icicle-nondirectory-*.
;; icicle-next-candidate: If not icicle-cycle-into-subdirs-flag, then use relative
;; file/dir name, not nondirectory part.
;; icicle-(apropos|prefix)-complete:
;; Set icicle-default-directory if sole completion is a subdirectory.
;; icicle-sort-and-strip-ignored: Removed optional arg and treatment of subdirs.
;; icicle-next-(apropos|prefix)-candidate, icicle-(apropos|prefix)-complete:
;; Don't treat icicle-cycle-into-subdirs-flag here.
;; icicle-(apropos|prefix)-complete, icicle-next-candidate:
;; Set icicle-default-directory, if directory candidate.
;; icicle-minibuffer-setup: Set icicle-default-directory.
;; icicle-apropos-complete: Different message if icicle-apropos-icompleting-p.
;; icicle-sort-dirs-last: Treat other kinds of candidates, besides files and dirs.
;; Commentary and doc strings: Updated for icicle-sort-function, icicle-cycle-into-subdirs.
;; Let delete-selection mode work with icicle-self-insert.
;; icicle-display-candidates-in-*Completions*: Make *Completions* read-only.
;; 2005/09/09 dadams
;; choose-completion-string: bug fix for Emacs 21.3.1 - use Emacs 20 version for 21.3.1.
;; 2005/09/08 dadams
;; completion-setup-function: bug fix for Emacs 21.3.1 - use Emacs 20 version for 21.3.1.
;; Added: icicle-remap, icicle-unmap, icicle-(bind|restore)-completion-keys.
;; completing-read: Do not append suffix if not in Icicle mode.
;; icicle-rebind-completion-maps:
;; Clean-up. Use icicle-(bind|restore)-completion-keys.
;; Don't (suppress-keymap completion-list-mode-map).
;; 2005/09/06 dadams
;; Provided apropos icompletion.
;; Added: icicle-self-insert, icicle-incremental-completion-flag,
;; icicle-apropos-icompleting-p.
;; icicle-apropos-complete: Respect icicle-apropos-icompleting-p.
;; Commentary: Updated Icompletion and Customization sections.
;; Added Apropos Icompletion.
;; Changed default value of icicle-word-completion-key to M-SPC.
;; icicle-rebind-completion-maps:
;; Bind icicle-self-insert. Use self-insert for SPC.
;; Updated icicle-completion-help-string. Treat menu-bar menu for the minibuffer.
;; completion-setup-function: Add instruction2 only when icicle-mode.
;; icicle-display-candidates-in-*Completions*: Use save-restriction.
;; icicle-minibuffer-contents-from-minibuffer:
;; Allow for mixing $ of environment vars with $ of regexps.
;; 2005/09/02 dadams
;; Added: icicle-bookmark, icicle-buffer(-other-window), icicle-candidate-action,
;; icicle-candidate-action-fn, icicle-color-theme(s), icicle-font,
;; icicle-frame-(b|f)g.
;; Renamed: icicle-(next|previous)-(apropos|prefix)-*-help to
;; icicle-(next|previous)-(apropos|prefix)-*-action.
;; icicle-(apropos|prefix)-complete: Set icicle-last-completion-candidate.
;; In renamed functions: Use icicle-candidate-action, not icicle-help-on-candidate.
;; icicle-rebind-completion-maps: Bound C-o to icicle-candidate-action.
;; Added Commentary section on actions on candidates.
;; icicle-move-to-next-completion: Test line num, not char position (fix).
;; icicle-previous-line: 3 or 4, not 4 or 5 (fix).
;; 2005/09/01 dadams
;; Fixed major bug: file-name completion did not work at all in non-MS Windows!
;; icicle-file-name-(apropos|prefix)-candidates:
;; Removed code for case where input starts with "/".
;; icicle-nondirectory-file-name-(apropos|prefix)-candidates:
;; Removed code for case where input starts with "/". Bind default-directory.
;; icicle-(apropos|prefix)-complete: Treat case when icicle-cycle-into-subdirs-flag = nil.
;; icicle-next-candidate: Took out code that moved point when line is too long.
;; icicle-minibuffer-setup: Reset icicle-prompt.
;; 2005/08/23 dadams
;; Added: icicle-help-on-candidate, icicle-cancel-*Help*-redirection,
;; icicle-(previous|next)-(prefix|apropos)-candidate-help. Bound them all.
;; icicle-rebind-completion-maps:
;; Bound icicle-help-on-candidate, icicle-(previous|next)-(prefix|apropos)-candidate-help.
;; 2005/08/22 dadams
;; Unconditionally require cl.el when compile (because of case).
;; 2005/08/19 dadams
;; Renamed icicle-cursor-position-in-candidate to icicle-point-position-in-candidate.
;; Added: icicle-mark-position-in-candidate, icicle-minibuffer-prompt-end.
;; icicle-place-cursor: Position both point and mark.
;; icicle-point-position-in-candidate: Change values from bob, eob to input-start/end.
;; Removed: icicle-select-rest-of-completion-flag.
;; Use inequality test on point and mark.
;; 2005/08/16 dadams
;; Minbuffer messages: Differentiate prefix from apropos completion.
;; completing-read, read-file-name: Append icicle-prompt-suffix for Emacs 20 (oversight).
;; 2005/08/15 dadams
;; Bug fix: Only use face-spec-reset-face if target faces defined.
;; read-file-name: bug fix:
;; Use condition-case to get the correct number of args for
;; old-read-file-name. Thx to Mathias Dahl for both bug reports.
;; 2005/08/14 dadams
;; icicle-place-cursor: Narrow region to exclude minibuffer-prompt
;; 2005/08/13 dadams
;; Add regexp support (removed it when introduced highlighting).
;; icicle-next-candidate: Added regexp-p arg. Use in icicle-next-apropos-candidate.
;; icicle-place-cursor: Use regexp search. For root-start, go to match-beginning.
;; icicle-unsorted-file-name-apropos-candidates: Don't use regexp-quote.
;; icicle-switch-to-*Completions*:
;; Search in restriction of mouse-face zone; repeat.
;; Treat file case (use nondirectory part). Bind case-fold-search.
;; Protect (aref <input> 0) against empty string.
;; member -> memq, for symbols.
;; 2005/08/12 dadams
;; Added: icicle-word-completion-key, icy-mode, icicle-insert-a-space.
;; icicle-rebind-completion-maps: Use icicle-word-completion-key and icicle-insert-a-space.
;; completing-read, icicle-rebind-completion-maps: Corrected bindings in doc string.
;; 2005/07/29 dadams
;; Added: icicle-change-region-background-flag, icicle-increment-color-value,
;; icicle-region-background, icicle-saved-region-background,
;; icicle-restore-region-face.
;; Added icicle-restore-region-face to minibuffer-exit-hook.
;; Require hexrgb.el.
;; Removed: icicle-select-rest-of-completion.
;; icicle-minibuffer-setup:
;; Save icicle-saved-region-background and use icicle-region-background.
;; 2005/07/28 dadams
;; Added: icicle-*Completions*-instruction-*.
;; completion-setup-function:
;; Use icicle-*Completions*-instruction-*.
;; Remove ? from instruction2. Put both instr on same line.
;; Use put-text-property, not *-w-face*.
;; ------
;; Move all completion stuff here, from simple+.el:
;; choose-completion-string, completion-setup-function, switch-to-completions.
;; Wrap *Completions* window deletion in save-selected-window.
;; Added icicle-prefix-word-complete, and bound it to SPC.
;; completion-setup-function:
;; Renamed icicle-completing-read-prompt-suffix to icicle-prompt-suffix.
;; 2005/07/27 dadams
;; Renamed: icicle-completing-read-prompt* to icicle-prompt*.
;; Added: read-file-name, face
;; icicle-completing-read-prompt-suffix, icicle-remove-property,
;; icicle-select-rest-of-completion (simple, for now).
;; completing-read: Apply faces to prompt.
;; icicle-place-cursor: Use icicle-select-rest-of-completion.
;; Added (if icicle-mode (icicle-mode 1)) at end.
;; Reworded Commentary in terms of "input completion", not just completing-read.
;; 2005/07/26 dadams
;; rebind-minibuffer-completion-maps: Minor bug fix.
;; icicle-mode: Added " Icy" to mode line.
;; Wrapped Emacs 21 version of icicle-mode (with define-minor-mode) in (eval (quote...)),
;; so byte-compiling in Emacs 20 will produce a *.elc that works in Emacs 21.
;; 2005/07/25 dadams
;; Added: icicle-mode, icicle-*-hook, icicle-minibuffer-setup, icicle-activate-mark.
;; rebind-minibuffer-completion-maps:
;; Restore bindings when exit Icicle mode.
;; Added argument. Pick up everything bound to help-command.
;; Message only when mode is turned on.
;; 2005/07/24 dadams
;; Now leave region from end of root to end of completion, so you can easily replace it,
;; especially if you use delete-selection mode. (Suggestion by Lennart Borgman.)
;; Added: icicle-select-rest-of-completion-flag.
;; icicle-place-cursor: Create active region if icicle-select-rest-of-completion-flag
;; icicle-completion-help: Removed icicle-abort-minibuffer-input.
;; icicle-abort-minibuffer-input: Removed obsolete code & comment on icomplete-inhibit.
;; 2005/07/22 dadams
;; Major fixup: Treat file and directory names well, respect standard user options, more.
;; Renamed:
;; icicle-(next|previous)?-completion-candidate to icicle-*-prefix-candidate(s),
;; icicle*filename* to icicle*file-name*,
;; icicle-descend-into-subdirs to icicle-cycle-into-subdirs-flag.
;; Added: icicle-file-name-apropos-candidates, icicle-file-name-directory-w-default,
;; icicle-file-name-input-p, icicle-file-name-prefix-candidates,
;; icicle-nondirectory-file-name-apropos-candidates,
;; icicle-nondirectory-file-name-prefix-candidates,
;; icicle-sort-dirs-last, icicle-unsorted-apropos-candidates,
;; icicle-unsorted-file-name-apropos-candidates,
;; icicle-unsorted-file-name-prefix-candidates, icicle-unsorted-prefix-candidates,
;; icicle-last-command.
;; Respect insert-default-directory and completion-auto-help.
;; Use minibuffer-message instead of message.
;; Commentary: Added Customization & Tips section.
;; completing-read: Save icicle-last-input. Reset icicle-nb-of-other-cycle-candidates.
;; icicle-next-*-candidate: Branch to file-specific functions.
;; icicle-*-candidates: Use icicle-unsorted-*-candidates.
;; icicle-next-candidate:
;; Delete *Completions* window if no candidates.
;; Use icicle-file-name-directory, not file-name-directory.
;; icicle-minibuffer-contents-from-minibuffer: Use substitute-in-file-name.
;; icicle-*-complete:
;; Treat slashed file names (e.g. "/foo").
;; Use icicle-file-name-*-candidates, icicle-file-name-directory-w-default for files.
;; Added messages [No completion], [Sole completion], [Complete, but not unique].
;; Use icicle-last-command for repetition test. And set it.
;; icicle-rebind-completion-maps: Updated icicle-completion-help-string and message.
;; 2005/07/21 dadams
;; icicle-apropos-candidates: Use, not apropos, but delete-if-not on string-match.
;; Treat files too.
;; Removed icicle-intersection.
;; Added: icicle-descend-into-subdirs.
;; icicle-sort-and-strip-ignored: Use icicle-descend-into-subdirs. Don't use "." and "..".
;; icicle-next-candidate:
;; File names w/o dir.
;; Use regexp-quote on root for underlining file-name root.
;; Insert directory name for file.
;; icicle-place-cursor: Search past dir, then search for file-name w/o dir.
;; icicle-prefix-complete, icicle-apropos-complete,
;; icicle-switch-to-*Completions*: Use icicle-minibuffer-contents-from-minibuffer.
;; icicle-prefix-complete, icicle-apropos-complete: Insert dir when single candidate.
;; icicle-display-candidates-in-*Completions*: Underline file-name w/o dir.
;; 2005/07/20 dadams
;; icicle-next-candidate, *-display-candidates-in-*Completions*: Use set-buffer-modified-p.
;; icicle-next-candidate: Use ding when hit end of cycle.
;; Added: icicle-cursor-position-in-candidate, icicle-place-cursor.
;; Use in icicle-next-candidate to position cursor.
;; Added: defgroup icicles.
;; 2005/07/19 dadams
;; Initialize icicle-ignored-*.
;; Added: icicle-nb-of-other-cycle-candidates, icicle-minibuffer-contents-from-minibuffer.
;; completing-read: Reset icicle-last-completion-candidate to nil.
;; icicle-next-candidate:
;; Use icicle-minibuffer-contents-from-minibuffer.
;; Save icicle-nb-of-other-cycle-candidates for icomplete-completions (icomplete+).
;; Use copy of "next" string since change its text properties.
;; Use regexp-quote for underlined root.
;; Use put-text-property, so works in Emacs 20.
;; Update *Completions*, even if last command is repeated.
;; icicle-*-complete: Complete rewrite.
;; icicle-display-candidates-in-*Completions*: Do even if last command is repeated.
;; 2005/07/18 dadams
;; icicle-display-*: Highlight only first occurrence in each candidate.
;; icicle-next-candidate: Use completion-ignore-case.
;; 2005/07/17 dadams
;; Treat file names also.
;; Added: icicle-delete-if*, and use instead of delete-if-*. Removed require cl.el.
;; Added: icicle-ignored-extensions*, icicle-sort-and-strip-ignored,
;; icicle-filename-input-p, icicle-update-ignored-extensions-regexp,
;; icicle-prefix-complete. Bound icicle-prefix-complete.
;; Use icicle-update-ignored-extensions-regexp as minibuffer-setup-hook.
;; icicle-*-candidates: Use icicle-sort-and-strip-ignored.
;; icicle-next-candidate, icicle-display-candidates-in-*Completions*:
;; Don't use predicate on file-name candidates (icicle-filename-input-p).
;; icicle-next-candidate:
;; Use read-file-name-completion-ignore-case (Emacs 22) and file-name-nondirectory.
;; icicle-apropos-complete: Return t/nil. Treat single candidate as no-op.
;; Reset std completions-* faces, so they don't interfere with apropos highlighting.
;; 2005/07/16 dadams
;; Added: icicle-display-*, icicle-apropos-complete.
;; Use icicle-display-* in icicle-next-candidate and icicle-apropos-complete.
;; Bound icicle-apropos-complete to S-tab in completion maps.
;; icicle-switch-to-*Completions*:
;; Move to start of candidate. Highlight candidate, not regexp.
;; icicle-next-candidate: Underline the root that was completed.
;; Added: faces icicle-root-highlight-*.
;; Removed: faces: icicle-completion-help*.
;; Removed (not used): require of strings.el.
;; Commentary: Added Nutshell View.
;; 2005/07/15 dadams
;; Renamed: icicle-completion-help+ to icicle-completion-help.
;; Replaced: icicle-delete-lines by icicle-erase-minibuffer.
;; icicle-next-candidate:
;; Wrapped display-* and re-search-forward in condition-case. Use icicle-place-overlay.
;; Changed icicle-completion-help bindings to [f1].
;; Added: icicle-*-line, icicle-switch-to-*, icicle-move-to-*-completion,
;; icicle-current-completion-in-*Completions*, icicle-place-overlay.
;; Added bindings for icicle-*-line, icicle-switch-to-*, icicle-move-to-*.
;; Bound q to icicle-abort-minibuffer-input in completion-list-mode-map.
;; icicle-completing-read-prompt-suffix: Mention both [f1] and ?.
;; Removed: icicle-fit-frame.
;; Commentary: Added How...Improves...(5). Updated Key Bindings.
;; 2005/07/14 dadams
;; icicle-next-candidate:
;; Update *Completions*, if displayed, to reflect current
;; candidates, but don't do it if this-command = last-command.
;; Reverse list as needed, to keep same order. Ensure current
;; *Completions* choice shows in window (recenter as needed).
;; For highlighting: Search with re-search-forward to be sure to get the right one.
;; Took test for presence of predicate out of loop.
;; Commentary: Added Note on pop-up-frames = t.
;; 2005/07/13 dadams
;; Rewrote icicle-apropos-candidates.
;; Added: icicle-intersection.
;; 2005/07/12 dadams
;; Added: icicle-(next|previous)-apropos-candidate, icicle-next-candidate,
;; icicle-apropos-candidates, icicle-completion-candidates.
;; Bound: icicle-(next|previous)-apropos-candidate.
;; Renamed: icicle-completion-help-(title-)face: Removed "-face".
;; icicle-next-completion-candidate: Redefined to use icicle-next-candidate.
;; icicle-rebind-completion-maps: Updated text to mention apropos completion.
;; icicle-completion-help+: Use icicle-abort-minibuffer-input, not abort-recursive-edit.
;; 2005/07/10 dadams
;; First version of icicles.el (previously called elect-mbuf.el).
;; Renamed: minibuffer-completion-help-string to icicle-completion-help-string,
;; completing-read-prompt to icicle-completing-read-prompt,
;; completing-read-prompt-suffix to icicle-completing-read-prompt-suffix,
;; mbuf-completion-help-face to icicle-completion-help-face,
;; mbuf-completion-help-title-face to icicle-completion-help-title-face,
;; minibuffer-last-default to icicle-last-completion-candidate,
;; command-calling-for-completion to icicle-cmd-calling-for-completion,
;; minibuffer-completion-help+ to icicle-completion-help+,
;; abort-minibuffer-input to icicle-abort-minibuffer-input,
;; next-default-input to icicle-next-completion-candidate,
;; previous-default-input to icicle-previous-completion-candidate,
;; rebind-minibuffer-completion-maps to icicle-rebind-completion-maps,
;; Added: minibuffer-complete-and-exit, icicle-fit-frame, icicle-last-input.
;; Moved delete-lines here from and renamed to icicle-delete-lines.
;; Removed: mod+ (unused).
;; icicle-completion-help+: Use *Help*, not *Completions*. Don't show completions.
;; icicle-next-completion-candidate: Use insert, not insert-string.
;; icicle-rebind-completion-maps: Made it interactive.
;; 2005/07/09 dadams
;; Removed: buffer-alist (not used).
;; 2005/05/15 dadams
;; Renamed: flash-ding-minibuffer-frame to 1on1-flash-ding-minibuffer-frame.
;; 2005/05/10 dadams
;; Hacked completing-read to remove *Completions* window at end if require-match is non-nil.
;; (Don't know why/when this became a problem.)
;; 2004/09/21 dadams
;; Updated to work in Emacs 21 (and 20):
;; next-default-input uses delete-minibuffer-contents for 21, but erase-buffer for 20.
;; minibuffer-completion-help+: bind inhibit-read-only to t around erase-buffer.
;; 2001/01/10 dadams
;; Protected remove-windows-on via fboundp.
;; 1999/09/03 dadams
;; Added: mbuf-completion-help-face, mbuf-completion-help-title-face.
;; minibuffer-completion-help+: Use mbuf-*-face's instead of hard-coding.
;; minibuffer-completion-help-string, completing-read-prompt-suffix: defconst -> defvar.
;; 1999/08/26 dadams
;; Protected faces via boundp.
;; 1999/04/13 dadams
;; Bound delete-lines to M-S-DEL and M-S-backspace.
;; 1999/03/17 dadams
;; protect calls with test fboundp.
;; 1996/04/26 dadams
;; Put escaped newlines on long-line strings.
;; 1996/03/26 dadams
;; minibuffer-completion-help+: concat -> concat-w-faces (color).
;; 1995/12/20 dadams
;; exit-minibuffer: Iconify *Completion* frame.
;; 1995/12/15 dadams
;; abort-minibuffer-input: Reset minibuffer-completion-table to avoid icompletion.
;; Defined replacement exit-minibuffer to do the same as #1.
;; 1995/12/01 dadams
;; abort-minibuffer-input: Incorporated delete-selection-mode code
;; rebind-minibuffer-completion-maps:
;; Added C-g bindings for minibuffer-local-map, minibuffer-local-ns-map,
;; minibuffer-local-isearch-map.
;; 1995/10/25 dadams
;; Put defvar of minibuffer-completion-help-string after do
;; rebind-minibuffer-completion-maps, so its doc string gives bindings.
;; 1995/10/24 dadams
;; Mention ESC-TAB completion in completing-read.
;; 1995/10/17 dadams
;; Let minibuffer use ESC-TAB for completion (Lisp symbols etc.)
;; completing-read: Minibuffer adopts current buffer's ESC-TAB binding.
;; Added command-calling-for-completion to memorize current command (done in
;; completion-setup-hook).
;; 1995/09/12 dadams
;; Added abort-minibuffer-input.
;; Define C-g as abort-minibuffer-input in completion-list-mode-map and
;; minibuffer-local-* maps.
;; No self-insertion for completion-list-mode-map.
;; 1995/08/16 dadams
;; next-default-input: Fixed bug - skip repeated alist entries.
;; 1995/08/10 dadams
;; Rewrote minibuffer-completion-help+: Provide help even if no completions.
;; So, added minibuffer-completion-help-string.
;; `?' defined correctly for minibuffer-local-must-match-map.
;; 1995/08/08 dadams
;; next-default-input: error msg: no hard coding of key seq.
;; 1995/08/02 dadams
;; Major rewrite.
;; No reminders in prompts. Added minibuffer-completion-help+ to provide help info for
;; *Completions*.
;; Log for functions that were previously in simple+.el:
;; choose-completion-string, completion-setup-function, switch-to-completions.
;; 2005/07/28 dadams
;; completion-setup-function:
;; Renamed icicle-completing-read-prompt-suffix to icicle-prompt-suffix.
;; 2005/07/15 dadams
;; choose-completion-string, completion-setup-function: Updated for Emacs 21+.
;; 2005/07/10 dadams
;; Renamed: command-calling-for-completion to icicle-cmd-calling-for-completion.
;; 2004/09/21 dadams
;; Only redefine choose-completion-string if prior to Emacs 21.
;; 1999/03/17 dadams
;; choose-completion-string:
;; Added doc string. Updated to correspond to Emacs 34.1.
;; completion-setup-function: diff prompt setups. face1 & face2 tests.
;; Added: switch-to-completions.
;; 1996/04/26 dadams
;; Put escaped newlines on long-line strings.
;;;(@* "CHANGE LOG FOR `icicles-cmd.el'" - Deprecated file)
;;
;; 2009/05/22 dadams
;; Split in two: icicles-cmd1.el, icicles-cmd2.el. File too large to upload to Emacs Wiki.
;; 2009/05/20 dadams
;; Renamed: *-Info-build-node-completions-fix-* to *-Info-build-node-completions-1.
;; icicle-Info-goto-node: Plain C-u now prepends Info file name to candidates.
;; icicle-Info-goto-node-1: swapped arg order in call to Info-goto-node nodename (bug fix).
;; icicle-Info-read-node-name, icicle-Info-build-node-completions(-1):
;; Added optional arg INCLUDE-FILE-P.
;; 2009/05/11 dadams
;; icicle-complete-keys: Use icicle-local-keys-first-p as icicle-sort-function.
;; Bind icicle-hist-cands-no-highlight to ("..").
;; icicle-keys+cmds-w-prefix: Propertize candidate "..".
;; icicle-dabbrev-completion: Use icicle-upcase.
;; 2009/05/10 dadams
;; Added: icicle-search-(defs|lines|paragraphs|sentences|pages).
;; icicle-plist: Pretty-print, unless negative prefix arg (or Emacs 20).
;; icicle-search-regexp-scan: Fix to pick up candidate at eob: removed (not (eobp)) test.
;; 2009/05/05 dadams
;; icicle-find-file-(absolute|in-tags-table)(-other-window),
;; icicle-(recent|locate)-file(-other-window), icicle-describe-option-of-type,
;; icicle-(vardoc|fundoc|doc|plist), icicle-goto-global-marker:
;; Remove quote before face name, for icicle-candidate-properties-alist value.
;; icicle-buffer(-other-window|-list), icicle-kill-buffer, icicle-choose-candidate-of-type:
;; Bind completion-ignore-case, based on read-buffer-completion-ignore-case.
;; 2009/05/01 dadams
;; Added: icicle-shell-command-on-file.
;; Bind both icicle-all-candidates-list-alt-action-fn and icicle-candidate-alt-action-fn
;; to icicle-alt-act-fn-for-type for appropriate type - same commands as for 2009/04/26,
;; except removed these for *recent* (mistaken).
;; Use renaming from icicles-fn.el: *-choose-action-for-type -> *-alt-act-fn-for-type.
;; 2009/04/28 dadams
;; icicle-object-action:
;; At end, just apply the fn returned by icicle-choose-action-for-type to chosen object.
;; Use icicle-type-actions-alist, not icicle-object-named-types.
;; Update to use with icicle-predicate-types-alist (not flat list of preds).
;; icicle-choose-candidate-of-type: Handle color type too.
;; icicle-get-anything-actions-for-type:
;; Highlight Anything actions using face icicle-special-candidate.
;; 2009/04/26 dadams
;; icicle-marker+text, icicle-compilation-search-in-context-fn:
;; Bind inhibit-field-text-motion to t, to ensure real end-of-line.
;; Load icicles-mac (at compile time) using load-library, to ensure latest .elc.
;; Bind icicle-candidate-alt-action-fn, where appropriate, to icicle-choose-action-for-type:
;; *-lisp-complete-symbol, *-customize-face(-other-window), *-execute-extended-command,
;; *-command-abbrev, *-command-abbrev-command, *-execute-named-keyboard-macro,
;; *-set-option-to-t, *-reset-option-to-nil, *-toggle-option, *-select-frame,
;; *-delete-windows, *-kill-buffer, icicle-buffer(-other-window),
;; *-(add|remove)-buffer-candidate, *-(buffer|face|file|directory)-list,
;; *-find-file(-absolute|-in-tags-table)(-other-window),
;; *-(recent|locate)-file(-other-window), *-frame-(bg|fg), *-where-is,
;; *-apropos(-variable|option|function|command), *-apply, *-save-string-to-variable,
;; *--choose-candidate-of-type, *-read-var-value-satisfying, *-read-color.
;; icicle-execute-extended-command-1, icicle-command-abbrev-action:
;; Rebind icicle-candidate-alt-action-fn to nil so we don't override it for invoked cmd.
;; icicle-object-action: Respect icicle-use-anything-candidates-flag.
;; 2009/04/25 dadams
;; icicle-find-file-in-tags-table(-other-window): Fixed copy+paste typo.
;; 2009/04/24 dadams
;; Added: icicle-find-file-in-tags-table(-other-window).
;; 2009/04/19 dadams
;; icicle-customize-apropos-options-of-type, icicle-dabbrev-completion:
;; Don't fset unless standard function is defined.
;; Use when/unless instead of or for fset's. (cosmetic)
;; 2009/04/18 dadams
;; Soft-require hexrgb.el unconditionally, not just when there is a window-system.
;; icicle-read-color: Error if hexrgb is not loaded.
;; 2009/04/11 dadams
;; Added: icicle-region-add-short-help.
;; icicle-font-w-orig-size: Construct short help only if user will see it.
;; icicle-describe-opt-of-type-complete, icicle-marker+text,
;; icicle-(select|search|remove)-region, icicle-search-(regexp|char-property)-scan:
;; Add short help for mode-line and tooltip.
;; icicle-region-help: Corrected start/end order.
;; icicle-region-help, icicle-search-help: Removed unused help: No help.
;; 2009/04/10 dadams
;; icicle-font-w-orig-size: Provide help string. Set font to use orig-pointsize also.
;; icicle-font: Modify frame - don't use menu-bar-mode. Get orig menu-bar info from frame.
;; Save orig-pointsize also.
;; icicle-frame-(bg|fg):
;; Incorporate behavior of icicle-read-color: multi-completion etc. Added short help.
;; (Use icicle-make-color-candidate, icicle-color-completion-setup.)
;; icicle-read-color:
;; Factored out stuff as new function icicle-color-completion-setup.
;; Corrected handling of ARG > 2.
;; Moved to icicles-fn.el:
;; icicle-color-help, icicle-make-color-candidate, icicle-remove-color-duplicates.
;; 2009/04/09 dadams
;; Added: icicle-font-w-orig-size.
;; icicle-font: Use icicle-font-w-orig-size. No menu bar, to avoid Emacs frame-sizing bug.
;; 2009/04/04 dadams
;; icicle-kill-buffer, icicle-buffer(-other-window|-list), icicle-choose-candidate-of-type:
;; Bind icicle-sort-functions-alist for buffer names.
;; 2009/03/29 dadams
;; icicle-make-color-candidate: Use white or black foreground, depending on color value.
;; 2009/03/27 dadams
;; Renamed: icicle-default-buffer-name to icicle-default-buffer-names.
;; icicle-buffer(-other-window):
;; Bind bufflist, to make it available also to icicle-default-buffer-names.
;; icicle-default-buffer-names: Emacs 23: Provide first 4 buffers from bufflist.
;; 2009/03/26 dadams
;; Added: icicle-default-buffer-name.
;; icicle-buffer(-other-window), icicle-add-buffer-candidate:
;; Use icicle-default-buffer-name.
;; 2009/03/16 dadams
;; icicle-buffer(-other-window), icicle-buffer-list, icicle-kill-buffer,
;; icicle-add-buffer-candidate: Treat prefix arg buffers visiting files or frame-local.
;; icicle-recent-file(-other-window): Bind icicle-use-candidates-only-once-alt-p to t.
;; 2009/03/15 dadams
;; Added: icicle-remove-file-from-recentf-list, icicle-remove-from-recentf-candidate-action.
;; icicle-recent-file(-other-window):
;; Bind icicle-candidate-alt-action-fn to icicle-remove-from-recentf-candidate-action.
;; 2009/03/10 dadams
;; Added: icicle-recompute-shell-command-candidates.
;; 2009/02/28 dadams
;; icicle-find-file-absolute(-other-window):
;; Treat directory candidates as special candidates.
;; icicle-apropos: Treat functions as special candidates.
;; icicle-apropos-variable: Treat user options as special candidates.
;; icicle-apropos-function: Treat commands as special candidates.
;; icicle-apropos-command (non-apropos-fn+var version): Treat cmds as special candidates.
;; 2009/02/23 dadams
;; icicle-Info-goto-node-action:
;; Protect dir insertion with icicle-extra-candidates-dir-insert-p.
;; 2009/02/17 dadams
;; icicle-lisp-complete-symbol:
;; Added predicate arg. Updated wrt Emacs 23 (better var completion).
;; 2009/02/01 dadams
;; icicle-(find-file-absolute|(recent|locate)-file)(-other-window):
;; Bind C-backspace to icicle-up-directory.
;; 2009/01/18 dadams
;; icicle-dired-saved-file-candidates(-other-window):
;; If there is no saved set, then use icicle-file-list to let user choose a set.
;; Added: icicle-dired-chosen-files(-other-window), as aliases.
;; 2009/01/14 dadams
;; Same commands as yesterday: icicle-remove-duplicates -> icicle-remove-dups-if-extras.
;; 2009/01/13 dadams
;; icicle-kill-buffer, icicle-buffer(-other-window), icicle-(buffer|file|directory)-list,
;; icicle-find-file(-absolute)(-other-window), icicle-(recent|locate)-file(-other-window),
;; icicle-choose-candidate-of-type:
;; Bind icicle-transform-function to icicle-remove-duplicates.
;; 2009/01/05 dadams
;; Added: icicle-gud-gdb-complete-command.
;; icicle-shell-dynamic-complete(-as)-environment-variable: (require 'shell)
;; icicle-shell-dynamic-complete-as-command: Added candidate help for shell commands.
;; 2009/01/04 dadams
;; Added ESS support:
;; Added: icicle-comint-replace-by-expanded-filename, icicle-ess-complete-filename,
;; icicle-ess(-internal)-complete-object-name, icicle-ess-R-complete-object-name.
;; Thx to Sebastian Luque.
;; Improved some doc strings.
;; 2009/01/02 dadams
;; icicle-comint-dynamic-complete-as-filename, icicle-comint-dynamic-simple-complete:
;; Fixed for comint-completion-autolist, absolute directories. Thx to Sebastian Luque.
;; 2009/01/01 dadams
;; icicle-comint-replace-orig-completion-fns:
;; Use icicle-comint-dynamic-complete-replacements instead of hard-coded list.
;; icicle-comint-dynamic-simple-complete: Fix for Emacs 20: map #'list over completions.
;; 2008/12/30 dadams
;; Removed: shell-hook-fn.
;; Removed fset here for: old-comint-dynamic-*, old-shell-dynamic-*, old-bbdb-complete-name.
;; icicle-comint-dynamic-simple-complete: Map #'list over candidates (for Emacs 20).
;; icicle-comint-hook-fn:
;; Don't bind icicle-comint-command here - do it in icicle-bind-other-keymap-keys.
;; 2008/12/27 dadams
;; Removed: icicle-find-file(-other-window)-w-wildcards.
;; Removed soft require of dired+.el.
;; icicle-find-file(-other-window):
;; Use just find-file* with wildcards arg, not *-w-wildcards, as action fn.
;; Bind icicle-default-value so that it won't insert the default value.
;; icicle-find-file(-other-window), icicle-choose-candidate-of-type:
;; Use nil as 3rd read-file-name arg, if not in Dired on a file name.
;; 2008/12/23 dadams
;; icicle-comint-dynamic-complete-as-filename: Bind use-dialog-box to nil.
;; 2008/12/22 dadams
;; icicle-comint-dynamic-complete-as-filename: Use INIT and PRED in read-file-name call.
;; 2008/12/21 dadams
;; Added: icicle-shell-hook-fn, (icicle|old)-comint-dynamic-complete(-filename),
;; (icicle|old)-shell-dynamic-complete-(command|filename|environment-variable),
;; icicle-comint-replace-orig-completion-fns, icicle-comint-dynamic-simple-complete,
;; icicle-comint-dynamic-complete-as-filename,
;; icicle-shell-dynamic-complete-as-(command|environment-variable).
;; Renamed: icicle-comint-send-input to icicle-comint-search-send-input,
;; icicle-comint-get-final-choice to icicle-comint-search-get-final-choice,
;; icicle-comint-get-minibuffer-input to icicle-comint-search-get-minibuffer-input.
;; Require shell.el at compile time.
;; Use fn, not var, confirm-nonexistent-file-or-buffer. Thx to Daniel Clemente.
;; 2008/12/02 dadams
;; Removed all use of icicle-file-ignore-space-prefix-flag (removed).
;; 2008/11/23 dadams
;; Updated wrt Emacs 23:
;; find-file-confirm-nonexistent-file -> confirm-nonexistent-file-or-buffer.
;; icicle-buffer*, icicle-add-buffer-candidate, icicle-choose-candidate-of-type:
;; Added confirm-nonexistent-file-or-buffer.
;; 2008/11/22 dadams
;; icicle-command-abbrev, icicle-remove-buffer-config-action, icicle-find-file-absolute*,
;; icicle-(recent|locate)-file*, icicle-describe-option-of-type,
;; icicle-(vardoc|fundoc|plist|doc), icicle-complete-keys-1, icicle-read-color:
;; Put icicle-fancy-candidates property on prompt when appropriate.
;; icicle-(find|recent|locate)-file(-absolute)(-other-window):
;; Support find-file-confirm-nonexistent-file (Emacs 23).
;; 2008/11/17 dadams
;; Added: icicle-find-first-tag-action, icicle-find-first-tag-other-window-action.
;; icicle-find(-first)-tag(-other-window), icicle-find-tag-action: Crosshairs highlighting.
;; icicle-find-first-tag(-other-window): Use icicle-find-first-tag(-other-window)-action.
;; Mention crosshairs.el in doc strings of commands that use it.
;; 2008/11/14 dadams
;; icicle-locate-file*: Use face icicle-candidate-part only for negative prefix arg.
;; 2008/11/09 dadams
;; icicle-explore: When only 1 candidate, no completion. Thx to Hannes Janetzek.
;; 2008/11/04 dadams
;; Removed compile-time require of palette.el or eyedropper.el. Thx to Andrey Zhdanov.
;; icicle-read-color: Moved soft require of palette.el or eyedropper.el to beginning.
;; Removed: icicle-generic-S-tab.
;; icicle-add-key+cmd: Removed test for icicle-generic-S-tab.
;; 2008/11/03 dadams
;; icicle-insert-for-yank: push-mark first. Thx to Fabrice Knevez.
;; Renamed: icicle-insert-kill to icicle-completing-yank,
;; icicle-yank-insert to icicle-yank-maybe-completing.
;; icicle-search: Restored binding of icicle-searching-p (somehow, accidentally removed it).
;; 2008/11/02 dadams
;; icicle-(doc|vardoc|fundoc|plist):
;; Prefix arg uses candidates cache. Tighten scope of condition-case.
;; icicle-doc:
;; Show all of fn, var, and face doc that are available. Thx to Fabrice Knevez.
;; Use multi-completion: added symbol name and type.
;; icicle-doc-action: (intern (icicle-transform-multi-completion...)), not assoc.
;; 2008/10/27 dadams
;; icicle-find(-first)-tag*: Bind case-fold-search too.
;; 2008/10/26 dadams
;; icicle-(file|directory)-list, icicle-find-file(-absolute)(-other-window),
;; icicle-(locate|recent)-file(-other-window): Bind to icicle-file-* options.
;; icicle-locate-file*, icicle-recent-file*:
;; Bind icicle-abs-file-candidates, icicle-delete-candidate-object.
;; Move init code into bindings.
;; icicle-find-first-tag*: Move init code into bindings.
;; 2008/10/24 dadams
;; Find-tag fixes. Thx to Per Nordlow.
;; icicle-find-tag: Bind completion-ignore-case also for call to icicle-explore.
;; icicle-find-tag-define-candidates-1:
;; Look for regexp followed by DEL, through eol. Move to bol, then next line.
;; icicle-explore: Call icicle-get-alist-candidate with NO-ERROR-P arg.
;; 2008/10/23 dadams
;; icicle-find-tag: Use nil for REQUIRE-MATCH in call to icicle-explore.
;; 2008/10/21 dadams
;; icicle-search-read-context-regexp: Bound icicle-candidate-(action|help)-fn to nil.
;; icicle-search-define-candidates-1: Added error message - better than generic explore msg.
;; Moved enable-recursive-minibuffers from *-search-region to *-search-region-action.
;; icicle-search-region-action: Added message if no such file.
;; 2008/10/18 dadams
;; Replaced customize-save-variable by funcall icicle-customize-save-variable-function.
;; icicle-bookmark(-other-window): Use icicle-bookmark-cleanup. Removed completion default.
;; Added: icicle-bookmark-cleanup: Select orig-window at end. Thx to Andrey Zhdanov.
;; 2008/10/17 dadams
;; Added: icicle-bookmark-cmd.
;; 2008/10/16 dadams
;; icicle-bookmark-jump-1: Fixed for Emacs 23. Thx to Andrey Zhdanov.
;; 2008/10/12 dadams
;; Added: icicle-search-ibuffer-marked, icicle-search-buff-menu-marked.
;; icicle-search-dired-marked: Removed unused let binding.
;; 2008/10/11 dadams
;; icicle-Info-index-20: Use symbol at point as default index topic.
;; 2008/10/05 dadams
;; icicle-Info-read-node-name: Use lax completion. Thx to Richard Kim.
;; 2008/09/22 dadams
;; icicle-dired-project(-other-window):
;; Map expand-file-name over absolute file names, to expand ~ in fileset entries.
;; 2008/09/20 dadams
;; icicle-find-file-absolute(-other-window): abs-file-list -> icicle-abs-file-list.
;; 2008/09/19 dadams
;; icicle-add-entry-to-saved-completion-set:
;; Use only the fileset name, not the whole fileset, in the (:fileset...) entry.
;; icicle-remove-entry-from-saved-completion-set: Rewrote.
;; Either the entry to remove or the set to remove it from can now be a fileset.
;; icicle-dired-save-marked-persistently: Added FILESETP arg, so you can save in a fileset.
;; icicle-dired-project(-other-window): Include filesets as project candidates.
;; Renamed: icicle-dired-save-marked-to-cache-file to icicle-dired-save-marked-persistently.
;; Moved icicle-kill-a-buffer to icicles-fn.el.
;; 2008/09/15 dadams
;; icicle-(add|remove)-candidate-(to|from)-saved-completion-set: Use :fileset keyword.
;; icicle-search-where-arg, icicle-search-where-arg:
;; Wrap icicle-(file|buffer)-list with save-selected-window.
;; 2008/09/14 dadams
;; Renamed: icicle-(add|remove)-candidate-(to|from)-saved-completion-set to
;; icicle-(add|remove)-entry-(to|from)-saved-completion-set.
;; icicle-add-entry-to-saved-completion-set: Treat fileset entries, not just strings.
;; icicle-(add|remove)-entry-(to|from)-saved-completion-set,
;; icicle-remove-saved-completion-set, icicle-dired-project(-other-window):
;; No default value for completing-read.
;; 2008/09/13 dadams
;; Use renamings from icicles-mcmd.el:
;; icicle-candidate-set-save-to-cache-file to icicle-candidate-set-save-persistently,
;; icicle-candidate-set-retrieve-from-cache-file to *-candidate-set-retrieve-persistent.
;; 2008/09/11 dadams
;; Added: icicle-grep-saved-file-candidates.
;; 2008/09/09 dadams
;; Added: icicle-remove-saved-set-action: No longer set minibuffer-completion-table or call
;; icicle-complete-again-update.
;; icicle-dired-save-marked-(to-(variable|cache-file)|as-project),
;; icicle-dired-project(-other-window).
;; Renamed: icicle-candidate-set-dired-marked-save(-more) to icicle-dired-save-marked(-more)
;; icicle-remove-saved-completion-set:
;; Prompt and delete cache file. Use icicle-remove-saved-set-action as action function.
;; Bind: icicle-whole-candidate-as-text-prop-p, icicle-use-candidates-only-once-flag.
;; Remove *Completions* window at end.
;; 2008/09/08 dadams
;; icicle-dired-saved-file-candidates(-other-window):
;; Don't change to relative file names - use whichever form (abs, rel) is saved.
;; icicle-find-tag-define-candidates-1: Make sure tag is not empty before (aref tag 0).
;; icicle-find-file-absolute(-other-window):
;; Use default-directory as init value and default value.
;; 2008/09/03 dadams
;; icicle-bookmark(-other-window), icicle-goto-marker-1:
;; Use crosshairs-unhighlight, not icicle-unhighlight-crosshairs+cleanup.
;; icicle-goto-marker-1: Bind orig-buff.
;; *-bookmark-jump-1, *-goto-marker-1-action, *-compilation-search-in-context-fn:
;; Use crosshairs-highlight, not icicle-highlight-crosshairs.
;; 2008/09/02 dadams
;; Added: icicle-dabbrev--abbrev-at-point.
;; icicle-dabbrev-completion: Use icicle-dabbrev--abbrev-at-point. Thx to Tomer Levin.
;; 2008/09/01 dadams
;; Added: icicle-bookmark-jump(-other-window), icicle-bookmark-jump-1.
;; Removed: icicle-bookmark-other-window-action.
;; icicle-bookmark(-other-window): Use icicle-bookmark-jump(-other-window) as action fn.
;; Clean up crosshairs highlighting at end.
;; icicle-goto-marker-1:
;; Don't bind minibuffer-exit-hook. Don't require crosshairs.el or hl-line+.el.
;; Use icicle-unhighlight-crosshairs+cleanup for the cleanup.
;; icicle-compilation-search: Don't require hl-line+.el.
;; icicle-compilation-search-in-context-fn: Use icicle-highlight-crosshairs.
;; 2008/08/31 dadams
;; icicle-goto-marker-1-action:
;; Use col-highlight-(un)highlight, not crosshairs-flash. Force redisplay.
;; Add col-highlight-unhighlight to pre-command-hook.
;; Use hl-line-highlight-now, not hl-line-flash.
;; icicle-goto-marker-1: Remove col-highlight-unhighlight from pre-command-hook at end.
;; icicle-customize-face(-other-window, icicle-execute-extended-command-1,
;; icicle-find-tag-action, icicle-insert-thesaurus-entry, icicle-apply(-list)-action,
;; icicle-search-action, icicle-tags-search, icicle-choose-anything-candidate:
;; Select window before call select-frame-set-input-focus.
;; 2008/08/25 dadams
;; icicle-find-file-absolute(-other-window), icicle-(recent|locate)-file(-other-window):
;; Use lax completion and provide WILDCARDS arg to find-file.
;; 2008/08/24 dadams
;; Use renaming from icicles-fn.el: icicle-minibuffer-contents to icicle-minibuf-input.
;; 2008/08/23 dadams
;; icicle-clear-history: Wrap default value, minibuffer-history-variable, with symbol-name.
;; 2008/08/21 dadams
;; Added: icicle-file(-other-*), icicle-find-file-absolute(-other-*). Thx to Glauber M4.
;; Soft-require bbdb-com.el at compile time. Don't require bbdb.el at load time - define
;; old-bbdb-* only if original is already defined.
;; icicle-bbdb-complete-name: Raise error if BBDB not loaded.
;; 2008/08/20 dadams
;; icicle-bbdb-complete-name, icicle-clear-current-history: Replaced ding by icicle-ding.
;; 2008/08/18 dadams
;; icicle-clear-history:
;; Moved icicle-use-candidates-only-once-flag binding to icicle-clear-history-1.
;; icicle-delete-windows: Bind icicle-inhibit-try-switch-buffer.
;; icicle-insert-kill: Bind icicle-sort-function to nil.
;; icicle-recent-file(-other-window):
;; Bind *-candidate-properties-alist and *-list-use-nth-parts to nil if no prefix arg.
;; icicle-goto(-global)-marker:
;; Bind icicle-sort-function(s-alist) differently in each - don't bind in *-goto-marker-1.
;; icicle-remove-region: Use just icicle-delete-region-from-alist as action function.
;; icicle-delete-region-from-alist:
;; Use the propertized region name, not just reg-name in the cons to delete.
;; Moved icicle-cdr-less-p to icicles-fn.el and renamed to icicle-cdr-lessp.
;; Moved icicle-remove-candidate-display-others to icicles-mcmd.el.
;; Use renamings from icicles-fn.el: icicle-complete-again-update, icicle-remove-if-not.
;; icicle-explore, icicle-find-tag, icicle-complete-keys:
;; Renamed local orig-* vars. Use explore's in *-search-(quit-or-error|cleanup|action).
;; 2008/08/14 dadams
;; icicle-apply: Handle multi-completion alist entries.
;; icicle-goto-global-marker: Treat icicle-add-buffer-name-flag: Use multi-completions.
;; icicle-marker+text: Added optional arg. Annotate text with buffer name if appropriate.
;; icicle-goto-marker-1: Pass global-ring-p to icicle-marker+text, so it can annotate.
;; 2008/08/13 dadams
;; icicle-goto-marker-1: Don't add marker to ring markers if global ring.
;; icicle-goto-marker-1-action: select-frame-set-input-focus.
;; icicle-bbdb-complete-name: let -> let* (duh!) for completing-read.
;; 2008/08/12 dadams
;; Added: icicle-goto(-global)-marker-or-(set-mark-command|pop-global-mark),
;; icicle-goto-marker-1-action (factored out from icicle-goto-marker-1).
;; icicle-goto-marker-1:
;; Add mark-marker to list of markers in ring.
;; Use icicle-goto-marker-1-action.
;; Go directly to marker if only one. Message if same as point.
;; Better test for type of ring, for error msg.
;; icicle-apply: Use icicle-explore-final-choice-full in final result (not void var).
;; Added optional arg NOMSG; bind icicle-apply-nomsg.
;; icicle-apply-action: Respect icicle-apply-nomsg. Removed vestigial cruft.
;; icicle-bbdb-complete-name: Bind icicle-bbdb-complete-name to t and use strict completion.
;; 2008/08/11 dadams
;; icicle-search-highlight-context-levels: Increase overlay priority for each context level.
;; icicle-search-highlight-all-input-matches, icicle-search-highlight-input-matches-here:
;; Made of current-input overlay higher than any context-level overlay: 204 -> 220.
;; 2008/08/10 dadams
;; Added: icicle-explore, icicle-find-tag-define-candidates (renamed old to *-1),
;; icicle-search-define-candidates (renamed old to *-1), icicle-search-cleanup,
;; icicle-(find-tag|search)-(final-act|quit-or-error).
;; Renamed: icicle-find-tag-define-candidates to icicle-find-tag-define-candidates-1,
;; icicle-search-define-candidates to icicle-search-define-candidates-1.
;; Redefined to use icicle-explore: icicle-find-tag, icicle-apply, icicle-search.
;; icicle-comint-get-final-choice: Use icicle-explore-final-choice (not icicle-search-*).
;; 2008/08/08 dadams
;; Added: icicle-goto-marker-1 (from icicle-goto-marker):
;; Use unwind-protect and minibuffer-exit-hook to unhighlight crosshairs.
;; Provide S-delete: bind icicle-delete-candidate-object.
;; Require crosshairs.el, hl-line+.el. Use crosshairs-flash.
;; icicle-goto(-global)-marker: Use icicle-goto-marker-1.
;; 2008/08/06 dadams
;; icicle-kmacro(-action):
;; Better prefix arg treatment.
;; kmacro-end-or-call-macro if still defining.
;; No-exit require-match.
;; Default value if only one.
;; Minor bug fix (extra candidate).
;; Name macros just 1, 2..., not macro #1, macro #2...
;; 2008/08/03 dadams
;; Added: icicle-clear(-current)-history(-1|-entry), icicle-apply-list-action.
;; icicle-apply: Bind icicle-all-candidates-list-action-fn to icicle-apply-list-action.
;; Renamed: icicle-all-candidates-action-fn to icicle-all-candidates-list-action-fn,
;; icicle-candidate-alternative-action-fn to icicle-candidate-alt-action-fn.
;; 2008/07/27 dadams
;; icicle-recent-file*, icicle-locate-file*: Added date multi-completion, with prefix arg.
;; Added: icicle-make-file+date-candidate.
;; 2008/07/23 dadams
;; Renamed: icicle-map(-action) to icicle-apply(-action). Added defalias for icicle-map.
;; 2008/07/21 dadams
;; Added: icicle-bbdb-complete-name. Thx to Ian Swainson. require of bbdb.el for compile.
;; 2008/07/19 dadams
;; icicle-Info-menu: Corrected regexp to pick up menu-item default, for Emacs 20.
;; 2008/07/15 dadams
;; eval-when-compile require of: anything, cookie1, etags, eyedropper/palette, yow.
;; icicle-customize-apropos-options-of-type: Typo: help-remove-duplicates -> icicle-*.
;; icicle-send-bug-report: Include emacs-version.
;; 2008/05/16 dadams
;; icicle-find-first-tag*, icicle-find-tag: Use tags-lazy-completion-table for Emacs 23.
;; 2008/04/25 dadams
;; icicle-execute-extended-command-1:
;; Add msg about binding if suggest-key-bindings. Thx to Jonathan Arkell.
;; 2008/04/14 dadams
;; icicle-pp-eval-expression: Treat negative prefix arg.
;; 2008/04/13 dadams
;; icicle-pp-eval-expression:
;; Treat prefix arg (added optional arg).
;; Respect eval-expression-debug-on-error and icicle-pp-eval-*.
;; 2008/04/09 dadams
;; icicle-apropos-(function|command), icicle-imenu-non-interactive-function-p,
;; icicle-complete-keys-help: Use fboundp, not functionp, to also pick up macros.
;; 2008/04/04 dadams
;; icicle-bookmark: Bind completion-ignore-case to bookmark-completion-ignore-case.
;; Added: icicle-bookmark-other-window(-action).
;; 2008/04/01 dadams
;; icicle-describe-option-of-type: Bind icicle-apropos-complete-match-fn to nil.
;; icicle-describe-opt-of-type-complete:
;; Moved icicle-current-completion-mode test out of icicle-delete-if-not (iterates).
;; 2008/03/31 dadams
;; icicle-locate-file(-other-window), icicle-plist, icicle-describe-option-of-type,
;; icicle-(var|fun)doc: icicle-highlight-lighter, before gather candidates.
;; icicle-plist, icicle-describe-option-of-type, icicle-vardoc, icicle-fundoc:
;; Simplified doc string and prompt wrt C-M-j.
;; 2008/03/30 dadams
;; icicle-Info-menu: Treat also pseudo-menu at Top. Thx to William Xu.
;; 2008/03/26 dadams
;; Added: icicle-Info-menu(-cmd).
;; 2008/03/22 dadams
;; icicle-other-window-or-frame: Rewrote to use icicle-select-window for all frames or one.
;; icicle-select-window:
;; Rewrote: Similar to icicle-select-frame (unique window names). All frames or one.
;; Added: icicle-select-window-by-name, icicle-make-window-alist.
;; 2008/03/19 dadams
;; Added: icicle-pp-eval-expression (old version in icicles-mcmd.el was renamed).
;; 2008/03/11 dadams
;; icicle-repeat-complex-command: Rewrote doc string.
;; 2008/03/10 dadams
;; icicle-select-frame: Rewrote to use icicle-select-frame-by-name (unique frame names).
;; icicle-choose-candidate-of-type: Use icicle-make-frame-alist, not make-frame-alist.
;; Added: icicle-select-frame-by-name, icicle-make-frame-alist.
;; 2008/03/09 dadams
;; icicle-dabbrev-completion, icicle-find-tag-define-candidates,
;; icicle-Info-build-node-completions, icicle-search, icicle-read-color:
;; Call icicle-highlight-lighter.
;; 2008/03/05 dadams
;; icicle-map: Don't inhibit sorting.
;; icicle-goto(-global)-marker: Provide sorting choices. Highlight target line.
;; Added: icicle-cdr-less-p.
;; 2008/02/26 dadams
;; Added: icicle-where-is.
;; 2008/02/23 dadams
;; icicle-lisp-complete-symbol:
;; Wrap completing-read in save-excursion, because of icicle-top-level-*-completion-flag.
;; icicle-search: Use NOWARN arg with find-file-noselect.
;; Added: icicle-tags-search.
;; Renamed: icicle-search-tag* to icicle-find-tag*,
;; icicle-find-tag(-other-window) to icicle-find-first-tag(-other-window).
;; 2008/02/21 dadams
;; icicle-Info-goto-node: Added .. node for book order.
;; Use global var icicle-Info-only-rest-of-book-p. Call icicle-Info-goto-node-1.
;; icicle-Info-read-node-name: Remove REST-P arg.
;; icicle-Info-goto-node-action: When rest-of-book-p:
;; Update node completion table and then completions, and set current candidate number.
;; Added: icicle-Info-goto-node-1, icicle-Info-build-node-completions(-fix-*).
;; 2008/02/17 dadams
;; icicle-Info-goto-node:
;; Moved let to interactive spec, and added two args. Use icicle-Info-read-node-name.
;; Negative prefix arg means completions are limited to rest of book.
;; Add icicle-Info-book-order-p to icicle-sort-functions-alist.
;; New doc string, to explain everything.
;; Added: icicle-Info-book-order-p, icicle-Info-read-node-name.
;; 2008/02/16 dadams
;; icicle-(select|remove|search)-region:
;; Removed extraneous (setq icicle-candidates-alist) in let binding.
;; 2008/02/13 dadams
;; Added: icicle-search-tag, icicle-search-tag-define-candidates, icicle-search-tag-action,
;; icicle-search-tag-help, icicle-pop-tag-mark.
;; Updated doc string of icicle-find-tag(-other-window).
;; 2008/02/08 dadams
;; icicle-compilation-search-in-context-fn:
;; Simplified and corrected. Dropped let, with-current-buffer. Narrow to whole line.
;; Different code for Emacs 22+: Set current error; call compilation-next-error-function.
;; Removed: icicle-compilation-search-hl-line.
;; icicle-compilation-search: Soft require hl-line+.
;; Don't bind next-error-hook to icicle-*-search-hl-line.
;; Renamed: icicle-directories-list to icicle-directory-list.
;; 2008/02/07 dadams
;; icicle-search-action:
;; Moved icicle-highlight-candidate-* to after icicle-search-in-context-fn call.
;; icicle-compilation-search-in-context-fn:
;; Use buffer of marker. Removed code using overlay buffer.
;; icicle-compilation-search: Bound icicle-compilation-search-hl-line as next-error-hook.
;; Added: icicle-compilation-search-hl-line.
;; 2008/02/03 dadams
;; icicle-file-list: Rewrote using icicle-define-file-command.
;; icicle-(re)set-option-*: Added boundp before user-variable-p and icicle-binary-option-p.
;; Added: icicle-directories-list.
;; 2008/01/18 dadams
;; Moved icicle-complete-keys-alist to icicles-var.el
;; 2008/01/13 dadams
;; icicle-customize-face(-other-window), icicle-face-list, icicle-read-color:
;; Use icicle-transform-multi-completion.
;; icicle-(vardoc|fundoc): Use icicle-funvardoc-action as action fn and as help fn.
;; icicle-doc: Use icicle-doc-action as action fn and as help fn.
;; Added: icicle-funvardoc-action, icicle-doc-action.
;; icicle-search-replace-search-hit: Simplified bind/restore of Icicles completion vars.
;; 2008/01/11 dadams
;; icicle-search-highlight-and-maybe-replace:
;; Don't call icicle-update-completions or icicle-display-candidates-in-Completions here.
;; icicle-search-in-context-default-fn, icicle-compilation-search-in-context-fn:
;; Call icicle-update-completions (at the end), since not done in i*-and-maybe-replace.
;; 2008/01/08 dadams
;; icicle-describe-opt-of-type-complete: Treat 3rd arg. Treat prefix completion.
;; 2008/01/06 dadams
;; icicle-read-color: Provide color help for C-M-. Added: icicle-color-help.
;; 2008/01/04 dadams
;; icicle-doc, icicle-fundoc, icicle-vardoc: Use history variable icicle-doc-history.
;; 2008/01/02 dadams
;; Added: icicle-search-dired-marked.
;; 2008/01/01 dadams
;; icicle-(buffer|face|file)-list: Reverse list, so C-! keeps order.
;; icicle-dired-saved-file-candidates(-other-window):
;; Convert candidates to relative file names before opening Dired using them.
;; Error if any candidate is not a file in directory.
;; Added: icicle-candidate-set-dired-marked-save(-more).
;; 2007/12/31 dadams
;; Added: icicle-fn-doc-minus-sig.
;; icicle-fundoc, icicle-doc: Use icicle-fn-doc-minus-sig.
;; icicle-doc: Bind icicle-transform-function, not icicle-whole-candidate-as-text-prop-p.
;; 2007/12/27 dadams
;; icicle-describe-option-of-type:
;; Bind icicle-apropos-complete-match-fn to nil to prevent automatic input match.
;; 2007/12/26 dadams
;; icicle-describe-opt-of-type-complete: Pretty-print types. Bind icicle-candidate-help-fn.
;; Added: icicle-describe-opt-action.
;; 2007/12/24 dadams
;; icicle-describe-option-of-type:
;; Rewrote for different kinds of type matching. TYPE can be a regexp or type sexp.
;; Diff prefix args for diff behaviors. Handle type inheritance and value-checking.
;; Added: icicle-describe-opt-of-type-complete.
;; 2007/12/21 dadams
;; icicle-customize-apropos-options-of-type: help-var-is-* -> icicle-var-is-*.
;; 2007/12/20 dadams
;; icicle-dired-saved-file-candidates(-*):
;; Use substitute-command-keys in error msg. Use generate-new-buffer name, not y-or-n-p.
;; 2007/12/15 dadams
;; Added: icicle-customize-apropos-options-of-type.
;; 2007/12/11 dadams
;; icicle-read-color: Don't leave out variable proxies if don't have eyedropper.
;; 2007/12/07 dadams
;; Added: icicle-describe-option-of-type.
;; icicle-doc:
;; Choose kind of doc, instead of showing all (overwriting).
;; Removed binding of icicle-candidate-properties-alist.
;; icicle-read-color: Single-quote proxies, don't wrap with `_'.
;; 2007/12/06 dadams
;; icicle-doc: Forgot to include face doc.
;; 2007/12/03 dadams
;; Renamed icicle-longest-common-match to icicle-expanded-common-match.
;; 2007/12/02 dadams
;; icicle-read-color: Include color-valued variables as proxy candidates.
;; 2007/11/30 dadams
;; icicle-command-abbrev:
;; Use only membership in icicle-proxy-candidates, not icicle-proxy-candidate property.
;; So predicate is just commandp, since proxies are not part of regular candidates.
;; icicle-command-abbrev-action:
;; Bind to save/restore: icicle-add-proxy-candidates-flag, icicle-proxy-candidates.
;; icicle-command-abbrev-command: Bind icicle-add-proxy-candidates-flag to nil, to reset.
;; 2007/11/29 dadams
;; icicle-command-abbrev: Treat icicle-add-proxy-candidates-flag, icicle-proxy-candidates.
;; icicle-read-color: Don't test icicle-add-proxy-candidates-flag.
;; 2007/11/27 dadams
;; icicle-command-abbrev: Remove icicle-proxy-candidate property in unwind-protect.
;; 2007/11/26 dadams
;; icicle-get-anything-candidates: Fixed for try-completion and test-completion cases.
;; icicle-choose-anything-candidate: Bind icicle-candidates-alist to actions (two places).
;; 2007/11/25 dadams
;; Added: icicle-command-abbrev(-action|-command|-matching-commands|-record|regexp).
;; 2007/11/24 dadams
;; icicle-execute-extended-command: Bind use-file-dialog to nil.
;; 2007/11/17 dadams
;; icicle-read-color:
;; Respect icicle-add-proxy-candidates-flag. Convert proxy multi-completions to strings.
;; 2007/11/03 dadams
;; icicle-generic-S-tab: Doc string - mention icicle-generic-S-tab-keys.
;; 2007/10/28 dadams
;; icicle-search: Don't bind icicle-expand-input-to-common-match-flag. Updated doc string.
;; icicle-search-highlight-all-input-matches:
;; Don't set icicle-search-lcm unless icicle-expand-input-to-common-match-flag.
;; icicle-search-highlight-and-maybe-replace:
;; Match the lcm if icicle-search-replace-common-match-flag is non-nil.
;; Save icicle-candidate-nb around icicle-update-completions.
;; Set icicle-candidate-nb to 0 if nil.
;; icicle-search-highlight-input-matches-here:
;; Don't delete icicle-search-refined-overlays if icicle-*-all-current-flag.
;; 2007/10/26 dadams
;; icicle-search-highlight-all-input-matches: Loop through overlays twice, to get the lcm.
;; icicle-search-highlight-input-matches-here: Highlight the lcm, if available.
;; icicle-search: Bind icicle-search-lcm.
;; 2007/10/22 dadams
;; icicle-read-color: Use special-candidate face for pseudo color candidates.
;; icicle-add-key+cmd: Don't include keys bound to undefined.
;; 2007/10/20 dadams
;; icicle-read-color, icicle-remove-color-duplicates:
;; Treat pseudo colors too (e.g. *point foreground*).
;; icicle-make-color-candidate: Added optional HEX-RGB arg.
;; 2007/10/16 dadams
;; icicle-vardoc: Prefix arg means use only user options.
;; 2007/10/14 dadams
;; Updated doc strings to reflect new icicle-act-before-cycle-flag change.
;; 2007/10/13 dadams
;; icicle-get-anything-candidates:
;; If candidates is a fn, return fn that's useful for all-completions. Filter by input.
;; icicle-choose-anything-candidate:
;; Don't sort or transform cands. Respect Anything's require-pattern and delayed
;; settings. Bind icicle-candidates-alist to candidates, if that's a function.
;; icicle-get-anything-candidates-of-type: Don't use mapcar if candidates is a function.
;; Added: icicle-get-anything-req-pat-chars, icicle-get-anything-input-delay.
;; 2007/10/06 dadams
;; icicle-choose-candidate-of-type: Added entry for file type.
;; 2007/09/25 dadams
;; icicle-doc: Bind icicle-whole-candidate-as-text-prop-p to treat full candidates.
;; 2007/09/04 dadams
;; icicle-read-color: Added optional PROMPT arg.
;; 2007/08/31 dadams
;; icicle-buffer-list: Prefix arg means only buffers visiting files are candidates.
;; icicle-search-where-arg, icicle-occur:
;; Prefix arg 99 means only buffers visiting files are candidates.
;; Added: icicle-search-choose-buffers.
;; 2007/08/27 dadams
;; icicle-search-action: Fixed for return value. Display the error message.
;; 2007/08/25 dadams
;; icicle-choose-candidate-of-type: Removed (> emacs-major-version 21) restriction.
;; 2007/08/25 dadams
;; Added: a, any, buffer, file, icicle-get-anything-(types|(default-)actions-for-type|
;; candidates-of-type|(cached-)candidates), icicle-anything(-candidate-value),
;; what-which-how, icicle-choose-anything-candidate.
;; Renamed icicle-clear-option to clear-option.
;; icicle-object-action: Treat Anything stuff.
;; Added optional type arg. Use vars icicle-object-(named|predicate)-types.
;; Move icicle-read-var-value-satisfying call here from icicle-choose-candidate-of-type.
;; icicle-choose-candidate-of-type: Create buffer if needed.
;; Protected alias definitions with icicle-define-alias-commands-flag.
;; icicle-map(-action):
;; Use icicle-whole-candidate-as-text-prop-p and new icicle-get-alist-candidate.
;; icicle-(select|remove|search)-region, icicle-search:
;; Bind/use icicle-whole-candidate-as-text-prop-p.
;; icicle-occur: Require buffer names to match existing buffers. Thx to Hadron Quark.
;; 2007/08/15 dadams
;; Added command toggle as alias for icicle-toggle-option.
;; 2007/08/09 dadams
;; Soft require kmacro. Define icicle-kmacro* if kmacro gets loaded.
;; 2007/07/27 dadams
;; icicle-search: Renamed icicle-act-first-then-navigate-p to icicle-act-before-cycle-flag.
;; 2007/07/22 dadams
;; icicle-customize-face: Added prefix arg to give vanilla completion.
;; Added: icicle-customize-face-other-window.
;; Replace standard customize-face(-other-window) by icicle-customize-face(-other-window).
;; No longer require icicles-mode.el.
;; Require cus-edit.el (not just at compile time).
;; 2007/07/08 dadams
;; Added: icicle-customize-faces.
;; icicle-customize-face: Bind icicle-all-candidates-action-fn to icicle-customize-faces.
;; 2007/06/23 dadams
;; icicle-search-read-context-regexp, icicle-search-read-word, icicle-search-property-args,
;; icicle-add-region, icicle-save-string-to-variable:
;; Use icicle-completing-read-history, not read-from-minibuffer or read-string.
;; icicle-face-list: Bound icicle-list-nth-parts-join-string etc.
;; Moved to icicles-fn.el: icicle-read-from-minibuf-nil-default.
;; 2007/06/22 dadams
;; Added: icicle-group-regexp, icicle-keyword-list, icicle-search-keywords.
;; 2007/06/21 dadams
;; icicle-plist, icicle-(var|fun)doc, icicle-region-add-buffers, icicle-search-regexp-scan,
;; icicle-search-char-property-scan:
;; Use face icicle-candidate-part, not icicle-special-candidate.
;; icicle-add-key+cmd: Highlight key side of the pair (key = binding).
;; 2007/06/18 dadams
;; Added: icicle-customize-face.
;; 2007/06/17 dadams
;; icicle-make-color-candidate: Respect icicle-WYSIWYG-Completions-flag.
;; icicle-search-action: Added priority in call to icicle-place-overlay.
;; 2007/06/12 dadams
;; icicle-execute-extended-command(-1):
;; i-e-e-c-1 prepares the new last command, but i-e-e-c sets it, at end, to this-command.
;; 2007/06/10 dadams
;; Added: icicle-comint-hook-fn, icicle-compilation-hook-fn.
;; Removed unconditional add-hooks for comint-mode-hook and compilation(minor)-mode-hook.
;; 2007/06/09 dadams
;; icicle-set-option-to-t, icicle-reset-option-to-nil, icicle-delete-windows,
;; icicle-add-buffer-candidate, icicle-remove-buffer-candidate, icicle-buffer-list,
;; icicle-remove-buffer-config, icicle-face-list, icicle-file-list,
;; icicle-remove-all-regions-in-buffer, icicle-delete-file:
;; Bind icicle-use-candidates-only-once-flag to t.
;; icicle-set-option-to-t, icicle-clear-option: Candidate vars must have value nil/non-nil.
;; icicle-search-regexp-scan: Added eobp test and empty hit-string test.
;; icicle-select-(frame|window), icicle-delete-windows:
;; Removed extra t arg to icicle-define-command.
;; 2007/06/08 dadams
;; Added icicle-find-tag(-other-window).
;; 2007/06/07 dadams
;; Renamed: icicle-font-history to icicle-font-name-history,
;; icicle-function-history to icicle-function-name-history,
;; icicle-variable-history to icicle-variable-name-history.
;; Use standard history variable if bound, else use Icicles history variable:
;; bookmark-history, color-history, color-theme-history, face-name-history,
;; font-name-history, frame-name-history, function-name-history, variable-name-history
;; 2007/06/05 dadams
;; Don't require hexrgb.el if no window system.
;; icicle-read-color: Use featurep, not require, for hexrgb.
;; icicle-make-color-candidate: Error if hexrgb is not loaded.
;; 2007/05/31 dadams
;; icicle-execute-extended-command-1: Set, don't bind this-command.
;; icicle-execute-extended-command, icicle-execute-named-keyboard-macro:
;; Simpler save and restore of last-command.
;; 2007/05/28 dadams
;; icicle-imenu: Use same prefix-arg behavior as icicle-search (search multiple...).
;; Added: icicle-imenu-(command|non-interactive-function(-p)).
;; icicle-search-highlight-context-levels:
;; Wrapped loop in condition-case. Took max-levels determination out of loop.
;; 2007/05/25 dadams
;; Added: icicle-face-list, icicle-next-single-char-property-change,
;; icicle-search-(where-arg|property-args|char-property(-scan)|overlay-property),
;; icicle-char-properties-in-buffer(s).
;; Removed: icicle-text-properties-in-buffer(s), icicle-search-text-property-scan.
;; icicle-search(-word): Use icicle-search-where-arg.
;; 2007/05/21 dadams
;; Added: icicle-search-(buffer|file|all-regions).
;; icicle-imenu: Fixed treatment of prefix arg.
;; icicle-imenu-command-p: Fix to work also with Emacs 22 and 21.
;; 2007/05/14 dadams
;; icicle-execute-extended-command-1: Error if empty command name.
;; 2007/05/12 dadams
;; icicle-imenu: Added prefix arg for search for commands and non-cmds in Emacs-Lisp mode.
;; Added: icicle-imenu-command-p.
;; 2007/05/11 dadams
;; icicle-search-define-candidates:
;; Move scan-fn-or-regexp to 4th arg from 2nd. Removed &optional.
;; Apply icicle-search-regexp-scan to args also.
;; icicle-search-regexp-scan: Treat predicate.
;; Move regexp to 3rd arg from 2nd, and add predicate arg. Removed &optional.
;; icicle-search-regexp-scan, icicle-search-text-property-scan:
;; Add lengths of temp-list and icicle-candidates-alist.
;; icicle-search-text-property(-scan): Added predicate argument.
;; icicle-search-region-action: Bind icicle-candidate-action-fn to icicle-search-action.
;; icicle-(select|search|remove)-region: Removed temp var bound to (icicle-region-sorted).
;; icicle-search: Mention predicate in no-match message.
;; 2007/05/07 dadams
;; icicle-add-buffer-config: Added history args for icicle-read-from-minibuf-nil-default.
;; 2007/05/06 dadams
;; icicle-search: Bind icicle-must-pass-predicate to icicle-search-context-match-predicate.
;; icicle-search-read-context-regexp: Don't accept an empty regexp.
;; Changed S-C- to C-S- and M-C- to C-M- in doc.
;; 2007/05/04 dadams
;; icicle-(re)set-option-to-(nil|t), icicle-toggle-option: Enable recursive minibuffers.
;; 2007/05/02 dadams
;; icicle-search-read-word: Updated doc string.
;; icicle-search: Respect icicle-search-whole-word-flag and icicle-regexp-quote-flag.
;; Single message for non-existent buffers.
;; icicle-select-region-action: Message for non-existent file.
;; Added empty defvars for Emacs 22 standard vars, to quiet byte compiler.
;; 2007/05/01 dadams
;; icicle-execute-extended-command-1:
;; Don't bind icicle-candidate-action-fn if we have already read command name.
;; icicle-search-*-scan: Fill, reverse temp list, then append to icicle-candidates-alist.
;; Added: icicle-search-word, icicle-search-read-word.
;; 2007/04/29 dadams
;; icicle-search, icicle-search-text-property, icicle-text-properties-in-buffers:
;; Allow search of multiple files. Change prefix arg accordingly.
;; 2007/04/28 dadams
;; Added: icicle-compilation-search-in-context-fn, icicle-search-in-context-default-fn,
;; icicle-search-highlight-and-maybe-replace.
;; icicle-search-action: Move code to the new functions. Use icicle-search-in-context-fn.
;; icicle-compilation-search: Rewrote.
;; No longer use compile-goto-error as icicle-search-hook.
;; Use icicle-compilation-search-in-context-fn.
;; Cannot-replace error msg if not Emacs 22, since no compilation-highlight-overlay.
;; Provide .* regexp and do not highlight - as in icicle-occur.
;; 2007/04/22 dadams
;; icicle-search: Allow for pre-bound icicle-candidate(-alternative)-action-fn.
;; icicle-search-replace-search-hit:
;; Call icicle-candidate-action-fn, not necessarily icicle-search-action.
;; 2007/04/20 dadams
;; Added: icicle-search-highlight-context-levels. Use in icicle-search-action.
;; icicle-search-highlight-cleanup: Delete icicle-search-level-overlays.
;; icicle-search: Set icicle-search-context-regexp nil if scan-fn-or-regexp is not string.
;; icicle-search-replace-fixed-case-p: Return nil if arg is nil.
;; icicle-search-read-context-regexp: Use default with read-number; protect with fboundp.
;; Added soft require of strings.el.
;; 2007/04/18 dadams
;; Added: icicle-search-replace-fixed-case-p. Use in icicle-search-action.
;; icicle-search-action:
;; Set match data to region when icicle-search-replace-whole-candidate-flag is t.
;; Don't search for icicle-search-context-regexp.
;; icicle-search-replace-match: Added fixedcase arg.
;; Use icicle-search-replace-literally-flag.
;; Use replace-match-maybe-edit (Emacs 22), not replace-match, and save and restore stuff.
;; icicle-search-replace-search-hit:
;; Use regexp-history in read-string. Use icicle-search-define-replacement.
;; 2007/04/17 dadams
;; Added: icicle-search-replace-match. Treat Emacs<22 also. Use in icicle-search-action.
;; icicle-search-replace-search-hit: Use regexp-history in read-string.
;; 2007/04/16 dadams
;; icicle-search-action: Use replace-count.
;; icicle-search: Initialize replace-count to 0.
;; 2007/04/15 dadams
;; icicle-search-action: Allow \,... etc. replacement.
;; Use query-replace-compile-replacement and replace-match, with error treatment.
;; Removed unwind-protect. Removed %s from error-msg return.
;; icicle-search: Save search string as icicle-search-context-regexp.
;; Use "%s" for error message in failure error call.
;; Updated doc string for lisp-eval replacement etc.
;; *(-all)-input-matches(-here): save-match-data around input matching.
;; icicle-search-highlight-input-matches-here: Added not eobp to loop test.
;; 2007/04/13 dadams
;; icicle-search-highlight-input-matches-here: Bound free var ov.
;; 2007/04/10 dadams
;; icicle-search-regexp-scan:
;; Use match indicated by icicle-search-context-level as context.
;; Added: icicle-search-read-context-regexp.
;; icicle-search(-region|-regexp-scan): Use icicle-search-read-context-regexp.
;; 2007/04/08 dadams
;; icicle-map-action, icicle-search-action:
;; Return nil for success, error msg for failure (it was reversed).
;; Use icicle-highlight-candidate-in-Completions.
;; icicle-map-action: Moved minibuffer frame selection to unwind-protect final clause.
;; icicle-search: Give focus to original frame, in unwinding clause (C-g).
;; Added: icicle-search-highlight-input-matches-here.
;; icicle-search-highlight-all-input-matches: Highlight all input matches in candidate.
;; icicle-search-replace-search-hit:
;; Use 0 if icicle-candidate-nb is nil. Display completions.
;; Save and restore: icicle-last-completion-command, icicle-last-input.
;; Prevent using same string as candidate for replacement.
;; icicle-search-action: Rewrote. Enable repeated replacment of input matches.
;; Save and restore icicle-candidate-nb. Wrap it around if at end.
;; Warn about empty input for whole-candidate replacement.
;; Update icicle-last-completion-candidate. Display completions.
;; 2007/04/07 dadams
;; icicle-search: Added query-replace functionality.
;; Navigate first, then act (C-next).
;; Give focus to last frame searched.
;; Bind: icicle-candidate-alternative-action-fn, icicle-inhibit-sort-p,
;; icicle-searching-p, icicle-expand-input-to-common-match-flag.
;; Bind icicle-buffer-require-match-flag to partial-match-ok in interactive spec.
;; icicle-search-action:
;; Added optional replace arg: if non-nil, then fn becomes a replace action.
;; Added: icicle-search-replace-search-hit, icicle-search-replace-candidate,
;; icicle-buffer-list: Bind all the stuff that is bound in icicle-buffer.
;; 2007/04/06 dadams
;; icicle-execute-extended-command-1:
;; Bind this-command, but only around call to cmd - don't set it.
;; 2007/04/02 dadams
;; Added: icicle-search-text-property, icicle-search-text-property-scan,
;; icicle-text-properties-in-buffer(s).
;; icicle-search:
;; Added &rest args. Updated doc string. Don't read regexp or reverse alist here.
;; Use icicle-search-define-candidates, not icicle-search-regexp-scan.
;; icicle-search-regexp-scan: Read regexp here. Reverse alist here.
;; Moved to icicles-fn.el: icicle-filter-alist, icicle-first-matching-candidate.
;; Renamed: icicle-search-region-beg-end to icicle-region-or-buffer-limits.
;; 2007/04/01 dadams
;; icicle-repeat-complex-command:
;; Remove duplicates and sort entries, but only for reading command to eval.
;; 2007/03/31 dadams
;; icicle-lisp-complete-symbol: Bind icicle-top-level-when-sole-completion-flag to t.
;; 2007/03/27 dadams
;; icicle-search: Hard-code C-next key in message.
;; icicle-search-regexp-scan: Initialize last-beg for first time.
;; 2007/03/23 dadams
;; icicle-execute-extended-command-1:
;; Don't restore last-command. Run (pre|post)-command-hook. Set, don't bind,
;; this-command. enable-recursive-minibuffers for interactive call of cmd.
;; icicle-execute-extended-command, icicle-execute-named-keyboard-macro:
;; Restore last-command at end.
;; 2007/03/20 dadams
;; icicle-execute-extended-command-1: When wrong-number-of-args, icicle-help-on-candidate.
;; 2007/03/14 dadams
;; icicle-dired-saved-file-candidates, icicle-buffer, icicle-(find|locate|recent)-file:
;; Put 200 as value of property icicle-Completions-window-max-height.
;; Added ;;;###autoload for icicle-define*.
;; 2007/03/09 dadams
;; icicle-search, icicle-map, icicle-(remove|search|select)-region, icicle-imenu,
;; icicle-occur, icicle-compilation-search:
;; Bound icicle-transform-function to nil if interactive-p.
;; icicle-comint-search: Updated doc string to mention false positives in command matching.
;; Removed eval-when-compile from requires of Icicles libraries (except icicle-mac.el).
;; 2007/03/08 dadams
;; icicle-insert-kill: Bound icicle-delete-candidate-object.
;; 2007/03/07 dadams
;; icicle-delete-windows, icicle-map-action, icicle-search-action,
;; icicle-choose-candidate-of-type, icicle-complete-keys-help:
;; Use 0, not t, as frame arg to get-buffer-window.
;; 2007/03/06 dadams
;; icicle-search, icicle-map, icicle-(remove|search|select)-region:
;; Bind icicle-inhibit-sort-p to non-nil to prevent user sorting.
;; Update doc string to mention that you cannot sort candidates.
;; icicle-(remove|search|select)-region: Sort candidates by buffer and then by tag.
;; icicle-search-region: Bound icicle-delete-candidate-object.
;; icicle-search, icicle-map: Don't add or subtract one from candidate # if use action fn.
;; icicle-search:
;; If require-match, set icicle-completion-candidates and marker to reflect final choice.
;; Renamed: icicle-get-current-candidate to icicle-get-alist-candidate.
;; Added: icicle-region-sorted, icicle-region-add-buffers.
;; 2007/03/04 dadams
;; icicle-get-current-candidate: Return nil if icicle-candidates-alist is nil.
;; 2007/03/02 dadams
;; icicle-remove-buffer-config, icicle-remove-buffer-candidate: Removed extraneous quote.
;; icicle-(find|recent)-file(-other-window): Bound icicle-delete-candidate-object.
;; 2007/02/28 dadams
;; icicle-buffer-list, icicle-color-theme: Bound icicle-delete-candidate-object.
;; 2007/02/27 dadams
;; icicle-recent-file(-other-window): Changed INITIAL-INPUT completing-read arg to nil.
;; 2007/02/25 dadams
;; Added: icicle-remove-buffer-candidate-action, icicle-remove-buffer-config-action.
;; icicle-add-buffer-candidate, icicle-bookmark, icicle-buffer-config:
;; Bound icicle-delete-candidate-object.
;; 2007/02/24 dadams
;; Added: icicle-kill-a-buffer-and-update-completions (was kill-a-buffer),
;; icicle-delete-region-from-alist.
;; icicle-delete-window: Use icicle-kill-a-buffer...-completions, not icicle-kill-a-buffer.
;; icicle-buffer(-other-window), icicle-choose-candidate-of-type:
;; Bind icicle-delete-candidate-object to icicle-kill-a-buffer.
;; Bind icicle-sort-function to self if icicle-buffer-sort-function is nil.
;; icicle-select-region:
;; Bind icicle-delete-candidate-object to icicle-delete-region-from-alist.
;; icicle-remove-region: Rewrote.
;; Use icicle-delete-region-from-alist.
;; Use icicle-remove-candidate-display-others, but don't redisplay unless completing.
;; Respect icicle-add-buffer-name-flag (append buffer names).
;; 2007/02/20 dadams
;; Added: icicle-search-region-action. Open file associated with candidate.
;; icicle-search-region:
;; Use icicle-search-region-action. Updated doc string. Bind icicle-list-*.
;; Fix default completing-read value. Respect icicle-add-buffer-name-flag.
;; icicle-select-region-action: Open file associated with candidate.
;; icicle-region-open-all-files: Ignore files that are not readable.
;; icicle-regions: Remove only non-existent buffers that are not associated with files.
;; 2007/02/19 dadams
;; Added: icicle-region-open-all-files.
;; icicle-(search|select)-region, icicle-search: Use icicle-region-open-all-files.
;; icicle-add-region: Add file name to region entry in alist.
;; icicle-select-region-action, icicle-region-help, icicle-search:
;; Updated selectors for point and mark, because of addition of file name.
;; icicle-region-help: Add file name to help message.
;; 2007/02/18 dadams
;; Added: icicle-first-matching-candidate.
;; icicle-get-current-candidate: Use icicle-first-matching-candidate, not assoc.
;; 2007/02/07 dadams
;; icicle-search-action: Make *Completions* window dedicated. Thx to Peter Povinec.
;; 2007/02/07 dadams
;; icicle-search: pop-to-buffer and raise frame. Don't select orig-window.
;; 2007/02/06 dadams
;; icicle-search, icicle-select-region, icicle-search-regexp-scan:
;; Respect icicle-add-buffer-name-flag.
;; icicle-search: Bound icicle-show-Completions-initially-flag to t.
;; Bound icicle-candidate-help-fn to icicle-search-help.
;; icicle-search-regexp-scan: nil BUFFER arg means current buffer now.
;; icicle-search-action, icicle-filter-alist: Treat multi-completion case also.
;; Added: icicle-search-help.
;; icicle-map-action, icicle-search-action: Removed unused local var, curr-cand-string.
;; icicle-select-region, icicle-remove-region, icicle-search-region:
;; Use icicle-candidates-alist, not regions-w-buffers (but bind it locally too).
;; Renamed: icicle-get-current-region-candidate to icicle-get-current-candidate.
;; icicle-region-help: Provide region limits also.
;; Added note to some doc strings that the command is for Icicle mode only.
;; 2007/02/02 dadams
;; icicle-search: Test for buffers, not buffer names, in WHERE. Thx to Peter Povinec.
;; icicle-buffer-list: Return the list of buffers.
;; 2007/01/28 dadams
;; icicle-complete-keys:
;; Bind icicle-sort-functions-alist, using icicle-command-names-alphabetic-p.
;; 2007/01/22 dadams
;; icicle-read-color:
;; Removed free var NTH-PARTS.
;; Bound icicle-list-nth-parts-join-string the same as icicle-list-join-string.
;; Remove duplicates: AliceBlue and alice blue etc.: downcase and remove whitespace.
;; Added: icicle-remove-color-duplicates.
;; Added soft require of hexrgb.el.
;; icicle-*doc, icicle-plist: Bound icicle-candidate-properties-alist.
;; 2007/01/21 dadams
;; Added: icicle-read-color, icicle-make-color-candidate.
;; 2007/01/18 dadams
;; Added: icicle-get-current-region-candidate.
;; Use current cand if cycled or `mouse-2'. Else if single match, use that. Else error.
;; icicle-remove-region, icicle-search-region, icicle-region-help:
;; Use icicle-get-current-region-candidate.
;; icicle-add-region: Added optional TAG arg and prefix arg treatment.
;; icicle-remove-region: Update completions list. Bind regions-w-buffers.
;; icicle-remove-all-regions-in-buffer: Use current buffer name as default.
;; Added: icicle-select-region-action.
;; icicle-select-region: Use icicle-select-region-action.
;; Renamed: option icicle-regions to icicle-region-alist.
;; icicle-regions: Sort entries.
;; 2007/01/17 dadams
;; icicle-filter-alist: Reversed arg order. Return alist arg if filter-keys arg is empty.
;; 2007/01/12 dadams
;; icicle-delete-window: Do icicle-remove-Completions-window if in minibuffer.
;; icicle-yank-insert: Do icicle-yank if in minibuffer.
;; icicle-(fundoc|vardoc|doc|plist): Added condition-case: protect symbols that error.
;; 2007/01/01 dadams
;; Added: icicle-(add|remove)-candidate-(to|from)-saved-completion-set.
;; icicle-add-buffer-config: Use nil, not "nil" as default, if icicle-buffer-sort is nil.
;; Use icicle-define-add-to-alist-command to define it.
;; icicle-remove-buffer-config, icicle-remove-saved-completion-set:
;; Use icicle-assoc-delete-all, not delete of assoc.
;; icicle-remove-saved-completion-set: Update display after removal.
;; Reformatted icicle-define(-file)-command, based on setup.el's lisp-indentation-hack.
;; 2006/12/25 dadams
;; Bug fix: icicle-search-action: Use icicle-filter-alist on icicle-candidates-alist.
;; icicle-(select|search)-region: Use pop-to-buffer and raise-frame, not set-buffer.
;; icicle-select-region: Activate the region.
;; 2006/12/23 dadams
;; Added: icicle-region-help. Use in icicle-*-region.
;; Added: icicle-remove-all-regions-in-buffer, icicle-remove-all-regions-action.
;; icicle-(select|search)-region: Ignore regions in non-existent buffers.
;; icicle-remove-region: Update the persistent value of icicle-regions.
;; 2006/12/22 dadams
;; Added: icicle-exchange-point-and-mark.
;; icicle-customize-icicles-group: icicles -> Icicles (group name).
;; 2006/12/18 dadams
;; icicle-object-action: Remove print arg. icicle-apply-to-* uses current-prefix-arg now.
;; 2006/12/17 dadams
;; Added: icicle-object-action, icicle-choose-candidate-of-type,
;; icicle-read-var-value-satisfying.
;; 2006/12/16 dadams
;; icicle-map-action: Bug fix: Use icicle-candidate-nb, not assoc.
;; Added: icicle-goto(-global)-marker, icicle-marker+text, icicle-markers.
;; 2006/12/10 dadams
;; Moved minibuffer and *Completions* commands to new file, icicles-mcmd.el.
;; Require icicles-opt.el.
;; icicle-buffer-list: Added final message.
;; 2006/11/26 dadams
;; icicle-search-action: Bug fix: Use icicle-candidate-nb, not assoc, to get cand+mrker.
;; icicle-*-complete-1: Bug fix: Don't set icicle-current-input to icicle-last-input if nil.
;; Renamed: icicle-search-region to icicle-search-region-beg-end.
;; Added: icicle-(add|remove|select|search)-region.
;; icicle-search: Use icicle-regions for numeric prefix arg. Updated doc string.
;; Added: icicle-Info-index-20 - thx to Tamas Patrovics. Use it in icicle-Info-index.
;; 2006/11/25 dadams
;; icicle-search: After final selection, select orig-window and give its frame input focus.
;; 2006/11/24 dadams
;; Added: icicle-ensure-overriding-map-is-bound, icicle-universal-argument,
;; icicle-universal-argument-more, icicle-negative-argument, icicle-digit-argument,
;; icicle-universal-argument-other-key, icicle-universal-argument-minus,
;; icicle-kmacro(-action).
;; icicle-dabbrev-completion: Don't stop at common root, and use lax completion.
;; Replaced icicle-select-window-or-frame by icicle-other-window-or-frame (respects C-u 0).
;; 2006/11/23 dadams
;; icicle-prefix-complete-1: Respect icicle-TAB-shows-candidates-flag.
;; icicle-execute-extended-command-1: Treat named keyboard macros too.
;; Added: icicle-execute-named-keyboard-macro.
;; 2006/11/18 dadams
;; icicle-add/update-saved-completion-set, icicle-apropos*, icicle-bookmark,
;; icicle-buffer-config, icicle-candidate-set-retrieve, icicle-candidate-set-save,
;; icicle-color-theme, icicle-comint-command, icicle-complete-thesaurus-entry,
;; icicle-customize-apropos*, icicle-delete-windows, icicle-font, icicle-frame-bg,
;; icicle-frame-fg, icicle-insert-kill, icicle-insert-string-from-variable,
;; icicle-insert-thesaurus-entry, icicle-locate-file*, icicle-map, icicle-narrow-candidates,
;; icicle-remove-buffer-config, icicle-remove-saved-completion-set,
;; icicle-reset-option-to-nil, icicle-save-string-to-variable, icicle-search,
;; icicle-select-window, icicle-set-option-to-t, icicle-toggle-option:
;; Use a specific history variable.
;; 2006/11/17 dadams
;; Added: icicle-select-(frame|window), icicle-select-window-or-frame.
;; 2006/11/10 dadams
;; icicle-mouse-candidate-action: read-event to swallow mouse up event.
;; icicle-map-action:
;; Don't use icicle-filter-alist - find string in icicle-candidates-alist.
;; Unwind-protect to reselect minibuffer frame. Don't bind case-fold-search.
;; icicle-map: enable-recursive-minibuffers.
;; 2006/11/09 dadams
;; icicle-nb-of-candidate-in-Completions: Redefined using binary search, for performance.
;; icicle-toggle-ignored-space-prefix: Update doc string to use icicle-dispatch-C-^.
;; icicle-search:
;; Bind icicle-update-input-hook unconditionally, after icicle-search-regexp-scan.
;; icicle-search-regexp-scan: Highlight up to icicle-search-highlight-threshold.
;; icicle-search-highlight-all-input-matches:
;; Only update input and highlight if icicle-search-highlight-all-current-flag.
;; icicle-search-action:
;; Don't use icicle-filter-alist - find string in icicle-candidates-alist.
;; icicle-search-highlight-cleanup: Bind inhibit-quit to t.
;; 2006/11/07 dadams
;; Added: icicle-toggle-highlight-all-current.
;; 2006/11/06 dadams
;; icicle-search-action:
;; Highlight icicle-current-input, not icicle-current-raw-input (not updated).
;; Renamed icicle-search-highlight-all-flag to icicle-search-highlight-threshold.
;; 2006/11/05 dadams
;; Added: icicle-search-regexp-scan.
;; icicle-search:
;; Added buffers arg. Updated doc string.
;; Use icicle-search-regexp-scan: Scan each buffer in buffers.
;; Add marker, not position, to icicle-candidates-alist.
;; Go to candidate in its buffer.
;; Added progress message.
;; icicle-search-action: Pop to buffer of candidate (marker) and raise frame.
;; icicle-occur:
;; Added buffers arg. Updated doc string. Call icicle-search-highlight-cleanup.
;; icicle-search-highlight-all-input-matches: set-buffer for each ov in dolist (minor opt.).
;; icicle-search-highlight-cleanup: Added progress messages. Minor optimization.
;; 2006/10/22 dadams
;; icicle-complete-keys-action:
;; Set last-nonmenu-event to non-mouse info, to ignore *Completions* click.
;; icicle-complete-keys-1: Don't use a default value for completing-read.
;; 2006/10/21 dadams
;; Added: icicle-insert-char.
;; icicle-add-key+cmd: Respect icicle-complete-keys-self-insert-flag.
;; 2006/10/20 dadams
;; icicle-map, icicle-delete-window: Corrected doc string.
;; 2006/10/16 dadams
;; icicle-add-key+cmd: Protect :enable's eval with condition-case.
;; icicle-complete-keys-1:
;; No longer use icicle-extra-candidates.
;; Use default value of .. for completing-read (except at top level).
;; icicle-complete-keys-action: Correct no-match case: must match whole and part.
;; icicle-keys+cmds-w-prefix: Add .. to icicle-complete-keys-alist unless at top level.
;; 2006/10/15 dadams
;; icicle-complete-keys:
;; Bind icicle-complete-keys-action, not icicle-complete-keys-help, to icicle-*-action-fn.
;; Bind orig-buff, orig-window, and icicle-completing-keys-p, for use elsewhere.
;; Added: icicle-complete-keys-action using code from icicle-complete-keys.
;; icicle-complete-keys-action:
;; Use orig-buff and orig-window; restore to originally selected window.
;; Error if candidate doesn't match template xxx = yyy.
;; icicle-complete-keys-1:
;; Call icicle-complete-keys-action on chosen candidate.
;; icicle-help-on-candidate: Treat key completion also.
;; Added from cus-edit+.el: custom-variable-p.
;; Moved to icicles-mode.el: icicle-select-minibuffer-contents, next-history-element.
;; Moved here from icicles-mode.el: icicle-generic-S-tab.
;; icicle-generic-S-tab (bug fix): Do not set last-command to icicle-apropos-complete.
;; Added: eval-when-compile's.
;; 2006/10/13 dadams
;; icicle-add-key+cmd:
;; Add actual key to icicle-complete-keys-alist. Thx to Stefan Monnier.
;; Don't filter out index (Imenu) keymap.
;; Treat :enable condition.
;; icicle-complete-keys-1:
;; Use actual key recorded in icicle-*-keys-alist. Don't convert to key description.
;; Treat digit-argument and negative-argument.
;; icicle-complete-keys-alist: Updated doc string for new structure.
;; 2006/10/08 dadams
;; Added: icicle-add-key+cmd, icicle-read-single-key-description.
;; Added: icicle-complete-keys-alist.
;; Use in icicle-complete-keys-1, icicle-keys+cmds-w-prefix, icicle-add-key+cmd.
;; icicle-add-key+cmd: Update binding, depending on its type (menu item etc.).
;; Push (cons candidate binding), not just candidate, onto icicle-complete-keys-alist.
;; icicle-complete-keys-1:
;; Use binding, not just command name. Call it and put it in (this|last)-command.
;; Flipped (corrected) use of icicle-key-descriptions-use-<>-flag.
;; Use icicle-read-single-key-description.
;; icicle-prefix-keys-first-p, icicle-complete-keys-1, icicle-complete-keys-help,
;; icicle-keys+cmds-w-prefix: Don't use icicle-list-*-string.
;; 2006/10/05 dadams
;; icicle-complete-keys-1: Remove icicle-special-candidate property from all candidates.
;; icicle-keys+cmds-w-prefix:
;; Intern candidate and, if local binding, put icicle-special-candidate property on it.
;; Use single string for candidate (don't use multi-completion).
;; 2006/10/03 dadams
;; icicle-complete-keys-1: Treat "..".
;; icicle-complete-keys: Updated doc string accordingly.
;; icicle-prefix-keys-first-p: ".." is less than all other strings. Don't hard-code "= ".
;; icicle-keys+cmds-w-prefix:
;; Filtered out shadowed bindings, icicle-generic-S-tab, and icicle-complete-keys.
;; Use only map-keymap & lookup-key, not accessible-keymaps, current-active-maps,
;; map-keymap.
;; 2006/10/01 dadams
;; icicle-complete-keys: Bind sort functions, to put prefix keys first, by default.
;; Set last-command, before recursing.
;; Replaced icicle-alternative-sort with icicle-toggle-alternative-sorting (new).
;; icicle-(apropos|prefix)-complete-1:
;; Ensure icicle-(current|last)-input are strings, before compare.
;; icicle-keys+cmds-w-prefix: Tolerate empty local and global maps.
;; 2006/09/30 dadams
;; Added: icicle-read-kbd-macro, icicle-edmacro-parse-keys, icicle-toggle-angle-brackets.
;; icicle-complete-keys-1, icicle-dabbrev-completion:
;; key-description -> icicle-key-description, with icicle-key-descriptions-use-<>-flag.
;; icicle-complete-keys-1:
;; read-kbd-macro -> icicle-read-kbd-macro, with icicle-key-descriptions-use-<>-flag.
;; Got rid of extra space in prompt before colon, when no prefix.
;; icicle-keys+cmds-w-prefix: Use single-key-description with icicle-*-use-<>-flag.
;; icicle-insert-key-description:
;; Change arg to a toggle, and use icicle-key-descriptions-use-<>-flag.
;; Bind icicle-candidate-set-(retrieve|save) to C-M-<, C-M->, not C-<, C->.
;; icicle-dired-saved-file-candidates*:
;; Changed doc strings and messages to use dynamic binding of icicle-candidate-set-save.
;; 2006/09/24 dadams
;; Added: icicle-complete-keys-help.
;; icicle-complete-keys:
;; Bind icicle-*-action-fn to icicle-complete-keys-help. Mention help keys in docstring.
;; icicle-complete-keys-1:
;; Set last-command to command, so completion doesn't think candidate was last-command.
;; icicle-keys+cmds-w-prefix: Provide placeholder for future use of generic characters.
;; 2006/09/23 dadams
;; icicle-complete-keys-1:
;; Error if there are no keys for the prefix.
;; Error, not self-insert-command, for key read-kbd-macro can't convert. condition-case.
;; Report error if calling cmd fails.
;; Use vconcat for recursive call.
;; Read cmd, don't intern it - it might be a lambda or byte-compiled function.
;; Remove duplicates.
;; Provide KEYS arg to call-interactively, for error reporting.
;; Don't bind icicle-must-not-match-regexp to "^Character set .*= self-insert-command".
;; icicle-keys+cmds-w-prefix:
;; Treat also local keymap and current minor maps.
;; Do nothing if keys+maps is nil.
;; Only map-keymap if the target is a keymap.
;; Use keymapp, not functionp, as the binding test.
;; Only add binding if it is a command or keymap.
;; Only add self-insert-command binding if the key is char-valid-p.
;; Use format %S, not %s for a command binding.
;; icicle-insert-key-description: Added no-angle-brackets-p arg.
;; 2006/09/22 dadams
;; icicle-complete-keys-1:
;; Filter out keys described "Character set ...= self-insert-command".
;; 2006/09/20 dadams
;; icicle-complete-keys-1: Treat self-insert-command specially.
;; 2006/09/17 dadams
;; Added: icicle-complete-keys(-1), icicle-*-keys-prefix, icicle-keys+cmds-w-prefix,
;; icicle-doc: Removed one \n from each candidate.
;; 2006/09/12 dadams
;; Renamed icicle-switch-to-minibuffer to icicle-insert-completion.
;; Added: icicle-switch-to/from-minibuffer.
;; icicle-completion-help: Keep focus in the minibuffer after displaying help.
;; 2006/09/02 dadams
;; icicle-help-on-(next|previous)-(apropos|prefix)-candidate,
;; icicle-(next|previous)-(apropos|prefix)-candidate-action:
;; Use save-selected-window, not save-window-excursion.
;; icicle-find-file*: In Dired, ignore errors picking up current-line's file name.
;; icicle-mouse-choose-completion: Error if minibuffer is not active.
;; 2006/08/27 dadams
;; icicle-abort-minibuffer-input: If minibuffer not active, just kill buffer *Completions*.
;; icicle-execute-extended-command-1, icicle-insert-thesaurus-entry, icicle-search-action:
;; Ensure orig-window is live before using it.
;; 2006/08/23 dadams
;; Added: icicle-delete-window(s).
;; Added soft require of frame-cmds.el.
;; 2006/08/22 dadams
;; icicle-execute-extended-command-1: Bind this-command, don't set it (fixes C-next).
;; icicle-help-on-candidate: If no last candidate, then reset to first matching candidate.
;; icicle-*-candidate-action, icicle-help-on-*-candidate: save-window-excursion.
;; 2006/08/20 dadams
;; icicle-find-file*: Use diredp-find-a-file* in Dired mode (Emacs 22 or later).
;; Bug fix: icicle-candidate-action: Use icicle-*-candidates, not icicle-next-*-candidate.
;; icicle-next-*-candidate(-action): Set icicle-current-completion-mode.
;; 2006/08/18 dadams
;; Added: icicle-Info-goto-node(-(action|cmd)).
;; icicle-candidate-action: If no icicle-last-completion-candidate, use first candidate.
;; 2006/08/15 dadams
;; Added: icicle-help-on-*-*-candidate,icicle-mouse-help-on-candidate.
;; No longer put icicle-candidate-action-command property on symbols (not used).
;; Added: icicle-raise-Completions-frame.
;; icicle*-candidate-action, icicle-help-on-candidate: Use icicle-raise-Completions-frame.
;; icicle-help-on-candidate: Can use it from *Completions* too now.
;; Use icicle-barf-if-outside-Completions-and-minibuffer.
;; 2006/08/13 dadams
;; Added: icicle-Info-index(-(action|cmd)).
;; 2006/08/04 dadams
;; icicle-*-complete-1, icicle-prefix-word-complete, icicle-keep-only-past-inputs:
;; Set icicle-last-completion-command to the explicit command, not this-command.
;; icicle-history: Call icicle-last-completion-command, not icicle-apropos-complete.
;; icicle-apropos-complete-1, icicle-narrow-candidates:
;; Removed binding of icicle-apropos-completing-p (not used).
;; Added: icicle-plist, icicle-remove-Completions-window, icicle-pp-eval-expression.
;; Added soft require of pp+.el.
;; icicle-exit-minibuffer, icicle-minibuffer-complete-and-exit,
;; icicle-mouse-choose-completion, icicle-abort-minibuffer-input,
;; icicle-(apropos|prefix)-complete-1, icicle-keep-only-past-inputs,
;; icicle-insert-thesaurus-entry-cand-fn: Use icicle-remove-Completions-window.
;; icicle-doc: Treat doc of faces also.
;; icicle-non-whitespace-string-p: Added doc string.
;; 2006/08/03 dadams
;; Added:
;; icicle-comint-command, icicle-insert-kill, icicle-insert-for-yank,icicle-yank-insert.
;; Bound icicle-comint-command to C-c TAB in comint-mode.
;; icicle-search, icicle-comint-search: Cleaned up doc string.
;; 2006/08/02 dadams
;; icicle-comint-search: Mention *-prompt-pattern. Thx to Kevin Rodgers.
;; icicle-insert-string-from-variable: Added more variables to the completing-read alist.
;; 2006/07/29 dadams
;; Added: icicle-dispatch-C-., toggle-icicle-search-cleanup, icicle-toggle-search-cleanup.
;; 2006/07/23 dadams
;; Added: icicle-toggle-transforming.
;; icicle-comint-search: Bind icicle-transform-function to icicle-remove-duplicates.
;; 2006/07/22 dadams
;; Added: icicle-comint-search, icicle-comint-send-input, icicle-comint-get-*-input,
;; icicle-comint-get-final-choice, icicle-search-generic.
;; icicle-search: Added require-match arg for non-interactive calls.
;; Run the hooks if no match and no match required, and if we didn't cycle.
;; Return final choice as value (not used yet).
;; icicle-insert-string-from-variable: Use buffer-local value of variable, if there is one.
;; icicle-insert-string-from-variable:
;; Make sure we use the buffer-local value of the variable, if there is one
;; Added comint-prompt-regexp to regexp list.
;; Added mode hooks for icicle-compilation-search and icicle-comint-send-input.
;; 2006/07/20 dadams
;; Renamed icicle-arrows-respect-* to icicle-cycling-respects-completion-mode-flag.
;; 2006/07/19 dadams
;; Applied patch from Damien Elmes <emacs@repose.cx>:
;; Added: icicle-(next|previous)-context-candidate, icicle-scroll-completions.
;; icicle-switch-to-completions, icicle-switch-to-Completions-buf,
;; icicle-move-to-next-completion, icicle-map-action, icicle-search-action:
;; Use icicle-start-of-completions.
;; icicle-(apropos|prefix)-complete-1:
;; Set icicle-current-completion-type vs use icicle-arrows-respect-*-flag.
;; Use icicle-scroll-completions.
;; icicle-current-completion-in-Completions: Use point-min if no previous prop change.
;; icicle-keep-only-past-inputs: Use icicle-scroll-completions.
;; Renamed icicle-start-of-completions to icicle-start-of-candidates-in-Completions,
;; icicle-current-completion-type to icicle-current-completion-mode,
;; icicle-*-context-candidate to icicle-(next|previous)-candidate-per-mode,
;; icicle-scroll-completions to icicle-scroll-Completions.
;; icicle-(next|previous)-context-candidate: Use icicle-barf-if-outside-minibuffer.
;; icicle-scroll-Completions: Changed with-selected-window to Emacs 20 equivalent.
;; 2006/07/18 dadams
;; icicle-search: Bind completion-ignore-case to case-fold-search.
;; icicle-search-highlight-all-input-matches, icicle-search-action:
;; Put search inside condition-case, for bad regexp.
;; Added: icicle-toggle-case-sensitivity, toggle-icicle-case-sensitivity.
;; 2006/07/10 dadams
;; Added: icicle-search-region. Use in search functions. Thx to Le Wang.
;; 2006/07/08 dadams
;; icicle-search-highlight-all-input-matches: Use *-current-*, not *-current-raw-*.
;; icicle-execute-extended-command-1:
;; First try a string candidate as arg, then read it to convert it to symbol or number.
;; Reset focus back to the minibuffer, in action function.
;; 2006/07/07 dadams
;; Added: icicle-alternative-sort.
;; icicle-imenu: Show *Completions* initially for submenu choice (only).
;; icicle-execute-extended-command:
;; Echo prefix arg in prompt. Thx: *.dhcp.mdsn.wi.charter.com
;; 2006/07/06 dadams
;; Added (eval-when-compile (require 'icicles-mac)).
;; 2006/07/05 dadams
;; Renamed: icicle-current-regexp-input to icicle-current-raw-input.
;; icicle-prefix-complete-1: Don't set icicle-current-raw-input.
;; 2006/07/04 dadams
;; icicle-prefix-complete-1: No longer calculate common prefix and set current input to it.
;; Added plist entries to categorize commands:
;; icicle-(cycling|completing|candidate-action)-command.
;; icicle-(apropos|prefix)-complete-1, icicle-prefix-word-complete,
;; icicle-switch-to-Completions-buf, icicle-keep-only-past-inputs, icicle-history:
;; Use icicle-cycling-command property.
;; icicle-apropos-complete-1: Removed regexp-p arg in call to icicle-save-or-restore-input.
;; 2006/07/03 dadams
;; icicle-(apropos|prefix)-complete-1: deactivate mark after inserting current input.
;; 2006/06/18 dadams
;; icicle-apropos-complete-1, icicle-narrow-candidates: Bind icicle-apropos-completing-p.
;; 2006/06/09 dadams
;; Bug fixes: Picked up matching subdir as default dir, even if there other files match.
;; Thx to Andrey Zhdanov.
;; Empty directory not treated as a match.
;; icicle-(apropos|prefix)-complete-1:
;; If input matches an empty directory, then use that directory as the sole completion.
;; Do not expand file-name input before call icicle-file-name-*-candidates.
;; icicle-retrieve-last-input: Use insert, not icicle-insert-input (no longer used).
;; (Input backslashes reverted to slashes.)
;; 2006/06/08 dadams
;; Bug fix: Could not complete after cycling file names. Thx to Andrey Zhdanov.
;; icicle-insert-input: Use icicle-expand-file-name.
;; icicle-prefix-complete-1:
;; Expand file-name input before call icicle-file-name-prefix-candidates.
;; Expand icicle-last-completion-candidate if it is a directory name.
;; 2006/05/30 dadams
;; icicle-erase-minibuffer-or-history-element: Fix for consecutive deletions.
;; 2006/05/26 dadams
;; Added: icicle-erase-minibuffer-or-history-element.
;; 2006/05/19 dadams
;; Renamed icicle-inhibit-reminder* to icicle-reminder*.
;; icicle-narrow-candidates: Bind icicle-reminder-prompt-flag to nil, not t.
;; 2006/05/16 dadams
;; Added: icicle-kill(-a)-buffer.
;; 2006/05/15 dadams
;; Renamed: icicle-completion-nospace-flag to icicle-ignore-space-prefix-flag.
;; icicle-candidate-set-complement: Put back icicle-ignore-space-prefix-flag.
;; icicle-buffer(-other-window): Bind icicle-buffer-ignore-space-prefix-flag.
;; Added: icicle-toggle-ignored-space-prefix, toggle-icicle-ignored-space-prefix.
;; 2006/05/13 dadams
;; icicle-occur: Make icicle-search-main-regexp-others unnoticeable instead of
;; setting icicle-search-highlight-all-flag to nil.
;; icicle-candidate-set-complement: Use nil, not icicle-completion-nospace-flag.
;; Renamed: icicle-search-imenu to icicle-imenu,
;; icicle-search-imenu-in-buffer-p to icicle-imenu-in-buffer-p.
;; 2006/05/12 dadams
;; icicle-search-imenu: Remove unmatched submenus. Error if no imenu for the buffer.
;; Added: icicle-search-imenu-in-buffer-p.
;; icicle-insert-string-at-point: Use icicle-barf-if-outside-minibuffer.
;; Moved to icicles-fn.el: icicle-barf-if-outside-*.
;; Moved some commands to minibuffer-cmds section from top-level cmds section.
;; 2006/05/09 dadams
;; Added: icicle-customize-icicles-group, icicle-send-bug-report, icicle-customize-button.
;; 2006/04/30 dadams
;; Added: icicle-map, icicle-map-action.
;; icicle-filter-alist: Corrected and simplified.
;; icicle-search: Corrected cand-nb adjustment when cycle with action fns.
;; Renamed: icicle-search-action-fn to icicle-search-action,
;; icicle-search-candidates to icicle-candidates-alist.
;; 2006/04/28 dadams
;; icicle-retrieve-last-input, icicle-(apropos|prefix)-complete-1:
;; Use icicle-highlight-initial-whitespace.
;; 2006/04/25 dadams
;; icicle-completion-help: Emacs 21.3's help-insert-xref-button signature is different.
;; 2006/04/16 dadams
;; Added: icicle-search-imenu.
;; icicle-search: Bug fixes:
;; Treat completion without cycling: error or singleton go-to.
;; Only subtract one from candidate number for C- cycling, not regular cycling.
;; 2006/04/14 dadams
;; icicle-search:
;; Bug fix: Position was off by one.
;; Highlight input match inside each main regexp match (or not).
;; Bind icicle-update-input-hook and icicle-incremental-completion-flag.
;; Extract code to define icicle-search-action-fn.
;; Use icicle-search-candidates instead of local variable search-candidates.
;; Respect icicle-search-cleanup-flag.
;; Added: icicle-search-highlight-*, icicle-search-action-fn,
;; icicle-(insert|save)-text-(from|to)-variable.
;; Renamed icicle-search-refined-regexp to icicle-search-current-input.
;; 2006/04/09 dadams
;; icicle-(apropos|prefix)-complete-1: Deal with icicle-arrows-respect-*-flag.
;; Moved here from icicles-fn.el: icicle-customize-apropos*, icicle-repeat-complex-command.
;; 2006/04/07 dadams
;; icicle-search: Highlight all occurrences at once (like isearch highlight, but not lazy).
;; Error if no match for initial regexp.
;; icicle-occur: Bind icicle-search-highlight-all-flag to nil: don't highlight each line.
;; 2006/04/02 dadms
;; Added: icicle-toggle-regexp-quote, icicle-find-file*-w-wildcards.
;; icicle-find-file*: Use icicle-find-file*-w-wildcards.
;; 2006/03/31 dadams
;; icicle-search: Wrap action function with unwind-protect to select minibuffer frame.
;; Use completion-ignore-case when highlighting search hits.
;; Protect delete-overlay with overlayp.
;; Turn off region highlighting (so can see highlighting done here).
;; Removed sit-for-period argument.
;; icicle-candidate-set-save: Use prin1 instead of pp.
;; 2006/03/27 dadams
;; Added: icicle-occur.
;; icicle-search: Highlight also match of current regexp, inside that of regexp arg.
;; Use new faces icicle-search-*-regexp.
;; icicle-search, icicle-switch-to-Completions-buf, icicle-move-to-next-completion:
;; Use new, generic icicle-place-overlay.
;; Removed icicle-place-search-overlay.
;; 2006/03/26 dadams
;; icicle-search: Use icicle-search-overlay. Ensure don't match twice at same position.
;; Added regexp arg. Use 0 as sit-for default.
;; Added: icicle-place-search-overlay.
;; 2006/03/25 dadams
;; icicle-prefix-complete: Minor bug fix: Don't save try-completion if not a string.
;; icicle-candidate-set-(save|retrieve): Allow use of a variable to save/retrieve.
;; Added: icicle-candidate-set-(retrieve-from|save-to)-variable, icicle-*-no-display,
;; icicle-prefix-complete-1.
;; icicle-apropos-complete-1: Added no-display-p optional arg.
;; Use no-display-p arg in calls to icicle-display-candidates-in-Completions.
;; icicle-candidate-set-(retrieve-from|save-to)-cache-file: Pass a consp, not t.
;; icicle-candidate-set-retrieve: Don't display *Completions*.
;; 2006/03/24 dadams
;; Added icicle-delete-char.
;; 2006/03/23 dadams
;; icicle-candidate-set-define: Rewrote. Can also use at top level.
;; Error if wrong result type. Sort result. Use display-completion-list and
;; icicle-narrow-candidates (unless at top level).
;; icicle-narrow-candidates: Can call from top-level (but not interactively).
;; icicle-candidate-set-complement: Use icicle-maybe-sort-and-strip-candidates.
;; Mention in doc strings of minibuffer and *Completions* functions: where, key.
;; 2006/03/22 dadams
;; icicle-find-file*: Use default-directory as default, so opens directory on empty input.
;; icicle-prefix-complete:
;; Save icicle-current-regexp-input.
;; Set icicle-current-input to common prefix. Use it everywhere here.
;; Calls to icicle-display-candidates-in-Completions: no root arg now.
;; 2006/03/21 dadams
;; icicle-insert-input: Bug fix: Use directory of input, not default-directory.
;; Append a slash if input itself is a directory.
;; 2006/03/20 dadams
;; icicle-retrieve-last-input: Insert icicle-current-regexp-input if repeat C-l.
;; Added: icicle-insert-input.
;; 2006/03/19 dadams
;; icicle-apropos-complete-1: Call icicle-save-or-restore-input with non-nil regexp-p arg.
;; 2006/03/17 dadams
;; Added: icicle-add/update-saved-completion-set, icicle-remove-saved-completion-set,
;; icicle-retrieve-candidates-from-set.
;; Removed: icicle-cache-file.
;; icicle-candidate-set-retrieve: Read candidates set and use its cache file.
;; Enable recursive minibuffers.
;; icicle-candidate-set-save: Read candidates set and cache-file names.
;; Use icicle-add/update-saved-completion-set.
;; icicle-barf-if-outside-minibuffer: Move interactive test to calling functions.
;; icicle-files-within: Moved to icicle-fn.el.
;; 2006/03/16 dadams
;; Added: icicle*-saved-completion-set.
;; 2006/03/14 dadams
;; icicle-narrow-candidates: Handle no-catch error. Don't use icicle-completing-p.
;; icicle-candidate-set-complement:
;; Do what we do in icicle-candidate-set-retrieve: call icicle-narrow-candidates.
;; icicle-candidate-set-(retrieve|complement): Msg when display.
;; icicle-(apropos|prefix)-complete-1:
;; Removed test for last-command = icicle-candidate-set-complement.
;; 2006/03/13 dadams
;; Added: icicle-candidate-set-(retrieve-from|save-to)-cache-file.
;; icicle-candidate-set-(retrieve|save): C-u uses cache file.
;; 2006/03/12 dadams
;; Added: icicle-dired-saved-file-candidates(-other-window), icicle-locate-file*,
;; icicle-files-within.
;; 2006/03/11 dadams
;; icicle-find-file*, icicle-delete-file*:
;; Reverted to simple form (moved directory control to icicles-mac.el).
;; icicle-keep-only-past-inputs: Expand file name relative to directory of last input.
;; 2006/03/10 dadams
;; icicle-find-file*, icicle-delete-file*: Expand file name relative to dir of last input.
;; Renamed icicle-minibuffer-contents to icicle-minibuffer-contents-from-minibuffer.
;; 2006/03/09 dadams
;; icicle-barf-if-outside-*: Removed argument - use this-command instead.
;; 2006/03/08 dadams
;; icicle-bookmark: Use default value, not init value, for completing-read.
;; 2006/03/07 dadams
;; icicle-doc: Save table in minibuffer-completion-table, so can access via C-RET too.
;; icicle-insert-thesaurus-entry, icicle-*doc:
;; Removed binding of icicle-incremental-completion-flag to nil.
;; Added: icicle-barf-if-outside-(minibuffer|Completions). Use in appropriate commands.
;; Added: icicle-non-whitespace-string-p. Use in icicle-*doc.
;; 2006/03/06 dadams
;; Update doc strings of *-thesaurus*.
;; 2006/03/05 dadams
;; Added: icicle-toggle-incremental-completion, toggle-icicle-incremental-completion.
;; 2006/03/03 dadams
;; icicle-*doc: Clarified doc strings. Updated prompts.
;; Added: icicle-help-button. Use in icicle-completion-help.
;; 2006/03/02 dadams
;; icicle-insert-thesaurus-entry, icicle-complete-thesaurus-entry:
;; Use synonyms-ensure-synonyms-read-from-cache. Clarified doc strings.
;; icicle-complete-thesaurus-entry: Error if no word at point. Correct looking-at regexp.
;; 2006/03/01 dadams
;; Added: icicle-insert-thesaurus-entry, icicle-insert-thesaurus-entry-cand-fn,
;; icicle-complete-thesaurus-entry.
;; icicle-(previous|next)-(apropos|prefix)-candidate-action: Wrap in save-excursion.
;; Use icicle-clear-minibuffer instead of icicle-erase-minibuffer non-interactively.
;; icicle-erase-minibuffer: Use icicle-call-then-update-Completions.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;
;;; Code:
;; You need not load this file. It contains only documentation.
(provide 'icicles-chg)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;; icicles-chg.el ends here![[Home]](https://www.emacswiki.org/images/logo218x38.png)