]> wimlib.net Git - wimlib/blobdiff - doc/imagex-dir.1.in
imagex unmount --rebuild
[wimlib] / doc / imagex-dir.1.in
index fd2646751f0a3e6a0128e1d5ba2c8f009c327a30..415e237256ce4d76acb5f99fce1c9d43179bebb9 100644 (file)
@@ -1,19 +1,34 @@
-.TH IMAGEX "1" "May 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands"
+.TH IMAGEX "1" "November 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands"
 .SH NAME
-imagex dir \- Show the files contained in a WIM archive
+imagex-dir \- Show the files contained in a WIM archive
 
 .SH SYNOPSIS
-\fBimagex dir\fR \fIWIMFILE\fR (\fIIMAGE_NUM\fR | \fIIMAGE_NAME\fR | all),
+\fBimagex dir\fR \fIWIMFILE\fR \fIIMAGE\fR
 
 .SH DESCRIPTION
 .PP
-Lists all the files and directories contained in the specified image of
-\fIWIMFILE\fR.
+Lists all the files and directories contained in the specified image of the
+Windows Imaging (WIM) file \fIWIMFILE\fR.
 
-The image 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.  It also may be the keyword "all", which
-specifies all images.
+\fIIMAGE\fR specifies the WIM image to show the files of.  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 files from all images are to be shown.  Use the \fBimagex
+info\fR (1) command to show what images a WIM file contains.
+
+.SH NOTES
+
+\fBimagex dir\fR supports split WIMs, but it will only work on the first part of
+the split WIM.
+
+The DOS names of files are not displayed.
+
+.SH EXAMPLES
+Show all files in the first image of 'boot.wim':
+.RS
+.PP
+image dir boot.wim 1
+.RE
+.PP
 
 .SH SEE ALSO
 .BR imagex (1)