File: eudc-capf.el.html
This library provides functions to deliver email addresses from
EUDC search results to completion-at-point.
Email address completion will likely be desirable only in
situations where designating email recipients plays a role, such
as when composing or replying to email messages, or when posting
to newsgroups, possibly with copies of the post being emailed.
Hence, modes relevant in such contexts, such as for example
message-mode and mail-mode, often at least to some extent
provide infrastructure for different functions to be called when
completing in certain message header fields, or in the body of
the message. In other modes for editing email messages or
newsgroup posts, which do not provide such infrastructure, any
completion function providing email addresses will need to check
whether the completion attempt occurs in an appropriate context
(that is, in a relevant message header field) before providing
completion candidates. Two mechanisms are thus provided by this
library.
The first mechanism is intended for use by the modes listed in
eudc-capf-modes, and relies on these modes adding
eudc-capf-complete to completion-at-point-functions, as
would be usually done for any general-purpose completion
function. In this mode of operation, and in order to offer
email addresses only in contexts where the user would expect
them, a check is performed whether point is on a line that is a
message header field suitable for email addresses, such as for
example "To:", "Cc:", etc.
The second mechanism is intended for when the user modifies
message-completion-alist to replace message-expand-name with
the function eudc-capf-message-expand-name. As a result,
minibuffer completion (completing-read) for email addresses
would no longer enabled in message-mode, but
completion-at-point (in-buffer completion) only.
Defined variables (1)
eudc-capf-modes | List of modes in which email address completion is to be attempted. |