[Emacs-diffs] scratch/backports-25.2-strict e683495 1/4: Doc fix for url-http

[Noam Postavsky]

branch: scratch/backports-25.2-strict
commit e6834952edbd8b4e00c2e7b06535778fb6a1865b
Author: Devon Sean McCullough <address@hidden>
Commit: Noam Postavsky <address@hidden>

    Doc fix for url-http
    
    * lisp/url/url-http.el (url-http): Document better return values
      (bug#13187) (tiny change)
    
    (cherry picked from commit 344303c8d9cb03d4778a73940e80e966280aa694)
---
 lisp/url/url-http.el |   15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/lisp/url/url-http.el b/lisp/url/url-http.el
index 8f36dde..e0e080e 100644
--- a/lisp/url/url-http.el
+++ b/lisp/url/url-http.el
@@ -1195,17 +1195,20 @@ the end of the document."
   "Retrieve URL via HTTP asynchronously.
 URL must be a parsed URL.  See `url-generic-parse-url' for details.
 
-When retrieval is completed, execute the function CALLBACK, passing it
-an updated value of CBARGS as arguments.  The first element in CBARGS
-should be a plist describing what has happened so far during the
-request, as described in the docstring of `url-retrieve' (if in
-doubt, specify nil).
+When retrieval is completed, execute the function CALLBACK,
+passing it an updated value of CBARGS as arguments.  The first
+element in CBARGS should be a plist describing what has happened
+so far during the request, as described in the docstring of
+`url-retrieve' (if in doubt, specify nil).  The current buffer
+then CALLBACK is executed is the retrieval buffer.
 
 Optional arg RETRY-BUFFER, if non-nil, specifies the buffer of a
 previous `url-http' call, which is being re-attempted.
 
 Optional arg GATEWAY-METHOD specifies the gateway to be used,
-overriding the value of `url-gateway-method'."
+overriding the value of `url-gateway-method'.
+
+The return value of this function is the retrieval buffer."
   (cl-check-type url vector "Need a pre-parsed URL.")
   (let* ((host (url-host (or url-using-proxy url)))
         (port (url-port (or url-using-proxy url)))