X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=doc%2Fimagex-capture.1.in;h=410546674e53b648777414cc6c38c64fff2b9f18;hb=dc688119fee4dcd1cf146ceb0da285c7983a27bb;hp=deefd8528e5590d9184194b36fd8286ae03361a5;hpb=62e209e9aeaa36ba9e3c2a174428805b7264e0e7;p=wimlib

diff --git a/doc/imagex-capture.1.in b/doc/imagex-capture.1.in
index deefd852..41054667 100644
--- a/doc/imagex-capture.1.in
+++ b/doc/imagex-capture.1.in
@@ -191,12 +191,10 @@ You may also specify the actual names of the compression algorithms, "XPRESS"
 and "LZX", instead of "fast" and "maximum", respectively.
 .IP ""
 As of wimlib v1.6.0, a third compression type, "recovery" or "LZMS", is also
-available.  Its use is not recommended because other than wimlib itself, as of
-Windows 8 it is only compatible with WIMGAPI and Windows Setup (not even ImageX
-or Dism).  Furthermore, wimlib's LZMS compressor is currently less well
-optimized than its LZX compressor.  However, LZMS is the compression algorithm
-used in packed resources created if the \fB--pack-streams\fR option is
-specified.
+available.  Its use is generally not recommended because other than wimlib
+itself, as of Windows 8 it is only compatible with WIMGAPI and Windows Setup
+(not even ImageX or Dism).  However, LZMS is the compression algorithm used in
+packed resources created if the \fB--pack-streams\fR option is specified.
 .TP
 \fB--compress-slow\fR
 Spend even more time compressing the data to achieve a very slightly better
@@ -217,7 +215,7 @@ compression, the maximum allowed chunk size is 2^21 (2097152), and for XPRESS
 ("fast") and LZMS ("recovery") compression, the maximum allowed chunk size is
 2^26 (67108644).
 .TP
-\fB--pack-streams\fR
+\fB--pack-streams\fR, \fB--solid\fR
 Create a "solid" archive that compresses multiple unique streams ("files")
 together, rather than each unique stream ("file") independently.  This can
 result in a significantly better compression ratio, but this format greatly
@@ -226,10 +224,11 @@ mounted with \fB@IMAGEX_PROGNAME@ mount\fR.  Also, WIMs created using this
 option use a different version number in their header and as of Windows 8 are
 only compatible with Windows Setup and WIMGAPI, not even ImageX and Dism.
 .IP ""
-Packed resources use a chunk size that is independent of the WIM's "default
-chunk size", the latter of which may be adjusted by the \fB--chunk-size\fR
-option.  For compatibility reasons, there is currently no option to change the
-compression algorithm or chunk size used in packed resources.
+Packed resources use a compression type and chunk size that is independent of
+the WIM's "default compression type" and "default chunk size" (which may be
+adjusted by the \fB--compress\fR and \fB--chunk-size\fR options, respectively).
+For compatibility reasons, \fB@IMAGEX_PROGNAME@ capture\fR currently has no
+option to change the compression type or chunk size used in packed resources.
 .TP
 \fB--threads\fR=\fINUM_THREADS\fR
 Number of threads to use for compressing data.  Default: autodetect (number of
@@ -532,6 +531,11 @@ Microsoft's software.
 Pipable WIMs are incompatible with Microsoft's software.  Pipable WIMs are
 created only if \fIWIMFILE\fR was specified as "-" (standard output) or if
 the \fB--pipable\fR flag was specified.
+.IP \[bu]
+WIMs captured with a non-default chunk size (with the \fB--chunk-size\fR option)
+or as solid archives (with the \fB--pack-streams\fR option) have varying levels
+of compatibility with Microsoft's software.  The best compatibility is achieved
+with WIMGAPI itelf (not ImageX or Dism) on Windows 8 or later.
 .SH EXAMPLES
 First example:  Create a new WIM 'mywim.wim' with "maximum" (LZX) compression
 that will contain a captured image of the directory tree 'somedir'.  Note that