Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Contextualize 'considered an error' (#1067). #1098

Merged
merged 3 commits into from
Jun 6, 2019
Merged

Contextualize 'considered an error' (#1067). #1098

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f1a4baf
Contextualize 'considered an error' (#1067).
skynavga May 26, 2019
298eb6f
Address https://github.com/w3c/ttml2/pull/1098#pullrequestreview-2430…
skynavga Jun 3, 2019
831f253
Address https://github.com/w3c/ttml2/pull/1098#pullrequestreview-2430…
skynavga Jun 3, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 21 additions & 21 deletions spec/ttml2.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3351,8 +3351,9 @@ while a <loc href="#semantics-validation-state-validation-exception">validation
of type <code>warning</code> is referred to as a
<termdef id="defs-validation-warning" term="validation warning"><term>validation warning</term></termdef>.</p>
<p>Unless a <loc href="#terms-higher-level-protocol">higher level protocol</loc> applies,
(1) if a violation of a prescription or proscription of this specification is detected,
then a <termref def="defs-validation-error">validation error</termref> exception applies; and
(1) if a violation of a prescription or proscription of this specification by a <loc href="#terms-document-instance">document instance</loc> is detected,
then it is <termdef id="defs-considered-an-error" term=""><term>considered an error</term></termdef>, in which case
a <termref def="defs-validation-error">validation error</termref> exception applies; and
(2) if a violation of a recommendation or disrecommendation of this specification is detected, then a
<termref def="defs-validation-warning">validation warning</termref> applies.</p>
<note role="example"><p>An example of a higher level protocol in this context is a system or end-user defined
Expand Down Expand Up @@ -7491,7 +7492,7 @@ the specified attribute value(s) are to be used instead of the font characterist
must be considered to be equal to the value(s) of the same named font characteristics encoded in the <loc href="#terms-font-resource">font resource</loc>.</p>
<p>If the computed value of the <code>family</code> attribute (whether explicitly specified or not) matches a
<loc href="#style-value-generic-family-name">&lt;generic-family-name&gt;</loc> (by case-sensitive comparison),
then it is considered an error, and the referenced font resource must be ignored for the purpose of presentation processing.</p>
then it is <termref def="defs-considered-an-error">considered an error</termref> and the referenced font resource must be ignored for the purpose of presentation processing.</p>
<note role="elaboration">
<p>The effect of the previous paragraph is that a content author may not override a built-in font resource that corresponds to a generic font family.</p>
</note>
Expand Down Expand Up @@ -9645,7 +9646,7 @@ layout and presentation.</p>
<p>If the value of this attribute is <code>inlineBlock</code> and this attribute is applied
to a <loc href="#content-vocabulary-span"><el>span</el></loc> element, then
<loc href="#terms-inline-block-display">inline block display</loc> semantics apply and the element
is a candidate for region layout and presentation. Furthermore, it is considered an error if the
is a candidate for region layout and presentation. Furthermore, it is <termref def="defs-considered-an-error">considered an error</termref> if the
nigelmegitt marked this conversation as resolved.
Show resolved Hide resolved
<code>inlineBlock</code> value is applied to any element which is not a <loc href="#content-vocabulary-span"><el>span</el></loc> element.</p>
<p>The <att>tts:display</att> style is illustrated by the following example.</p>
<table id="style-attribute-display-example-1" role="example">
Expand Down Expand Up @@ -9893,7 +9894,7 @@ then the specified value is restricted to one of the following:
(3) two <loc href="#style-value-length">&lt;length&gt;</loc> specifications,
where these specifications are expressed as non-percentage, definite lengths using pixel units.
All other syntactically legal values must not be used in this context, and,
if used, must be considered an error for the purpose of <loc href="#terms-validation-processing">validation processing</loc> and must be ignored
if used, must be <termref def="defs-considered-an-error">considered an error</termref> and must be ignored
for the purpose of presentation processing, in which case the initial value (<code>auto</code>) applies.</p>
<p>If a <att>tts:extent</att> attribute is specified on a <loc href="#layout-vocabulary-region"><el>region</el></loc> element,
then its computed value determines the <loc href="#terms-width">width</loc> and <loc href="#terms-height">height</loc>
Expand Down Expand Up @@ -12575,13 +12576,13 @@ the <termref def="defs-explicit-ruby-text-container">explicit ruby text containe
<code>text</code> when the parent of that <loc href="#content-vocabulary-span"><el>span</el></loc> element is a
<loc href="#content-vocabulary-span"><el>span</el></loc> element for which the computed value of
<loc href="#style-attribute-ruby">tts:ruby</loc> is <code>textContainer</code>.
If specified (on the former <termref def="defs-ruby-text-content">ruby text content</termref>), then it is considered an error,
If specified (on the former <termref def="defs-ruby-text-content">ruby text content</termref>), then it is <termref def="defs-considered-an-error">considered an error</termref>
and must be ignored for the purpose of presentation processing.</p>
<p>The absolute position of the <termref def="defs-ruby-text-container">ruby text container</termref> or ruby text annotation is determined
in accordance to the computed value of the <code>tts:writingMode</code> style property of the region into which the affected content is placed;
in particular, the mappings defined enumerated by <specref ref="rubyPosition-semantics-mapping-table"/> apply as further defined
by <bibref ref="cssruby"/>, &sect;4.1.</p>
<p>If two <termref def="defs-ruby-text-container">ruby text containers</termref> apply to the same <termref def="defs-ruby-base-container">ruby base container</termref>, then it is considered an error if
<p>If two <termref def="defs-ruby-text-container">ruby text containers</termref> apply to the same <termref def="defs-ruby-base-container">ruby base container</termref>, then it is <termref def="defs-considered-an-error">considered an error</termref> if
the <termref def="defs-used-value">used value</termref> of the property associated with this attribute would result in
both <termref def="defs-ruby-text-container">ruby text containers</termref> being placed on the same relative side of the <termref def="defs-ruby-base-container">ruby base container</termref>, in which case, the presentation semantics of
this property are not defined by this specification.</p>
Expand Down Expand Up @@ -16189,8 +16190,8 @@ evaluated in the specified order, and that order applies to resolution of the va
style property in the case that it is specified along multiple reference paths.</p>
<p>The use of referential styling is restricted to making
reference to <el>style</el> element descendants of a <el>styling</el>
element. It is considered an error to reference a <el>style</el>
element that is a descendant of a <el>layout</el> element.</p>
element. It is <termref def="defs-considered-an-error">considered an error</termref> to reference a <el>style</el>
nigelmegitt marked this conversation as resolved.
Show resolved Hide resolved
element that is a descendant of a <el>layout</el> element, in which case, the presentation semantics are not defined by this specification.</p>
<note role="explanation">
<p>The use of referential styling encourages the reuse of style specifications while
sacrificing locality of reference.</p>
Expand Down Expand Up @@ -16229,11 +16230,11 @@ ref="semantics-style-inheritance-content"/> below.</p>
other out-of-line style properties, thus creating a chain of references starting at the
affected element. When expressed in this manner, the association of style information
is referred to as <emph>chained referential styling</emph>.</p>
<p>A loop in a sequence of chained style references must be considered an error.</p>
<p>A loop in a sequence of chained style references must be <termref def="defs-considered-an-error">considered an error</termref>.</p>
<p>The use of referential styling is restricted to making
nigelmegitt marked this conversation as resolved.
Show resolved Hide resolved
reference to <el>style</el> element descendants of a <el>styling</el>
element. It is considered an error to reference a <el>style</el>
element that is a descendant of a <el>layout</el> element.</p>
element. It is <termref def="defs-considered-an-error">considered an error</termref> to reference a <el>style</el>
element that is a descendant of a <el>layout</el> element, in which case, the presentation semantics are not defined by this specification.</p>
nigelmegitt marked this conversation as resolved.
Show resolved Hide resolved
<note role="explanation">
<p>The use of chained referential styling encourages the grouping of style specifications
into general and specific sets, which further aids in style specification reuse.</p>
Expand Down Expand Up @@ -16815,7 +16816,7 @@ determine (obtain) the computed style set <emph>CSS</emph> of
<label>[compute containment scaling](<emph>inout</emph> target rectangle TR, <emph>in</emph> reference rectangle RR)</label>
<def>
<olist>
<item><p>If the units of target rectangle TR and reference rectangle RR are not the same, then raise an error condition.</p></item>
<item><p>It is <termref def="defs-considered-an-error">considered an error</termref> if the units of target rectangle TR and reference rectangle RR are not the same, in which case exit this procedure without modifying the target rectangle.</p></item>
nigelmegitt marked this conversation as resolved.
Show resolved Hide resolved
<item><p>If the width of the target rectangle TR, <emph>W<sub>t</sub></emph>&thinsp;, is zero, then set <emph>W<sub>t</sub></emph> to one;
likewise, if the height of the target rectangle TR, <emph>H<sub>t</sub></emph>&thinsp;, is zero, then set <emph>H<sub>t</sub></emph> to one.</p></item>
<item><p>Let <emph>SAR<sub>r</sub></emph> be the storage aspect ratio of the reference rectangle <emph>RR</emph>.</p></item>
Expand Down Expand Up @@ -16853,7 +16854,7 @@ determine (obtain) the computed style set <emph>CSS</emph> of
<label>[compute cover scaling](<emph>inout</emph> target rectangle TR, <emph>in</emph> reference rectangle RR)</label>
<def>
<olist>
<item><p>If the units of target rectangle TR and reference rectangle RR are not the same, then raise an error condition.</p></item>
<item><p>It is <termref def="defs-considered-an-error">considered an error</termref> if the units of target rectangle TR and reference rectangle RR are not the same, in which case exit this procedure without modifying the target rectangle.</p></item>
<item><p>If the width of the target rectangle TR, <emph>W<sub>t</sub></emph>&thinsp;, is zero, then set <emph>W<sub>t</sub></emph> to one;
likewise, if the height of the target rectangle TR, <emph>H<sub>t</sub></emph>&thinsp;, is zero, then set <emph>H<sub>t</sub></emph> to one.</p></item>
<item><p>Let <emph>SF<sub>W </sub> </emph> be <emph>W<sub>R</sub> </emph>/<emph>W<sub>T</sub> </emph>, where
Expand Down Expand Up @@ -18213,17 +18214,17 @@ then the value of this term must be constrained to the interval
[0&hellip;<emph>F-1</emph>], where <emph>F</emph> is the frame rate
determined by the <att>ttp:frameRate</att> parameter as defined
by <specref ref="parameter-attribute-frameRate"/>.
It is considered an error if a <emph>frames</emph> term or
It is <termref def="defs-considered-an-error">considered an error</termref> if a <emph>frames</emph> term or
nigelmegitt marked this conversation as resolved.
Show resolved Hide resolved
<code>f</code> (frames) metric is specified when the <code>clock</code> time base applies.</p>
<p>If a &lt;time-expression&gt; is expressed in terms of a
<emph>clock-time</emph> and a <emph>sub-frames</emph> term is
specified, then the value of this term must be constrained to the
interval [0&hellip;<emph>S-1</emph>], where <emph>S</emph> is the
sub-frame rate determined by the <att>ttp:subFrameRate</att> parameter as defined by <specref
ref="parameter-attribute-subFrameRate"/>.
It is considered an error if a <emph>sub-frames</emph> term is specified
It is <termref def="defs-considered-an-error">considered an error</termref> if a <emph>sub-frames</emph> term is specified
when the <code>clock</code> time base applies.</p>
<p>It is considered an error if the <emph>wallclock-time</emph> form of a &lt;time-expression&gt;
<p>It is <termref def="defs-considered-an-error">considered an error</termref> if the <emph>wallclock-time</emph> form of a &lt;time-expression&gt;
is used in a <loc href="#terms-document-instance">document instance</loc> and the government time base is not <code>clock</code>.</p>
<p>If the computed value of the governing time base is <code>smpte</code>, then
(1) <phrase role="deprecated">use of an <emph>offset-time</emph> form of &lt;time-expression&gt; is deprecated</phrase>, and
Expand Down Expand Up @@ -18424,7 +18425,7 @@ considered equivalent to specifying <code>attributeName="tts:color"</code> and <
</item>
<item>
<p>If a <att>keyTimes</att> attribute is specified and the computed value of <emph>calcMode</emph> is <attval>paced</attval>,
then this usage must be considered an error for the purpose of validation processing and the animation must be ignored for the purpose of
then this usage must be <termref def="defs-considered-an-error">considered an error</termref> and the animation must be ignored for the purpose of
presentation processing.</p>
</item>
<item>
Expand Down Expand Up @@ -18472,7 +18473,7 @@ is <attval>0;0.5;1</attval>.</p>
</item>
<item>
<p>If a <att>keySplines</att> attribute is specified and the computed value of <emph>calcMode</emph> is not <attval>spline</attval>,
then this usage must be considered an error for the purpose of validation processing and the animation must be ignored for the purpose of
then this usage must be <termref def="defs-considered-an-error">considered an error</termref> and the animation must be ignored for the purpose of
presentation processing.</p>
</item>
<item>
Expand All @@ -18482,7 +18483,7 @@ of time <loc href="#terms-component">components</loc> in the computed value of t
</item>
<item>
<p>If no <att>keySplines</att> attribute is specified and the computed value of <emph>calcMode</emph> is <attval>spline</attval>,
then this usage must be considered an error for the purpose of validation processing and the animation must be ignored for the purpose of
then this usage must be <termref def="defs-considered-an-error">considered an error</termref> and the animation must be ignored for the purpose of
presentation processing.</p>
</item>
<item>
Expand Down Expand Up @@ -21745,7 +21746,6 @@ following features:
<loc href="#feature-presentation"><code>#presentation</code></loc> or
<loc href="#feature-profile-version-2"><code>#profile-version-2</code></loc>.</p>
</div3>

<div3 id="feature-processorProfiles">
<head>#processorProfiles</head>
<p>A TTML <loc href="#terms-transformation-processor">transformation processor</loc> supports the <code>#processorProfiles</code>
Expand Down