| Previous: Icicles - Google Matching | Icicles | IciclesIndex | Next: Icicles - File-Name Input |
The Icicles commands that read buffer names are multi-commands, so you can act on more than one buffer during a given command invocation.
These commands all let you use a prefix argument to control which buffers are completion candidates. It is the numeric value of the prefix argument that matters Candidates are only the buffers that satisfy these conditions:
‘C-u’: whose mode is derived from the current buffer mode‘C-u C-u’ (double): are visible (possibly in an iconified frame)‘C-u C-u C-u’ (triple): invisible‘-’ (plain ‘-’): are modified (unsaved)‘-’): are associated with the selected frameThose are the default behaviors, but you can change them using option `icicle-buffer-prefix-arg-filtering’
‘icicle-buffer’ (‘C-x b’ in Icicle mode, by default) is a multi-command that accepts multi-completion input: the first part matches buffer names, and the second part, which is optional, matches buffer content. So for example:
C-x b f o o → Match buffer names against ‘foo’C-x b C-M-j t o t o → Match buffer contents against ‘toto’C-x b f o o C-M-j t o t o → Match both buffer name and contents(Options `icicle-buffer-include-cached-files-nflag’ and `icicle-buffer-include-recent-files-nflag’ have no effect on command ‘icicle-kill-buffer’. Its candidates are only existing buffer names.)
You can use option `icicle-buffer-skip-functions’ to specify patterns for buffer names to exclude from content-searching when you provide a content-matching pattern to ‘icicle-buffer’.
Remember that you can use all of the usual Icicles multi-command keys. In particular, you can use `C-!’ to act on all matching buffers. So for example, you can use ‘C-x k’ (‘icicle-kill-buffer’), filter buffer-name candidates in various ways (including progressive completion), and then use `C-!’ to kill all of the remaining candidate buffers.
In addition to the usual Icicles key bindings, during buffer-name completion you can use additional keys, which are defined by option `icicle-buffer-candidate-key-bindings’. These are the keys provided by the default value of the option:
‘C-x F’ (‘icicle-toggle-include-cached-files’) Toggle whether ‘icicle-buffer’ includes cached file names as candidates. That is, toggle option `icicle-buffer-include-cached-files-nflag’. A prefix argument sets the option value to the numeric prefix value.‘C-x R’ (‘icicle-toggle-include-recent-files’) Toggle whether ‘icicle-buffer’ includes the names of recently accessed files as candidates. That is, toggle option `icicle-buffer-include-recent-files-nflag’. A prefix argument sets the option value to the numeric prefix value.‘C-x m’ (‘icicle-bookmark-non-file-other-window’) Visit a bookmarked buffer. This is available only if you use library Bookmark+. This too is a multi-command, so you can actually visit any number of buffer bookmarks with one use of ‘C-x m’. When finished, you can continue with non-bookmark buffer-name completion.‘C-x C-m -’ (‘icicle-remove-buffer-cands-for-derived-mode’) Remove the buffer-name candidates with a major mode that is derived from a given mode. You are prompted for the mode. You can repeat this key to narrow buffer candidates by mode. (‘C-m’ is the same key as ‘RET’.)C-x C-m +’ (‘icicle-keep-only-buffer-cands-for-derived-mode’) Keep only the buffer-name candidates with a major mode that is derived from a given mode. You are prompted for the mode. (‘C-m’ is the same key as ‘RET’.)‘C-x M -’ (‘icicle-remove-buffer-cands-for-mode’) Same as ‘C-x C-m -’, but excludes ancestor modes.C-x M +’ (‘icicle-keep-only-buffer-cands-for-mode’) Same as `C-x C-m +’, but excludes ancestor modes.‘C-x * -’ (‘icicle-remove-buffer-cands-for-modified’) Remove the buffer-name candidates for modified buffers.C-x * +’ (‘icicle-keep-only-buffer-cands-for-modified’) Keep only the buffer-name candidates for modified buffers.‘C-x i -’ (‘icicle-remove-buffer-cands-for-indirect’) Remove the buffer-name candidates for indirect buffers.C-x i +’ (‘icicle-remove-buffer-cands-for-indirect’) Keep only the buffer-name candidates for indirect buffers.‘C-x v -’ (‘icicle-remove-buffer-cands-for-visible’) Remove the candidate buffers that are visible. This includes buffers that are in iconified frames.C-x v +’ (‘icicle-keep-only-buffer-cands-for-visible’) Keep only the candidate buffers that are visible. This includes buffers that are in iconified frames.‘S-delete’ Kill the buffer named by the current completion candidate.When cached or recently used file names are included as candidates, option `icicle-file-skip-functions’ is used to exclude files from content-searching whose names match its patterns, similarly to what ‘icicle-buffer-skip-functions’ does for buffer names.
During completion, candidate sorting is specific to buffer names. `C-,’ cycles among the following sort orders:
* … *’ last: put buffers such as ‘*Messages*’ and ‘*Help*’ lastRemember too that the mode-line candidate help for a buffer-name candidate includes the mode name, buffer size, and associated file or directory, if any. The directory name can be especially helpful for Dired buffer candidates, since the buffer name does not tell you the full directory. For example, if you do ‘C-u C-x b’ from Dired, so the candidates are names of Dired buffers only, then cycling shows you the directory for each one.
Similarly, the more detailed help available from ‘C-M-RET’ etc. also lists the full name of the file or directory associated with the buffer.
The following user options control buffer-name completion.
You can use option ‘icicle-buffer-configs’ to define buffer configurations: persistent sets of the option values marked (*).
See Also:
| Previous: Icicles - Google Matching | Icicles | IciclesIndex | Next: Icicles - File-Name Input |
DrewsElispLibraries referenced here: Lisp:icicles.el