X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fimagex-delete.1.in;h=463171449fc444b306c1c82b555b8122a884c910;hb=f1153575fae2fad42e2b73ff744c25e3a8d01ad0;hp=ef8b3f61e8a16cc139418ec202ec6db35f833dff;hpb=bec7f491bd14b1da3aae7054edd72575dcf77a4f;p=wimlib diff --git a/doc/imagex-delete.1.in b/doc/imagex-delete.1.in index ef8b3f61..46317144 100644 --- a/doc/imagex-delete.1.in +++ b/doc/imagex-delete.1.in @@ -3,25 +3,30 @@ imagex delete \- Delete an image from a WIM archive .SH SYNOPSIS -\fBimagex delete\fR \fIWIMFILE\fR (\fIIMAGE_NUM\fR | \fIIMAGE_NAME\fR | all ) [--check] +\fBimagex delete\fR \fIWIMFILE\fR \fIIMAGE\fR [--check] .SH DESCRIPTION .PP -\fBimagex delete\fR deletes the specified image from \fIWIMFILE\fR. +\fBimagex delete\fR deletes the specified image from the Windows Imaging (WIM) +file \fIWIMFILE\fR. -The image to delete may be specified by \fIIMAGE_NUM\fR, which must be an -integer that is an index of an image in the WIM file, starting at 1. -Alternatively, it may be the name of an image in the WIM file, or the keyword -"all", which specifies that all images are to be deleted. +\fIIMAGE\fR specifies the WIM image to deleted. It may be a 1-based index of an +image in the WIM, the name of an image in the WIM, or the keyword "all" to +indicate that all images are to be deleted. Use the \fBimagex info\fR (1) +command to show what images a WIM file contains. -The WIM file is recreated with all unnecessary file resources removed. This is -different from imagex.exe, which only will delete the metadata and XML entries -for this operation. +.SH NOTES + +The WIM file is rebuild with all unnecessary file data removed. This is +different from imagex.exe, which only will delete the directory tree metadata +and XML data for this operation. Also, unlike imagex.exe, it is legal to delete all the images from a WIM and have a WIM with 0 images, although such a file wouldn't be very useful. +\fBimagex delete\fR does not yet support split WIMs. + .SH OPTIONS .TP 6 \fB--check\fR @@ -31,10 +36,12 @@ deleted, write an integrity table. If this option is not specified, no integrit table is included in the new WIM file, even if there was one before. .SH EXAMPLES -.IP +Delete the first image from 'boot.wim': +.RS +.PP image delete boot.wim 1 -.LP -Delete the first image from 'boot.wim'. +.RE +.PP .SH SEE ALSO .BR imagex (1)