Add more documentation about the C compressor maximum output buffer for flush.

Add more documentation about the C compressor maximum output buffer for flush. #637