From: Nick Magerko Date: Thu, 22 Aug 2019 16:37:47 +0000 (-0700) Subject: Differentiate --stream-size from --size-hint X-Git-Tag: v1.4.4~1^2~74^2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fd486a846abcbf6c92496dd4915d6a46bd4790c2;p=thirdparty%2Fzstd.git Differentiate --stream-size from --size-hint --- diff --git a/programs/zstd.1.md b/programs/zstd.1.md index ee5db9d63..1bdc42654 100644 --- a/programs/zstd.1.md +++ b/programs/zstd.1.md @@ -145,10 +145,10 @@ the last one takes effect. _note_ : at the time of this writing, `--adapt` can remain stuck at low speed when combined with multiple worker threads (>=2). * `--stream-size=#` : - When handling input from a stream, `zstd` must guess how large the source size - will be when optimizing compression parameters. This option sets the pledged source - size of a stream to eliminate that guesswork. Note that the pledged size must be exact; - incorrect stream sizes will cause an error. + Sets the pledged source size of input coming from a stream. This value must be exact, as it + will be included in the produced frame header. Incorrect stream sizes will cause an error. + This information will be used to better optimize compression parameters, resulting in + better and potentially faster compression, especially for smaller source sizes. * `--rsyncable` : `zstd` will periodically synchronize the compression state to make the compressed file more rsync-friendly. There is a negligible impact to