From: Richard M. Stallman <rms@gnu.org>
Date: Fri, 15 Jul 2005 05:11:28 +0000 (+0000)
Subject: (url-retrieve): The callback function can get an additional keyword arg pair.
X-Git-Tag: emacs-pretest-22.0.90~8141
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=497803edbef7a0e4b7b875165346fcf77e0ac298;p=emacs.git

(url-retrieve): The callback function can get an additional keyword arg pair.
---

diff --git a/lisp/url/url.el b/lisp/url/url.el
index 695aceb871e..21859ad9566 100644
--- a/lisp/url/url.el
+++ b/lisp/url/url.el
@@ -123,9 +123,14 @@ Emacs."
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 (defun url-retrieve (url callback &optional cbargs)
   "Retrieve URL asynchronously and call CALLBACK with CBARGS when finished.
-The callback is called when the object has been completely retrieved, with
+URL is either a string or a parsed URL.
+
+CALLBACK is called when the object has been completely retrieved, with
 the current buffer containing the object, and any MIME headers associated
-with it.  URL is either a string or a parsed URL.
+with it.  Normally it gets the arguments in the list CBARGS.
+However, if what we find is a redirect, CALLBACK is given
+two additional args, `:redirect' and the redirected URL,
+followed by CBARGS.
 
 Return the buffer URL will load into, or nil if the process has
 already completed."