[xiph-commits] r3273 - standards

[conrad at svn.annodex.net]

Author: conrad
Date: 2007-11-12 00:08:22 -0800 (Mon, 12 Nov 2007)
New Revision: 3273

Modified:
   standards/draft-pfeiffer-cmml-current.xml
Log:
minor grammatical changes, and fixes for xml2rfc errors


Modified: standards/draft-pfeiffer-cmml-current.xml
===================================================================
--- standards/draft-pfeiffer-cmml-current.xml	2007-11-08 07:36:47 UTC (rev 3272)
+++ standards/draft-pfeiffer-cmml-current.xml	2007-11-12 08:08:22 UTC (rev 3273)
@@ -1,3 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
+
 <!-- Todos: -->
 <!-- * move to XML schema -->
 <!-- * sort out how to combine with other XML modules -->
@@ -3,6 +6,4 @@
 <!-- * sort out style sheets -->
 
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
 
 <?rfc toc="yes"?>
@@ -112,27 +113,27 @@
       Therefore, format of the CMML derives much from XHTML.
       </t>
 
-      <t>CMML allows to attach free-text annotations, metadata, captions
-      and other textual information to clips of time-continuous data,
-      thus enabling a timed textual representation of the data, which
+      <t>CMML allows the attachment of free-text annotations, metadata,
+      captions and other textual information to clips of time-continuous
+      data. This provides a timed, textual representation of the data that
       can be indexed by Web search engines.
       </t>
 
-      <t>CMML also allows to attach a hyperlink to clips of
+      <t>CMML also allows the attachment of a hyperlink to each clip of
       time-continuous data, enabling Web search engines to crawl the
-      content. This also enables users to surf seamlessly between
+      content. This also allows users to surf seamlessly between
       time-continuous data and other Web resources, integrating clips
       of media into the browsing history of a Web browser.
       </t>
 
-      <t>CMML also allows to attach a representative image to clips
-      of time-continuous data, providing for a visual representation
-      of the clip in conjunction with the textual representation as,
-      for example, in the presentation of search results or in a
-      table of clips.
+      <t>CMML also provides a way of referencing a representative image
+      for each clip of time-continuous data, providing a visual representation
+      of the clip in conjunction with the textual representation. The
+      expected usage scenario for this is in the presentation of search
+      results or in a table of clips.
       </t>
 
-      <t>CMML provides for a "head" element to store information that
+      <t>CMML provides a "head" element to store information that
       concerns the complete time-continous resource, and a set of "clip"
       elements that each store information for a temporal subpart of the
       resource.
@@ -146,7 +147,7 @@
       </t>
       
       <t>CMML has also been designed as an authoring language for
-      Annodex bitstreams. It allows to describe the time-continuous
+      Annodex bitstreams. It allows the description of time-continuous
       data bitstream(s) that need to be multiplexed together to create
       an Annodex bitstream. This information is stored in the "stream"
       element of a CMML document. Such a document can be used to control
@@ -1098,7 +1099,7 @@
       <!--*************-->
       <section title="The 'img' element">
 	
-	<t>The "img" element specifies a link to a representative
+	<t>The "img" element specifies the URI of a representative
 	image for the clip.  This image should be quite small as it is
 	the representative image (known as "keyframe") for the current
 	clip. This image may be used to visually summarise the content
@@ -1440,7 +1441,7 @@
         </list>
 
         <t>The default granule rate for CMML is: 1/1000. The default
-        granule shift used is 32, which halfs the granule position to
+        granule shift used is 32, which halves the granule position to
         allow for the backwards pointer.
         </t>
 
@@ -1838,7 +1839,7 @@
       </t>
 
       <t>Additional information:</t>
-      <list style="none">
+      <list>
 	<t>Magic numbers: none. However, CMML files start with the XML
 	preamble as any <xref target="text/xml">XML document</xref>
 	and will also have the string <![CDATA['<cmml']]> near the
@@ -2756,4 +2757,4 @@
     
     
   </back>
-</rfc>
\ No newline at end of file
+</rfc>