From 1ebabaf9ff1d7d3365d92ed2ac38c8cec9e9aa68 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 15 Oct 2022 12:52:49 +0300 Subject: [PATCH] ; Fix documentation of ecomplete * lisp/ecomplete.el (ecomplete-sort-predicate) (ecomplete-filter-regexp, ecomplete-edit, ecomplete-remove): Doc fixes. * etc/NEWS: Fix wording of the 'ecomplete-filter-regexp' entry. --- etc/NEWS | 4 ++-- lisp/ecomplete.el | 13 +++++++------ 2 files changed, 9 insertions(+), 8 deletions(-) diff --git a/etc/NEWS b/etc/NEWS index 96415870523..62004c10a6c 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -1384,8 +1384,8 @@ If non-nil and there's only one matching option, auto-select that. --- *** New user option 'ecomplete-filter-regexp'. -If non-nil this user option describes what email addresses to ignore -and not add to the database. +If non-nil, this user option describes what entries not to add to the +database stored on disk. ** Dired diff --git a/lisp/ecomplete.el b/lisp/ecomplete.el index 21f5f456ea0..54d60c84d4f 100644 --- a/lisp/ecomplete.el +++ b/lisp/ecomplete.el @@ -70,9 +70,9 @@ :type '(symbol :tag "Coding system")) (defcustom ecomplete-sort-predicate #'ecomplete-decay - "Predicate to use when sorting matched. -The predicate is called with two parameters that represent the -completion. Each parameter is a list where the first element is + "Predicate to use when sorting matched ecomplete candidates. +The predicate is called with two arguments that represent the +completion. Each argument is a list where the first element is the times the completion has been used, the second is the timestamp of the most recent usage, and the third item is the string that was matched." @@ -87,7 +87,7 @@ string that was matched." :version "29.1") (defcustom ecomplete-filter-regexp nil - "Regular expression of addresses to not store." + "Regular expression of addresses that should not be stored by ecomplete." :type 'regexp :version "29.1") @@ -296,7 +296,7 @@ non-nil and there is only a single completion option available." nil t))) (defun ecomplete-edit () - "Prompt for an item and allow editing it." + "Prompt for an ecomplete item and allow editing it." (interactive) (let* ((type (ecomplete--prompt-type)) (data (cdr (assq type ecomplete-database))) @@ -312,7 +312,8 @@ non-nil and there is only a single completion option available." (ecomplete-save))) (defun ecomplete-remove () - "Remove entries matching a regexp from the ecomplete database." + "Remove from the ecomplete database the entries matching a regexp. +Prompt for the regexp to match the database entries to be removed." (interactive) (let* ((type (ecomplete--prompt-type)) (data (cdr (assq type ecomplete-database))) -- 2.39.5