[ttml2] improve delineation of profile and intermediate document types
authorGlenn Adams <glenn@skynav.com>
Mon, 03 Nov 2014 10:46:10 +0800
changeset 752 cad5a1104e50
parent 751 9e26bdc4ee6c
child 753 3900fa01a464
[ttml2] improve delineation of profile and intermediate document types
ttml2/spec/ttml2.xml
--- a/ttml2/spec/ttml2.xml	Mon Oct 27 11:32:40 2014 -0700
+++ b/ttml2/spec/ttml2.xml	Mon Nov 03 10:46:10 2014 +0800
@@ -499,7 +499,7 @@
 <gitem>
 <label>ISD</label>
 <def>
-<p>Intermedia Synchronic Document</p>
+<p>Intermediate Synchronic Document</p>
 </def>
 </gitem>
 <gitem>
@@ -638,10 +638,7 @@
 <gitem id="terms-document-instance">
 <label>[document instance]</label>
 <def>
-<p>A concrete realization of a Timed Text Markup Language document, where the concrete form
-is specific to the context of reference. For example, a sequence of bytes that represents an
-XML serialization of a Timed Text document, an internal, parsed representation of such a
-Timed Text document, etc.</p>
+<p>A <loc href="#terms-timed-text-document-instance">timed text document instance</loc>.</p>
 </def>
 </gitem>
 <gitem id="terms-document-interchange-context">
@@ -774,21 +771,28 @@
 <gitem id="terms-intermediate-synchronic-document">
 <label>[intermediate synchronic document]</label>
 <def>
-<p>An abstract or concrete representation of the static content, styling, and layout of a source TTML <loc href="#terms-document-instance">document instance</loc>
-during a non-overlapping temporal interval that intersects with the source document's <loc href="#terms-root-temporal-extent">root temporal extent</loc>.</p>
+<p>A <loc href="#terms-timed-text-intermediate-document">timed text intermediate document</loc> or a
+<loc href="#terms-timed-text-intermediate-document-instance">timed text intermediate document instance</loc>, according to the context of use,
+where the root (document) element is an <el>isd:isd</el> element, and which represents a
+non-overlapping temporal interval that intersects with the content, styling, layout, and timing of a source
+<loc href="#terms-timed-text-content-document">timed text content document</loc>.</p>
 </def>
 </gitem>
 <gitem id="terms-intermediate-synchronic-document-sequence">
 <label>[intermediate synchronic document sequence]</label>
 <def>
-<p>An abstract or concrete representation of a sequence of <loc href="#terms-intermediate-synchronic-document">intermediate synchronic document</loc> instances
-that effectively represent the content, styling, layout, and timing of a source TTML <loc href="#terms-document-instance">document instance</loc>.</p>
-</def>
-</gitem>
-<gitem id="terms-intermediate-synchronic-document-sequence-syntax">
-<label>[intermediate synchronic document sequence syntax]</label>
-<def>
-<p>A formalism for use in the concrete representation of an <loc href="#terms-intermediate-synchronic-document-sequence">intermediate synchronic document sequence</loc>.</p>
+<p>A <loc href="#terms-timed-text-intermediate-document">timed text intermediate document</loc> or a
+<loc href="#terms-timed-text-intermediate-document-instance">timed text intermediate document instance</loc>, according to the context of use,
+where the root (document) element is an <el>isd:sequence</el> element, and which represents a
+sequence of <loc href="#terms-intermediate-synchronic-document">intermediate synchronic document</loc> instances
+that effectively represent the content, styling, layout, and timing of a source <loc href="#terms-timed-text-content-document">timed text content document</loc>.</p>
+</def>
+</gitem>
+<gitem id="terms-intermediate-document-syntax">
+<label>[intermediate document syntax]</label>
+<def>
+<p>A formalism for use in the concrete representation of an <loc href="#terms-intermediate-synchronic-document-sequence">intermediate synchronic document sequence</loc> or
+an <loc href="#terms-intermediate-synchronic-document">intermediate synchronic document</loc>.</p>
 </def>
 </gitem>
 <gitem id="terms-nested-profile">
@@ -872,8 +876,8 @@
 <gitem id="terms-profile-definition-document">
 <label>[profile definition document]</label>
 <def>
-<p>A document that formally specifies a <loc href="#terms-profile">profile</loc>, where such document is a valid TTML document instance
-which has a root element type of <el>ttp:profile</el>.</p>
+<p>A <loc href="#terms-timed-text-profile-document">timed text profile document</loc> or a
+<loc href="#terms-timed-text-profile-document-instance">timed text profile document instance</loc>, according to the context of use.</p>
 </def>
 </gitem>
 <gitem id="terms-profile-designator">
@@ -991,13 +995,6 @@
 associated with timing information.</p>
 </def>
 </gitem>
-<gitem id="terms-timed-text-markup-language">
-<label>[timed text markup language]</label>
-<def>
-<p>A content type that represents timed text media for the purpose of
-interchange among authoring systems.</p>
-</def>
-</gitem>
 <gitem id="terms-timed-text-authoring-system">
 <label>[timed text authoring system]</label>
 <def>
@@ -1005,6 +1002,74 @@
 Timed Text Markup Language content.</p>
 </def>
 </gitem>
+<gitem id="terms-timed-text-content-document">
+<label>[timed text content document]</label>
+<def>
+<p>An abstract document that is purported or confirmed to be a
+<loc href="#terms-valid-abstract-document-instance">valid abstract document instance</loc> of
+the <loc href="#ttml-content-doctype">TTML Content Document Type</loc>.</p>
+</def>
+</gitem>
+<gitem id="terms-timed-text-content-document-instance">
+<label>[timed text content document instance]</label>
+<def>
+<p>A concrete realization of a <loc href="#terms-timed-text-content-document">timed text content document</loc>,
+about which see <specref ref="concrete-encoding"/>.</p>
+</def>
+</gitem>
+<gitem id="terms-timed-text-document-instance">
+<label>[timed text document instance]</label>
+<def>
+<p>A concrete realization of a
+<loc href="#terms-timed-text-markup-language-document">timed text markup language document</loc>,
+where  the concrete form is specific to the context of reference.
+Also referred to as a <loc href="#terms-document-instance">TTML document instance</loc>
+or simply <loc href="#terms-document-instance">document instance</loc>.</p>
+</def>
+</gitem>
+<gitem id="terms-timed-text-intermediate-document">
+<label>[timed text intermediate document]</label>
+<def>
+<p>An abstract document that is purported or confirmed to be a
+<loc href="#terms-valid-abstract-document-instance">valid abstract document instance</loc> of
+the <loc href="#ttml-intermediate-doctype">TTML Intermediate Document Type</loc>.</p>
+</def>
+</gitem>
+<gitem id="terms-timed-text-intermediate-document-instance">
+<label>[timed text intermediate document instance]</label>
+<def>
+<p>A concrete realization of a <loc href="#terms-timed-text-intermediate-document">timed text intermediate document</loc>,
+about which see <specref ref="concrete-encoding"/>.</p>
+</def>
+</gitem>
+<gitem id="terms-timed-text-markup-language">
+<label>[timed text markup language]</label>
+<def>
+<p>A content type that represents timed text content, intermediate representations of this content, or profiles of this content or content processors.</p>
+</def>
+</gitem>
+<gitem id="terms-timed-text-markup-language-document">
+<label>[timed text markup language document]</label>
+<def>
+<p>An abstract document that is purported or confirmed to be a
+<loc href="#terms-valid-abstract-document-instance">valid abstract document instance</loc>.</p>
+</def>
+</gitem>
+<gitem id="terms-timed-text-profile-document">
+<label>[timed text profile document]</label>
+<def>
+<p>An abstract document that is purported or confirmed to be a
+<loc href="#terms-valid-abstract-document-instance">valid abstract document instance</loc> of
+the <loc href="#ttml-profile-doctype">TTML Profile Document Type</loc>.</p>
+</def>
+</gitem>
+<gitem id="terms-timed-text-profile-document-instance">
+<label>[timed text profile document instance]</label>
+<def>
+<p>A concrete realization of a <loc href="#terms-timed-text-profile-document">timed text profile document</loc>,
+about which see <specref ref="concrete-encoding"/>.</p>
+</def>
+</gitem>
 <gitem id="terms-top-level-profile">
 <label>[top-level profile]</label>
 <def>
@@ -1161,10 +1226,10 @@
 <div1 id="conformance">
 <head>Conformance</head>
 <p>This section specifies the general conformance requirements for
-TTML Content and processors.</p>
+TTML documents and processors.</p>
 <div2 id="conformance-content">
-<head>Content Conformance</head>
-<p>A TTML <loc href="#terms-document-instance">document instance</loc> conforms to this specification if the following criteria are
+<head>Document Conformance</head>
+<p>A <loc href="#terms-timed-text-document-instance">timed text document instance</loc> conforms to this specification if the following criteria are
 satisfied:</p>
 <olist>
 <item>
@@ -1195,7 +1260,7 @@
 </item>
 <item>
 <p>The <loc href="#terms-reduced-xml-infoset">reduced xml infoset</loc> satisfies all additional mandatory syntactic and
-semantic constraints defined by this specification. In addition, this Infoset
+semantic constraints defined by this specification. In addition, this infoset
 should satisfy the web content accessibility guidelines specified by
 <bibref ref="wcag"/>.</p>
 </item>
@@ -1336,6 +1401,8 @@
 <p>This section defines the following TTML <emph>Abstract Document Types</emph>:</p>
 <ulist>
 <item><p><specref ref="ttml-content-doctype"/></p></item>
+<item><p><specref ref="ttml-intermediate-doctype"/></p></item>
+<item><p><specref ref="ttml-profile-doctype"/></p></item>
 </ulist>
 <p>Each <loc href="#terms-abstract-document-type">abstract document type</loc> consists of the following constraints:</p>
 <ulist>
@@ -1379,14 +1446,12 @@
 restrictive definition of validity.</p>
 </note>
 <div2 id="ttml-content-doctype">
-<head>TTML Content</head>
-<p>TTML Content is an <loc href="#terms-abstract-document-type">abstract document type</loc> of a profile of the Timed Text Markup Language intended
-to be used for interchange among distribution systems. This document type
-is defined in terms of the
-element and attribute vocabulary
-specified in <specref ref="vocabulary"/>.</p>
+<head>TTML Content Document Type</head>
+<p>The TTML Content Document Type is an <loc href="#terms-abstract-document-type">abstract document type</loc> of a profile
+of the Timed Text Markup Language intended to be used for interchange among distribution systems. This document type
+is defined in terms of the element and attribute vocabulary specified in <specref ref="vocabulary"/>.</p>
 <p>This specification references two types of schemas that may be used to validate a superset/subset
-of conformant TTML Content <loc href="#terms-document-instance">document instances</loc>:</p>
+of <loc href="#terms-timed-text-content-document-instance">timed text content document instances</loc>:</p>
 <ulist>
 <item><p><specref ref="ttml-schema-rnc"/></p></item>
 <item><p><specref ref="ttml-schema-xsd"/></p></item>
@@ -1413,7 +1478,52 @@
 exceptional reporting of this false negative does not impact the formal assessment
 of <loc href="#terms-document-instance">document instance</loc> validity.</p>
 </note>
+<note role="clarification">
+<p>A conforming <loc href="#conformance-generic-processor">Generic Processor</loc> is required to support the ingestion and processing
+of a <loc href="#terms-timed-text-content-document">timed text content document</loc>.</p>
+</note>
 </div2> <!-- ttml-content-doctype -->
+<div2 id="ttml-intermediate-doctype">
+<head>TTML Intermediate Document Type</head>
+<p>The TTML Intermediate Document Type is an <loc href="#terms-abstract-document-type">abstract document type</loc> intended
+to be used to represent the content of a
+<loc href="#terms-timed-text-content-document">timed text content document</loc>
+in such a manner that all discrete animation, styling, and timing information is denoted in
+a non-hierarchical (flat), temporally linear manner. This document type is defined in terms of the element and attribute vocabulary
+specified in <specref ref="isd"/> and <specref ref="vocabulary"/>.</p>
+<p>This specification references two types of schemas that may be used to validate
+<loc href="#terms-timed-text-intermediate-document-instance">timed text intermediate document instances</loc>:</p>
+<ulist>
+<item><p><specref ref="ttml-schema-rnc"/></p></item>
+<item><p><specref ref="ttml-schema-xsd"/></p></item>
+</ulist>
+<p>The (root) document element of a TTML Intermediate Synchronic <loc href="#terms-document-instance">document instance</loc> must be an
+<el>isd:sequence</el> or <el>isd:isd</el> element, as defined by <specref ref="isd"/>.</p>
+<note role="clarification">
+<p>A conforming <loc href="#conformance-generic-processor">Generic Processor</loc> is not required to support the ingestion or processing
+of a <loc href="#terms-timed-text-intermediate-document">timed text intermediate document</loc>.</p>
+</note>
+</div2> <!-- ttml-intermediate-doctype -->
+<div2 id="ttml-profile-doctype">
+<head>TTML Profile Document Type</head>
+<p>The TTML Profile Document Type is an <loc href="#terms-abstract-document-type">abstract document type</loc> intended
+to be used for defining and communicating constraints on the support or use of TTML features or extensions. This document type
+is defined in terms of the element and attribute vocabulary specified in <specref ref="vocabulary"/>.</p>
+<p>This specification references two types of schemas that may be used to validate
+<loc href="#terms-timed-text-profile-document-instance">timed text profile document instances</loc>:</p>
+<ulist>
+<item><p><specref ref="ttml-schema-rnc"/></p></item>
+<item><p><specref ref="ttml-schema-xsd"/></p></item>
+</ulist>
+<p>The (root) document element of a TTML Profile <loc href="#terms-document-instance">document instance</loc> must be a
+<el>ttp:profile</el> element, as defined by <specref ref="parameter-vocabulary-profile"/>.</p>
+<note role="clarification">
+<p>A conforming <loc href="#conformance-generic-processor">Generic Processor</loc> is recommended, but not required to support the ingestion or processing
+of a <loc href="#terms-timed-text-profile-document">timed text profile document</loc>. However, a <loc href="#terms-content-processor">content processor</loc>
+that claims to support the <code>http://www.w3.org/ns/ttml/feature/#profile</code> feature is required to support this (ingestion and processing of
+a <loc href="#terms-timed-text-profile-document">timed text profile document</loc>).</p>
+</note>
+</div2> <!-- ttml-profile-doctype -->
 </div1> <!-- doctypes -->
 <div1 id="vocabulary">
 <head>Vocabulary</head>
@@ -12137,10 +12247,11 @@
 </div2>
 </div1>
 <div1 id="isd">
-<head>Intermediate Synchronic Document Syntax</head>
+<head>Intermediate Document Syntax</head>
 <p><emph>This appendix is normative.</emph></p>
-<p>This appendix specifies the syntactic elements and structure of a TTML Intermediate Synchronic Document (ISD) Sequence and its
-constituent TTML Intermediate Synchronic Document (ISD) instances. An ISD instance may be represented as a standalone document instance or
+<p>This appendix specifies the syntactic elements and structure of a
+<loc href="#terms-timed-text-intermediate-document">timed text intermediate document</loc>.
+An ISD instance may be represented as a standalone document instance or
 in a collection represented as an ISD Sequence instance.</p>
 <p>All ISD related vocabulary is defined in the TTML ISD Namespace, defined here as <code>http://www.w3.org/ns/ttml#isd</code>,
 where the recommended prefix is <code>isd</code>.</p>