]> wimlib.net Git - wimlib/blobdiff - doc/imagex-dir.1.in
Update version number
[wimlib] / doc / imagex-dir.1.in
index 2372cdd61328bc0b9e2b29d60017e7fddd311137..379dddcef19c3806444fc21339e423c4c630ada5 100644 (file)
@@ -1,30 +1,37 @@
-.TH IMAGEX "1" "April 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
+.TH WIMLIB-IMAGEX "1" "March 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
 .SH NAME
 @IMAGEX_PROGNAME@-dir \- Show the files contained in a WIM archive
-
 .SH SYNOPSIS
-\fB@IMAGEX_PROGNAME@ dir\fR \fIWIMFILE\fR \fIIMAGE\fR
-
+\fB@IMAGEX_PROGNAME@ dir\fR \fIWIMFILE\fR \fIIMAGE\fR [\fIOPTIONS\fR]
 .SH DESCRIPTION
+Lists the files and directories contained in the specified image of the Windows
+Imaging (WIM) file \fIWIMFILE\fR.
+This command is also available as simply \fBwimdir\fR if the appropriate hard
+link or batch file has been installed.
 .PP
-Lists all the files and directories contained in the specified image of the
-Windows Imaging (WIM) file \fIWIMFILE\fR.
-
-\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
-\fB@IMAGEX_PROGNAME@ info\fR (1) command to show what images a WIM file
-contains.
-
+\fIIMAGE\fR specifies the image in \fIWIMFILE\fR to show the files of.  It may
+be a 1-based index of an image in \fIWIMFILE\fR, the name of an image in
+\fIWIMFILE\fR, or the keyword "all" to indicate that files from all images in
+\fIWIMFILE\fR are to be shown.  Use the \fB@IMAGEX_PROGNAME@ info\fR (1) command
+to show what images a WIM file contains.
+.SH OPTIONS
+.TP 6
+\fB--path\fR=\fIPATH\fR
+List the files recursively from the \fIPATH\fR directory instead of from the
+root directory.
+.TP
+\fB--detailed\fR
+List detailed information about each file.
+.TP
+\fB--one-file-only\fR
+Show information about one file only.  Intended for use with both \fB--path\fR
+and \fB--detailed\fR.
 .SH NOTES
-
 \fB@IMAGEX_PROGNAME@ 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.
-
-Alternate data streams are not displayed.
-
+.PP
+DOS names and alternate (named) data streams are not listed unless the
+\fB--detailed\fR mode is used.
 .SH EXAMPLES
 List all files in the first image of 'boot.wim':
 .RS
@@ -32,7 +39,6 @@ List all files in the first image of 'boot.wim':
 @IMAGEX_PROGNAME@ dir boot.wim 1
 .RE
 .PP
-
 .SH SEE ALSO
 .BR @IMAGEX_PROGNAME@ (1)
 .BR @IMAGEX_PROGNAME@-info (1)