Fix #2369 by documenting decompression behavior.
Merge pull request #2470 from metalivedev/2369-docuncompress

Documenting decompression behavior.