Only access struct stat.mtim if available

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

diff --git a/doc/imagex-capture.1.in b/doc/imagex-capture.1.in
index 5e5fe0bdff27dbf5609bddc55d7a9564d2034566..1647f7a1c2ceb4b9a5d18a58651c6d50775b1d35 100644 (file)
--- a/doc/imagex-capture.1.in
+++ b/doc/imagex-capture.1.in
@@ -1,6 +1,6 @@
-.TH IMAGEX "1" "September 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands"
+.TH IMAGEX "1" "November 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands"
 .SH NAME
-imagex capture, append \- Capture a WIM image from a directory tree
+imagex-capture, imagex-append \- Capture a WIM image from a directory tree
 
 .SH SYNOPSIS
 \fBimagex capture\fR \fISOURCE\fR \fIWIMFILE\fR [\fIIMAGE_NAME\fR] \
@@ -44,7 +44,7 @@ directory tree:
 The "normal" name and contents of each file and directory
 .IP \[bu]
 File and directory creation, access, and modification timestamps to the nearest
-nanosecond, if supported by the underlying filesystem
+100 nanoseconds, if supported by the underlying filesystem
 .IP \[bu]
 Hard links and symbolic links
 
@@ -113,6 +113,18 @@ must be the same as that of the existing WIM.  \fITYPE\fR may be "none",
 You may also specify the actual names of the compression algorithms, "XPRESS"
 and "LZX", instead of "fast" and "maximum", respectively.
 .TP
+\fB--threads\fR=\fINUM_THREADS\fR
+Number of threads to use for compressing data.  Default: autodetect (number of
+processors).  Note: if creating or appending to an uncompressed WIM, additional
+threads will not be used, regardless of this parameter, since no compression
+needs to be done in this case.
+.TP
+\fB--rebuild\fR
+For \fBimagex append\fR: rebuild the entire WIM rather than appending the new
+data to the end of it.  Rebuilding the WIM is slower, but will save a little bit
+of space that would otherwise be left as a hole in the WIM.  Also see \fBimagex
+optimize\fR.
+.TP
 \fB--flags\fR=\fIEDITIONID\fR
 Specify a string to use in the <FLAGS> element of the XML data for the new
 image.
@@ -188,6 +200,13 @@ type, and \fBimagex\fR always enforces this.
 stream chunk size of 32768.  The only WIMs I've seen that are different from
 this are some pre-Vista WIMs that had a different version number.
 
+Unless --rebuild is specified, aborting an \fBimagex append\fR command mid-way
+through has a small chance of corrupting the WIM file.  However, a precaution is
+taken against this, so it should be very unlikely.  In the event of an aborted
+\fBimagex append\fR, \fBimagex optimize\fR may be run to remove extra data that
+may have been partially appended to the physical WIM file but not yet
+incorporated into the structure of the WIM.
+
 .SH EXAMPLES
 Create a new WIM 'mywim.wim' from the directory 'somedir', using LZX compression and
 including an integrity table: