From b8ec4b0fd6d32a9934cc8f9631e3a11974f7177b Mon Sep 17 00:00:00 2001 From: Yann Collet Date: Tue, 9 Jul 2019 11:43:59 -0700 Subject: [PATCH] updated version number (to v1.4.1) also : added doc on context re-use, as suggested by @scherepanov at #1676 --- doc/zstd_manual.html | 13 +++++++++---- lib/zstd.h | 11 ++++++++--- programs/zstd.1 | 6 +++++- programs/zstdgrep.1 | 2 +- programs/zstdless.1 | 2 +- 5 files changed, 24 insertions(+), 10 deletions(-) diff --git a/doc/zstd_manual.html b/doc/zstd_manual.html index c38c1f60..f2811200 100644 --- a/doc/zstd_manual.html +++ b/doc/zstd_manual.html @@ -1,10 +1,10 @@ -zstd 1.4.0 Manual +zstd 1.4.1 Manual -

zstd 1.4.0 Manual

+

zstd 1.4.1 Manual


Contents

    @@ -141,9 +141,14 @@ int ZSTD_maxCLevel(void); /*!< maximum compression lev

    Explicit context

    
     
     

    Compression context

      When compressing many times,
    -  it is recommended to allocate a context just once, and re-use it for each successive compression operation.
    +  it is recommended to allocate a context just once,
    +  and re-use it for each successive compression operation.
       This will make workload friendlier for system's memory.
    -  Use one context per thread for parallel execution in multi-threaded environments. 
    +  Note : re-using context is just a speed / resource optimization.
    +         It doesn't change the compression ratio, which remains identical.
    +  Note 2 : In multi-threaded environments,
    +         use one different context per thread for parallel execution.
    + 
     
    typedef struct ZSTD_CCtx_s ZSTD_CCtx;
     ZSTD_CCtx* ZSTD_createCCtx(void);
     size_t     ZSTD_freeCCtx(ZSTD_CCtx* cctx);
    diff --git a/lib/zstd.h b/lib/zstd.h
    index 922a2dfe..a1910ee2 100644
    --- a/lib/zstd.h
    +++ b/lib/zstd.h
    @@ -71,7 +71,7 @@ extern "C" {
     /*------   Version   ------*/
     #define ZSTD_VERSION_MAJOR    1
     #define ZSTD_VERSION_MINOR    4
    -#define ZSTD_VERSION_RELEASE  0
    +#define ZSTD_VERSION_RELEASE  1
     
     #define ZSTD_VERSION_NUMBER  (ZSTD_VERSION_MAJOR *100*100 + ZSTD_VERSION_MINOR *100 + ZSTD_VERSION_RELEASE)
     ZSTDLIB_API unsigned ZSTD_versionNumber(void);   /**< to check runtime library version */
    @@ -183,9 +183,14 @@ ZSTDLIB_API int         ZSTD_maxCLevel(void);               /*!< maximum compres
     ***************************************/
     /*= Compression context
      *  When compressing many times,
    - *  it is recommended to allocate a context just once, and re-use it for each successive compression operation.
    + *  it is recommended to allocate a context just once,
    + *  and re-use it for each successive compression operation.
      *  This will make workload friendlier for system's memory.
    - *  Use one context per thread for parallel execution in multi-threaded environments. */
    + *  Note : re-using context is just a speed / resource optimization.
    + *         It doesn't change the compression ratio, which remains identical.
    + *  Note 2 : In multi-threaded environments,
    + *         use one different context per thread for parallel execution.
    + */
     typedef struct ZSTD_CCtx_s ZSTD_CCtx;
     ZSTDLIB_API ZSTD_CCtx* ZSTD_createCCtx(void);
     ZSTDLIB_API size_t     ZSTD_freeCCtx(ZSTD_CCtx* cctx);
    diff --git a/programs/zstd.1 b/programs/zstd.1
    index cb4e1271..beca9da4 100644
    --- a/programs/zstd.1
    +++ b/programs/zstd.1
    @@ -1,5 +1,5 @@
     .
    -.TH "ZSTD" "1" "December 2018" "zstd 1.3.8" "User Commands"
    +.TH "ZSTD" "1" "July 2019" "zstd 1.4.1" "User Commands"
     .
     .SH "NAME"
     \fBzstd\fR \- zstd, zstdmt, unzstd, zstdcat \- Compress or decompress \.zst files
    @@ -187,6 +187,10 @@ verbose mode
     suppress warnings, interactivity, and notifications\. specify twice to suppress errors too\.
     .
     .TP
    +\fB\-\-no\-progress\fR
    +do not display the progress bar, but keep all other messages\.
    +.
    +.TP
     \fB\-C\fR, \fB\-\-[no\-]check\fR
     add integrity check computed from uncompressed data (default: enabled)
     .
    diff --git a/programs/zstdgrep.1 b/programs/zstdgrep.1
    index 57bc14de..d0a02922 100644
    --- a/programs/zstdgrep.1
    +++ b/programs/zstdgrep.1
    @@ -1,5 +1,5 @@
     .
    -.TH "ZSTDGREP" "1" "December 2018" "zstd 1.3.8" "User Commands"
    +.TH "ZSTDGREP" "1" "July 2019" "zstd 1.4.1" "User Commands"
     .
     .SH "NAME"
     \fBzstdgrep\fR \- print lines matching a pattern in zstandard\-compressed files
    diff --git a/programs/zstdless.1 b/programs/zstdless.1
    index ff39742b..4e21d5a9 100644
    --- a/programs/zstdless.1
    +++ b/programs/zstdless.1
    @@ -1,5 +1,5 @@
     .
    -.TH "ZSTDLESS" "1" "December 2018" "zstd 1.3.8" "User Commands"
    +.TH "ZSTDLESS" "1" "July 2019" "zstd 1.4.1" "User Commands"
     .
     .SH "NAME"
     \fBzstdless\fR \- view zstandard\-compressed files