.TH IMAGEX "1" "May 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands"
.SH NAME
imagex append \- Append a directory to a WIM archive as a new image

.SH SYNOPSIS
\fBimagex append\fR \fIDIRECTORY\fR \fIWIMFILE\fR [\fIIMAGE_NAME\fR] \
[\fIDESCRIPTION\fR] [\fIOPTION\fR]...

.SH DESCRIPTION
.PP
Captures a WIM image from \fIDIRECTORY\fR and appends it to \fIWIMFILE\fR, which
must be a valid WIM archive.  \fIDIRECTORY\fR becomes the root directory of the
image.

\fIIMAGE_NAME\fR and \fIDESCRIPTION\fR specify the name and description of the
new image.  If \fIIMAGE_NAME\fR is not given, it is taken to be the same as the
base name of \fIDIRECTORY\fR.  If \fIDESCRIPTION\fR is not given, the
description is taken to be empty.

.SH OPTIONS
.TP 6
\fB--boot\fR
Specifies that the new image is to be the bootable image of the WIM archive.
.TP
\fB--check\fR
When reading \fIWIMFILE\fR, verify its integrity if the integrity table is
present; additionally, when writing \fIWIMFILE\fR with the new image added,
write an integrity table.  If this option is not specified, no integrity table
is included in the new WIM file, even if there was one before.
.TP
\fB--flags\fR \fIEDITIONID\fR
Specify a string to use in the <FLAGS> element of the XML data for the image.
.TP
\fB--dereference\fR
Follow symlinks; archive and dump the files they point to.  (The default is to
archive the symlinks themselves)

.SH EXAMPLES
.IP 
image append boot.wim winpe/ "Microsoft Windows PE"
.LP 
Add a new image to the existing WIM file boot.wim.  The files in the directory 'winpe' 
are added recursively to the image.  The image is given the name "Microsoft
Windows PE" and no description.

.SH SEE ALSO
.BR imagex (1)