Merge pull request #21 from darobin/patch-1

Clarify that the end() callback is different from the end of the stream

Author: thejoshwolfe

README.md

@@ -153,7 +153,9 @@ See `addFile()` for the meaning of `mtime` and `mode`.
 #### end([finalSizeCallback])
 
 Indicates that no more files will be added via `addFile()`, `addReadStream()`, or `addBuffer()`.
-Some time after calling this function, `outputStream` will be ended.
+Some time after calling this function, `outputStream` will be ended. Note that this entails that you cannot rely on this
+callback to know when you are done producing output. If for instance you are creating a zip archive on disk, you will need
+to listen to the `end` event on the `outputStream` before notifying consumers of that file.
 
 If specified and non-null, `finalSizeCallback` is given the parameters `(finalSize)`
 sometime during or after the call to `end()`.