]> git.ipfire.org Git - thirdparty/zstd.git/commit
Promote `ZSTD_c_targetCBlockSize` Parameter to Stable API 3964/head
authorW. Felix Handte <w@felixhandte.com>
Wed, 13 Mar 2024 20:56:54 +0000 (16:56 -0400)
committerW. Felix Handte <w@felixhandte.com>
Wed, 13 Mar 2024 21:07:10 +0000 (17:07 -0400)
commit3613448fb8623361dc6bd9b32c8d4b3d2da85823
tree1a3fc03fb8f3583c581acb4024424552b95245f6
parent7c2aa73a8ef16e387b57e54cf2b71588c539fbfb
Promote `ZSTD_c_targetCBlockSize` Parameter to Stable API

This feature has demonstrated itself to be useful in web compression and we
want to encourage other folks to use it. But we currently make it difficult
to do so since it's locked away in the experimental API.

The API itself is really straightforward and I think it's fine to commit to
maintaining support / compatibility for this API even if in the future the
underlying implementation may continue to evolve.

Note that this commit changes its enum name and also its numeric value. Users
who respected the instructions of using the experimental API should be fine
with both of these changes since they should only have referred to it by the.

Conceivably someone could have done bad feature detection of this capability
by doing `#ifdef ZSTD_c_targetCBlockSize` which will now return false since
it's no longer a macro... but I think that's an acceptable hypothetical
breakage.
lib/zstd.h