Variable LZX window sizes

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

diff --git a/doc/imagex-optimize.1.in b/doc/imagex-optimize.1.in
index 30edd4ad2072fee73de432ccd87ca052faeaf1b1..c1cf5cb1290a0ea004e526f6340b6558fd09a9b4 100644 (file)
--- a/doc/imagex-optimize.1.in
+++ b/doc/imagex-optimize.1.in
@@ -41,12 +41,22 @@ Spend even more time compressing the data in order to achieve a more optimal
 compression ratio.  Compared to the default \fB--recompress\fR, this will make
 compression about twice as slow and will increase the compression ratio by maybe
 1%, depending on the data.  This option implies \fB--recompress\fR and
-\fB--compress\fR="maximum" (recompress using LZX compression).
+\fB--compress\fR=\fImaximum\fR (recompress using LZX compression).
 .TP
 \fB--compress\fR=\fITYPE\fR
 Recompress the WIM file using the specified compression type.  \fITYPE\fR may be
 "none", "fast", or "maximum".  This implies \fB--recompress\fR.
 .TP
+\fB--chunk-size\fR=\fISIZE\fR
+Set the WIM compression chunk size to \fISIZE\fR.  Using this option is not
+recommended because WIM chunk sizes other than the default of 32768 are not
+supported by Microsoft's software.  But if you decide to use this option
+regardless, you can choose a chunk size that is any power of 2 greater than or
+equal to 2^15 (32768) up to 2^21 (2097152) for LZX ("maximum") compression or
+2^26 (67108864) for XPRESS ("fast") compression.  Larger chunks mean larger LZ77
+dictionaries and better compression ratios on sufficiently large files, but
+slower random access.
+.TP
 \fB--threads\fR=\fINUM_THREADS\fR
 Number of threads to use for compressing data.  Default: autodetect (number of
 processors).  This parameter is only meaningful when \fB--recompress\fR is also