From 6a8715f8d43dcbaec8d33945a7cfdae06ef1be6d Mon Sep 17 00:00:00 2001 From: Jennifer Lee Date: Wed, 4 Mar 2026 13:29:20 -0800 Subject: [PATCH 1/3] update man --- programs/zstd.1.md | 3 ++- programs/zstdcli.c | 7 ++++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/programs/zstd.1.md b/programs/zstd.1.md index bb9258d57..49d9e5f88 100644 --- a/programs/zstd.1.md +++ b/programs/zstd.1.md @@ -131,6 +131,7 @@ the last one takes effect. In all cases, the nb of threads is capped to `ZSTDMT_NBWORKERS_MAX`, which is either 64 in 32-bit mode, or 256 for 64-bit environments. This modifier does nothing if `zstd` is compiled without multithread support. + Note that memory usage increases with each thread. * `--single-thread`: Use a single thread for both I/O and compression. As compression is serialized with I/O, this can be slightly slower. @@ -157,7 +158,7 @@ the last one takes effect. when combined with multiple worker threads (>=2). * `--long[=#]`: enables long distance matching with `#` `windowLog`, if `#` is not - present it defaults to `27`. + present it defaults to `27`. The highest possible value is 31 This increases the window size (`windowLog`) and memory usage for both the compressor and decompressor. This setting is designed to improve the compression ratio for files with diff --git a/programs/zstdcli.c b/programs/zstdcli.c index 34db7bf51..7749b2908 100644 --- a/programs/zstdcli.c +++ b/programs/zstdcli.c @@ -1540,7 +1540,12 @@ int main(int argCount, const char* argv[]) /* check compression level limits */ { int const maxCLevel = ultra ? ZSTD_maxCLevel() : ZSTDCLI_CLEVEL_MAX; if (cLevel > maxCLevel) { - DISPLAYLEVEL(2, "Warning : compression level higher than max, reduced to %i \n", maxCLevel); + DISPLAYLEVEL(2, "Warning : compression level higher than max, reduced to %i. ", maxCLevel); + DISPLAYLEVEL(2, "Specify --ultra to raise the limit to 22 and use " + "--long=31 for maximum compression. Note that this " + "requires high amounts of memory, and the resulting data " + "might be rejected by third-party decoders and is " + "therefore only recommended for archival purposes. \n"); cLevel = maxCLevel; } } #endif From 1bd8e553633bb1b51fae051bc6b7fa75cb135fc6 Mon Sep 17 00:00:00 2001 From: jlee303 Date: Thu, 5 Mar 2026 15:12:33 -0800 Subject: [PATCH 2/3] Update programs/zstd.1.md Co-authored-by: Nick Terrell --- programs/zstd.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/programs/zstd.1.md b/programs/zstd.1.md index 49d9e5f88..1721441df 100644 --- a/programs/zstd.1.md +++ b/programs/zstd.1.md @@ -158,7 +158,7 @@ the last one takes effect. when combined with multiple worker threads (>=2). * `--long[=#]`: enables long distance matching with `#` `windowLog`, if `#` is not - present it defaults to `27`. The highest possible value is 31 + present it defaults to `27`. The highest possible value is 31. This increases the window size (`windowLog`) and memory usage for both the compressor and decompressor. This setting is designed to improve the compression ratio for files with From 7b04e6dd1e2385df0701e2c513db2478e5950d1b Mon Sep 17 00:00:00 2001 From: Jennifer Lee Date: Fri, 6 Mar 2026 09:47:03 -0800 Subject: [PATCH 3/3] Retry CI