Icicles - Buffer-Name Input

Previous: Icicles - Google MatchingIciclesIciclesIndexNext: Icicles - File-Name Input

Buffer-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 arg that matters Candidates are only the buffers that satisfy these conditions:

Those 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

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’.

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:

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:

Remember 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 MatchingIciclesIciclesIndexNext: Icicles - File-Name Input

DrewsElispLibraries referenced here: Lisp:icicles.el

CategoryCommands CategoryCompletion CategoryBufferSwitching