From: Mark Adler <madler@alumni.caltech.edu>
Date: Tue, 9 Jan 2018 02:16:05 +0000 (-0800)
Subject: Emphasize the need to continue decompressing gzip members.
X-Git-Tag: 1.9.9-b1~591
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=463f9e15e191f14f45c3723679d931af1b51412a;p=thirdparty%2Fzlib-ng.git

Emphasize the need to continue decompressing gzip members.
---

diff --git a/zlib.h b/zlib.h
index 49da9aed3..c7b7bf67a 100644
--- a/zlib.h
+++ b/zlib.h
@@ -847,9 +847,11 @@ ZEXTERN int ZEXPORT inflateInit2(z_stream *strm, int  windowBits);
    detection, or add 16 to decode only the gzip format (the zlib format will
    return a Z_DATA_ERROR).  If a gzip stream is being decoded, strm->adler is a
    CRC-32 instead of an Adler-32.  Unlike the gunzip utility and gzread() (see
-   below), inflate() will not automatically decode concatenated gzip streams.
-   inflate() will return Z_STREAM_END at the end of the gzip stream.  The state
-   would need to be reset to continue decoding a subsequent gzip stream.
+   below), inflate() will *not* automatically decode concatenated gzip members.
+   inflate() will return Z_STREAM_END at the end of the gzip member.  The state
+   would need to be reset to continue decoding a subsequent gzip member.  This
+   *must* be done if there is more data after a gzip member, in order for the
+   decompression to be compliant with the gzip standard (RFC 1952).
 
      inflateInit2 returns Z_OK if success, Z_MEM_ERROR if there was not enough
    memory, Z_VERSION_ERROR if the zlib library version is incompatible with the