X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=doc%2Fimagex-delete.1.in;h=166eaffd71b690716e8d83c0bd07f552cf0c1db5;hp=41a10bc7bf389dbb376992da54958d25b4ef8a4f;hb=e510d33bc53ca66de7737d49b8086532bac2e4f7;hpb=4a7d507821b3134360b4c1243e650d781bf38dc0 diff --git a/doc/imagex-delete.1.in b/doc/imagex-delete.1.in index 41a10bc7..166eaffd 100644 --- a/doc/imagex-delete.1.in +++ b/doc/imagex-delete.1.in @@ -1,33 +1,26 @@ .TH IMAGEX "1" "May 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" .SH NAME @IMAGEX_PROGNAME@-delete \- Delete an image from a WIM archive - .SH SYNOPSIS \fB@IMAGEX_PROGNAME@ delete\fR \fIWIMFILE\fR \fIIMAGE\fR [--check] - .SH DESCRIPTION -.PP - \fB@IMAGEX_PROGNAME@ delete\fR deletes the specified image from the Windows Imaging (WIM) file \fIWIMFILE\fR. - +.PP \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 \fB@IMAGEX_PROGNAME@ info\fR (1) command to show what images a WIM file contains. - .SH NOTES - By default, the WIM file is rebuilt with all unnecessary file data removed. This is different from Microsoft's imagex.exe, which only will delete the directory tree metadata and XML data for this operation. (See the \fB--soft\fR option for the other kind of delete). - +.PP Also, unlike Microsoft's 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. - +.PP \fB@IMAGEX_PROGNAME@ delete\fR does not support split WIMs. - .SH OPTIONS .TP 6 \fB--check\fR @@ -43,10 +36,9 @@ changes to correctly remove the image from the WIM will be taken. In particular, all streams will be left alone, even if they are no longer referenced. This is probably not what you want, because almost no space will be saved by deleting an image in this way. - +.IP "" You may use \fB@IMAGEX_PROGNAME@ optimize\fR to delete unreferenced streams from a WIM that has had images soft-deleted from it. - .SH EXAMPLES Delete the first image from 'boot.wim': .RS @@ -54,9 +46,7 @@ Delete the first image from 'boot.wim': @IMAGEX_PROGNAME@ delete boot.wim 1 .RE .PP - .SH SEE ALSO .BR @IMAGEX_PROGNAME@ (1) .BR @IMAGEX_PROGNAME@-info (1) .BR @IMAGEX_PROGNAME@-optimize (1) -