Comments clarifications

Author: bangnoise

external/hap/hap.c

@@ -585,6 +585,9 @@ unsigned int HapDecode(const void *inputBuffer, unsigned long inputBufferBytes,
 
             if (result == HapResult_No_Error)
             {
+                /*
+                 Perform decompression
+                 */
                 bytesUsed = running_uncompressed_chunk_size;
 
                 callback((HapDecodeWorkFunction)hap_decode_chunk, chunk_info, chunk_count, info);
@@ -647,7 +650,7 @@ unsigned int HapDecode(const void *inputBuffer, unsigned long inputBufferBytes,
         return HapResult_Bad_Frame;
     }
     /*
-     Fill out the remaining return values
+     Fill out the remaining return value
      */
     if (outputBufferBytesUsed != NULL)
     {

external/hap/hap.h

@@ -68,7 +68,7 @@ unsigned long HapMaxEncodedLength(unsigned long inputBytes);
 
 /*
  Encodes inputBuffer which is a buffer containing texture data of format textureFormat, or returns an error.
- Use HapMaxEncodedLength() to discover the minimal value for outputBufferBytes
+ Use HapMaxEncodedLength() to discover the minimal value for outputBufferBytes.
  If this returns HapResult_No_Error and outputBufferBytesUsed is not NULL then outputBufferBytesUsed will be set
  to the actual encoded length of the output buffer.
  */
@@ -77,10 +77,12 @@ unsigned int HapEncode(const void *inputBuffer, unsigned long inputBufferBytes,
                        unsigned long *outputBufferBytesUsed);
 
 /*
- Decodes inputBuffer which is a Hap frame. If the frame permits multithreaded decoding, callback will be called
- once for you to invoke a platform-appropriate mechanism to assign work to threads, and trigger that work by calling
- the function passed to your callback the number of times indicated by the count argument, usually from a number
- of different threads.
+ Decodes inputBuffer which is a Hap frame.
+
+ If the frame permits multithreaded decoding, callback will be called once for you to invoke a platform-appropriate
+ mechanism to assign work to threads, and trigger that work by calling the function passed to your callback the number
+ of times indicated by the count argument, usually from a number of different threads. This callback must not return
+ until all the work has been completed.
 
  void MyHapDecodeCallback(HapDecodeWorkFunction function, void *p, unsigned int count, void *info)
  {