remove old
authorJoerg Jaspert <joerg.jaspert@dlh.de>
Fri, 23 Sep 2016 14:09:21 +0000 (16:09 +0200)
committerJoerg Jaspert <joerg.jaspert@dlh.de>
Fri, 23 Sep 2016 14:09:21 +0000 (16:09 +0200)
13 files changed:
.emacs.d/elisp/icicle/icicles-chg.el [deleted file]
.emacs.d/elisp/icicle/icicles-cmd1.el [deleted file]
.emacs.d/elisp/icicle/icicles-cmd2.el [deleted file]
.emacs.d/elisp/icicle/icicles-doc1.el [deleted file]
.emacs.d/elisp/icicle/icicles-doc2.el [deleted file]
.emacs.d/elisp/icicle/icicles-face.el [deleted file]
.emacs.d/elisp/icicle/icicles-fn.el [deleted file]
.emacs.d/elisp/icicle/icicles-mac.el [deleted file]
.emacs.d/elisp/icicle/icicles-mcmd.el [deleted file]
.emacs.d/elisp/icicle/icicles-mode.el [deleted file]
.emacs.d/elisp/icicle/icicles-opt.el [deleted file]
.emacs.d/elisp/icicle/icicles-var.el [deleted file]
.emacs.d/elisp/icicle/icicles.el [deleted file]

diff --git a/.emacs.d/elisp/icicle/icicles-chg.el b/.emacs.d/elisp/icicle/icicles-chg.el
deleted file mode 100644 (file)
index 48df0d4..0000000
+++ /dev/null
@@ -1,11448 +0,0 @@
-;;; 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-2015, Drew Adams, all rights reserved.
-;; Created: Tue Nov 27 07:47:53 2007
-;; Last-Updated: Wed Jan 21 09:13:40 2015 (-0800)
-;;           By: dradams
-;;     Update #: 11389
-;; URL: http://www.emacswiki.org/icicles-chg.el
-;; Doc URL: http://www.emacswiki.org/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
-;;
-;; 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:
-;;  http://dto.freeshell.org/notebook/Linkd.html.
-;;
-;;  (@> "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'")
-;;
-;; 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'")
-;;
-;; 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'")
-;;
-;; 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'")
-;;
-;; 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.
-;; ****************************************************************************************************
-;;
-;; 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'")
-;;
-;; 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'")
-;;
-;; 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: Don't 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: Don't 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: Don't 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'")
-;;
-;; 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