Document explicitly that the comment header uses little endian integers

for the the benefit of those reading the comment spec in isolation.

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

diff --git a/doc/xml/05-comment.xml b/doc/xml/05-comment.xml
index 32bf758..932921c 100644 (file)
--- a/doc/xml/05-comment.xml
+++ b/doc/xml/05-comment.xml
@@ -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>