changeset 64330:ba29905c8f52

(url-retrieve): The callback function can get an additional keyword arg pair.
author Richard M. Stallman <rms@gnu.org>
date Fri, 15 Jul 2005 05:11:28 +0000
parents 654fa84e4f98
children bb65f8cf3863
files lisp/url/url.el
diffstat 1 files changed, 7 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/lisp/url/url.el	Fri Jul 15 01:23:01 2005 +0000
+++ b/lisp/url/url.el	Fri Jul 15 05:11:28 2005 +0000
@@ -123,9 +123,14 @@
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 (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."