avl_tree: Optimize first iteration of insertion rebalance loop

[wimlib] / doc / imagex-capture.1.in

diff --git a/doc/imagex-capture.1.in b/doc/imagex-capture.1.in
index 76ef71f10187a6c90ef28598f9f093236af3122f..25212292072f4f2f3aa227146a57c9997de3a2fd 100644 (file)
--- a/doc/imagex-capture.1.in
+++ b/doc/imagex-capture.1.in
@@ -1,4 +1,4 @@
-.TH WIMLIB-IMAGEX "1" "January 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
+.TH WIMLIB-IMAGEX "1" "March 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
 .SH NAME
 @IMAGEX_PROGNAME@-capture, @IMAGEX_PROGNAME@-append \- Create or append a WIM image
 .SH SYNOPSIS
@@ -225,7 +225,7 @@ decide to use this option regardless, you may choose a chunk size that is a
 power of 2 greater than or equal to 2^15 (32768) up to a maximum determined by
 the compression format.  For LZX ("maximum") compression, the maximum allowed
 chunk size is 2^21 (2097152), and for XPRESS ("fast") and LZMS ("recovery")
-compression, the maximum allowed chunk size is 2^26 (67108864).
+compression, the maximum allowed chunk size is 2^30 (1073741824).
 .IP ""
 For XPRESS and LZX compression, Microsoft's implementation (as of Windows 8)
 does not appear to support alternate chunk sizes; although it will still open
@@ -248,7 +248,18 @@ Packed resources use a compression type and chunk size that is independent of
 the WIM's "default compression type" and "default chunk size" (which may be
 adjusted by the \fB--compress\fR and \fB--chunk-size\fR options, respectively).
 For compatibility reasons, \fB@IMAGEX_PROGNAME@ capture\fR currently has no
-option to change the compression type or chunk size used in packed resources.
+option to change the compression type used in packed resources; however, the
+\fB--pack-chunk-size\fR option may be used to set the chunk size.
+.TP
+\fB--pack-chunk-size\fR=\fISIZE\fR, \fB--solid-chunk-size\fR=\fISIZE\fR
+Like \fB--chunk-size\fR, but set the chunk size used in packed resources.  The
+compression format is LZMS, so the chunk size can be any power of 2 between 2^15
+and 2^30, inclusively.  WIMGAPI (Windows 8) appears to be compatible with these
+sizes up to 2^26 inclusively, despite not being compatible with sizes greater
+than 2^20 in non-packed resources.  The default is currently 2^25 (33554432).
+Note: currently, the LZMS compression algorithm uses about 15 times the chunk
+size in memory per thread, which is about 500 MB per thread for the default pack
+chunk size of 2^25 or 1 GB per thread if you change it to 2^26 (67108864).
 .TP
 \fB--threads\fR=\fINUM_THREADS\fR
 Number of threads to use for compressing data.  Default: autodetect (number of