]> wimlib.net Git - wimlib/blobdiff - doc/imagex-optimize.1.in
Variable LZX window sizes
[wimlib] / doc / imagex-optimize.1.in
index 52b90c2a9f67828f311414f6717bab55b84fd445..c1cf5cb1290a0ea004e526f6340b6558fd09a9b4 100644 (file)
@@ -36,11 +36,26 @@ verify that the WIM is intact (equivalent to applying all the images from it).
 Note: as of wimlib v1.5.3, wimlib's LZX compressor usually achieves the same or
 better compression than Microsoft's, but is slightly slower.
 .TP
-\fB--compress-slow
-For LZX compression only: spend even more time compressing the data in order to
-achieve a more optimal compression ratio.  This will make compression about
-twice as slow and will increase the compression ratio by maybe 1%, if you're
-lucky.
+\fB--recompress-slow\fR, \fB--compress-slow\fR
+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=\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