Source: squashfs-tools
Severity: minor
Being generally somewhat confused by the wording in the man page regarding the
default value of
-Xdict-size to XZ, I would like to suggest an edit to include this information.
Please change the wording according to your wishes, but this is the most
pleasant way of wording
it that I could come up with.
As per xz_wrapper.c:
/* No -Xdict-size specified, use defaults */
dictionary_size = block_size;
The reader might be confused whether using this option would do any good (as
some have been) but
effectively you cannot improve over the default option; this could also be
explicitly stated.
Best wishes,
Dryden
--- mksquashfs.1.old 2013-05-09 22:22:49.000000000 +0200
+++ mksquashfs.1 2018-02-14 09:52:13.200000000 +0100
@@ -113 +113 @@
-Use \fIDICT_SIZE\fR as the XZ dictionary size. The dictionary size can be
specified as a percentage of the block size, or as an absolute value. The
dictionary size must be less than or equal to the block size and 8192 bytes or
larger. It must also be storable in the xz header as either 2^n or as
2^n+2^(n+1). Example dict\-sizes are 75%, 50%, 37.5%, 25%, or 32K, 16K, 8K etc.
+Use \fIDICT_SIZE\fR as the XZ dictionary size. The dictionary size can be
specified as a percentage of the block size, or as an absolute value. The
default size is 100% of the block size. The size must be less than or equal to
the block size and 8192 bytes or larger. It must also be storable in the xz
header as either 2^n or as 2^n+2^(n+1). Example dict\-sizes are 75%, 50%,
37.5%, 25%, or 32K, 16K, 8K etc. The default is 100%.
