[libzstd] Fix return value docs for ZSTD_compressStream2()

This commit is contained in:
Nick Terrell 2019-04-05 17:44:07 -07:00
parent a63aaaa2cc
commit ce388fe4d2

View File

@ -577,10 +577,8 @@ typedef struct ZSTD_outBuffer_s {
* The caller must check if input has been entirely consumed. * The caller must check if input has been entirely consumed.
* If not, the caller must make some room to receive more compressed data, * If not, the caller must make some room to receive more compressed data,
* and then present again remaining input data. * and then present again remaining input data.
* @return : a size hint, preferred nb of bytes to use as input for next function call * @return : provides a minimum amount of data remaining to be flushed from internal buffers
* or an error code, which can be tested using ZSTD_isError(). * or an error code, which can be tested using ZSTD_isError().
* Note 1 : it's just a hint, to help latency a little, any value will work fine.
* Note 2 : size hint is guaranteed to be <= ZSTD_CStreamInSize()
* *
* At any moment, it's possible to flush whatever data might remain stuck within internal buffer, * At any moment, it's possible to flush whatever data might remain stuck within internal buffer,
* using ZSTD_compressStream2() with ZSTD_e_flush. `output->pos` will be updated. * using ZSTD_compressStream2() with ZSTD_e_flush. `output->pos` will be updated.