[Emacs-diffs] feature/auth-source-pass f6e4aa8 1/3: auth-source: documentation change

[Teodor Zlatanov]

branch: feature/auth-source-pass
commit f6e4aa832be771a29884bdbd4a8c01274d953734
Author: Damien Cassou <address@hidden>
Commit: Damien Cassou <address@hidden>

    auth-source: documentation change
---
 lisp/auth-source.el | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/lisp/auth-source.el b/lisp/auth-source.el
index 5ad4277..3b60bd8 100644
--- a/lisp/auth-source.el
+++ b/lisp/auth-source.el
@@ -353,12 +353,15 @@ with \"[a/b/c] \" if CHOICES is \(?a ?b ?c)."
       k)))
 
 (defvar auth-source-backend-parser-functions nil
-  "List of auth-source parser functions
-These functions return backends from an entry in `auth-sources'.
-Add your backends to this list with `add-hook'.")
+  "List of auth-source parser functions.
+Each function takes an entry from `auth-sources' as parameter and
+returns a backend or nil if the entry is not supported.  Add a
+parser function to this list with `add-hook'.  Searching for a
+backend starts with the first element on the list and stops as
+soon as a function returns non-nil.")
 
 (defun auth-source-backend-parse (entry)
-  "Creates an auth-source-backend from an ENTRY in `auth-sources'."
+  "Create an auth-source-backend from an ENTRY in `auth-sources'."
 
   (let (backend)
     (dolist (f auth-source-backend-parser-functions)