aboutsummaryrefslogtreecommitdiff
path: root/src/liblzma
diff options
context:
space:
mode:
authorJia Tan <jiat0218@gmail.com>2023-02-24 23:46:23 +0800
committerJia Tan <jiat0218@gmail.com>2023-03-01 21:42:31 +0800
commitf1ab1f6b339d16a53ac53efeb97779ecd2bae70f (patch)
tree3b1dbec9abc4c68e58f7259c41849bc0df939c05 /src/liblzma
parentCMake: Require that the C compiler supports C99 or a newer standard. (diff)
downloadxz-f1ab1f6b339d16a53ac53efeb97779ecd2bae70f.tar.xz
liblzma: Clarify lzma_lzma_preset() documentation in lzma12.h.
lzma_lzma_preset() does not guarentee that the lzma_options_lzma are usable in an encoder even if it returns false (success). If liblzma is built with default configurations, then the options will always be usable. However if the match finders hc3, hc4, or bt4 are disabled, then the options may not be usable depending on the preset level requested. The documentation was updated to reflect this complexity, since this behavior was unclear before.
Diffstat (limited to 'src/liblzma')
-rw-r--r--src/liblzma/api/lzma/lzma12.h5
1 files changed, 5 insertions, 0 deletions
diff --git a/src/liblzma/api/lzma/lzma12.h b/src/liblzma/api/lzma/lzma12.h
index 3d3723f9..e7d00fcc 100644
--- a/src/liblzma/api/lzma/lzma12.h
+++ b/src/liblzma/api/lzma/lzma12.h
@@ -555,6 +555,11 @@ do { \
* This function is available only if LZMA1 or LZMA2 encoder has been enabled
* when building liblzma.
*
+ * If features (like certain match finders) have been disabled at build time,
+ * then the function may return success (false) even though the resulting
+ * LZMA1/LZMA2 options may not be usable for encoder initialization
+ * (LZMA_OPTIONS_ERROR).
+ *
* \param[out] options Pointer to LZMA1 or LZMA2 options to be filled
* \param preset Preset level bitwse-ORed with preset flags
*