[Top][All Lists]
[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
- [Emacs-diffs] /srv/bzr/emacs/trunk r107222: Document url-queue-retrieve,
Glenn Morris <=