From: Andre Noll <maan@systemlinux.org>
Date: Sun, 15 Dec 2013 22:37:45 +0000 (+0100)
Subject: ogg_afh: Add a comment about the three vorbis header packets.
X-Git-Tag: v0.5.4~1^2~2
X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=commitdiff_plain;h=901f3308d7868a546bee4cdf9449a283793569b4

ogg_afh: Add a comment about the three vorbis header packets.

With this information at hand, it's easier to understand how the
vorbis packet callback works.
---

diff --git a/ogg_afh.c b/ogg_afh.c
index 1e389d9e..9dfb028d 100644
--- a/ogg_afh.c
+++ b/ogg_afh.c
@@ -20,6 +20,20 @@ struct private_vorbis_data {
 	vorbis_comment vc;
 };
 
+/*
+ * Vorbis uses three header packets, all of which are required: the
+ * identification header, the comments header, and the setup header.
+ *
+ * The identification header identifies the bitstream as Vorbis. It contains
+ * the Vorbis version and simple audio characteristics of the stream such as
+ * sample rate and number of channels.
+ *
+ * The comment header includes user text comments (tags) and a vendor string
+ * for the application/library that produced the bitstream.
+ *
+ * The setup header includes extensive CODEC setup information as well as the
+ * complete VQ and Huffman codebooks needed for decoding.
+ */
 static int vorbis_packet_callback(ogg_packet *packet, int packet_num,
 		__a_unused int serial, struct afh_info *afhi, void *private_data)
 {