Changeset 1183

Show
Ignore:
Timestamp:
2005-03-29 02:59:21 (4 years ago)
Author:
silvia
Message:

Fixed CMML version 2.1

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • standards/cmml_2_1.dtd

    r1128 r1183  
    290290                [NOT INCLUDED IN ANNODEXED DOCUMENT] --> 
    291291 
    292 XXX FIX THIS CONTENT MODEL XXX 
    293292<!ELEMENT clip (meta*, a?, img?, desc?)> 
    294293<!ATTLIST clip 

  • standards/draft-pfeiffer-cmml-03.xml

    r1156 r1183  
    151151      <t>The following picture illustrates the multiplexing activity 
    152152      schematically; in reality, the stream tag is not preserved in its 
    153       original form and some attributes are also made irrelevant during 
    154       multiplexing. Details of how CMML markup is encoded in an 
     153      original form and some attribute values are also encoded in the binary 
     154      data. Details of how CMML markup is encoded in an 
    155155      Annodex bitstream are given later in this document. 
    156156      </t> 
    …… 
    223223      </section> 
    224224 
    225       <section title="URIs"> 
     225      <section title="LinkTypes"> 
     226        <t>"LinkTypes" specifies a space-separated list of the types of 
     227        relationships a linked, i.e. related, document has to the current 
     228        one. As in XHTML, user agents, search engines, etc. may interpret 
     229        these link types in a variety of ways. For example, user agents  
     230        may provide access to linked documents through a navigation bar. 
     231        Authors may use the following recognized link types which are a 
     232        superset of the ones used for XHTML/HTML: 
     233          <list style="symbols"> 
     234            <t>edit: Refers to a document that allows editing the resource. 
     235               This enables a document author to allow others to edit 
     236               the CMML which is the basis for an Annodex resource. 
     237            </t> 
     238            <t>alternate: Designates substitute versions for the document 
     239               in which the link occurs. When used together with the media 
     240               attribute, it implies a version designed for a different  
     241               medium (or media). 
     242            </t> 
     243            <t>stylesheet: Refers to an external style sheet. 
     244            </t> 
     245            <t>start: Refers to the first document in a collection of  
     246               documents. This link type tells search engines which document 
     247               is considered by the author to be the starting point of the 
     248               collection. 
     249            </t> 
     250            <t>next: Refers to the next document in a linear sequence of 
     251               documents. User agents may choose to pre-load the "next"  
     252               document, to reduce the perceived load time. 
     253            </t> 
     254            <t>prev: Refers to the previous document in an ordered series of 
     255               documents. 
     256            </t>                 
     257            <t>contents: Refers to a document serving as a table of contents. 
     258               Although this may seem strange in a CMML file, it makes sense 
     259               in an Annodex file and may simply refer back to the CMML file 
     260               or to a HTML page that provides similar information. 
     261            </t> 
     262            <t>index: Refers to a document providing an index for the current 
     263               document. 
     264            </t> 
     265            <t>glossary: Refers to a document providing a glossary of terms  
     266               that pertain to the current document. 
     267            </t> 
     268            <t>copyright: Refers to a copyright statement for the current 
     269               document. While this could also be given in the meta tags, 
     270               this could refer to a formatted, legal document. 
     271            </t> 
     272            <t>chapter: Refers to a document serving as a chapter in a  
     273               collection of documents. 
     274            </t> 
     275            <t>section: Refers to a document serving as a section in a  
     276               collection of documents. 
     277            </t> 
     278            <t>subsection: Refers to a document serving as a subsection in a  
     279               collection of documents. 
     280            </t> 
     281            <t>appendix: Refers to a document serving as an appendix in a  
     282               collection of documents. 
     283            </t> 
     284            <t>help: Refers to a document offering help (more information,  
     285               links to other sources information, etc.) 
     286            </t> 
     287            <t>bookmark: Refers to a bookmark. A bookmark is a link to a key 
     288               entry point within an extended document. The title attribute may 
     289               be used, for example, to label the bookmark. Note that several 
     290               bookmarks may be defined in each document. 
     291            </t> 
     292          </list>  
     293        </t> 
     294      </section> 
     295 
     296      <section title="MediaDesc"> 
     297        <t>A "MediaDesc" describes one or several types of devices for  
     298        which the given style is appropriate. It is given as a list of 
     299        comma-separated media descriptors. Which devices are supported 
     300        will need to be specified in a separate style sheet specification. 
     301        The following set of device types, adapted from XHTML/HTML 
     302        in CSS1, are recognized: 
     303          <list style="symbols"> 
     304            <t>all: suitable for all devices. 
     305            </t> 
     306            <t>aural: suitable for speech synthesizers. 
     307            </t> 
     308            <t>braille: intended for braille tactile feedback devices. 
     309            </t> 
     310            <t>embossed: intended for paged braille printers. 
     311            </t> 
     312            <t>handheld: intended for handheld devices (characterized 
     313            by a small, monochrome or colour display and limited bandwidth). 
     314            </t> 
     315            <t>print: intended for paged output to a printer or print 
     316            preview on a screen. 
     317            </t> 
     318            <t>projection: intended for projected presentations (projectors 
     319            or print to transparencies). 
     320            </t> 
     321            <t>screen: intended for non-paged, colour computer screens. 
     322            </t> 
     323            <t>tty: intended for fixed-pitch character grid displays (such 
     324            as the teletypes or terminals). 
     325            </t> 
     326            <t>tv: for television-type devices with low resolution and 
     327            limited scrollability. 
     328            </t> 
     329          </list>  
     330        </t> 
     331      </section> 
     332 
     333      <section title="Text"> 
     334        <t>A "Text" describes a short, free form text being used for 
     335        the "title" attribute. 
     336        </t> 
     337      </section> 
     338 
     339      <section title="URI"> 
    226340        <t>A "URI" is a character string that conforms to the 
    227341        specification of the Uniform Resource Identifier as defined in 
    …… 
    274388        </t> 
    275389         
     390      </section> 
     391 
     392      <section title="Core Attributes"> 
     393        <t>To cluster together the attributes that are common to 
     394        most displayable elements, the "attrs" entity draws them together. 
     395        As "i18n" is already a cluster, a "coreattrs" entity is defined, 
     396        which groups together the other commonly used attributes for 
     397        displayable elements, namely the unique identifier given in "id", 
     398        the "class" attribute which provides a space-separated list of  
     399        style sheet classes that the element belongs to, and the "title"  
     400        attribute, which provides a short tooltip-like description  
     401        for an element. 
     402        </t> 
    276403      </section> 
    277404 
    …… 
    298425      </figure> 
    299426 
    300       <t>The attribute "standalone" is set to "yes" when the only DTD 
    301       that is used for the instance document is cmml.dtd. The encoding 
    302       format specifies the character encoding that is used for the 
    303       values of the attributes and elements of the CMML file. E.g. for 
    304       languages that are non-latin based, such as most Arab and Asian 
    305       languages, a simple character encoding like US-ASCII does not 
    306       cover all the characters. The default "UTF-8" charset can 
    307       accommodate for any and all. 
    308       </t> 
    309        
    310427      <t>After the preamble, the CMML tag follows. A CMML file has a 
    311428      "cmml" tag as the root element. It embraces all the other tags. 
    …… 
    319436  id          ID             #IMPLIED 
    320437  xmlns       %URI;          #FIXED 'http://www.annodex.net/cmml' 
     438  granulerate CDATA          #IMPLIED 
    321439  > 
    322440            ]]></artwork> 
    …… 
    331449      <t>Attributes of the "cmml" element are the usual xml root tag 
    332450      attributes: the internationalisation attributes "lang" and 
    333       "dir", an identifier "id" and a fixed namespace "xmlns". 
     451      "dir", an identifier "id", a fixed namespace "xmlns", and the 
     452      "granulerate". 
    334453      </t> 
    335454 
    …… 
    349468      </t> 
    350469 
     470      <t>The "granulerate" attribute may provide a base temporal resolution for 
     471      the CMML bitstream. This is in particular used for creation of Annodex 
     472      files from a given CMML instance document. 
     473      </t> 
     474 
    351475    </section> 
    352476     
    …… 
    365489      </t> 
    366490 
    367       <t>The "stream" element describes the input time-continuous 
    368       bitstreams that are to be multiplexed together on authoring 
    369       the Annodex bitstreams inthe "import" tags. Its attributes 
     491      <t>The "stream" element describes in the "import" tags the input 
     492      time-continuous bitstreams that are to be multiplexed together on 
     493      authoring the Annodex bitstream. Its attributes 
    370494      describe other features of the Annodex bitstream such as the 
    371495      time mappings for the start of the file. 
    …… 
    377501<!ATTLIST stream 
    378502  id          ID             #IMPLIED 
     503  basetime    %Playbacktime; "0" 
    379504  timebase    %Playbacktime; "0" 
    380505  utc         %UTCtime;      #IMPLIED 
    …… 
    389514      </t> 
    390515 
    391       <t>The "timebase" attribute contains a playback time in seconds 
     516      <t>The "basetime" attribute contains a playback time in seconds 
    392517      associated with the first data packet of the Annodex 
    393518      bitstream. All other times in the CMML file MUST be calculated 
    394       relative to this timebase. For example, a timebase of 300 
     519      relative to this basetime. For example, a basetime of 300 
    395520      seconds npt for a video file implies that the first frame is 
    396521      related to a play time of 300 seconds, and a clip with a start 
    397522      time of 350 seconds is to be included 50 seconds into the 
    398       Annodex bitstream.  If no timebase (or no stream tag) is given, 
    399       the timebase defaults to 0 npt. The timebase can be given as a 
     523      Annodex bitstream.  If no basetime (or no stream tag) is given, 
     524      the basetime defaults to 0 npt. The basetime can be given as a 
    400525      SMPTE or NPT time, or as a rational number as in 5/1300, but 
    401526      not as a utc time. 
    402527      </t> 
    403528 
     529      <t>The "timebase" attribute is retained in CMML 2.1 for backwards 
     530      compatibility, but deprecated. It will disappear with CMML 3.0. 
     531      The "basetime" attribute has precedence over the "timebase" attribute. 
     532      </t> 
     533 
    404534      <t>The "utc" attribute associates a calendar date and a 
    405       wall-clock time with the timebase. It therefore provides a 
    406       mapping of the timebase to a real-world clock time and is given 
     535      wall-clock time with the basetime. It therefore provides a 
     536      mapping of the basetime to a real-world clock time and is given 
    407537      as a UTC time. If it is omitted, the start attribute in the 
    408538      import tag, and the start and end attributes in clip tags MUST 
    …… 
    497627        Annodex bitstream at which the media bitstream will be 
    498628        inserted. This time is specified with respect to the 
    499         "timebase" attribute given in the "stream" element. 
     629        "basetime" attribute given in the "stream" element. 
    500630        </t> 
    501631 
    …… 
    503633        bitstream at which the media bitstream will stop at the 
    504634        latest. This time is also specified with respect to the 
    505         "timebase" attribute given in the "stream" element. This 
     635        "basetime" attribute given in the "stream" element. This 
    506636        attribute is not required when the full bitstream is used. 
    507637        </t> 
    …… 
    571701        <figure> 
    572702          <artwork><![CDATA[ 
    573 <!ELEMENT head (meta*, 
    574                 ((title, meta*, (base, meta*)?) | 
    575                  (base, meta*, (title, meta*)?)))> 
     703<!ENTITY % head.misc "(meta|link)*"> 
     704<!ELEMENT head (%head.misc;, 
     705                ((title, %head.misc;, (base, %head.misc;)?) | 
     706                 (base, %head.misc;, (title, %head.misc;))))> 
    576707<!ATTLIST head 
    577708  %i18n; 
    …… 
    584715      <t>The "head" tag must contain a "title" tag. It may contain one 
    585716      "base" tag before or after the "title" tag and any number of 
    586       "meta" tags at any position. 
     717      "meta" or "link" tags at any position. 
    587718      </t> 
    588719 
    …… 
    700831      </section> 
    701832 
     833      <!--**************--> 
     834      <!-- Link element --> 
     835      <!--**************--> 
     836      <section title="The 'link' element"> 
     837         
     838        <t>The "link" element in the "head" element defines links to a 
     839        related external resource. These resources are often used to augment 
     840        the user agent's ability to process the current document.  
     841        The "link" element is declared as follows: 
     842        </t> 
     843        <figure> 
     844          <artwork><![CDATA[ 
     845<!ELEMENT link EMPTY> 
     846<!ATTLIST link 
     847  %attrs; 
     848  href        %URI;          #IMPLIED 
     849  type        %ContentType;  #IMPLIED 
     850  rel         %LinkTypes;    #IMPLIED 
     851  rev         %LinkTypes;    #IMPLIED 
     852  media       %MediaDesc;    #IMPLIED 
     853  > 
     854            ]]></artwork> 
     855        </figure> 
     856 
     857        <t>The "attrs;" attribute covers the specification of the language 
     858        of the title attribute, a unique identifing name, a reference to a 
     859        style sheet specification, and a title attribute to provide a  
     860        short description of the relationship between the current document 
     861        and the one referred to in the "href" attributed. 
     862        </t> 
     863 
     864        <t>The "href" attribute contains a URI reference to a related 
     865        external resource. These resources are often used to augment 
     866        the user agent's ability to process the current document.  
     867        </t> 
     868 
     869        <t>The "type" attribute contains a media type specification for 
     870        the linked document as per <xref target="ContentType">RFC 2045</xref>, 
     871        e.g. "text/x-css-cmml". 
     872        </t> 
     873 
     874        <t>The "rel" attribute describes the relationship from the 
     875        current document to the resource specified by the href attribute. 
     876        The value of this attribute is a space-separated list of link 
     877        types. 
     878        </t> 
     879 
     880        <t>The "rev" attribute describes a reverse link from the 
     881        resource specified by the href attribute to the current document. 
     882        The value of this attribute is a space-separated list of link types. 
     883        </t> 
     884 
     885        <t>The "media" attribute specifies the intended destination device 
     886        for style information, if the href points to an external style sheet. 
     887        It may be a single media descriptor or a comma-separated list. 
     888        The default value for this attribute is "screen".  
     889        </t> 
     890 
     891      </section> 
     892 
    702893    </section> 
    703894 
    …… 
    721912<!ELEMENT clip (meta*, a?, img?, desc?)> 
    722913<!ATTLIST clip 
    723   %i18n; 
    724   id          ID             #IMPLIED 
     914  %attrs; 
    725915  track       CDATA          "default" 
    726916  start       %Timestamp;    #REQUIRED 
    …… 
    736926      </t> 
    737927         
    738       <t>A "clip" element defines a unique identifying name for the 
    739       clip in its "id" attribute. This name can be used in URIs that 
    740       point either to the CMML file or the Annodex bitstream created 
    741       from it, and allows to point straight at the clip. This may 
    742       either be done as a URI fragment or URI query specification. 
    743       </t> 
    744          
    745       <t>The "%i18n;" attribute specifies the base language for all 
    746       the clip's attribute values and content elements. 
     928      <t>The "%i18n;" attributes part of the "%attrs;" attributes specify 
     929      the base language for all the clip's attribute values and content 
     930      elements. Also, a unique identifying name is specified for the clip 
     931      in the "id" attribute. This name can be used in URIs that point 
     932      either to the CMML file or the Annodex bitstream created from it, 
     933      and allows to point straight at the clip. This may either be done 
     934      as a URI fragment or URI query specification. The "class" attribute 
     935      provides a space-separated list of style sheet classes, and the 
     936      "title" attribute a short tooltip-like clip description. 
    747937      </t> 
    748938 
    …… 
    761951      <t>The "start" and "end" attributes specify the time range 
    762952      during which the clip element is defined. This time range is 
    763       specified with respect to the "timebase" and "utc" attributes 
     953      specified with respect to the "basetime" and "utc" attributes 
    764954      given in the "stream" tag. If the "stream" tag does not contain 
    765955      a "utc" specification, "start" and "end" times are not allowed 
    …… 
    801991<!ELEMENT a (#PCDATA)> 
    802992<!ATTLIST a 
    803   %i18n; 
    804   id          ID             #IMPLIED 
    805   class       CDATA          #IMPLIED 
     993  %attrs; 
    806994  href        %URI;          #REQUIRED 
    807995  > 
    …… 
    809997        </figure> 
    810998 
    811         <t>The internationalisation attributes specify the language of 
    812         the anchor's attribute values and of the anchor text. 
    813         </t> 
    814  
    815         <t>The "class" attribute allows to override style sheet 
    816         defaults for this anchor instance. 
     999        <t>The "attrs" attributes specify internationalisation of 
     1000        the anchor's attribute values and of the anchor text, style 
     1001        sheet class, unique id, and a short, textual description of 
     1002        the hyperlink to be given e.g. in tooltips. 
    8171003        </t> 
    8181004 
    …… 
    8571043<!ELEMENT img EMPTY> 
    8581044<!ATTLIST img 
    859   %i18n; 
    860   id          ID             #IMPLIED 
     1045  %attrs; 
    8611046  src         %URI;          #REQUIRED 
    8621047  alt         CDATA          #IMPLIED 
    …… 
    8651050        </figure> 
    8661051 
    867         <t>The internationalisation attributes specify the language of 
    868         the image's attribute values. 
     1052        <t>The "attrs" attributes specify internationalisation of 
     1053        the image's attribute values, provide an "id" attribute, a 
     1054        short "title" text, and a style sheet "class" for formatting 
     1055        the layout of the image. 
    8691056        </t> 
    8701057 
    …… 
    8951082<!ELEMENT desc  (#PCDATA)> 
    8961083<!ATTLIST desc 
    897   %i18n; 
    898   id        ID    #IMPLIED 
     1084  %attrs; 
    8991085> 
    9001086            ]]></artwork> 
    9011087        </figure> 
    9021088 
    903         <t>For extracting a short text from the "desc" element as 
    904         needs to be displayed in a table of clips or as caption, 
    905         the first few characters of the description will be taken. It 
    906         is therefore recommended to place a short meaningful summary 
    907         sentence at the beginning of the description when authoring 
    908         annotations. 
    909         </t> 
    910  
    9111089        <t>The internationalisation attributes specify the language of 
    912         the text in the description and the "id" attribute a unique 
    913         identifier for the element. 
     1090        the text in the description, the "id" attribute a unique identifier 
     1091        for the element, the "class" attribute a style-sheet mapping, and 
     1092        the "title" attribute a brief description to be displayed in e.g. 
     1093        a table of clips or as caption. 
    9141094        </t> 
    9151095 
    …… 
    9741154 
    9751155  
    976         <t>The fields in an CMML ident header packet have the following 
     1156        <t>The fields in a CMML ident header packet have the following 
    9771157        meaning: 
    9781158        </t> 
    …… 
    11721352          number each. They represent the temporal resolution of the 
    11731353          logical bitstream in Hz given as a rational number in the 
    1174           same way as the fishead timebase field above. 
     1354          same way as the fishead basetime field above. 
    11751355          </t> 
    11761356          <t>Granuleshift: a 1 Byte integer number describing whether to 
    …… 
    12091389 
    12101390        <t>If CMML is encapsulated in Ogg without the skeleton bitstream, 
    1211         it potentially loses time information. The timebase will then be 
     1391        it potentially loses time information. The basetime will then be 
    12121392        mapped always to 0 and utc time mappings cannot be represented. 
    12131393        It also loses all the message header fields which contain 
    …… 
    12441424        <section title="Creating the skeleton ident packet"> 
    12451425 
    1246           <t>The skeleton ident packet receives the "timebase" and the 
     1426          <t>The skeleton ident packet receives the "basetime" and the 
    12471427          "utc" field information from the "stream" tag. 
    12481428          </t> 
    12491429 
    1250           <t>"Basetime numerator &amp; denominator": if the "timebase" 
     1430          <t>"Basetime numerator &amp; denominator": if the "basetime" 
    12511431          attribute is given in a CMML instance document, it MUST be 
    12521432          represented in the skeleton ident header in the fields 
    12531433          "Basetime numerator" and "Basetime denominator". It is converted 
    12541434          from a possible NPT or SMPTE representation to a rational number 
    1255           to be stored in these fishead fields. Note the name change from 
    1256           timebase to basetime with Annodex version 3.0, which further 
    1257           versions of CMML will also mirror. 
     1435          to be stored in these fishead fields. 
    12581436          </t> 
    12591437 
    12601438          <t>"Presentationtime numerator &amp; denominator": to be filled 
    1261           by the muxer appropriately, e.g. reusing the timebase values. 
     1439          by the muxer appropriately, e.g. reusing the basetime values. 
    12621440          </t> 
    12631441 
    …… 
    13321510          </t> 
    13331511 
    1334           <t>"Granulerate numerator &amp; denominator": is fixed to the 
    1335           default value of "1/1000". 
     1512          <t>"Granulerate numerator &amp; denominator":  if the "granulerate" 
     1513          attribute is present in the "cmml" tag, it MUST be represented  
     1514          in the fisbone header in the fields "Granulerate numerator" and 
     1515          "Granulerate denominator". The encoder MUST however ascertain 
     1516          that the values are sensible. The value defaults to "1/1000" if 
     1517          it is not specified by the user. 
    13361518          </t> 
    13371519 
    …… 
    13741556            </t> 
    13751557 
    1376             <t>timebase: this attribute maps to the skeleton 
    1377             ident header fields "Timebase numerator" and "Timebase 
     1558            <t>basetime: this attribute maps to the skeleton 
     1559            ident header fields "Basetime numerator" and "Basetime 
    13781560            denominator". 
    13791561            </t> 
    …… 
    14891671        the content of the CMML logical bitstream and thus a textual 
    14901672        representation of the interleaved bitstream. However, if the 
    1491         Annodex bitstream has a non-zero "timebase" or a non-null "utc" 
     1673        Annodex bitstream has a non-zero "basetime" or a non-null "utc" 
    14921674        time in the skeleton ident header, a "stream" tag will allow 
    14931675        accurate time information in the CMML file and SHOULD be created 
    …… 
    14951677        </t> 
    14961678 
    1497         <t>If a "stream" tag is created with the "timebase" and "utc" 
     1679        <t>If a "stream" tag is created with the "basetime" and "utc" 
    14981680        attributes, it is empty by default. A ripping application MAY 
    14991681        however extract all the data bitstreams out of the Annodex 
    …… 
    15211703<figure> 
    15221704<artwork><![CDATA[ 
    1523 <stream timebase="[Timebase]" utc="[UTC]"> 
     1705<stream basetime="[Basetime]" utc="[UTC]"> 
    15241706  <import id="[ID message header value]" 
    15251707          granulerate="[Granulerate numerator]/[Granulerate denominator]" 
    …… 
    17741956          substantially. 
    17751957          </t> 
     1958 
     1959        </list> 
     1960      </t> 
     1961 
     1962      <t>draft-pfeiffer-cmml-03: 
     1963        <list style="symbols"> 
     1964 
     1965          <t>added the link tag to the head, which has recognized link 
     1966             types of html plus "edit".</t> 
     1967          <t>added granulerate to the cmml root tag and changed the muxing 
     1968             description for CMML tracks.</t> 
     1969          <t>added title tags for each element.</t> 
     1970          <t>replaced timebase with basetime as a better name.</t> 
     1971          <t>kept the basetime attribute of the stream tag for 
     1972             backwards compatibility.</t> 
    17761973 
    17771974        </list> 
    …… 
    26122809                [NOT INCLUDED IN ANNODEXED DOCUMENT] --> 
    26132810 
    2614 XXX FIX THIS CONTENT MODEL XXX 
    26152811<!ELEMENT clip (meta*, a?, img?, desc?)> 
    26162812<!ATTLIST clip 
    …… 
    26792875<cmml lang="en"> 
    26802876 
    2681 <stream timebase="0"> 
     2877<stream basetime="0"> 
    26822878  <import contenttype="video/mpeg" src="fish.mpg" start="0"/> 
    26832879</stream> 

  • standards/draft-pfeiffer-cmml-current.xml

    r1155 r1183  
     1<!-- Todos: --> 
     2<!-- * move to XML schema --> 
     3<!-- * sort out how to combine with other XML modules --> 
     4<!-- * sort out style sheets --> 
     5 
    16<?xml version="1.0" encoding="UTF-8"?> 
    27<!DOCTYPE rfc SYSTEM "rfc2629.dtd"> 
    …… 
    151156      <t>The following picture illustrates the multiplexing activity 
    152157      schematically; in reality, the stream tag is not preserved in its 
    153       original form and some attributes are also made irrelevant during 
    154       multiplexing. Details of how CMML markup is encoded in an 
     158      original form and some attribute values are also encoded in the binary 
     159      data. Details of how CMML markup is encoded in an 
    155160      Annodex bitstream are given later in this document. 
    156161      </t> 
    …… 
    231236        may provide access to linked documents through a navigation bar. 
    232237        Authors may use the following recognized link types which are a 
    233         subset of the ones used for XHTML/HTML: 
     238        superset of the ones used for XHTML/HTML: 
    234239          <list style="symbols"> 
     240            <t>edit: Refers to a document that allows editing the resource. 
     241               This enables a document author to allow others to edit 
     242               the CMML which is the basis for an Annodex resource. 
     243            </t> 
    235244            <t>alternate: Designates substitute versions for the document 
    236245               in which the link occurs. When used together with the media 
    …… 
    305314      <section title="MediaDesc"> 
    306315        <t>A "MediaDesc" describes one or several types of devices for  
    307         which the given style is appropriate. Which devices are supported 
     316        which the given style is appropriate. It is given as a list of 
     317        comma-separated media descriptors. Which devices are supported 
    308318        will need to be specified in a separate style sheet specification. 
    309319        The following set of device types, adapted from XHTML/HTML 
    310         in CSS1, are currently recommended: 
     320        in CSS1, are recognized: 
    311321          <list style="symbols"> 
    312322            <t>all: suitable for all devices. 
    …… 
    345355      </section> 
    346356 
    347       <section title="URIs"> 
     357      <section title="URI"> 
    348358        <t>A "URI" is a character string that conforms to the 
    349359        specification of the Uniform Resource Identifier as defined in 
    …… 
    433443      </figure> 
    434444 
    435       <t>The attribute "standalone" is set to "yes" when the only DTD 
    436       that is used for the instance document is cmml.dtd. The encoding 
    437       format specifies the character encoding that is used for the 
    438       values of the attributes and elements of the CMML file. E.g. for 
    439       languages that are non-latin based, such as most Arab and Asian 
    440       languages, a simple character encoding like US-ASCII does not 
    441       cover all the characters. The default "UTF-8" charset can 
    442       accommodate for any and all. 
    443       </t> 
    444        
    445445      <t>After the preamble, the CMML tag follows. A CMML file has a 
    446446      "cmml" tag as the root element. It embraces all the other tags. 
    …… 
    454454  id          ID             #IMPLIED 
    455455  xmlns       %URI;          #FIXED 'http://www.annodex.net/cmml' 
     456  granulerate CDATA          #IMPLIED 
    456457  > 
    457458            ]]></artwork> 
    …… 
    466467      <t>Attributes of the "cmml" element are the usual xml root tag 
    467468      attributes: the internationalisation attributes "lang" and 
    468       "dir", an identifier "id" and a fixed namespace "xmlns". 
     469      "dir", an identifier "id", a fixed namespace "xmlns", and the 
     470      "granulerate". 
    469471      </t> 
    470472 
    …… 
    484486      </t> 
    485487 
     488      <t>The "granulerate" attribute may provide a base temporal resolution for 
     489      the CMML bitstream. This is in particular used for creation of Annodex 
     490      files from a given CMML instance document. 
     491      </t> 
     492 
    486493    </section> 
    487494     
    …… 
    500507      </t> 
    501508 
    502       <t>The "stream" element describes the input time-continuous 
    503       bitstreams that are to be multiplexed together on authoring 
    504       the Annodex bitstreams inthe "import" tags. Its attributes 
     509      <t>The "stream" element describes in the "import" tags the input 
     510      time-continuous bitstreams that are to be multiplexed together on 
     511      authoring the Annodex bitstream. Its attributes 
    505512      describe other features of the Annodex bitstream such as the 
    506513      time mappings for the start of the file. 
    …… 
    864871        <t>The "attrs;" attribute covers the specification of the language 
    865872        of the title attribute, a unique identifing name, a reference to a 
    866         style sheet specification, and a title attribute to provides a  
     873        style sheet specification, and a title attribute to provide a  
    867874        short description of the relationship between the current document 
    868875        and the one referred to in the "href" attributed. 
    …… 
    15001507          </t> 
    15011508 
    1502           <t>"Presentationtime numerator &amp; denominator": if the "basetime" 
    1503           attribute is given in a CMML instance document, it also 
    1504           determines the presentation time of the interleaved bitstream and 
    1505           the "Basetime numerator" and "Basetime denominator" MUST be 
    1506           copied to the "Presentationtime numerator" and "Presentationtime 
    1507           denominator" fields of the skeleton ident header. 
     1509          <t>"Presentationtime numerator &amp; denominator": to be filled 
     1510          by the muxer appropriately, e.g. reusing the basetime values. 
    15081511          </t> 
    15091512 
    …… 
    20322035        <list style="symbols"> 
    20332036 
    2034           <t>CMML version 2.1: introduction of the "link" element, the 
    2035           "title" tags for each element, and an addition of the 
    2036           "basetime" field deprecating the "timebase" field. 
    2037           </t> 
     2037          <t>added the link tag to the head, which has recognized link 
     2038             types of html plus "edit".</t> 
     2039          <t>added granulerate to the cmml root tag and changed the muxing 
     2040             description for CMML tracks.</t> 
     2041          <t>added title tags for each element.</t> 
     2042          <t>replaced timebase with basetime as a better name.</t> 
     2043          <t>kept the basetime attribute of the stream tag for 
     2044             backwards compatibility.</t> 
    20382045 
    20392046        </list>