Browse Source

2010-10-30 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

	Added cross reference in XML-RPC method section. Also added cross
	reference for remaining -i list options.
	* doc/aria2c.1.txt
Tatsuhiro Tsujikawa 15 years ago
parent
commit
b67f6dc126
3 changed files with 139 additions and 95 deletions
  1. 6 0
      ChangeLog
  2. 67 64
      doc/aria2c.1.html
  3. 66 31
      doc/aria2c.1.txt

+ 6 - 0
ChangeLog

@@ -1,3 +1,9 @@
+2010-10-30  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
+
+	Added cross reference in XML-RPC method section. Also added cross
+	reference for remaining -i list options.
+	* doc/aria2c.1.txt
+
 2010-10-30  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
 2010-10-30  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
 
 
 	Updated doc
 	Updated doc

+ 67 - 64
doc/aria2c.1.html

@@ -619,7 +619,8 @@ downloading a file like BitTorrent.</p></div>
   Downloads URIs found in FILE. You can specify multiple URIs for a single
   Downloads URIs found in FILE. You can specify multiple URIs for a single
   entity: separate URIs on a single line using the TAB character.
   entity: separate URIs on a single line using the TAB character.
   Reads input from stdin when <em>-</em> is specified.
   Reads input from stdin when <em>-</em> is specified.
-  The additional <strong>out</strong> and <strong>dir</strong> options can be specified after each line of
+  The additional <strong><a href="#aria2_optref_out">out</a></strong> and <strong><a href="#aria2_optref_dir">dir</a></strong>
+  options can be specified after each line of
   URIs. This optional line must start with white space(s).
   URIs. This optional line must start with white space(s).
   See <strong><a href="#_input_file">Input File</a></strong> subsection for details.
   See <strong><a href="#_input_file">Input File</a></strong> subsection for details.
 </p>
 </p>
@@ -3158,7 +3159,8 @@ http://foo/bar</tt></pre>
 <em>file.iso</em> is saved as <em>/iso_images/file.img</em> and it is downloaded
 <em>file.iso</em> is saved as <em>/iso_images/file.img</em> and it is downloaded
 from http://server/file.iso and http://mirror/file.iso.  The file
 from http://server/file.iso and http://mirror/file.iso.  The file
 <em>bar</em> is downloaded from http://foo/bar and saved as <em>/tmp/bar</em>.</p></div>
 <em>bar</em> is downloaded from http://foo/bar and saved as <em>/tmp/bar</em>.</p></div>
-<div class="paragraph"><p>In some cases, <strong>out</strong> parameter has no effect.  See note of <strong><a href="#aria2_optref_out">--out</a></strong>
+<div class="paragraph"><p>In some cases, <strong><a href="#aria2_optref_out">out</a></strong> parameter has no effect.
+See note of <strong><a href="#aria2_optref_out">--out</a></strong>
 option for the restrictions.</p></div>
 option for the restrictions.</p></div>
 <h3 id="_server_performance_profile">Server Performance Profile</h3><div style="clear:left"></div>
 <h3 id="_server_performance_profile">Server Performance Profile</h3><div style="clear:left"></div>
 <div class="paragraph"><p>This section describes the format of server performance profile.  The
 <div class="paragraph"><p>This section describes the format of server performance profile.  The
@@ -3269,7 +3271,7 @@ GID
 </dl></div>
 </dl></div>
 <h3 id="_methods">Methods</h3><div style="clear:left"></div>
 <h3 id="_methods">Methods</h3><div style="clear:left"></div>
 <div class="paragraph"><p>All code examples come from Python2.7 interpreter.</p></div>
 <div class="paragraph"><p>All code examples come from Python2.7 interpreter.</p></div>
-<h4 id="_strong_aria2_adduri_strong_em_uris_options_position_em"><strong>aria2.addUri</strong> (<em>uris[, options[, position]]</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_addUri"><strong>aria2.addUri</strong> (<em>uris[, options[, position]]</em>)</h4>
 <h5 id="_description_2">Description</h5>
 <h5 id="_description_2">Description</h5>
 <div class="paragraph"><p>This method adds new HTTP(S)/FTP/BitTorrent Magnet URI.  <em>uris</em> is of
 <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
 type array and its element is URI which is of type string.  For
@@ -3277,7 +3279,7 @@ BitTorrent Magnet URI, <em>uris</em> must have only one element and it should
 be BitTorrent Magnet URI.  URIs in <em>uris</em> must point to the same file.
 be BitTorrent Magnet URI.  URIs in <em>uris</em> must point to the same file.
 If you mix other URIs which point to another file, aria2 does not
 If you mix other URIs which point to another file, aria2 does not
 complain but download may fail.  <em>options</em> is of type struct and its
 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
+members are a pair of option name and value. See <strong><a href="#aria2_xmlrpc_options">Options</a></strong> below for
 more details.  If <em>position</em> is given as an integer starting from 0,
 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
 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
 <em>position</em> is not given or <em>position</em> is larger than the size of the
@@ -3303,10 +3305,10 @@ GID of registered download.</p></div>
 <pre><tt>&gt;&gt;&gt; s.aria2.addUri(['http://example.org/file'], {}, 0)
 <pre><tt>&gt;&gt;&gt; s.aria2.addUri(['http://example.org/file'], {}, 0)
 '3'</tt></pre>
 '3'</tt></pre>
 </div></div>
 </div></div>
-<h4 id="_strong_aria2_addtorrent_strong_em_torrent_uris_options_position_em"><strong>aria2.addTorrent</strong> (<em>torrent[, uris[, options[, position]]]</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_addTorrent"><strong>aria2.addTorrent</strong> (<em>torrent[, uris[, options[, position]]]</em>)</h4>
 <h5 id="_description_3">Description</h5>
 <h5 id="_description_3">Description</h5>
 <div class="paragraph"><p>This method adds BitTorrent download by uploading .torrent file.  If
 <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
+you want to add BitTorrent Magnet URI, use <strong><a href="#aria2_xmlrpc_aria2_addUri">aria2.addUri</a></strong> method
 instead.  <em>torrent</em> is of type base64 which contains Base64-encoded
 instead.  <em>torrent</em> is of type base64 which contains Base64-encoded
 .torrent file.  <em>uris</em> is of type array and its element is URI which
 .torrent file.  <em>uris</em> is of type array and its element is URI which
 is of type string. <em>uris</em> is used for Web-seeding.  For single file
 is of type string. <em>uris</em> is used for Web-seeding.  For single file
@@ -3314,7 +3316,7 @@ torrents, URI can be a complete URI pointing to the resource or if URI
 ends with /, name in torrent file is added. For multi-file torrents,
 ends with /, name in torrent file is added. For multi-file torrents,
 name and path in torrent are added to form a URI for each file.
 name and path in torrent are added to form a URI for each file.
 <em>options</em> is of type struct and its members are a pair of option name
 <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
+and value. See <strong><a href="#aria2_xmlrpc_options">Options</a></strong> below for more details.  If <em>position</em> is
 given as an integer starting from 0, the new download is inserted at
 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> 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
 <em>position</em> is larger than the size of the queue, it is appended at the
@@ -3329,12 +3331,12 @@ Please note that the downloads added by this method are not saved by
 &gt;&gt;&gt; s.aria2.addTorrent(xmlrpclib.Binary(open('file.torrent').read()))
 &gt;&gt;&gt; s.aria2.addTorrent(xmlrpclib.Binary(open('file.torrent').read()))
 '6'</tt></pre>
 '6'</tt></pre>
 </div></div>
 </div></div>
-<h4 id="_strong_aria2_addmetalink_strong_em_metalink_options_position_em"><strong>aria2.addMetalink</strong> (<em>metalink[, options[, position]]</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_addMetalink"><strong>aria2.addMetalink</strong> (<em>metalink[, options[, position]]</em>)</h4>
 <h5 id="_description_4">Description</h5>
 <h5 id="_description_4">Description</h5>
 <div class="paragraph"><p>This method adds Metalink download by uploading .metalink file.
 <div class="paragraph"><p>This method adds Metalink download by uploading .metalink file.
 <em>metalink</em> is of type base64 which contains Base64-encoded .metalink
 <em>metalink</em> is of type base64 which contains Base64-encoded .metalink
 file.  <em>options</em> is of type struct and its members are a pair of
 file.  <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
+option name and value. See <strong><a href="#aria2_xmlrpc_options">Options</a></strong> below for more details.  If
 <em>position</em> is given as an integer starting from 0, the new download is
 <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
 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
 given or <em>position</em> is larger than the size of the queue, it is
@@ -3349,7 +3351,7 @@ method are not saved by <strong><a href="#aria2_optref_save_session">--save-sess
 &gt;&gt;&gt; s.aria2.addMetalink(xmlrpclib.Binary(open('file.meta4').read()))
 &gt;&gt;&gt; s.aria2.addMetalink(xmlrpclib.Binary(open('file.meta4').read()))
 ['8']</tt></pre>
 ['8']</tt></pre>
 </div></div>
 </div></div>
-<h4 id="_strong_aria2_remove_strong_em_gid_em"><strong>aria2.remove</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_remove"><strong>aria2.remove</strong> (<em>gid</em>)</h4>
 <h5 id="_description_5">Description</h5>
 <h5 id="_description_5">Description</h5>
 <div class="paragraph"><p>This method removes the download denoted by <em>gid</em>. <em>gid</em> is of type
 <div class="paragraph"><p>This method removes the download denoted by <em>gid</em>. <em>gid</em> is of type
 string. If specified download is in progress, it is stopped at
 string. If specified download is in progress, it is stopped at
@@ -3363,52 +3365,52 @@ returns GID of removed download.</p></div>
 &gt;&gt;&gt; s.aria2.remove('3')
 &gt;&gt;&gt; s.aria2.remove('3')
 '3'</tt></pre>
 '3'</tt></pre>
 </div></div>
 </div></div>
-<h4 id="_strong_aria2_forceremove_strong_em_gid_em"><strong>aria2.forceRemove</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_forceRemove"><strong>aria2.forceRemove</strong> (<em>gid</em>)</h4>
 <h5 id="_description_6">Description</h5>
 <h5 id="_description_6">Description</h5>
 <div class="paragraph"><p>This method removes the download denoted by <em>gid</em>.  This method
 <div class="paragraph"><p>This method removes the download denoted by <em>gid</em>.  This method
-behaves just like <strong>aria2.remove</strong> except that this method removes
+behaves just like <strong><a href="#aria2_xmlrpc_aria2_remove">aria2.remove</a></strong> except that this method removes
 download without any action which takes time such as contacting
 download without any action which takes time such as contacting
 BitTorrent tracker.</p></div>
 BitTorrent tracker.</p></div>
-<h4 id="_strong_aria2_pause_strong_em_gid_em"><strong>aria2.pause</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_pause"><strong>aria2.pause</strong> (<em>gid</em>)</h4>
 <h5 id="_description_7">Description</h5>
 <h5 id="_description_7">Description</h5>
 <div class="paragraph"><p>This method pauses the download denoted by <em>gid</em>. <em>gid</em> is of type
 <div class="paragraph"><p>This method pauses the download denoted by <em>gid</em>. <em>gid</em> is of type
 string. The status of paused download becomes "paused".  If the
 string. The status of paused download becomes "paused".  If the
 download is active, the download is placed on the first position of
 download is active, the download is placed on the first position of
 waiting queue.  As long as the status is "paused", the download is not
 waiting queue.  As long as the status is "paused", the download is not
-started.  To change status to "waiting", use <strong>aria2.unpause</strong> method.
+started.  To change status to "waiting", use <strong><a href="#aria2_xmlrpc_aria2_unpause">aria2.unpause</a></strong> method.
 This method returns GID of paused download.</p></div>
 This method returns GID of paused download.</p></div>
-<h4 id="_strong_aria2_pauseall_strong"><strong>aria2.pauseAll</strong> ()</h4>
+<h4 id="aria2_xmlrpc_aria2_pauseAll"><strong>aria2.pauseAll</strong> ()</h4>
 <h5 id="_description_8">Description</h5>
 <h5 id="_description_8">Description</h5>
-<div class="paragraph"><p>This method is equal to calling <strong>aria2.pause</strong> for every active/waiting
+<div class="paragraph"><p>This method is equal to calling <strong><a href="#aria2_xmlrpc_aria2_pause">aria2.pause</a></strong> for every active/waiting
 download. This methods returns "OK" for success.</p></div>
 download. This methods returns "OK" for success.</p></div>
-<h4 id="_strong_aria2_forcepause_strong_em_pid_em"><strong>aria2.forcePause</strong> (<em>pid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_forcePause"><strong>aria2.forcePause</strong> (<em>pid</em>)</h4>
 <h5 id="_description_9">Description</h5>
 <h5 id="_description_9">Description</h5>
 <div class="paragraph"><p>This method pauses the download denoted by <em>gid</em>.  This method
 <div class="paragraph"><p>This method pauses the download denoted by <em>gid</em>.  This method
-behaves just like <strong>aria2.pause</strong> except that this method pauses
+behaves just like <strong><a href="#aria2_xmlrpc_aria2_pause">aria2.pause</a></strong> except that this method pauses
 download without any action which takes time such as contacting
 download without any action which takes time such as contacting
 BitTorrent tracker.</p></div>
 BitTorrent tracker.</p></div>
-<h4 id="_strong_aria2_forcepauseall_strong"><strong>aria2.forcePauseAll</strong> ()</h4>
+<h4 id="aria2_xmlrpc_aria2_forcePauseAll"><strong>aria2.forcePauseAll</strong> ()</h4>
 <h5 id="_description_10">Description</h5>
 <h5 id="_description_10">Description</h5>
-<div class="paragraph"><p>This method is equal to calling <strong>aria2.forcePause</strong> for every
+<div class="paragraph"><p>This method is equal to calling <strong><a href="#aria2_xmlrpc_aria2_forcePause">aria2.forcePause</a></strong> for every
 active/waiting download. This methods returns "OK" for success.</p></div>
 active/waiting download. This methods returns "OK" for success.</p></div>
-<h4 id="_strong_aria2_unpause_strong_em_gid_em"><strong>aria2.unpause</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_unpause"><strong>aria2.unpause</strong> (<em>gid</em>)</h4>
 <h5 id="_description_11">Description</h5>
 <h5 id="_description_11">Description</h5>
 <div class="paragraph"><p>This method changes the status of the download denoted by <em>gid</em> from
 <div class="paragraph"><p>This method changes the status of the download denoted by <em>gid</em> from
 "paused" to "waiting". This makes the download eligible to restart.
 "paused" to "waiting". This makes the download eligible to restart.
 <em>gid</em> is of type string.  This method returns GID of unpaused
 <em>gid</em> is of type string.  This method returns GID of unpaused
 download.</p></div>
 download.</p></div>
-<h4 id="_strong_aria2_unpauseall_strong"><strong>aria2.unpauseAll</strong> ()</h4>
+<h4 id="aria2_xmlrpc_aria2_unpauseAll"><strong>aria2.unpauseAll</strong> ()</h4>
 <h5 id="_description_12">Description</h5>
 <h5 id="_description_12">Description</h5>
-<div class="paragraph"><p>This method is equal to calling <strong>aria2.unpause</strong> for every active/waiting
+<div class="paragraph"><p>This method is equal to calling <strong><a href="#aria2_xmlrpc_aria2_unpause">aria2.unpause</a></strong> for every active/waiting
 download. This methods returns "OK" for success.</p></div>
 download. This methods returns "OK" for success.</p></div>
-<h4 id="_strong_aria2_tellstatus_strong_em_gid_keys_em"><strong>aria2.tellStatus</strong> (<em>gid[, keys]</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_tellStatus"><strong>aria2.tellStatus</strong> (<em>gid[, keys]</em>)</h4>
 <h5 id="_description_13">Description</h5>
 <h5 id="_description_13">Description</h5>
 <div class="paragraph"><p>This method returns download progress of the download denoted by
 <div class="paragraph"><p>This method returns download progress of the download denoted by
 <em>gid</em>. <em>gid</em> is of type string. <em>keys</em> is array of string. If it is
 <em>gid</em>. <em>gid</em> is of type string. <em>keys</em> is array of string. If it is
 specified, the response contains only keys in <em>keys</em> array. If <em>keys</em>
 specified, the response contains only keys in <em>keys</em> array. If <em>keys</em>
 is empty or not specified, the response contains all keys.  This is
 is empty or not specified, the response contains all keys.  This is
 useful when you just want specific keys and avoid unnecessary
 useful when you just want specific keys and avoid unnecessary
-transfers. For example, <strong>aria2.tellStatus</strong>("1", ["gid", "status"])
+transfers. For example, <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong>("1", ["gid", "status"])
 returns <em>gid</em> and <em>status</em> key.  The response is of type struct and it
 returns <em>gid</em> and <em>status</em> key.  The response is of type struct and it
 contains following keys. The value type is string.</p></div>
 contains following keys. The value type is string.</p></div>
 <div class="dlist"><dl>
 <div class="dlist"><dl>
@@ -3574,7 +3576,7 @@ files
 <dd>
 <dd>
 <p>
 <p>
   Returns the list of files. The element of list is the same struct
   Returns the list of files. The element of list is the same struct
-  used in <strong>aria2.getFiles</strong> method.
+  used in <strong><a href="#aria2_xmlrpc_aria2_getFiles">aria2.getFiles</a></strong> method.
 </p>
 </p>
 </dd>
 </dd>
 <dt class="hdlist1">
 <dt class="hdlist1">
@@ -3678,7 +3680,7 @@ name
 &gt;&gt;&gt; pprint(r)
 &gt;&gt;&gt; pprint(r)
 {'completedLength': '34896138', 'gid': '1', 'totalLength': '34896138'}</tt></pre>
 {'completedLength': '34896138', 'gid': '1', 'totalLength': '34896138'}</tt></pre>
 </div></div>
 </div></div>
-<h4 id="_strong_aria2_geturis_strong_em_gid_em"><strong>aria2.getUris</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_getUris"><strong>aria2.getUris</strong> (<em>gid</em>)</h4>
 <h5 id="_description_14">Description</h5>
 <h5 id="_description_14">Description</h5>
 <div class="paragraph"><p>This method returns URIs used in the download denoted by <em>gid</em>.  <em>gid</em>
 <div class="paragraph"><p>This method returns URIs used in the download denoted by <em>gid</em>.  <em>gid</em>
 is of type string. The response is of type array and its element is of
 is of type string. The response is of type array and its element is of
@@ -3702,7 +3704,7 @@ status
 </p>
 </p>
 </dd>
 </dd>
 </dl></div>
 </dl></div>
-<h4 id="_strong_aria2_getfiles_strong_em_gid_em"><strong>aria2.getFiles</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_getFiles"><strong>aria2.getFiles</strong> (<em>gid</em>)</h4>
 <h5 id="_description_15">Description</h5>
 <h5 id="_description_15">Description</h5>
 <div class="paragraph"><p>This method returns file list of the download denoted by <em>gid</em>. <em>gid</em>
 <div class="paragraph"><p>This method returns file list of the download denoted by <em>gid</em>. <em>gid</em>
 is of type string. The response is of type array and its element is of
 is of type string. The response is of type array and its element is of
@@ -3749,11 +3751,11 @@ uris
 <dd>
 <dd>
 <p>
 <p>
   Returns the list of URI for this file. The element of list is the
   Returns the list of URI for this file. The element of list is the
-  same struct used in <strong>aria2.getUris</strong> method.
+  same struct used in <strong><a href="#aria2_xmlrpc_aria2_getUris">aria2.getUris</a></strong> method.
 </p>
 </p>
 </dd>
 </dd>
 </dl></div>
 </dl></div>
-<h4 id="_strong_aria2_getpeers_strong_em_gid_em"><strong>aria2.getPeers</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_getPeers"><strong>aria2.getPeers</strong> (<em>gid</em>)</h4>
 <h5 id="_description_16">Description</h5>
 <h5 id="_description_16">Description</h5>
 <div class="paragraph"><p>This method returns peer list of the download denoted by <em>gid</em>. <em>gid</em>
 <div class="paragraph"><p>This method returns peer list of the download denoted by <em>gid</em>. <em>gid</em>
 is of type string. This method is for BitTorrent only.  The response
 is of type string. This method is for BitTorrent only.  The response
@@ -3836,7 +3838,7 @@ seeder
 </p>
 </p>
 </dd>
 </dd>
 </dl></div>
 </dl></div>
-<h4 id="_strong_aria2_getservers_strong_em_gid_em"><strong>aria2.getServers</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_getServers"><strong>aria2.getServers</strong> (<em>gid</em>)</h4>
 <h5 id="_description_17">Description</h5>
 <h5 id="_description_17">Description</h5>
 <div class="paragraph"><p>This method returns currently connected HTTP(S)/FTP servers of the download denoted by <em>gid</em>. <em>gid</em> is of type string. The response
 <div class="paragraph"><p>This method returns currently connected HTTP(S)/FTP servers of the download denoted by <em>gid</em>. <em>gid</em> is of type string. The response
 is of type array and its element is of type struct and it contains
 is of type array and its element is of type struct and it contains
@@ -3887,19 +3889,19 @@ downloadSpeed
 </dl></div>
 </dl></div>
 </dd>
 </dd>
 </dl></div>
 </dl></div>
-<h4 id="_strong_aria2_tellactive_strong_em_keys_em"><strong>aria2.tellActive</strong> (<em>[keys]</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_tellActive"><strong>aria2.tellActive</strong> (<em>[keys]</em>)</h4>
 <h5 id="_description_18">Description</h5>
 <h5 id="_description_18">Description</h5>
 <div class="paragraph"><p>This method returns the list of active downloads.  The response is of
 <div class="paragraph"><p>This method returns the list of active downloads.  The response is of
 type array and its element is the same struct returned by
 type array and its element is the same struct returned by
-<strong>aria2.tellStatus</strong> method. For <em>keys</em> parameter, please refer to
-<strong>aria2.tellStatus</strong> method.</p></div>
-<h4 id="_strong_aria2_tellwaiting_strong_em_offset_num_keys_em"><strong>aria2.tellWaiting</strong> (<em>offset, num, [keys]</em>)</h4>
+<strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method. For <em>keys</em> parameter, please refer to
+<strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
+<h4 id="aria2_xmlrpc_aria2_tellWaiting"><strong>aria2.tellWaiting</strong> (<em>offset, num, [keys]</em>)</h4>
 <h5 id="_description_19">Description</h5>
 <h5 id="_description_19">Description</h5>
 <div class="paragraph"><p>This method returns the list of waiting download, including paused
 <div class="paragraph"><p>This method returns the list of waiting download, including paused
 downloads. <em>offset</em> is of type integer and specifies the offset from
 downloads. <em>offset</em> is of type integer and specifies the offset from
 the download waiting at the front. <em>num</em> is of type integer and
 the download waiting at the front. <em>num</em> is of type integer and
 specifies the number of downloads to be returned.  For <em>keys</em>
 specifies the number of downloads to be returned.  For <em>keys</em>
-parameter, please refer to <strong>aria2.tellStatus</strong> method.</p></div>
+parameter, please refer to <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
 <div class="paragraph"><p>If offset is a positive integer, this method returns downloads in the
 <div class="paragraph"><p>If offset is a positive integer, this method returns downloads in the
 range of [<em>offset</em>, <em>offset</em>+<em>num</em>).</p></div>
 range of [<em>offset</em>, <em>offset</em>+<em>num</em>).</p></div>
 <div class="paragraph"><p><em>offset</em> can be a negative integer. <em>offset</em> == -1 points last
 <div class="paragraph"><p><em>offset</em> can be a negative integer. <em>offset</em> == -1 points last
@@ -3911,18 +3913,18 @@ in this order. aria2.tellWaiting(0, 1) returns
 ["A"]. aria2.tellWaiting(1, 2) returns ["B", "C"].
 ["A"]. aria2.tellWaiting(1, 2) returns ["B", "C"].
 aria2.tellWaiting(-1, 2) returns ["C", "B"].</p></div>
 aria2.tellWaiting(-1, 2) returns ["C", "B"].</p></div>
 <div class="paragraph"><p>The response is of type array and its element is the same struct
 <div class="paragraph"><p>The response is of type array and its element is the same struct
-returned by <strong>aria2.tellStatus</strong> method.</p></div>
-<h4 id="_strong_aria2_tellstopped_strong_em_offset_num_keys_em"><strong>aria2.tellStopped</strong> (<em>offset, num, [keys]</em>)</h4>
+returned by <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
+<h4 id="aria2_xmlrpc_aria2_tellStopped"><strong>aria2.tellStopped</strong> (<em>offset, num, [keys]</em>)</h4>
 <h5 id="_description_20">Description</h5>
 <h5 id="_description_20">Description</h5>
 <div class="paragraph"><p>This method returns the list of stopped download.  <em>offset</em> is of type
 <div class="paragraph"><p>This method returns the list of stopped download.  <em>offset</em> is of type
 integer and specifies the offset from the oldest download. <em>num</em> is of
 integer and specifies the offset from the oldest download. <em>num</em> is of
 type integer and specifies the number of downloads to be returned.
 type integer and specifies the number of downloads to be returned.
-For <em>keys</em> parameter, please refer to <strong>aria2.tellStatus</strong> method.</p></div>
-<div class="paragraph"><p><em>offset</em> and <em>num</em> have the same semantics as <strong>aria2.tellWaiting</strong>
+For <em>keys</em> parameter, please refer to <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
+<div class="paragraph"><p><em>offset</em> and <em>num</em> have the same semantics as <strong><a href="#aria2_xmlrpc_aria2_tellWaiting">aria2.tellWaiting</a></strong>
 method.</p></div>
 method.</p></div>
 <div class="paragraph"><p>The response is of type array and its element is the same struct
 <div class="paragraph"><p>The response is of type array and its element is the same struct
-returned by <strong>aria2.tellStatus</strong> method.</p></div>
-<h4 id="_strong_aria2_changeposition_strong_em_gid_pos_how_em"><strong>aria2.changePosition</strong> (<em>gid, pos, how</em>)</h4>
+returned by <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
+<h4 id="aria2_xmlrpc_aria2_changePosition"><strong>aria2.changePosition</strong> (<em>gid, pos, how</em>)</h4>
 <h5 id="_description_21">Description</h5>
 <h5 id="_description_21">Description</h5>
 <div class="paragraph"><p>This method changes the position of the download denoted by
 <div class="paragraph"><p>This method changes the position of the download denoted by
 <em>gid</em>. <em>pos</em> is of type integer. <em>how</em> is of type string. If <em>how</em> is
 <em>gid</em>. <em>pos</em> is of type integer. <em>how</em> is of type string. If <em>how</em> is
@@ -3938,7 +3940,7 @@ destination position.</p></div>
 -1, POS_CUR) will change its position to 2. Additional
 -1, POS_CUR) will change its position to 2. Additional
 aria2.changePosition(1, 0, POS_SET) will change its position to 0(the
 aria2.changePosition(1, 0, POS_SET) will change its position to 0(the
 beginning of the queue).</p></div>
 beginning of the queue).</p></div>
-<h4 id="_strong_aria2_changeuri_strong_em_gid_fileindex_deluris_adduris_position_em"><strong>aria2.changeUri</strong> (<em>gid, fileIndex, delUris, addUris[, position]</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_changeUri"><strong>aria2.changeUri</strong> (<em>gid, fileIndex, delUris, addUris[, position]</em>)</h4>
 <h5 id="_description_22">Description</h5>
 <h5 id="_description_22">Description</h5>
 <div class="paragraph"><p>This method removes URIs in <em>delUris</em> from and appends URIs in
 <div class="paragraph"><p>This method removes URIs in <em>delUris</em> from and appends URIs in
 <em>addUris</em> to download denoted by <em>gid</em>. <em>delUris</em> and <em>addUris</em> are
 <em>addUris</em> to download denoted by <em>gid</em>. <em>delUris</em> and <em>addUris</em> are
@@ -3957,39 +3959,39 @@ specify (at least) 3 "http://example.org/aria2" in <em>delUris</em>.  This
 method returns a list which contains 2 integers. The first integer is
 method returns a list which contains 2 integers. The first integer is
 the number of URIs deleted. The second integer is the number of URIs
 the number of URIs deleted. The second integer is the number of URIs
 added.</p></div>
 added.</p></div>
-<h4 id="_strong_aria2_getoption_strong_em_gid_em"><strong>aria2.getOption</strong> (<em>gid</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_getOption"><strong>aria2.getOption</strong> (<em>gid</em>)</h4>
 <h5 id="_description_23">Description</h5>
 <h5 id="_description_23">Description</h5>
 <div class="paragraph"><p>This method returns options of the download denoted by <em>gid</em>.  The
 <div class="paragraph"><p>This method returns options of the download denoted by <em>gid</em>.  The
 response is of type struct. Its key is the name of option.  The value type
 response is of type struct. Its key is the name of option.  The value type
 is string.</p></div>
 is string.</p></div>
-<h4 id="_strong_aria2_changeoption_strong_em_gid_options_em"><strong>aria2.changeOption</strong> (<em>gid, options</em>)</h4>
+<h4 id="aria2_xmlrpc_aria2_changeOption"><strong>aria2.changeOption</strong> (<em>gid, options</em>)</h4>
 <h5 id="_description_24">Description</h5>
 <h5 id="_description_24">Description</h5>
 <div class="paragraph"><p>This method changes options of the download denoted by <em>gid</em>
 <div class="paragraph"><p>This method changes options of the download denoted by <em>gid</em>
 dynamically.  <em>gid</em> is of type string.  <em>options</em> is of type struct
 dynamically.  <em>gid</em> is of type string.  <em>options</em> is of type struct
-and the available options are: <strong>bt-max-peers</strong>,
-<strong>bt-request-peer-speed-limit</strong>, <strong>max-download-limit</strong> and
-<strong>max-upload-limit</strong>.  This method returns "OK" for success.</p></div>
-<h4 id="_strong_aria2_getglobaloption_strong"><strong>aria2.getGlobalOption</strong> ()</h4>
+and the available options are: <strong><a href="#aria2_optref_bt_max_peers">bt-max-peers</a></strong>,
+<strong><a href="#aria2_optref_bt_request_peer_speed_limit">bt-request-peer-speed-limit</a></strong>, <strong><a href="#aria2_optref_max_download_limit">max-download-limit</a></strong> and
+<strong><a href="#aria2_optref_max_upload_limit">max-upload-limit</a></strong>.  This method returns "OK" for success.</p></div>
+<h4 id="aria2_xmlrpc_aria2_getGlobalOption"><strong>aria2.getGlobalOption</strong> ()</h4>
 <h5 id="_description_25">Description</h5>
 <h5 id="_description_25">Description</h5>
 <div class="paragraph"><p>This method returns global options.  The response is of type
 <div class="paragraph"><p>This method returns global options.  The response is of type
 struct. Its key is the name of option.  The value type is string.
 struct. Its key is the name of option.  The value type is string.
 Because global options are used as a template for the options of newly
 Because global options are used as a template for the options of newly
 added download, the response contains keys returned by
 added download, the response contains keys returned by
-<strong>aria2.getOption</strong> method.</p></div>
-<h4 id="_strong_aria2_changeglobaloption_strong_em_options_em"><strong>aria2.changeGlobalOption</strong> (<em>options</em>)</h4>
+<strong><a href="#aria2_xmlrpc_aria2_getOption">aria2.getOption</a></strong> method.</p></div>
+<h4 id="aria2_xmlrpc_aria2_changeGlobalOption"><strong>aria2.changeGlobalOption</strong> (<em>options</em>)</h4>
 <h5 id="_description_26">Description</h5>
 <h5 id="_description_26">Description</h5>
 <div class="paragraph"><p>This method changes global options dynamically.  <em>options</em> is of type
 <div class="paragraph"><p>This method changes global options dynamically.  <em>options</em> is of type
-struct and the available options are <strong>max-concurrent-downloads</strong>,
-<strong>max-overall-download-limit</strong>, <strong>max-overall-upload-limit</strong>, <strong>log-level</strong>
-and <strong>log</strong>. Using <strong>log</strong> option, you can dynamically start logging or
+struct and the available options are <strong><a href="#aria2_optref_max_concurrent_downloads">max-concurrent-downloads</a></strong>,
+<strong><a href="#aria2_optref_max_overall_download_limit">max-overall-download-limit</a></strong>, <strong><a href="#aria2_optref_max_overall_upload_limit">max-overall-upload-limit</a></strong>, <strong><a href="#aria2_optref_log_level">log-level</a></strong>
+and <strong><a href="#aria2_optref_log">log</a></strong>. Using <strong><a href="#aria2_optref_log">log</a></strong> option, you can dynamically start logging or
 change log file. To stop logging, give empty string("") as a parameter
 change log file. To stop logging, give empty string("") as a parameter
 value. Note that log file is always opened in append mode. This method
 value. Note that log file is always opened in append mode. This method
 returns "OK" for success.</p></div>
 returns "OK" for success.</p></div>
-<h4 id="_strong_aria2_purgedownloadresult_strong"><strong>aria2.purgeDownloadResult</strong> ()</h4>
+<h4 id="aria2_xmlrpc_aria2_purgeDownloadResult"><strong>aria2.purgeDownloadResult</strong> ()</h4>
 <h5 id="_description_27">Description</h5>
 <h5 id="_description_27">Description</h5>
 <div class="paragraph"><p>This method purges completed/error/removed downloads to free memory.
 <div class="paragraph"><p>This method purges completed/error/removed downloads to free memory.
 This method returns "OK".</p></div>
 This method returns "OK".</p></div>
-<h4 id="_strong_aria2_getversion_strong"><strong>aria2.getVersion</strong> ()</h4>
+<h4 id="aria2_xmlrpc_aria2_getVersion"><strong>aria2.getVersion</strong> ()</h4>
 <h5 id="_description_28">Description</h5>
 <h5 id="_description_28">Description</h5>
 <div class="paragraph"><p>This method returns version of the program and the list of enabled
 <div class="paragraph"><p>This method returns version of the program and the list of enabled
 features. The response is of type struct and contains following keys.</p></div>
 features. The response is of type struct and contains following keys.</p></div>
@@ -4028,7 +4030,7 @@ enabledFeatures
                      'XML-RPC'],
                      'XML-RPC'],
  'version': '1.10.5'}</tt></pre>
  'version': '1.10.5'}</tt></pre>
 </div></div>
 </div></div>
-<h4 id="_strong_aria2_getsessioninfo_strong"><strong>aria2.getSessionInfo</strong> ()</h4>
+<h4 id="aria2_xmlrpc_aria2_getSessionInfo"><strong>aria2.getSessionInfo</strong> ()</h4>
 <h5 id="_description_29">Description</h5>
 <h5 id="_description_29">Description</h5>
 <div class="paragraph"><p>This method returns session information.
 <div class="paragraph"><p>This method returns session information.
 The response is of type struct and contains following key.</p></div>
 The response is of type struct and contains following key.</p></div>
@@ -4049,15 +4051,15 @@ sessionId
 &gt;&gt;&gt; s.aria2.getSessionInfo()
 &gt;&gt;&gt; s.aria2.getSessionInfo()
 {'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}</tt></pre>
 {'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}</tt></pre>
 </div></div>
 </div></div>
-<h4 id="_strong_aria2_shutdown_strong"><strong>aria2.shutdown</strong> ()</h4>
+<h4 id="aria2_xmlrpc_aria2_shutdown"><strong>aria2.shutdown</strong> ()</h4>
 <h5 id="_description_30">Description</h5>
 <h5 id="_description_30">Description</h5>
 <div class="paragraph"><p>This method shutdowns aria2.  This method returns "OK".</p></div>
 <div class="paragraph"><p>This method shutdowns aria2.  This method returns "OK".</p></div>
-<h4 id="_strong_aria2_forceshutdown_strong"><strong>aria2.forceShutdown</strong> ()</h4>
+<h4 id="aria2_xmlrpc_aria2_forceShutdown"><strong>aria2.forceShutdown</strong> ()</h4>
 <h5 id="_description_31">Description</h5>
 <h5 id="_description_31">Description</h5>
-<div class="paragraph"><p>This method shutdowns aria2. This method behaves like <strong>aria2.shutdown</strong>
+<div class="paragraph"><p>This method shutdowns aria2. This method behaves like <strong><a href="#aria2_xmlrpc_aria2_shutdown">aria2.shutdown</a></strong>
 except that any actions which takes time such as contacting BitTorrent
 except that any actions which takes time such as contacting BitTorrent
 tracker are skipped. This method returns "OK".</p></div>
 tracker are skipped. This method returns "OK".</p></div>
-<h4 id="_strong_system_multicall_strong_em_methods_em"><strong>system.multicall</strong> (<em>methods</em>)</h4>
+<h4 id="aria2_xmlrpc_system_multicall"><strong>system.multicall</strong> (<em>methods</em>)</h4>
 <h5 id="_description_32">Description</h5>
 <h5 id="_description_32">Description</h5>
 <div class="paragraph"><p>This methods encapsulates multiple method calls in a single request.
 <div class="paragraph"><p>This methods encapsulates multiple method calls in a single request.
 <em>methods</em> is of type array and its element is struct.  The struct
 <em>methods</em> is of type array and its element is struct.  The struct
@@ -4083,7 +4085,7 @@ http://example.org/file and second one is file.torrent:</p></div>
 <h3 id="_error_handling">Error Handling</h3><div style="clear:left"></div>
 <h3 id="_error_handling">Error Handling</h3><div style="clear:left"></div>
 <div class="paragraph"><p>In case of error, aria2 returns faultCode=1 and the error message in
 <div class="paragraph"><p>In case of error, aria2 returns faultCode=1 and the error message in
 faultString.</p></div>
 faultString.</p></div>
-<h3 id="_options_2">Options</h3><div style="clear:left"></div>
+<h3 id="aria2_xmlrpc_options">Options</h3><div style="clear:left"></div>
 <div class="paragraph"><p>Same options for <strong><a href="#aria2_optref_input_file">-i</a></strong> list are available. See <strong><a href="#_input_file">Input File</a></strong> subsection for complete list of options.</p></div>
 <div class="paragraph"><p>Same options for <strong><a href="#aria2_optref_input_file">-i</a></strong> list are available. See <strong><a href="#_input_file">Input File</a></strong> subsection for complete list of options.</p></div>
 <div class="paragraph"><p>In the option struct, name element is option name(without preceding
 <div class="paragraph"><p>In the option struct, name element is option name(without preceding
 "--") and value element is argument as string.</p></div>
 "--") and value element is argument as string.</p></div>
@@ -4100,7 +4102,8 @@ faultString.</p></div>
   &lt;/member&gt;
   &lt;/member&gt;
 &lt;/struct&gt;</tt></pre>
 &lt;/struct&gt;</tt></pre>
 </div></div>
 </div></div>
-<div class="paragraph"><p><strong>header</strong> and <strong>index-out</strong> option are allowed multiple times in
+<div class="paragraph"><p><strong><a href="#aria2_optref_header">header</a></strong> and <strong><a href="#aria2_optref_index_out">index-out</a></strong>
+option are allowed multiple times in
 command-line. Since name should be unique in struct(many XML-RPC
 command-line. Since name should be unique in struct(many XML-RPC
 library implementation uses hash or dict for struct), single string is
 library implementation uses hash or dict for struct), single string is
 not enough. To overcome this situation, they can take array as value
 not enough. To overcome this situation, they can take array as value
@@ -4583,7 +4586,7 @@ files in the program, then also delete it here.</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer">
 <div id="footer-text">
 <div id="footer-text">
-Last updated 2010-10-30 20:41:46 JST
+Last updated 2010-10-30 21:20:38 JST
 </div>
 </div>
 </div>
 </div>
 </body>
 </body>

+ 66 - 31
doc/aria2c.1.txt

@@ -37,7 +37,8 @@ Basic Options
   Downloads URIs found in FILE. You can specify multiple URIs for a single
   Downloads URIs found in FILE. You can specify multiple URIs for a single
   entity: separate URIs on a single line using the TAB character.
   entity: separate URIs on a single line using the TAB character.
   Reads input from stdin when '-' is specified.
   Reads input from stdin when '-' is specified.
-  The additional *out* and *dir* options can be specified after each line of
+  The additional *<<aria2_optref_out, out>>* and *<<aria2_optref_dir, dir>>*
+  options can be specified after each line of
   URIs. This optional line must start with white space(s).
   URIs. This optional line must start with white space(s).
   See *<<_input_file, Input File>>* subsection for details.
   See *<<_input_file, Input File>>* subsection for details.
 
 
@@ -1378,7 +1379,8 @@ If aria2 is executed with *<<aria2_optref_input_file, -i>>* uri.txt *<<aria2_opt
 from \http://server/file.iso and \http://mirror/file.iso.  The file
 from \http://server/file.iso and \http://mirror/file.iso.  The file
 'bar' is downloaded from \http://foo/bar and saved as '/tmp/bar'.
 'bar' is downloaded from \http://foo/bar and saved as '/tmp/bar'.
 
 
-In some cases, *out* parameter has no effect.  See note of *<<aria2_optref_out, --out>>*
+In some cases, *<<aria2_optref_out, out>>* parameter has no effect.
+See note of *<<aria2_optref_out, --out>>*
 option for the restrictions.
 option for the restrictions.
 
 
 Server Performance Profile
 Server Performance Profile
@@ -1451,6 +1453,7 @@ Methods
 
 
 All code examples come from Python2.7 interpreter.
 All code examples come from Python2.7 interpreter.
 
 
+[[aria2_xmlrpc_aria2_addUri]]
 *aria2.addUri* ('uris[, options[, position]]')
 *aria2.addUri* ('uris[, options[, position]]')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1463,7 +1466,7 @@ BitTorrent Magnet URI, 'uris' must have only one element and it should
 be BitTorrent Magnet URI.  URIs in 'uris' must point to the same file.
 be BitTorrent Magnet URI.  URIs in 'uris' must point to the same file.
 If you mix other URIs which point to another file, aria2 does not
 If you mix other URIs which point to another file, aria2 does not
 complain but download may fail.  'options' is of type struct and its
 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
+members are a pair of option name and value. See *<<aria2_xmlrpc_options, Options>>* below for
 more details.  If 'position' is given as an integer starting from 0,
 more details.  If 'position' is given as an integer starting from 0,
 the new download is inserted at 'position' in the waiting queue. If
 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
 'position' is not given or 'position' is larger than the size of the
@@ -1490,6 +1493,7 @@ Adding a download and insert it to the front of waiting downloads:
 '3'
 '3'
 ---------------------------------------------------------------
 ---------------------------------------------------------------
 
 
+[[aria2_xmlrpc_aria2_addTorrent]]
 *aria2.addTorrent* ('torrent[, uris[, options[, position]]]')
 *aria2.addTorrent* ('torrent[, uris[, options[, position]]]')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1497,7 +1501,7 @@ Description
 +++++++++++
 +++++++++++
 
 
 This method adds BitTorrent download by uploading .torrent file.  If
 This method adds BitTorrent download by uploading .torrent file.  If
-you want to add BitTorrent Magnet URI, use *aria2.addUri* method
+you want to add BitTorrent Magnet URI, use *<<aria2_xmlrpc_aria2_addUri, aria2.addUri>>* method
 instead.  'torrent' is of type base64 which contains Base64-encoded
 instead.  'torrent' is of type base64 which contains Base64-encoded
 .torrent file.  'uris' is of type array and its element is URI which
 .torrent file.  'uris' is of type array and its element is URI which
 is of type string. 'uris' is used for Web-seeding.  For single file
 is of type string. 'uris' is used for Web-seeding.  For single file
@@ -1505,7 +1509,7 @@ torrents, URI can be a complete URI pointing to the resource or if URI
 ends with /, name in torrent file is added. For multi-file torrents,
 ends with /, name in torrent file is added. For multi-file torrents,
 name and path in torrent are added to form a URI for each file.
 name and path in torrent are added to form a URI for each file.
 'options' is of type struct and its members are a pair of option name
 '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
+and value. See *<<aria2_xmlrpc_options, Options>>* below for more details.  If 'position' is
 given as an integer starting from 0, the new download is inserted at
 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' in the waiting queue. If 'position' is not given or
 'position' is larger than the size of the queue, it is appended at the
 'position' is larger than the size of the queue, it is appended at the
@@ -1521,6 +1525,7 @@ Adding local file file.torrent to aria2:
 '6'
 '6'
 ---------------------------------------------------------------------
 ---------------------------------------------------------------------
 
 
+[[aria2_xmlrpc_aria2_addMetalink]]
 *aria2.addMetalink* ('metalink[, options[, position]]')
 *aria2.addMetalink* ('metalink[, options[, position]]')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1530,7 +1535,7 @@ Description
 This method adds Metalink download by uploading .metalink file.
 This method adds Metalink download by uploading .metalink file.
 'metalink' is of type base64 which contains Base64-encoded .metalink
 'metalink' is of type base64 which contains Base64-encoded .metalink
 file.  'options' is of type struct and its members are a pair of
 file.  'options' is of type struct and its members are a pair of
-option name and value. See *Options* below for more details.  If
+option name and value. See *<<aria2_xmlrpc_options, Options>>* below for more details.  If
 'position' is given as an integer starting from 0, the new download is
 'position' is given as an integer starting from 0, the new download is
 inserted at 'position' in the waiting queue. If 'position' is not
 inserted at 'position' in the waiting queue. If 'position' is not
 given or 'position' is larger than the size of the queue, it is
 given or 'position' is larger than the size of the queue, it is
@@ -1546,6 +1551,7 @@ Adding local file file.meta4 to aria2:
 ['8']
 ['8']
 --------------------------------------------------------------------
 --------------------------------------------------------------------
 
 
+[[aria2_xmlrpc_aria2_remove]]
 *aria2.remove* ('gid')
 *aria2.remove* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1565,6 +1571,7 @@ Removing download whose GID is '3':
 '3'
 '3'
 --------------------------------------------------------------------
 --------------------------------------------------------------------
 
 
+[[aria2_xmlrpc_aria2_forceRemove]]
 *aria2.forceRemove* ('gid')
 *aria2.forceRemove* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1572,10 +1579,11 @@ Description
 +++++++++++
 +++++++++++
 
 
 This method removes the download denoted by 'gid'.  This method
 This method removes the download denoted by 'gid'.  This method
-behaves just like *aria2.remove* except that this method removes
+behaves just like *<<aria2_xmlrpc_aria2_remove, aria2.remove>>* except that this method removes
 download without any action which takes time such as contacting
 download without any action which takes time such as contacting
 BitTorrent tracker.
 BitTorrent tracker.
 
 
+[[aria2_xmlrpc_aria2_pause]]
 *aria2.pause* ('gid')
 *aria2.pause* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1586,18 +1594,20 @@ This method pauses the download denoted by 'gid'. 'gid' is of type
 string. The status of paused download becomes "paused".  If the
 string. The status of paused download becomes "paused".  If the
 download is active, the download is placed on the first position of
 download is active, the download is placed on the first position of
 waiting queue.  As long as the status is "paused", the download is not
 waiting queue.  As long as the status is "paused", the download is not
-started.  To change status to "waiting", use *aria2.unpause* method.
+started.  To change status to "waiting", use *<<aria2_xmlrpc_aria2_unpause, aria2.unpause>>* method.
 This method returns GID of paused download.
 This method returns GID of paused download.
 
 
+[[aria2_xmlrpc_aria2_pauseAll]]
 *aria2.pauseAll* ()
 *aria2.pauseAll* ()
 ^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^
 
 
 Description
 Description
 +++++++++++
 +++++++++++
 
 
-This method is equal to calling *aria2.pause* for every active/waiting
+This method is equal to calling *<<aria2_xmlrpc_aria2_pause, aria2.pause>>* for every active/waiting
 download. This methods returns "OK" for success.
 download. This methods returns "OK" for success.
 
 
+[[aria2_xmlrpc_aria2_forcePause]]
 *aria2.forcePause* ('pid')
 *aria2.forcePause* ('pid')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1605,19 +1615,21 @@ Description
 +++++++++++
 +++++++++++
 
 
 This method pauses the download denoted by 'gid'.  This method
 This method pauses the download denoted by 'gid'.  This method
-behaves just like *aria2.pause* except that this method pauses
+behaves just like *<<aria2_xmlrpc_aria2_pause, aria2.pause>>* except that this method pauses
 download without any action which takes time such as contacting
 download without any action which takes time such as contacting
 BitTorrent tracker.
 BitTorrent tracker.
 
 
+[[aria2_xmlrpc_aria2_forcePauseAll]]
 *aria2.forcePauseAll* ()
 *aria2.forcePauseAll* ()
 ^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 
 Description
 Description
 +++++++++++
 +++++++++++
 
 
-This method is equal to calling *aria2.forcePause* for every
+This method is equal to calling *<<aria2_xmlrpc_aria2_forcePause, aria2.forcePause>>* for every
 active/waiting download. This methods returns "OK" for success.
 active/waiting download. This methods returns "OK" for success.
 
 
+[[aria2_xmlrpc_aria2_unpause]]
 *aria2.unpause* ('gid')
 *aria2.unpause* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1629,15 +1641,17 @@ This method changes the status of the download denoted by 'gid' from
 'gid' is of type string.  This method returns GID of unpaused
 'gid' is of type string.  This method returns GID of unpaused
 download.
 download.
 
 
+[[aria2_xmlrpc_aria2_unpauseAll]]
 *aria2.unpauseAll* ()
 *aria2.unpauseAll* ()
 ^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^
 
 
 Description
 Description
 +++++++++++
 +++++++++++
 
 
-This method is equal to calling *aria2.unpause* for every active/waiting
+This method is equal to calling *<<aria2_xmlrpc_aria2_unpause, aria2.unpause>>* for every active/waiting
 download. This methods returns "OK" for success.
 download. This methods returns "OK" for success.
 
 
+[[aria2_xmlrpc_aria2_tellStatus]]
 *aria2.tellStatus* ('gid[, keys]')
 *aria2.tellStatus* ('gid[, keys]')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1649,7 +1663,7 @@ This method returns download progress of the download denoted by
 specified, the response contains only keys in 'keys' array. If 'keys'
 specified, the response contains only keys in 'keys' array. If 'keys'
 is empty or not specified, the response contains all keys.  This is
 is empty or not specified, the response contains all keys.  This is
 useful when you just want specific keys and avoid unnecessary
 useful when you just want specific keys and avoid unnecessary
-transfers. For example, *aria2.tellStatus*("1", ["gid", "status"])
+transfers. For example, *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>*("1", ["gid", "status"])
 returns 'gid' and 'status' key.  The response is of type struct and it
 returns 'gid' and 'status' key.  The response is of type struct and it
 contains following keys. The value type is string.
 contains following keys. The value type is string.
 
 
@@ -1745,7 +1759,7 @@ dir::
 files::
 files::
 
 
   Returns the list of files. The element of list is the same struct
   Returns the list of files. The element of list is the same struct
-  used in *aria2.getFiles* method.
+  used in *<<aria2_xmlrpc_aria2_getFiles, aria2.getFiles>>* method.
 
 
 
 
 bittorrent::
 bittorrent::
@@ -1816,6 +1830,7 @@ Get information specifying keys you are interested in:
 {'completedLength': '34896138', 'gid': '1', 'totalLength': '34896138'}
 {'completedLength': '34896138', 'gid': '1', 'totalLength': '34896138'}
 --------------------------------------------------------------------------
 --------------------------------------------------------------------------
 
 
+[[aria2_xmlrpc_aria2_getUris]]
 *aria2.getUris* ('gid')
 *aria2.getUris* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1835,6 +1850,7 @@ status::
   'used' if the URI is already used. 'waiting' if the URI is waiting
   'used' if the URI is already used. 'waiting' if the URI is waiting
   in the queue.
   in the queue.
 
 
+[[aria2_xmlrpc_aria2_getFiles]]
 *aria2.getFiles* ('gid')
 *aria2.getFiles* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1867,8 +1883,9 @@ selected::
 uris::
 uris::
 
 
   Returns the list of URI for this file. The element of list is the
   Returns the list of URI for this file. The element of list is the
-  same struct used in *aria2.getUris* method.
+  same struct used in *<<aria2_xmlrpc_aria2_getUris, aria2.getUris>>* method.
 
 
+[[aria2_xmlrpc_aria2_getPeers]]
 *aria2.getPeers* ('gid')
 *aria2.getPeers* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1919,6 +1936,7 @@ seeder::
 
 
   "true" is this client is a seeder. Otherwise "false".
   "true" is this client is a seeder. Otherwise "false".
 
 
+[[aria2_xmlrpc_aria2_getServers]]
 *aria2.getServers* ('gid')
 *aria2.getServers* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1951,6 +1969,7 @@ servers::
 
 
     Download speed (byte/sec)
     Download speed (byte/sec)
 
 
+[[aria2_xmlrpc_aria2_tellActive]]
 *aria2.tellActive* ('[keys]')
 *aria2.tellActive* ('[keys]')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1959,9 +1978,10 @@ Description
 
 
 This method returns the list of active downloads.  The response is of
 This method returns the list of active downloads.  The response is of
 type array and its element is the same struct returned by
 type array and its element is the same struct returned by
-*aria2.tellStatus* method. For 'keys' parameter, please refer to
-*aria2.tellStatus* method.
+*<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method. For 'keys' parameter, please refer to
+*<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
 
 
+[[aria2_xmlrpc_aria2_tellWaiting]]
 *aria2.tellWaiting* ('offset, num, [keys]')
 *aria2.tellWaiting* ('offset, num, [keys]')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1972,7 +1992,7 @@ This method returns the list of waiting download, including paused
 downloads. 'offset' is of type integer and specifies the offset from
 downloads. 'offset' is of type integer and specifies the offset from
 the download waiting at the front. 'num' is of type integer and
 the download waiting at the front. 'num' is of type integer and
 specifies the number of downloads to be returned.  For 'keys'
 specifies the number of downloads to be returned.  For 'keys'
-parameter, please refer to *aria2.tellStatus* method.
+parameter, please refer to *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
 
 
 If offset is a positive integer, this method returns downloads in the
 If offset is a positive integer, this method returns downloads in the
 range of ['offset', 'offset'+'num').
 range of ['offset', 'offset'+'num').
@@ -1988,8 +2008,9 @@ in this order. aria2.tellWaiting(0, 1) returns
 aria2.tellWaiting(-1, 2) returns ["C", "B"].
 aria2.tellWaiting(-1, 2) returns ["C", "B"].
 
 
 The response is of type array and its element is the same struct
 The response is of type array and its element is the same struct
-returned by *aria2.tellStatus* method.
+returned by *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
 
 
+[[aria2_xmlrpc_aria2_tellStopped]]
 *aria2.tellStopped* ('offset, num, [keys]')
 *aria2.tellStopped* ('offset, num, [keys]')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -1999,14 +2020,15 @@ Description
 This method returns the list of stopped download.  'offset' is of type
 This method returns the list of stopped download.  'offset' is of type
 integer and specifies the offset from the oldest download. 'num' is of
 integer and specifies the offset from the oldest download. 'num' is of
 type integer and specifies the number of downloads to be returned.
 type integer and specifies the number of downloads to be returned.
-For 'keys' parameter, please refer to *aria2.tellStatus* method.
+For 'keys' parameter, please refer to *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
 
 
-'offset' and 'num' have the same semantics as *aria2.tellWaiting*
+'offset' and 'num' have the same semantics as *<<aria2_xmlrpc_aria2_tellWaiting, aria2.tellWaiting>>*
 method.
 method.
 
 
 The response is of type array and its element is the same struct
 The response is of type array and its element is the same struct
-returned by *aria2.tellStatus* method.
+returned by *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
 
 
+[[aria2_xmlrpc_aria2_changePosition]]
 *aria2.changePosition* ('gid, pos, how')
 *aria2.changePosition* ('gid, pos, how')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2029,6 +2051,7 @@ For example, if GID#1 is placed in position 3, aria2.changePosition(1,
 aria2.changePosition(1, 0, POS_SET) will change its position to 0(the
 aria2.changePosition(1, 0, POS_SET) will change its position to 0(the
 beginning of the queue).
 beginning of the queue).
 
 
+[[aria2_xmlrpc_aria2_changeUri]]
 *aria2.changeUri* ('gid, fileIndex, delUris, addUris[, position]')
 *aria2.changeUri* ('gid, fileIndex, delUris, addUris[, position]')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2053,6 +2076,7 @@ method returns a list which contains 2 integers. The first integer is
 the number of URIs deleted. The second integer is the number of URIs
 the number of URIs deleted. The second integer is the number of URIs
 added.
 added.
 
 
+[[aria2_xmlrpc_aria2_getOption]]
 *aria2.getOption* ('gid')
 *aria2.getOption* ('gid')
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2063,6 +2087,7 @@ This method returns options of the download denoted by 'gid'.  The
 response is of type struct. Its key is the name of option.  The value type
 response is of type struct. Its key is the name of option.  The value type
 is string.
 is string.
 
 
+[[aria2_xmlrpc_aria2_changeOption]]
 *aria2.changeOption* ('gid, options')
 *aria2.changeOption* ('gid, options')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2071,10 +2096,11 @@ Description
 
 
 This method changes options of the download denoted by 'gid'
 This method changes options of the download denoted by 'gid'
 dynamically.  'gid' is of type string.  'options' is of type struct
 dynamically.  'gid' is of type string.  'options' is of type struct
-and the available options are: *bt-max-peers*,
-*bt-request-peer-speed-limit*, *max-download-limit* and
-*max-upload-limit*.  This method returns "OK" for success.
+and the available options are: *<<aria2_optref_bt_max_peers, bt-max-peers>>*,
+*<<aria2_optref_bt_request_peer_speed_limit, bt-request-peer-speed-limit>>*, *<<aria2_optref_max_download_limit, max-download-limit>>* and
+*<<aria2_optref_max_upload_limit, max-upload-limit>>*.  This method returns "OK" for success.
 
 
+[[aria2_xmlrpc_aria2_getGlobalOption]]
 *aria2.getGlobalOption* ()
 *aria2.getGlobalOption* ()
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2085,8 +2111,9 @@ This method returns global options.  The response is of type
 struct. Its key is the name of option.  The value type is string.
 struct. Its key is the name of option.  The value type is string.
 Because global options are used as a template for the options of newly
 Because global options are used as a template for the options of newly
 added download, the response contains keys returned by
 added download, the response contains keys returned by
-*aria2.getOption* method.
+*<<aria2_xmlrpc_aria2_getOption, aria2.getOption>>* method.
 
 
+[[aria2_xmlrpc_aria2_changeGlobalOption]]
 *aria2.changeGlobalOption* ('options')
 *aria2.changeGlobalOption* ('options')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2094,13 +2121,14 @@ Description
 +++++++++++
 +++++++++++
 
 
 This method changes global options dynamically.  'options' is of type
 This method changes global options dynamically.  'options' is of type
-struct and the available options are *max-concurrent-downloads*,
-*max-overall-download-limit*, *max-overall-upload-limit*, *log-level*
-and *log*. Using *log* option, you can dynamically start logging or
+struct and the available options are *<<aria2_optref_max_concurrent_downloads, max-concurrent-downloads>>*,
+*<<aria2_optref_max_overall_download_limit, max-overall-download-limit>>*, *<<aria2_optref_max_overall_upload_limit, max-overall-upload-limit>>*, *<<aria2_optref_log_level, log-level>>*
+and *<<aria2_optref_log, log>>*. Using *<<aria2_optref_log, log>>* option, you can dynamically start logging or
 change log file. To stop logging, give empty string("") as a parameter
 change log file. To stop logging, give empty string("") as a parameter
 value. Note that log file is always opened in append mode. This method
 value. Note that log file is always opened in append mode. This method
 returns "OK" for success.
 returns "OK" for success.
 
 
+[[aria2_xmlrpc_aria2_purgeDownloadResult]]
 *aria2.purgeDownloadResult* ()
 *aria2.purgeDownloadResult* ()
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2110,6 +2138,7 @@ Description
 This method purges completed/error/removed downloads to free memory.
 This method purges completed/error/removed downloads to free memory.
 This method returns "OK".
 This method returns "OK".
 
 
+[[aria2_xmlrpc_aria2_getVersion]]
 *aria2.getVersion* ()
 *aria2.getVersion* ()
 ^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2144,6 +2173,7 @@ enabledFeatures::
  'version': '1.10.5'}
  'version': '1.10.5'}
 --------------------------------------------------------------------
 --------------------------------------------------------------------
 
 
+[[aria2_xmlrpc_aria2_getSessionInfo]]
 *aria2.getSessionInfo* ()
 *aria2.getSessionInfo* ()
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2164,6 +2194,7 @@ sessionId::
 {'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}
 {'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}
 --------------------------------------------------------------------
 --------------------------------------------------------------------
 
 
+[[aria2_xmlrpc_aria2_shutdown]]
 *aria2.shutdown* ()
 *aria2.shutdown* ()
 ^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^
 
 
@@ -2172,16 +2203,18 @@ Description
 
 
 This method shutdowns aria2.  This method returns "OK".
 This method shutdowns aria2.  This method returns "OK".
 
 
+[[aria2_xmlrpc_aria2_forceShutdown]]
 *aria2.forceShutdown* ()
 *aria2.forceShutdown* ()
 ^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 
 Description
 Description
 +++++++++++
 +++++++++++
 
 
-This method shutdowns aria2. This method behaves like *aria2.shutdown*
+This method shutdowns aria2. This method behaves like *<<aria2_xmlrpc_aria2_shutdown, aria2.shutdown>>*
 except that any actions which takes time such as contacting BitTorrent
 except that any actions which takes time such as contacting BitTorrent
 tracker are skipped. This method returns "OK".
 tracker are skipped. This method returns "OK".
 
 
+[[aria2_xmlrpc_system_multicall]]
 *system.multicall* ('methods')
 *system.multicall* ('methods')
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
@@ -2217,6 +2250,7 @@ Error Handling
 In case of error, aria2 returns faultCode=1 and the error message in
 In case of error, aria2 returns faultCode=1 and the error message in
 faultString.
 faultString.
 
 
+[[aria2_xmlrpc_options]]
 Options
 Options
 ~~~~~~~
 ~~~~~~~
 
 
@@ -2239,7 +2273,8 @@ In the option struct, name element is option name(without preceding
 </struct>
 </struct>
 -------------------------------------------------
 -------------------------------------------------
 
 
-*header* and *index-out* option are allowed multiple times in
+*<<aria2_optref_header, header>>* and *<<aria2_optref_index_out, index-out>>*
+option are allowed multiple times in
 command-line. Since name should be unique in struct(many XML-RPC
 command-line. Since name should be unique in struct(many XML-RPC
 library implementation uses hash or dict for struct), single string is
 library implementation uses hash or dict for struct), single string is
 not enough. To overcome this situation, they can take array as value
 not enough. To overcome this situation, they can take array as value