- * ogg_get_file_info() calls this function for each of the three
- * header packets. If this callback returns a negative value, the
- * audio file is considered invalid and the chunk table is not
- * created. If it returns zero, the end of the header has been
- * reached and no further ogg packets should be processed.
- */
+ * ogg_get_file_info() calls this function for the first three ogg
+ * packets, or until the callback returns a non-positive value. If it
+ * returns negative, the audio file was not recognized by the audio
+ * format handler. If it returns zero, the audio file is considered
+ * valid, and no further processing by the callback is needed. In this
+ * case the header chunk, i.e. chunk number zero, is defined as the
+ * concatenation of all packets that have been processed by the
+ * callback.
+ */