2009-03-25 Tatsuhiro Tsujikawa <[email protected]>

	Documented 'falloc' in man page.
	* doc/aria2c.1.txt

ChangeLog

@@ -1,3 +1,8 @@
+2009-03-25  Tatsuhiro Tsujikawa  <[email protected]>
+
+	Documented 'falloc' in man page.
+	* doc/aria2c.1.txt
+
 2009-03-25  Tatsuhiro Tsujikawa  <[email protected]>
 
 	Updated doc

doc/aria2c.1

@@ -1,11 +1,11 @@
 .\"     Title: aria2c
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
-.\"      Date: 03/22/2009
+.\"      Date: 03/25/2009
 .\"    Manual: 
 .\"    Source: 
 .\"
-.TH "ARIA2C" "1" "03/22/2009" "" ""
+.TH "ARIA2C" "1" "03/25/2009" "" ""
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -800,7 +800,16 @@ or
 \fInone\fR
 doesn\'t pre\-allocate file space\&.
 \fIprealloc\fR
-pre\-allocates file space before download begins\&. This may take some time depending on the size of the file\&. Default:
+pre\-allocates file space before download begins\&. This may take some time depending on the size of the file\&. If you are using newer file systems such as ext4 (with extents support), btrfs or xfs,
+\fIfalloc\fR
+is your best choice\&. It allocates large(few GiB) files almost instantly\&. Don\'t use
+\fIfalloc\fR
+with legacy file systems such as ext3 because it takes almost same time as
+\fIprealloc\fR
+and it blocks aria2 entirely until allocation finishes\&.
+\fIfalloc\fR
+may not be available if your system doesn\'t have
+\fBposix_fallocate\fR() function\&. Default:
 \fIprealloc\fR
 .RE
 .PP

doc/aria2c.1.html

@@ -1446,6 +1446,15 @@ writes the piece to the appropriate files.</td>
   <em>none</em> doesn't pre-allocate file space. <em>prealloc</em> pre-allocates file space
   before download begins. This may take some time depending on the size of the
   file.
+  If you are using newer file systems such as ext4
+  (with extents support), btrfs or xfs, <em>falloc</em> is
+  your best choice. It allocates large(few GiB)
+  files almost instantly. Don't use <em>falloc</em> with
+  legacy file systems such as ext3 because it takes
+  almost same time as <em>prealloc</em> and it blocks aria2
+  entirely until allocation finishes. <em>falloc</em> may
+  not be available if your system doesn't have
+  <strong>posix_fallocate</strong>() function.
   Default: <em>prealloc</em>
 </p>
 </dd>
@@ -2337,7 +2346,7 @@ files in the program, then also delete it here.</p></div>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2009-03-22 16:27:15 JST
+Last updated 2009-03-25 15:03:34 JST
 </div>
 </div>
 </body>

doc/aria2c.1.txt

@@ -575,10 +575,20 @@ Advanced Options
   'select'.
 
 *--file-allocation*=METHOD::
+
   Specify file allocation method. METHOD is either 'none' or 'prealloc'.
   'none' doesn't pre-allocate file space. 'prealloc' pre-allocates file space
   before download begins. This may take some time depending on the size of the
   file.
+  If you are using newer file systems such as ext4
+  (with extents support), btrfs or xfs, 'falloc' is
+  your best choice. It allocates large(few GiB)
+  files almost instantly. Don't use 'falloc' with
+  legacy file systems such as ext3 because it takes
+  almost same time as 'prealloc' and it blocks aria2
+  entirely until allocation finishes. 'falloc' may
+  not be available if your system doesn't have
+  *posix_fallocate*() function.
   Default: 'prealloc'
 
 *--log-level*=LEVEL::