[xiph-commits] r12939 - trunk/vorbis/doc

[lu_zero at svn.xiph.org]

Author: lu_zero
Date: 2007-05-11 02:50:23 -0700 (Fri, 11 May 2007)
New Revision: 12939

Modified:
   trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.txt
   trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.xml
Log:
First rephrase of the new header packing procedure, more pending

Modified: trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.txt
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.txt	2007-05-10 02:48:29 UTC (rev 12938)
+++ trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.txt	2007-05-11 09:50:23 UTC (rev 12939)
@@ -462,19 +462,20 @@
 3.1.1.  Packed Configuration
 
    A Vorbis Packed Configuration is indicated with the Vorbis Data Type
-   field set to 1.  Of the three headers, defined in the Vorbis I
+   field set to 1.  Of the three headers defined in the Vorbis I
    specification [12], the identification and the setup MUST be packed
-   together as they are, while the comment header MAY be replaced with a
-   dummy one.  The packed configuration follows a generic way to store
-   xiph codec configurations: The first field stores the number of
+   as they are, while the comment header MAY be replaced with a dummy
+   one.  The packed configuration follows a generic way to store xiph
+   codec configurations: The first field stores the number of the
    following packets minus one (count field), the next ones represent
    the size of the headers (length fields), the headers immediately
    follow the list of length fields.  The size of the last header is
    implicit.  The count and the length fields are encoded using the
    following logic: the most significant bit in the octect is used as
    mark, if set to 1 the value continues in the next byte; the other 7
-   bits are used to store the value.  The headers are packed in the same
-   order they are present in ogg: identification, comment, setup.
+   bits are used to store the value.  The bytes are in network order.
+   The headers are packed in the same order they are present in ogg:
+   identification, comment, setup.
 
 
 
@@ -499,7 +500,6 @@
 
 
 
-
 Barbato                 Expires November 5, 2007                [Page 9]
 
 Internet-Draft        draft-ietf-avt-rtp-vorbis-04              May 2007

Modified: trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.xml
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.xml	2007-05-10 02:48:29 UTC (rev 12938)
+++ trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.xml	2007-05-11 09:50:23 UTC (rev 12939)
@@ -436,10 +436,10 @@
 
 <t>
 A Vorbis Packed Configuration is indicated with the Vorbis Data Type field set
-to 1. Of the three headers, defined in the
+to 1. Of the three headers defined in the
 <xref target="vorbis-spec-ref">Vorbis I specification</xref>, the
-identification and the setup MUST be packed together as they are, while the comment header MAY be replaced with a dummy one. The packed configuration follows a generic way to store xiph codec configurations: The first field stores the number of following packets minus one (count field), the next ones represent the size of the headers (length fields), the headers immediately follow the list of length fields. The size of the last header is implicit.
-The count and the length fields are encoded using the following logic: the most significant bit in the octect is used as mark, if set to 1 the value continues in the next byte; the other 7 bits are used to store the value.
+identification and the setup MUST be packed as they are, while the comment header MAY be replaced with a dummy one. The packed configuration follows a generic way to store xiph codec configurations: The first field stores the number of the following packets minus one (count field), the next ones represent the size of the headers (length fields), the headers immediately follow the list of length fields. The size of the last header is implicit.
+The count and the length fields are encoded using the following logic: the most significant bit in the octect is used as mark, if set to 1 the value continues in the next byte; the other 7 bits are used to store the value. The bytes are in network order. 
 The headers are packed in the same order they are present in ogg: identification, comment, setup.</t>
 
 <figure anchor="Packed Configuration Figure" title="Packed Configuration Figure">