[elpa] externals/plz 81d1c61f1f 07/40: Tidy docstring and comment

[ELPA Syncer]

branch: externals/plz
commit 81d1c61f1f4dd90fe4f90aa2ec89c21309788715
Author: Adam Porter <adam@alphapapa.net>
Commit: Adam Porter <adam@alphapapa.net>

    Tidy docstring and comment
---
 plz.el | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/plz.el b/plz.el
index 7af4093c33..140f9843c8 100644
--- a/plz.el
+++ b/plz.el
@@ -321,8 +321,11 @@ For binary content, it should be nil.  When AS is `binary',
 DECODE is automatically set to nil.
 
 THEN is a callback function, whose sole argument is selected
-above with AS.  Or THEN may be `sync' to make a synchronous
-request, in which case the result is returned directly.
+above with AS; if the request fails and no ELSE function is
+given (see below), the argument will be a `plz-error' struct
+describing the error.  Or THEN may be `sync' to make a
+synchronous request, in which case the result is returned
+directly from this function.
 
 ELSE is an optional callback function called when the request
 fails (i.e. if curl fails, or if the HTTP response has a non-2xx
@@ -750,7 +753,6 @@ node `(elisp) Sentinels').  Kills the buffer before 
returning."
                         (err (make-plz-error :curl-error (cons curl-exit-code 
curl-error-message))))
                    (process-put process-or-buffer :plz-result err)
                    (pcase-exhaustive plz-else
-                     ;; FIXME: Returning a plz-error structure which has a 
curl-error slot, wrapped in a plz-curl-error, is confusing.
                      (`nil (setf plz-result err))
                      ((pred functionp) (funcall plz-else err)))))