Fix #2369 by documenting decompression behavior.

fix #2369