Change "alternativeFor" to "represents"

w3c · Mar 28, 2024 · 5bef65e · 5bef65e
1 parent 6b86c50
commit 5bef65e
Show file tree

Hide file tree

Showing 12 changed files with 36 additions and 36 deletions.
diff --git a/examples/intro-original-language-with-dub-language-and-adaptation.xml b/examples/intro-original-language-with-dub-language-and-adaptation.xml
@@ -5,7 +5,7 @@
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
     xml:lang="en"
     daptm:langSrc="fr"
-    daptm:alternativeFor="dialogue"
+    daptm:represents="dialogue"
     daptm:scriptType="preRecording">
   <head>
     <metadata>

diff --git a/examples/intro-original-language-with-dub-language.xml b/examples/intro-original-language-with-dub-language.xml
@@ -5,7 +5,7 @@
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
     xml:lang="en"
     daptm:langSrc="fr"
-    daptm:alternativeFor="dialogue"
+    daptm:represents="dialogue"
     daptm:scriptType="translatedTranscript">
   <head>
     <metadata>

diff --git a/examples/intro-original-language.xml b/examples/intro-original-language.xml
@@ -5,7 +5,7 @@
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
     xml:lang="fr"
     daptm:langSrc="fr"
-    daptm:alternativeFor="dialogue"
+    daptm:represents="dialogue"
     daptm:scriptType="originalTranscript">
   <head>
     <metadata>

diff --git a/examples/intro-script-with-gain.xml b/examples/intro-script-with-gain.xml
@@ -1,5 +1,5 @@
 <tt ...
-  daptm:alternativeFor="visualNonText, visualText"
+  daptm:represents="visualNonText, visualText"
   daptm:scriptType="asRecorded"
   xml:lang="en"
   daptm:langSrc="">

diff --git a/examples/intro-times-and-text.xml b/examples/intro-times-and-text.xml
@@ -5,7 +5,7 @@
   ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
   xml:lang="en"
   daptm:langSrc=""
-  daptm:alternativeFor="visualNonText, visualText"
+  daptm:represents="visualNonText, visualText"
   daptm:scriptType="preRecording">
   <body>
     <div begin="10s" end="13s">

diff --git a/examples/intro-top-level.xml b/examples/intro-top-level.xml
@@ -4,7 +4,7 @@
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
     xml:lang="en"
     daptm:langSrc="en"
-    daptm:alternativeFor="dialogue"
+    daptm:represents="dialogue"
     daptm:scriptType="originalTranscript">
   <head>
     <metadata>

diff --git a/examples/sourceMediaIdentifier.xml b/examples/sourceMediaIdentifier.xml
@@ -4,7 +4,7 @@
     xmlns:ebuttm="urn:ebu:tt:metadata"
     xml:lang="en" 
     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
-    daptm:alternativeFor="dialogue"
+    daptm:represents="dialogue"
     daptm:scriptType="originalTranscript">
   <head>
     <metadata>

diff --git a/figures/class-diagram.svg b/figures/class-diagram.svg
diff --git a/figures/sources/class-diagram.puml b/figures/sources/class-diagram.puml
@@ -13,7 +13,7 @@ skinparam Ranksep 80
 skinparam MinClassWidth 220
 
 Class DAPTScript as "**DAPT Script**" [[#dapt-script]] {
-    Alternative For [[[#alternative-for]]]
+    Represents [[[#represents]]]
     Script Type [[[#script-type]]]
     Default Language [[[#default-language]]]
     {field} (optional) Text Language Source [[[#text-language-source]]]

diff --git a/index.html b/index.html
@@ -351,7 +351,7 @@ <h4>Basic document structure</h4>
           <ul>
           <li>The <code>&lt;tt&gt;</code> root element in the namespace <code>http://www.w3.org/ns/ttml</code> indicates that this is a TTML document
           and the <a><code>ttp:contentProfiles</code></a> attribute indicates that it adheres to the DAPT <a>content profile</a> defined in this specification.</li>
-          <li>The <code>daptm:alternativeFor</code> attribute indicates what the contents of the document are an alternative for,
+          <li>The <code>daptm:represents</code> attribute indicates what the contents of the document are an alternative for,
             within the original programme.</li>
           <li>The <code>daptm:scriptType</code> attribute indicates the type of <a>transcript</a> or <a>script</a>
           but in this empty example, it is not relevant, since only the structure of the document is shown.</li>
@@ -538,20 +538,20 @@ <h3>DAPT Script</h3>
           that corresponds to a document processed within an authoring workflow or processed by a client,
           and conforms to the constraints of this specification.
           It has properties and objects defined in the following sections:
-          <a>Alternative For</a>, <a>Script Type</a>, <a>Default Language</a>, <a>Text Language Source</a>, <a>Script Events</a>
+          <a>Represents</a>, <a>Script Type</a>, <a>Default Language</a>, <a>Text Language Source</a>, <a>Script Events</a>
           and, for <a>Dubbing Scripts</a>, <a>Characters</a>.</p>
         <p>A <dfn>DAPT Document</dfn> is a TTML <a>Document Instance</a> representing a <a>DAPT Script</a>.
           A <a>DAPT Document</a> has the structure and constraints defined in the following sections.</p>
         <section>
-          <h4>Alternative For</h4>
-          <p>The <dfn>Alternative For</dfn> property is a mandatory property of a <a>DAPT Script</a> which
+          <h4>Represents</h4>
+          <p>The <dfn>Represents</dfn> property is a mandatory property of a <a>DAPT Script</a> which
             indicates which components of the <a>related media object</a>
             the contents of the document provide an alternative for.
           </p>
-          <p>To represent this property, the <dfn><code>daptm:alternativeFor</code></dfn> attribute MUST be present on the <code>&lt;tt&gt;</code> element:</p>
+          <p>To represent this property, the <dfn><code>daptm:represents</code></dfn> attribute MUST be present on the <code>&lt;tt&gt;</code> element:</p>
           <div class="exampleInner">
             <pre class="language-abnf">
-  daptm:alternativeFor
+  daptm:represents
   : &lt;content-descriptor&gt; ( &lt;lwsp&gt;? "," &lt;lwsp&gt;? &lt;content-descriptor&gt;)*
 
   &lt;content-descriptor&gt;
@@ -563,10 +563,10 @@ <h4>Alternative For</h4>
   &lt;lwsp&gt;  # as TTML2
             </pre>
           </div>
-          <p>For example, a dubbing script would have <code>daptm:alternativeFor=&quot;dialogue&quot;</code>,
-            an audio description script would have <code>daptm:alternativeFor=&quot;visualNonText, visualText&quot;</code>,
+          <p>For example, a dubbing script would have <code>daptm:represents=&quot;dialogue&quot;</code>,
+            an audio description script would have <code>daptm:represents=&quot;visualNonText, visualText&quot;</code>,
             and a post-production script that could be the precursor to a hard of hearing subtitle document
-            would have <code>daptm:alternativeFor=&quot;dialogue, nonDialogueSounds&quot;</code>.</p>
+            would have <code>daptm:represents=&quot;dialogue, nonDialogueSounds&quot;</code>.</p>
         </section>
 
         <section>
@@ -1164,7 +1164,7 @@ <h4>On Screen</h4>
             <li>OFF_ON - the <a>Script Event</a>'s subject starts off screen, but goes on screen at some point</li>
           </ul>
           <p>If omitted, the default value is "ON".</p>
-          <aside class="note">When the <a>daptm:alternativeFor</a> attribute value includes
+          <aside class="note">When the <a>daptm:represents</a> attribute value includes
             <code>visualNonText</code> or <code>visualText</code> the subject of each
             <a>Script Event</a>, i.e. what is being described,
             is expected to be in the video image, therefore the default of "ON" allows
@@ -2712,13 +2712,6 @@ <h4>Disposition of Features and Extensions</h4>
               This is the profile expression of <a href="#character"></a>.
             </td>
           </tr>
-          <tr>
-            <td><a href="#alternativefor-root"><code>#alternativeFor-root</code></a></td>
-            <td><span class="required label">required</span></td>
-            <td>
-              This is the profile expression of <a href="#alternative-for"></a>.
-            </td>
-          </tr>
           <tr>
             <td><a href="#contentprofiles-root"><code>#contentProfiles-root</code></a></td>
             <td><span class="required label">required</span></td>
@@ -2740,6 +2733,13 @@ <h4>Disposition of Features and Extensions</h4>
               This is the profile expression of <a href="#ttp-profile"></a>.
             </td>
           </tr>
+          <tr>
+            <td><a href="#represents-root"><code>#represents-root</code></a></td>
+            <td><span class="required label">required</span></td>
+            <td>
+              This is the profile expression of <a href="#represents"></a>.
+            </td>
+          </tr>
           <tr>
             <td><a href="#scripttype-root"><code>#scriptType-root</code></a></td>
             <td><span class="required label">required</span></td>
@@ -2964,20 +2964,20 @@ <h3>#textLanguageSource</h3>
       </section>
 
       <section>
-        <h3>#alternativeFor-root</h3>
-        <p>A <a>transformation processor</a> supports the <code>#alternativeFor-root</code> extension if
+        <h3>#represents-root</h3>
+        <p>A <a>transformation processor</a> supports the <code>#represents-root</code> extension if
           it recognizes and is capable of transforming values of the
-          <a><code>daptm:alternativeFor</code></a> attribute on the <code>&lt;tt&gt;</code> element.</p>
+          <a><code>daptm:represents</code></a> attribute on the <code>&lt;tt&gt;</code> element.</p>
 
-        <p>A <a>presentation processor</a> supports the <code>#alternativeFor-root</code> extension if
+        <p>A <a>presentation processor</a> supports the <code>#represents-root</code> extension if
           it implements presentation semantic support of the
-          <a><code>daptm:alternativeFor</code></a> attribute on the <code>&lt;tt&gt;</code> element.</p>
+          <a><code>daptm:represents</code></a> attribute on the <code>&lt;tt&gt;</code> element.</p>
 
         <p>An example of a <a>transformation processor</a> that supports this extension is
           a validating processor that reports an error if the extension is required by a
           <a>content profile</a> but the <a>Document Instance</a> claiming
           conformance to that profile either does not have a
-          <a><code>daptm:alternativeFor</code></a> attribute on the <code>&lt;tt&gt;</code> element
+          <a><code>daptm:represents</code></a> attribute on the <code>&lt;tt&gt;</code> element
           or has one whose value is not conformant with the requirements defined herein.</p>
 
       </section>

diff --git a/profiles/dapt-content-profile.xml b/profiles/dapt-content-profile.xml
@@ -82,8 +82,8 @@
   </features>
   <extensions xml:base="http://www.w3.org/ns/ttml/profile/dapt/extension/">
     <!-- required (mandatory) extension support -->
-    <extension value="required">#alternativeFor-root</extension>
     <extension value="required">#contentProfiles-root</extension>
+    <extension value="required">#represents-root</extension>
     <extension value="required">#scriptType-root</extension>
     <extension value="required">#serialization</extension>
     <extension value="required">#xmlId-div</extension>

diff --git a/profiles/dapt-processor-profile.xml b/profiles/dapt-processor-profile.xml
@@ -83,9 +83,9 @@
   <extensions xml:base="http://www.w3.org/ns/ttml/profile/dapt/extension/">
     <!-- required (mandatory) extension support -->
     <extension value="required">#agent</extension>
-    <extension value="required">#alternativeFor-root</extension>
     <extension value="required">#contentProfiles-root</extension>
     <extension value="required">#onScreen</extension>
+    <extension value="required">#represents-root</extension>
     <extension value="required">#scriptType-root</extension>
     <extension value="required">#serialization</extension>
     <extension value="required">#textLanguageSource</extension>