RE: Icicles [was: shell command completion gone]

["Drew Adams" <drew.adams@oracle.com>]

> vanilla gives history icicles gives all possible completions
> Trying to answer my own question:

You didn't ask a question. ;-)

> Does (setq icicle-default-cycling-mode 'history)
> do what I want?

Dunno.  What do you want?

> [Well it seems to as far as I can tell.  Just dunno
> about odd/corner cases]

If you want up/down to _always_ cycle the history, then customize these options
accordingly: `icicle-modal-cycle-up-keys', `icicle-modal-cycle-down-keys'.
Replace `up' and `down' in the key lists with keys of your choice.

(If you do that, you might also want to change the similar options for keys that
cycle per-mode actions, alternate actions, and help, `C-down', `C-S-down',
`C-M-down', etc. for consistency.)


Option `icicle-default-cycling-mode' determines only the _default_ cycling mode:
the mode in effect if you do not specify the mode (i.e., before you specify it),
by hitting `TAB' (for prefix completion) or `S-TAB' (for apropos completion).
This option has no effect once you have specified the current cycling mode.

If you leave the default bindings for `icicle-modal-cycle-(up|down)-keys' as
`up' and `down', those two keys reflect the current completion mode.  They do
not cycle history once you have specified the current completion mode explicitly
(`TAB' or `S-TAB').

E.g., if you type `foo TAB', then `up' and `down' perform prefix-mode cycling,
not history cycling, regardless of the value of `icicle-default-cycling-mode'.
It is only before you hit either `TAB' or `S-TAB' that a default setting of
`icicle-default-cycling-mode' other than `prefix', `apropos', and `nil' cycles
the history.

,----
| icicle-default-cycling-mode is a variable defined in `icicles-opt.el'.
| Its value is prefix
| 
| Documentation:
| *Default completion mode for per-mode cycling.
| When you hit a completion key (`TAB' or `S-TAB'), it sets the current
| completion mode (prefix or apropos, respectively).  That determines
| the kind of completion to be used by the per-mode cycling keys.
| 
| This option controls which completion mode to use if you cycle using a
| per-mode key (e.g. `down') *before* hitting a completion key.
| 
|  - `prefix'  means cycle prefix completions
|  - `apropos' means cycle apropos completions
|  - Any other non-nil value means cycle inputs from the input history
|  - nil means do not cycle - you must first hit a completion key
| 
| The per-mode cycling keys are the values of
| `icicle-modal-cycle-up-keys' (backward) and
| `icicle-modal-cycle-down-keys' (forward).  By default, these are keys
| `up' and `down' as well as the mouse wheel.
| 
| For example, if the value is `prefix' (the default) then you can
| immediately cycle prefix completions using `up', `down', or the mouse
| wheel, without first hitting `TAB'.
| 
| Once you have used `TAB' or `S-TAB', the only way to traverse the
| history is using `M-p' and `M-n' (they always traverse the history).
| 
| This option affects only cycling with the per-mode keys.  You can
| always use the mode-specific cycling keys instead to cycle according
| to a particular mode.  The mode-specific keys are (by default):
| 
|  - `end'  and `home'  for prefix completion
|  - `next' and `prior' for apropos completion
| 
| (By default there is no conflict between the cycling keys that are
| mode-specific and those that are per-mode.  But if you customize them
| in such a way that you set a key to both, the mode-specific use takes
| priority.)
| 
| After you change the value of this option, toggle Icicle mode off,
| then on again, for the change to take effect in the same session.
| 
| You can customize this variable.
`----