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 ed0947795b06dc8229be3b62ed5a5dcd4884dfe5..5242d42f04c3f1a68ea4ee11e6f812447ea80a0f 100644 (file)
--- 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