2009-12-05 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

	Updated usage text for --bt-prioritize-piece option.
	* doc/aria2c.1.txt
	* src/usage_text.h

ChangeLog

@@ -1,3 +1,9 @@
+2009-12-05  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
+
+	Updated usage text for --bt-prioritize-piece option.
+	* doc/aria2c.1.txt
+	* src/usage_text.h
+
 2009-12-05  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
 
 	In configure script, if --with-PACKAGE and --enable-FEATURE are

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: 12/04/2009
+.\"      Date: 12/05/2009
 .\"    Manual: Aria2 Manual
 .\"    Source: Aria2
 .\"  Language: English
 .\"
-.TH "ARIA2C" "1" "12/04/2009" "Aria2" "Aria2 Manual"
+.TH "ARIA2C" "1" "12/05/2009" "Aria2" "Aria2 Manual"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -506,10 +506,10 @@ Set minimum level of encryption method\&. If several encryption methods are prov
 .PP
 \fB\-\-bt\-prioritize\-piece\fR=\fIhead\fR[=SIZE],\fItail\fR[=SIZE]
 .RS 4
-Try to download first and last pieces of each file first\&. The argument can contain 2 keywords:
+Try to download first and last pieces of each file first\&. This is useful for previewing files\&. The argument can contain 2 keywords:
 \fIhead\fR
 and
-\fItail\fR\&. To include both keywords, they must be separated by comma\&. These keywords can take one parameter, SIZE\&. For example , if
+\fItail\fR\&. To include both keywords, they must be separated by comma\&. These keywords can take one parameter, SIZE\&. For example, if
 \fIhead\fR=SIZE is specified, pieces in the range of first SIZE bytes of each file get higher priority\&.
 \fItail\fR=SIZE means the range of last SIZE bytes of each file\&. SIZE can include
 \fIK\fR

doc/aria2c.1.html

@@ -1216,13 +1216,14 @@ writes the piece to the appropriate files.</td>
 </dt>
 <dd>
 <p>
-  Try to download first and last pieces of each file first. The
-  argument can contain 2 keywords: <em>head</em> and <em>tail</em>. To include both
-  keywords, they must be separated by comma. These keywords can take
-  one parameter, SIZE. For example , if <em>head</em>=SIZE is specified,
-  pieces in the range of first SIZE bytes of each file get higher
-  priority. <em>tail</em>=SIZE means the range of last SIZE bytes of each
-  file. SIZE can include <em>K</em> or <em>M</em>(1K = 1024, 1M = 1024K).
+  Try to download first and last pieces of each file first. This is
+  useful for previewing files. The argument can contain 2
+  keywords: <em>head</em> and <em>tail</em>. To include both keywords, they must be
+  separated by comma. These keywords can take one parameter, SIZE. For
+  example, if <em>head</em>=SIZE is specified, pieces in the range of first
+  SIZE bytes of each file get higher priority.  <em>tail</em>=SIZE means the
+  range of last SIZE bytes of each file. SIZE can include <em>K</em> or
+  <em>M</em>(1K = 1024, 1M = 1024K).
 </p>
 </dd>
 <dt class="hdlist1">
@@ -3447,7 +3448,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 2009-12-04 16:45:39 JST
+Last updated 2009-12-05 15:42:10 JST
 </div>
 </div>
 </body>

doc/aria2c.1.txt

@@ -357,13 +357,14 @@ BitTorrent Specific Options
 
 *--bt-prioritize-piece*='head'[=SIZE],'tail'[=SIZE]::
 
-  Try to download first and last pieces of each file first. The
-  argument can contain 2 keywords: 'head' and 'tail'. To include both
-  keywords, they must be separated by comma. These keywords can take
-  one parameter, SIZE. For example , if 'head'=SIZE is specified,
-  pieces in the range of first SIZE bytes of each file get higher
-  priority. 'tail'=SIZE means the range of last SIZE bytes of each
-  file. SIZE can include 'K' or 'M'(1K = 1024, 1M = 1024K).
+  Try to download first and last pieces of each file first. This is
+  useful for previewing files. The argument can contain 2
+  keywords: 'head' and 'tail'. To include both keywords, they must be
+  separated by comma. These keywords can take one parameter, SIZE. For
+  example, if 'head'=SIZE is specified, pieces in the range of first
+  SIZE bytes of each file get higher priority.  'tail'=SIZE means the
+  range of last SIZE bytes of each file. SIZE can include 'K' or
+  'M'(1K = 1024, 1M = 1024K).
 
 *--bt-require-crypto*='true'|'false'::
   If true is given, aria2 doesn't accept and establish connection with legacy

src/usage_text.h

@@ -566,15 +566,16 @@ _(" --xml-rpc-listen-all[=true|false] Listen incoming XML-RPC requests on all\n"
   "                              on local loopback interface.")
 #define TEXT_BT_PRIORITIZE_PIECE \
 _(" --bt-prioritize-piece=head[=SIZE],tail[=SIZE] Try to download first and last\n"\
-  "                              pieces of each file first. The argument can\n"\
-  "                              contain 2 keywords:head and tail. To include both\n"\
-  "                              keywords, they must be separated by comma. These\n"\
-  "                              keywords can take one parameter, SIZE. For example\n"\
-  "                              , if head=SIZE is specified, pieces in the range\n"\
-  "                              of first SIZE bytes of each file get higher\n"\
-  "                              priority. tail=SIZE means the range of last SIZE\n"\
-  "                              bytes of each file. SIZE can include K or M(1K =\n"\
-  "                              1024, 1M = 1024K).")
+  "                              pieces of each file first. This is useful for\n"\
+  "                              previewing files. The argument can contain 2\n"\
+  "                              keywords:head and tail. To include both keywords,\n"\
+  "                              they must be separated by comma. These keywords\n"\
+  "                              can take one parameter, SIZE. For example, if\n"\
+  "                              head=SIZE is specified, pieces in the range of\n"\
+  "                              first SIZE bytes of each file get higher priority.\n"\
+  "                              tail=SIZE means the range of last SIZE bytes of\n"\
+  "                              each file. SIZE can include K or M(1K = 1024, 1M =\n"\
+  "                              1024K).")
 #define TEXT_INTERFACE \
 _(" --interface=INTERFACE        Bind sockets to given interface. You can specify\n"\
   "                              interface name, IP address and hostname.")