wimdir: Add --one-file-only option

[wimlib] / doc / imagex-info.1.in

diff --git a/doc/imagex-info.1.in b/doc/imagex-info.1.in
index acc2ca18fc91055e0679a33d05a5257c1381e97b..0bcbc4d06aa1567ed21796e26eac51a61e1e1460 100644 (file)
--- a/doc/imagex-info.1.in
+++ b/doc/imagex-info.1.in
@@ -1,38 +1,30 @@
-.TH IMAGEX "1" "October 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands"
+.TH WIMLIB-IMAGEX "1" "January 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"

 .SH NAME
 .SH NAME

-imagex info \- Display information about a WIM file, or change information about
+@IMAGEX_PROGNAME@-info \- Display information about a WIM file, or change information about

 an image
 an image

-

 .SH SYNOPSIS
 .SH SYNOPSIS

-\fBimagex info\fR \fIWIMFILE\fR [\fIIMAGE_NUM\fR | \fIIMAGE_NAME\fR]  \
-[\fINEW_NAME\fR] [\fINEW_DESC\fR] [\fIOPTION\fR]...
-
-
+\fB@IMAGEX_PROGNAME@ info\fR \fIWIMFILE\fR [\fIIMAGE\fR [\fINEW_NAME\fR
+[\fINEW_DESC\fR]]] [\fIOPTION\fR...]

 .SH DESCRIPTION
 .SH DESCRIPTION

-.PP
-
-\fBimagex info\fR displays information about \fIWIMFILE\fR, and optionally
+\fB@IMAGEX_PROGNAME@ info\fR displays information about \fIWIMFILE\fR, and optionally

 changes which image is bootable, or what the name and description of an image
 are.
 changes which image is bootable, or what the name and description of an image
 are.

-
-If neither an image nor any other flags other than \fB--check\fR are specified,
-some basic information about the WIM archive as well as information about the
-images contained in it will be printed.  If an image is specified, the printed
-information is restricted to that concerning the specified image.
-
+This command is also available as simply \fBwiminfo\fR if the appropriate hard
+link or batch file has been installed.
+.PP
+If neither an image nor any flags other than \fB--check\fR are specified, some
+basic information about the WIM archive as well as information about the images
+contained in it will be printed.  If an image is specified by \fIIMAGE\fR (as a
+1-based image index or an image name), the printed information is restricted to
+that concerning the specified image.
+.PP

 Changes to the WIM are made if \fINEW_NAME\fR and/or \fB--boot\fR are specified.
 Changes to the WIM are made if \fINEW_NAME\fR and/or \fB--boot\fR are specified.

-\fINEW_NAME\fR is taken to be the new name of the image specified by
-\fIIMAGE_NUM\fR or \fIIMAGE_NAME\fR, while \fINEW_DESC\fR is taken to be its new
-description. \fINEW_DESC\fR defaults to the old description if it is not given.
-
-Since none of these changes require changing the WIM's file resources, metadata
-resources, or stream lookup table, they can be done very quickly by only
-re-writing the header and XML data.  It will only take significant time if
-\fB--check\fR is specified for a WIM that had no integrity checks before.
-
-\fBimagex info\fR does not support modifying a split WIM, although you may
+\fINEW_NAME\fR is taken to be the new name of the image specified by \fIIMAGE\fR
+while \fINEW_DESC\fR is taken to be its new description.  If \fINEW_DESC\fR is
+not specified, the image's description is unchanged.
+.PP
+\fB@IMAGEX_PROGNAME@ info\fR does not support modifying a split WIM, although you may

 display information about one.
 display information about one.

-

 .SH OPTIONS
 .TP 6
 \fB--boot\fR
 .SH OPTIONS
 .TP 6
 \fB--boot\fR


@@ -41,14 +33,20 @@ archive.
 .TP
 \fB--check\fR
 When reading \fIWIMFILE\fR, verify its integrity if the integrity table is
 .TP
 \fB--check\fR
 When reading \fIWIMFILE\fR, verify its integrity if the integrity table is

-present; additionally if an action that requires changing the WIM archive is
+present; additionally if an action that requires modifying the WIM archive is

 specified, include an integrity table in the modified WIM.  If this option is
 specified, include an integrity table in the modified WIM.  If this option is

-not specified and \fIWIMFILE\fR is recreated, no integrity table is included in
-the modified WIM, even if there was one before.
+not specified and \fIWIMFILE\fR is modified, an integrity table will be included
+in the modified WIM if and only if there was one before.
+.TP
+\fB--nocheck\fR
+If an action that requires modifying the WIM archive is specified, do not
+include an integrity table in the modified WIM.  If this option is not specified
+and \fIWIMFILE\fR is modified, an integrity table will be included in the
+modified WIM if and only if there was one before.

 .TP
 .TP

-\fB--extract-xml\fR \fIFILE\fR
+\fB--extract-xml\fR=\fIFILE\fR

 Extracts the raw data from the XML resource in the WIM file to \fIFILE\fR.
 Extracts the raw data from the XML resource in the WIM file to \fIFILE\fR.

-Note: the XML data should be encoded using UTF-16LE, and it should begin with a
+Note: the XML data will be encoded using UTF-16LE, and it will begin with a

 byte-order mark.
 .TP
 \fB--header\fR
 byte-order mark.
 .TP
 \fB--header\fR


@@ -57,13 +55,9 @@ Shows detailed information from the WIM header.
 \fB--lookup-table\fR
 Prints all the entries in the stream lookup table of the WIM.
 .TP
 \fB--lookup-table\fR
 Prints all the entries in the stream lookup table of the WIM.
 .TP

-\fB--metadata\fR
-Prints the metadata, including the security data and the directory entry tree,
-for the specified image.  This only works on standalone WIMs or on the first
-part of a split WIM.
-.TP

 \fB--xml\fR
 \fB--xml\fR

-Prints the XML data for the WIM.
+Prints the raw XML data from the WIM.  Note: the XML data will be encoded using
+UTF-16LE, and it will begin with a byte-order mark.

 .SH SEE ALSO
 .SH SEE ALSO

-.BR imagex (1)
-
+.BR @IMAGEX_PROGNAME@ (1)
+.BR @IMAGEX_PROGNAME@-dir (1)