Document explicitly that the comment header uses little endian integers
authorRalph Giles <giles@xiph.org>
Sun, 6 Jul 2008 18:02:04 +0000 (18:02 +0000)
committerRalph Giles <giles@xiph.org>
Sun, 6 Jul 2008 18:02:04 +0000 (18:02 +0000)
for the the benefit of those reading the comment spec in isolation.

svn path=/trunk/vorbis/; revision=15099

doc/xml/05-comment.xml

index 32bf758bf6d29db40af69316b2e163da755679f4..932921c3b95a1b4e33d8238f21965cef1c660d6a 100644 (file)
@@ -50,6 +50,12 @@ list, there is a single vector for vendor name (also 8 bit clean,
 length encoded in 32 bits). For example, the 1.0 release of libvorbis 
 set the vendor string to "Xiph.Org libVorbis I 20020717".</para>
 
+<para>
+The vector lengths and number of vectors are stored lsb first, according 
+to the bit packing conventions of the vorbis codec. However, since data 
+in the comment header is octet-aligned, they can simply be read as 
+unaligned 32 bit little endian unsigned integers.
 <para>The comment header is decoded as follows:
 
 <programlisting>