[xiph-cvs] cvs commit: vorbis/doc v-comment.html
Ralph Giles
giles at xiph.org
Fri Jan 19 14:24:57 PST 2001
giles 01/01/19 14:24:57
Modified: doc v-comment.html
Log:
minor comment doc cleanups
Revision Changes Path
1.3 +6 -11 vorbis/doc/v-comment.html
Index: v-comment.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/v-comment.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- v-comment.html 2000/10/22 08:01:54 1.2
+++ v-comment.html 2001/01/19 22:24:56 1.3
@@ -7,7 +7,7 @@
Ogg Vorbis comment field specification
</font></h1>
-Last update to this document: June 16, 2000</em><p>
+Last update to this document: January 19, 2001</em><p>
The text comment header is the second (of three) header packets that
begin a Vorbis bitstream. It is meant for short, text comments,
@@ -16,7 +16,6 @@
<h2>Comment use rationale</h2>
-
The comment field is meant to be used much like someone jotting a
quick note on the bottom of a CDR. It should be a little information to
remember the disc by and explain it to others; a short, to-the-point
@@ -37,7 +36,7 @@
is not null terminated. In addition to the vector list, there is a
single vector for vendor name (also 8 bit clean, length encoded in 32
bits). Libvorbis currently sets the vendor string to "Xiphophorus
-libVorbis I 20000508".<p>
+libVorbis I 20010119".<p>
The comment vectors are structured similarly to a UNIX environment.
That is, comment fields consist of a field name and a field value and
@@ -72,7 +71,8 @@
<dl>
<dt>TITLE<dd>Track name
-<dt>VERSION<dd>The version field may be used to differentiate multiple version of the same track title in a single collection.
+<dt>VERSION<dd>The version field may be used to differentiate multiple
+version of the same track title in a single collection. (e.g. remix info)
<dt>ALBUM<dd>The collection name to which this track belongs
@@ -80,7 +80,7 @@
<dt>ARTIST<dd>Track performer
-<dt>ORGANIZATION<dd>Name of the organization producing the track (ie,
+<dt>ORGANIZATION<dd>Name of the organization producing the track (i.e.
the 'record label')
<dt>DESCRIPTION<dd>A short text description of the contents
@@ -116,7 +116,7 @@
<li>
Field names are not required to be unique (occur once) within a
comment header. As an example, assume a track was recorded by three
-well know artists; the following is permissible:
+well know artists; the following is permissible, and encouraged:
<pre>
ARTIST=Dizzy Gillespie
ARTIST=Sonny Rollins
@@ -188,9 +188,4 @@
copyright (C) 1994-2000 Xiphophorus. All rights reserved.<p>
</body>
-
-
-
-
-
--- >8 ----
List archives: http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'cvs-request at xiph.org'
containing only the word 'unsubscribe' in the body. No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.
More information about the commits
mailing list