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

diff --git a/etc/NEWS b/etc/NEWS
index 9641587052328caa6ef14a2d43134f7168b5565d..62004c10a6c7789084c2353740c624922adc1c95 100644 (file)
--- 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 21f5f456ea00e5caa0c52520e0357134e085edbd..54d60c84d4f00743827590e0ca3b9f28feb7f062 100644 (file)
--- 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)))