aboutsummaryrefslogtreecommitdiffstats
path: root/erts/doc
diff options
context:
space:
mode:
authorSverker Eriksson <[email protected]>2017-03-06 13:25:01 +0100
committerSverker Eriksson <[email protected]>2017-03-06 13:25:01 +0100
commitedfdd488e5da5907313cbf9f0a0539c53b9864e6 (patch)
treed1ab6133f12e6a96570bc0426833c1d852d03e61 /erts/doc
parent5f6c8a4554d2b2b78af4c13587ff964d90b0881e (diff)
parent1b3b07e78580435477eec4d8558e91167b7c03aa (diff)
downloadotp-edfdd488e5da5907313cbf9f0a0539c53b9864e6.tar.gz
otp-edfdd488e5da5907313cbf9f0a0539c53b9864e6.tar.bz2
otp-edfdd488e5da5907313cbf9f0a0539c53b9864e6.zip
Merge branch 'sverker/zlib-option-8/ERL-362/OTP-14254' into maint
Diffstat (limited to 'erts/doc')
-rw-r--r--erts/doc/src/zlib.xml9
1 files changed, 9 insertions, 0 deletions
diff --git a/erts/doc/src/zlib.xml b/erts/doc/src/zlib.xml
index 138414a880..583d21ad7b 100644
--- a/erts/doc/src/zlib.xml
+++ b/erts/doc/src/zlib.xml
@@ -315,6 +315,15 @@ list_to_binary([B1,B2])</pre>
<c><anno>WindowBits</anno></c> value suppresses the zlib header
(and checksum) from the stream. Notice that the zlib source
mentions this only as a undocumented feature.</p>
+ <warning>
+ <p>Due to a known bug in zlib, <c>WindowsBits</c> values 8 and -8
+ do not work as expected. In zlib versions before 1.2.9 values
+ 8 and -8 are automatically changed to 9 and -9. <em>From zlib version 1.2.9
+ value -8 is rejected</em> causing <c>zlib:deflateInit/6</c> to fail
+ (8 is still changed to 9). It also seem possible that future versions
+ of zlib may fix this bug and start accepting 8 and -8 as is.</p>
+ <p>Conclusion: Avoid values 8 and -8 unless you know your zlib version supports them.</p>
+ </warning>
</item>
<tag><c><anno>MemLevel</anno></c></tag>
<item>