X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=doc%2Fman1%2Fwimlib-imagex-export.1;h=198b5044ac21ed319c0a7c3d277952212278402f;hp=c09dabee04fd0e8a41e885eaee10a672c0641920;hb=4e0e062e081fcbb6a660084308287926c52c9353;hpb=3bdac428d5dfb5c609b8012e4a6a1df7a7eb91dd diff --git a/doc/man1/wimlib-imagex-export.1 b/doc/man1/wimlib-imagex-export.1 index c09dabee..198b5044 100644 --- a/doc/man1/wimlib-imagex-export.1 +++ b/doc/man1/wimlib-imagex-export.1 @@ -1,4 +1,4 @@ -.TH WIMLIB-IMAGEX "1" "August 2015" "wimlib 1.8.2" "User Commands" +.TH WIMLIB-IMAGEX "1" "January 2016" "wimlib 1.9.0" "User Commands" .SH NAME wimlib-imagex-export \- Exports an image from a WIM archive to an existing or new WIM archive .SH SYNOPSIS @@ -134,7 +134,10 @@ archive, set the compression type to that recommended for WIMBoot (currently, XPRESS with 4096 byte chunks). .TP \fB--unsafe-compact\fR -See the documentation for this option in \fBwimlib-imagex-optimize\fR (1). +Compact the WIM archive in-place and append any new data, eliminating "holes". +In general, this option should \fInot\fR be used because a failed or interrupted +compaction will corrupt the WIM archive. For more information, see the +documentation for this option in \fBwimlib-imagex-optimize\fR (1). .SH SPLIT WIMS You may use \fBwimlib-imagex export\fR to export images from a split WIM. The \fISRC_WIMFILE\fR argument must specify the first part of the split WIM, @@ -159,12 +162,13 @@ To export the first image of this split WIM to a new or existing WIM file wimlib-imagex export mywim.swm 1 other.wim --ref="mywim*.swm" .RE .SH NOTES -\fIData integrity\fR: It is safe to abort a \fBwimlib-imagex export\fR command partway through. -However, after doing this, it is recommended to run \fBwimlib-imagex -optimize\fR on the destination WIM to remove any data that was appended to the -physical WIM file but not yet incorporated into the structure of the WIM, unless -the WIM was being rebuilt (e.g. with \fB--rebuild\fR), in which case you should -delete the temporary file left over. +\fIData integrity\fR: Except when using \fB--unsafe-compact\fR, it is safe to +abort a \fBwimlib-imagex export\fR command partway through. However, after +doing this, it is recommended to run \fBwimlib-imagex optimize\fR on the +destination WIM to remove any data that was appended to the physical WIM file +but not yet incorporated into the structure of the WIM, unless the WIM was being +rebuilt (e.g. with \fB--rebuild\fR), in which case you should delete the +temporary file left over. .PP \fISingle instancing\fR: The WIM format uses single-instance streams (roughly, "files"). When an image is exported, only the streams ("files") not already