2010-06-28 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

	Updated doc for aria2.addUri
	* doc/aria2c.1.txt

ChangeLog

@@ -1,3 +1,8 @@
+2010-06-28  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
+
+	Updated doc for aria2.addUri
+	* doc/aria2c.1.txt
+
 2010-06-27  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
 
 	Don't set previousUri_ to "" on redirect.

doc/aria2c.1

@@ -2,12 +2,12 @@
 .\"     Title: aria2c
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 06/23/2010
+.\"      Date: 06/28/2010
 .\"    Manual: Aria2 Manual
 .\"    Source: Aria2 1.9.4
 .\"  Language: English
 .\"
-.TH "ARIA2C" "1" "06/23/2010" "Aria2 1\&.9\&.4" "Aria2 Manual"
+.TH "ARIA2C" "1" "06/28/2010" "Aria2 1\&.9\&.4" "Aria2 Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -2623,7 +2623,7 @@ GID(or gid) is the key to manage each download\&. Each download has an unique GI
 .sp
 \fBaria2\&.addUri\fR \fIuris[, options[, position]]\fR
 .sp
-This method adds new HTTP(S)/FTP/BitTorrent Magnet URI\&. \fIuris\fR is of type array and its element is URI which is of type string\&. For BitTorrent Magnet URI, \fIuris\fR must have only one element and it should be BitTorrent Magnet URI\&. \fIoptions\fR is of type struct and its members are a pair of option name and value\&. See \fBOptions\fR below for more details\&. If \fIposition\fR is given as an integer starting from 0, the new download is inserted at \fIposition\fR in the waiting queue\&. If \fIposition\fR is not given or \fIposition\fR is larger than the size of the queue, it is appended at the end of the queue\&. This method returns GID of registered download\&.
+This method adds new HTTP(S)/FTP/BitTorrent Magnet URI\&. \fIuris\fR is of type array and its element is URI which is of type string\&. For BitTorrent Magnet URI, \fIuris\fR must have only one element and it should be BitTorrent Magnet URI\&. URIs in \fIuris\fR must point to the same file\&. For example, a file \fIchunkybaconlinux\&.iso\fR is hosted in 2 locations: http://server/chunkybaconlinux\&.iso and http://mirror/chunkybaconlinux\&.iso\&. You can download this iso image using 2 URIs issuing aria2\&.addUri([\fIhttp://server/chunkybaconlinux\&.iso\fR, \fIhttp://mirror/chunkybaconlinux\&.iso\fR])\&. Imagine there is an another file URI, say, http://mirror2/chunkydonutslinux\&.iso, which is different iso image\&. You cannot mix this URI with previous URIs in one aria2\&.addUri command\&. If you do, aria2 does not complain but download may fail\&. \fIoptions\fR is of type struct and its members are a pair of option name and value\&. See \fBOptions\fR below for more details\&. If \fIposition\fR is given as an integer starting from 0, the new download is inserted at \fIposition\fR in the waiting queue\&. If \fIposition\fR is not given or \fIposition\fR is larger than the size of the queue, it is appended at the end of the queue\&. This method returns GID of registered download\&.
 .sp
 \fBaria2\&.addTorrent\fR \fItorrent[, uris[, options[, position]]]\fR
 .sp

doc/aria2c.1.html

@@ -3064,13 +3064,23 @@ GID
 <div class="paragraph"><p>This method adds new HTTP(S)/FTP/BitTorrent Magnet URI.  <em>uris</em> is of
 type array and its element is URI which is of type string.  For
 BitTorrent Magnet URI, <em>uris</em> must have only one element and it should
-be BitTorrent Magnet URI.  <em>options</em> is of type struct and its members
-are a pair of option name and value. See <strong>Options</strong> below for more
-details.  If <em>position</em> is given as an integer starting from 0, the
-new download is inserted at <em>position</em> in the waiting queue. If
-<em>position</em> is not given or <em>position</em> is larger than the size of the
-queue, it is appended at the end of the queue.  This method returns
-GID of registered download.</p></div>
+be BitTorrent Magnet URI.  URIs in <em>uris</em> must point to the same
+file. For example, a file <em>chunkybaconlinux.iso</em> is hosted in 2
+locations: <a href="http://server/chunkybaconlinux.iso">http://server/chunkybaconlinux.iso</a> and
+<a href="http://mirror/chunkybaconlinux.iso">http://mirror/chunkybaconlinux.iso</a>.  You can download this iso image
+using 2 URIs issuing
+aria2.addUri([<em>http://server/chunkybaconlinux.iso</em>,
+<em>http://mirror/chunkybaconlinux.iso</em>]).  Imagine there is an another
+file URI, say, <a href="http://mirror2/chunkydonutslinux.iso">http://mirror2/chunkydonutslinux.iso</a>, which is
+different iso image.  You cannot mix this URI with previous URIs in
+one aria2.addUri command.  If you do, aria2 does not complain but
+download may fail.  <em>options</em> is of type struct and its members are a
+pair of option name and value. See <strong>Options</strong> below for more details.
+If <em>position</em> is given as an integer starting from 0, the new download
+is inserted at <em>position</em> in the waiting queue. If <em>position</em> is not
+given or <em>position</em> is larger than the size of the queue, it is
+appended at the end of the queue.  This method returns GID of
+registered download.</p></div>
 <div class="paragraph"><p><strong>aria2.addTorrent</strong> <em>torrent[, uris[, options[, position]]]</em></p></div>
 <div class="paragraph"><p>This method adds BitTorrent download by uploading .torrent file.  If
 you want to add BitTorrent Magnet URI, use <strong>aria2.addUri</strong> method
@@ -4202,7 +4212,7 @@ files in the program, then also delete it here.</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2010-06-23 23:10:50 JST
+Last updated 2010-06-28 21:00:35 JST
 </div>
 </div>
 </body>

doc/aria2c.1.txt

@@ -1317,13 +1317,23 @@ Methods
 This method adds new HTTP(S)/FTP/BitTorrent Magnet URI.  'uris' is of
 type array and its element is URI which is of type string.  For
 BitTorrent Magnet URI, 'uris' must have only one element and it should
-be BitTorrent Magnet URI.  'options' is of type struct and its members
-are a pair of option name and value. See *Options* below for more
-details.  If 'position' is given as an integer starting from 0, the
-new download is inserted at 'position' in the waiting queue. If
-'position' is not given or 'position' is larger than the size of the
-queue, it is appended at the end of the queue.  This method returns
-GID of registered download.
+be BitTorrent Magnet URI.  URIs in 'uris' must point to the same
+file. For example, a file chunkybaconlinux.iso is hosted in 2
+locations: http://server/chunkybaconlinux.iso and
+http://mirror/chunkybaconlinux.iso.  You can download this iso image
+using 2 URIs by issuing
+aria2.addUri(['http://server/chunkybaconlinux.iso',
+'http://mirror/chunkybaconlinux.iso']).  Imagine there is an another
+file URI, say, http://mirror2/chunkydonutslinux.iso, which is
+different iso image.  You cannot mix this URI with previous URIs in
+one aria2.addUri command.  If you do, aria2 does not complain but
+download may fail.  'options' is of type struct and its members are a
+pair of option name and value. See *Options* below for more details.
+If 'position' is given as an integer starting from 0, the new download
+is inserted at 'position' in the waiting queue. If 'position' is not
+given or 'position' is larger than the size of the queue, it is
+appended at the end of the queue.  This method returns GID of
+registered download.
 
 *aria2.addTorrent* 'torrent[, uris[, options[, position]]]'