1 files changed, 6 insertions, 2 deletions
diff --git a/src/compress.h b/src/compress.h
index cfb2487..e885231 100644
--- a/src/compress.h
+++ b/src/compress.h
@@ -21,9 +21,13 @@
 
 #include "io.h"
 
-/* Inflates `s` into a newly allocated stream structure. */
+/* Inflates `len` bytes from the current position of `s` to a new stream
+   structure of size `decompressed_len` bytes. Stream inflation will not
+   work if `decompressed_len` does not represent the actual size of the
+   original data. */
 struct stream *stream_inflate(struct stream *s, size_t len,
                               size_t decompressed_len);
 
-/* Deflates `s` into a newly allocated stream structure. */
+/* Deflates `len` bytes from the current position of `s` to a new stream
+   structure, where the `len` member represents the decompressed size. */
 struct stream *stream_deflate(struct stream *s, size_t len);