emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] /srv/bzr/emacs/trunk r107222: Document url-queue-retrieve


From: Glenn Morris
Subject: [Emacs-diffs] /srv/bzr/emacs/trunk r107222: Document url-queue-retrieve
Date: Thu, 09 Feb 2012 22:23:47 -0500
User-agent: Bazaar (2.3.1)

------------------------------------------------------------
revno: 107222
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Thu 2012-02-09 22:23:47 -0500
message:
  Document url-queue-retrieve
  
  * doc/misc/url.texi (Retrieving URLs): Update url-retrieve arguments.
  Mention url-queue-retrieve.
  
  * lisp/url/url-queue.el (url-queue-retrieve): Doc fix.
  
  * etc/NEWS: Edits.
modified:
  doc/misc/ChangeLog
  doc/misc/url.texi
  etc/NEWS
  lisp/url/ChangeLog
  lisp/url/url-queue.el
=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2012-02-09 07:48:22 +0000
+++ b/doc/misc/ChangeLog        2012-02-10 03:23:47 +0000
@@ -1,3 +1,8 @@
+2012-02-10  Glenn Morris  <address@hidden>
+
+       * url.texi (Retrieving URLs): Update url-retrieve arguments.
+       Mention url-queue-retrieve.
+
 2012-02-09  Glenn Morris  <address@hidden>
 
        * sem-user.texi (Semantic mode user commands): Typo fix.

=== modified file 'doc/misc/url.texi'
--- a/doc/misc/url.texi 2012-01-19 07:21:25 +0000
+++ b/doc/misc/url.texi 2012-02-10 03:23:47 +0000
@@ -201,13 +201,25 @@
 info, or mailto URLs that need no further processing).
 @end defun
 
address@hidden url-retrieve url callback &optional cbargs
address@hidden url-retrieve url callback &optional cbargs silent no-cookies
 Retrieve @var{url} asynchronously and call @var{callback} with args
 @var{cbargs} when finished.  The callback is called when the object
 has been completely retrieved, with the current buffer containing the
 object and any MIME headers associated with it.  @var{url} is either a
 string or a parsed URL structure.  Returns the buffer @var{url} will
 load into, or @code{nil} if the process has already completed.
+If the optional argument @var{silent} is address@hidden, suppress
+progress messages.  If the optional argument @var{no-cookies} is
address@hidden, do not store or send cookies.
address@hidden defun
+
address@hidden url-queue-parallel-processes
address@hidden url-queue-timeout
address@hidden url-queue-retrieve url callback &optional cbargs silent 
no-cookies
+This acts like the @code{url-retrieve} function, but downloads in
+parallel.  The option @code{url-queue-parallel-processes} controls the
+number of concurrent processes, and the option @code{url-queue-timeout}
+sets a timeout in seconds.
 @end defun
 
 @node Supported URL Types

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-02-10 02:48:25 +0000
+++ b/etc/NEWS  2012-02-10 03:23:47 +0000
@@ -858,8 +858,9 @@
 *** The option `ange-ftp-binary-file-name-regexp' has changed its
 default value to "".
 
-** `url-queue-retrieve' downloads web pages asynchronously, but allow
-controlling the degree of parallelism.
++++
+** New function, url-queue-retrieve, fetches URLs asynchronously like
+url-retrieve does, but in parallel.
 
 ** VC and related modes
 
@@ -921,6 +922,7 @@
 ---
 *** pc-mode.el is obsolete (CUA mode is much more comprehensive).
 
+[gnus.texi, message.texi need updating]
 *** pgg is obsolete (use EasyPG instead)
 
 ---

=== modified file 'lisp/url/ChangeLog'
--- a/lisp/url/ChangeLog        2012-02-09 07:48:22 +0000
+++ b/lisp/url/ChangeLog        2012-02-10 03:23:47 +0000
@@ -1,3 +1,7 @@
+2012-02-10  Glenn Morris  <address@hidden>
+
+       * url-queue.el (url-queue-retrieve): Doc fix.
+
 2012-02-08  Lars Ingebrigtsen  <address@hidden>
 
        * url-parse.el (url): Add the `use-cookies' slot to the URL struct

=== modified file 'lisp/url/url-queue.el'
--- a/lisp/url/url-queue.el     2012-02-08 00:04:42 +0000
+++ b/lisp/url/url-queue.el     2012-02-10 03:23:47 +0000
@@ -56,9 +56,10 @@
 ;;;###autoload
 (defun url-queue-retrieve (url callback &optional cbargs silent 
inhibit-cookies)
   "Retrieve URL asynchronously and call CALLBACK with CBARGS when finished.
-Like `url-retrieve' (which see for details of the arguments), but
-controls the level of parallelism via the
-`url-queue-parallel-processes' variable."
+This is like `url-retrieve' (which see for details of the arguments),
+but downloads in parallel.  The variable `url-queue-parallel-processes'
+sets the number of concurrent processes.  The variable `url-queue-timeout'
+sets a timeout."
   (setq url-queue
        (append url-queue
                (list (make-url-queue :url url
@@ -127,7 +128,7 @@
        (push job jobs)))
     (dolist (job jobs)
       (setq url-queue (delq job url-queue)))))
-  
+
 (defun url-queue-start-retrieve (job)
   (setf (url-queue-buffer job)
        (ignore-errors


reply via email to

[Prev in Thread] Current Thread [Next in Thread]