From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Wed, 15 May 2019 07:45:08 +0000 (+0200)
Subject: Describe error data in url-retrieve better
X-Git-Tag: emacs-27.0.90~2886
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=8f544c610445e763c4fca4a2d6773a099385a3a6;p=emacs.git

Describe error data in url-retrieve better

* lisp/url/url.el (url-retrieve): Describe the error data more in
depth (bug#25735).
---

diff --git a/lisp/url/url.el b/lisp/url/url.el
index ed0947795b0..5242d42f04c 100644
--- a/lisp/url/url.el
+++ b/lisp/url/url.el
@@ -136,9 +136,11 @@ STATUS is a plist representing what happened during the request,
 with most recent events first, or an empty list if no events have
 occurred.  Each pair is one of:
 
-\(:redirect REDIRECTED-TO) - the request was redirected to this URL
-\(:error (ERROR-SYMBOL . DATA)) - an error occurred.  The error can be
-signaled with (signal ERROR-SYMBOL DATA).
+\(:redirect REDIRECTED-TO) - the request was redirected to this URL.
+
+\(:error (error type . DATA)) - an error occurred.  TYPE is a
+symbol that says something about where the error occurred, and
+DATA is a list (possibly nil) that describes the error further.
 
 Return the buffer URL will load into, or nil if the process has
 already completed (i.e. URL was a mailto URL or similar; in this case