X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=doc%2Fimagex-optimize.1.in;h=f1ffa98a5dfa99567ad670866da028531494b014;hb=4016a9dba036f4d2eca0253c99370e6647a9ccb6;hp=9074fb41c7c8fb6e54b106e54bbb4fe9c8e9073f;hpb=ce81b1490c131f0be20c21661bc8f954d45c417c;p=wimlib diff --git a/doc/imagex-optimize.1.in b/doc/imagex-optimize.1.in index 9074fb41..f1ffa98a 100644 --- a/doc/imagex-optimize.1.in +++ b/doc/imagex-optimize.1.in @@ -1,4 +1,4 @@ -.TH IMAGEX "1" "November 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands" +.TH IMAGEX "1" "February 2013" "imagex (wimlib) wimlib @VERSION@" "User Commands" .SH NAME imagex-optimize \- Optimize a WIM archive @@ -18,17 +18,23 @@ In addition, some errors in the original WIM may be fixed by re-writing it .TP 6 \fB--check\fR When reading \fIWIMFILE\fR, verify its integrity if the integrity table is -present; include an integrity table in the optimized WIM. If this option is not -specified and \fIWIMFILE\fR, no integrity table is included in the optimized -WIM, even if there was one before. +present; in addition, include an integrity table in the optimized WIM. If this +option is not specified, no integrity table is included in the optimized WIM, +even if there was one in the original WIM. .TP 6 \fB--recompress\fR Recompress all compressed streams in \fIWIMFILE\fR when rebuilding it. This -will increase the time needed to rebuild the WIM,unless the WIM is uncompressed, -but it may result in a better compression ratio if wimlib can do a better job -than the program that wrote the original file. A side effect of this is that -every stream in the original WIM will be checksummed, so this can help verify -that the WIM is intact (equivalent to applying all the images from it). +will increase the time needed to rebuild the WIM, unless the WIM is +uncompressed, but it may result in a better compression ratio if wimlib can do a +better job than the program that wrote the original file. A side effect of this +is that every stream in the original WIM will be checksummed, so this can help +verify that the WIM is intact (equivalent to applying all the images from it). + +Note: as mentioned in the README, wimlib generally provides a slightly better +XPRESS compression ratio than Microsoft's software, while it generally provides +a slightly worse LZX compression ratio than Microsoft's software. So, you may +not want to specify \fB--recompress\fR when optimizing a LZX-compressed WIM +created on Windows. .SH NOTES