File: crm.el.html
This code defines a function, completing-read-multiple, which
provides the ability to read multiple strings in the minibuffer,
with completion. See that function's documentation for details.
For the moment, I have decided to not bind any special behavior to the separator key. In the future, the separator key might be used to provide completion in certain circumstances. One of the reasons why this functionality is not yet provided is that it is unclear to the author what the precise circumstances are, under which separator-invoked completion should be provided.
Design note: completing-read-multiple is modeled after
completing-read. They should be similar -- it was intentional.
Some of this code started out as translation from C code in src/minibuf.c to Emacs Lisp code. After this code was rewritten in Elisp and made to operate on any field, this file was completely rewritten to just reuse that code.
Thanks to Sen Nagata <sen@eccosys.com> for the original version of the code, and sorry for throwing it all out. --Stef
Thanks to Richard Stallman for all of his help (many of the good ideas in here are from him), Gerd Moellmann for his attention, Stefan Monnier for responding with a code sample and comments very early on, and Kai Grossjohann & Soren Dayton for valuable feedback.
Defined variables (5)
crm-completion-table | An alist whose elements’ cars are strings, or an obarray. |
crm-default-separator | Default value of ‘crm-separator’. |
crm-local-completion-map | Local keymap for minibuffer multiple input with completion. |
crm-local-must-match-map | Local keymap for minibuffer multiple input with exact match completion. |
crm-separator | Separator regexp used for separating strings in ‘completing-read-multiple’. |
Defined functions (9)
completing-read-multiple | (PROMPT TABLE &optional PREDICATE REQUIRE-MATCH INITIAL-INPUT HIST DEF INHERIT-INPUT-METHOD) |
crm--choose-completion-string | (CHOICE BUFFER BASE-POSITION &rest IGNORED) |
crm--collection-fn | (STRING PREDICATE FLAG) |
crm--completion-command | (BEG END &rest BODY) |
crm--current-element | () |
crm-complete | () |
crm-complete-and-exit | () |
crm-complete-word | () |
crm-completion-help | () |