Briefly describe --unsafe-compact for each command

diff --git a/doc/man1/wimlib-imagex-capture.1 b/doc/man1/wimlib-imagex-capture.1
index c8fae9496fe6ab896c723dd2dd32677ab57aea00..6e35a314a275b5823373250676721f434c969c2a 100644 (file)
--- a/doc/man1/wimlib-imagex-capture.1
+++ b/doc/man1/wimlib-imagex-capture.1
@@ -579,7 +579,11 @@ default, set the configuration file to
 however, this may still be overridden through the \fB--config\fR parameter.
 .TP
 \fB--unsafe-compact\fR
-See the documentation for this option in \fBwimlib-imagex-optimize\fR (1).
+For \fBwimlib-imagex append\fR: compact the WIM archive in-place and append any
+new data, eliminating "holes".  In general, this option should \fInot\fR be used
+because a failed or interrupted compaction will corrupt the WIM archive.  For
+more information, see the documentation for this option in
+\fBwimlib-imagex-optimize\fR (1).
 .TP
 \fB--snapshot\fR
 Create a temporary filesystem snapshot of the source directory and capture the

diff --git a/doc/man1/wimlib-imagex-delete.1 b/doc/man1/wimlib-imagex-delete.1
index 4d063e3c8e1c6f863e36b559cad3e397ae80ff6e..d72d9be8371daf85325efdad688e158958b82904 100644 (file)
--- a/doc/man1/wimlib-imagex-delete.1
+++ b/doc/man1/wimlib-imagex-delete.1
@@ -46,7 +46,10 @@ You may use \fBwimlib-imagex optimize\fR to delete unreferenced streams from a W
 has had images soft-deleted from it.
 .TP
 \fB--unsafe-compact\fR
-See the documentation for this option in \fBwimlib-imagex-optimize\fR (1).
+Compact the WIM archive in-place, eliminating "holes".  In general, this option
+should \fInot\fR be used because a failed or interrupted compaction will corrupt
+the WIM archive.  For more information, see the documentation for this option in
+\fBwimlib-imagex-optimize\fR (1).
 .SH EXAMPLES
 Delete the first image from 'boot.wim':
 .RS

diff --git a/doc/man1/wimlib-imagex-export.1 b/doc/man1/wimlib-imagex-export.1
index 67dcc2dfaa4aeea60f79c2b5e89834d6a9d6fbd2..198b5044ac21ed319c0a7c3d277952212278402f 100644 (file)
--- a/doc/man1/wimlib-imagex-export.1
+++ b/doc/man1/wimlib-imagex-export.1
@@ -134,7 +134,10 @@ archive, set the compression type to that recommended for WIMBoot (currently,
 XPRESS with 4096 byte chunks).
 .TP
 \fB--unsafe-compact\fR
-See the documentation for this option in \fBwimlib-imagex-optimize\fR (1).
+Compact the WIM archive in-place and append any new data, eliminating "holes".
+In general, this option should \fInot\fR be used because a failed or interrupted
+compaction will corrupt the WIM archive.  For more information, see the
+documentation for this option in \fBwimlib-imagex-optimize\fR (1).
 .SH SPLIT WIMS
 You may use \fBwimlib-imagex export\fR to export images from a split WIM.
 The \fISRC_WIMFILE\fR argument must specify the first part of the split WIM,

diff --git a/doc/man1/wimlib-imagex-update.1 b/doc/man1/wimlib-imagex-update.1
index cc6dab9e6e1823820da16fa4e2096b0cb78fa1c3..bb8054906c5e0a2d67c4b22f639e4b714380dce4 100644 (file)
--- a/doc/man1/wimlib-imagex-update.1
+++ b/doc/man1/wimlib-imagex-update.1
@@ -165,7 +165,10 @@ boot process).  See the documentation for the \fB--wimboot\fR option of
 \fBwimlib-imagex apply\fR (1) for more information.
 .TP
 \fB--unsafe-compact\fR
-See the documentation for this option in \fBwimlib-imagex-optimize\fR (1).
+Compact the WIM archive in-place and append any new data, eliminating "holes".
+In general, this option should \fInot\fR be used because a failed or interrupted
+compaction will corrupt the WIM archive.  For more information, see the
+documentation for this option in \fBwimlib-imagex-optimize\fR (1).
 .SH NOTES
 \fBwimlib-imagex update\fR is partly redundant with \fBwimlib-imagex
 mountrw\fR, since if a WIM image can be mounted read-write, then there