From f1a4baf96cb59d96e6028f87b87dc0ec8ba6fd5d Mon Sep 17 00:00:00 2001 From: Glenn Adams Date: Sun, 26 May 2019 10:13:41 -0600 Subject: [PATCH 1/3] Contextualize 'considered an error' (#1067). --- spec/ttml2.xml | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/spec/ttml2.xml b/spec/ttml2.xml index 031c5ccac..b6445335f 100644 --- a/spec/ttml2.xml +++ b/spec/ttml2.xml @@ -3351,8 +3351,9 @@ while a validation of type warning is referred to as a validation warning.

Unless a higher level protocol applies, -(1) if a violation of a prescription or proscription of this specification is detected, -then a validation error exception applies; and +(1) if a violation of a prescription or proscription of this specification by a document instance is detected, +then it is considered an error, in which case +a validation error exception applies; and (2) if a violation of a recommendation or disrecommendation of this specification is detected, then a validation warning applies.

An example of a higher level protocol in this context is a system or end-user defined @@ -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 font resource.

If the computed value of the family attribute (whether explicitly specified or not) matches a <generic-family-name> (by case-sensitive comparison), -then it is considered an error, and the referenced font resource must be ignored for the purpose of presentation processing.

+then it is considered an error and the referenced font resource must be ignored for the purpose of presentation processing.

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.

 @@ -9645,7 +9646,7 @@ layout and presentation.

If the value of this attribute is inlineBlock and this attribute is applied to a span element, then inline block display 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 considered an error if the inlineBlock value is applied to any element which is not a span element.

The tts:display style is illustrated by the following example.

@@ -9893,7 +9894,7 @@ then the specified value is restricted to one of the following: (3) two <length> 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 validation processing and must be ignored +if used, must be considered an error and must be ignored for the purpose of presentation processing, in which case the initial value (auto) applies.

If a tts:extent attribute is specified on a region element, then its computed value determines the width and height @@ -12575,13 +12576,13 @@ the explicit ruby text containe text when the parent of that span element is a span element for which the computed value of tts:ruby is textContainer. -If specified (on the former ruby text content), then it is considered an error, +If specified (on the former ruby text content), then it is considered an error and must be ignored for the purpose of presentation processing.

The absolute position of the ruby text container or ruby text annotation is determined in accordance to the computed value of the tts:writingMode style property of the region into which the affected content is placed; in particular, the mappings defined enumerated by apply as further defined by , §4.1.

-

If two ruby text containers apply to the same ruby base container, then it is considered an error if +

If two ruby text containers apply to the same ruby base container, then it is considered an error if the used value of the property associated with this attribute would result in both ruby text containers being placed on the same relative side of the ruby base container, in which case, the presentation semantics of this property are not defined by this specification.

@@ -16189,7 +16190,7 @@ 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.

The use of referential styling is restricted to making reference to style element descendants of a styling -element. It is considered an error to reference a style +element. It is considered an error to reference a style element that is a descendant of a layout element.

The use of referential styling encourages the reuse of style specifications while @@ -16229,10 +16230,10 @@ ref="semantics-style-inheritance-content"/> below.

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 chained referential styling.

-

A loop in a sequence of chained style references must be considered an error.

+

A loop in a sequence of chained style references must be considered an error.

The use of referential styling is restricted to making reference to style element descendants of a styling -element. It is considered an error to reference a style +element. It is considered an error to reference a style element that is a descendant of a layout element.

The use of chained referential styling encourages the grouping of style specifications @@ -16815,7 +16816,7 @@ determine (obtain) the computed style set CSS of -

If the units of target rectangle TR and reference rectangle RR are not the same, then raise an error condition.

+

It is considered an error 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.

If the width of the target rectangle TR, Wt , is zero, then set Wt to one; likewise, if the height of the target rectangle TR, Ht , is zero, then set Ht to one.

Let SARr be the storage aspect ratio of the reference rectangle RR.

 @@ -16853,7 +16854,7 @@ determine (obtain) the computed style set CSS of -

If the units of target rectangle TR and reference rectangle RR are not the same, then raise an error condition.

 +

It is considered an error 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.

If the width of the target rectangle TR, Wt , is zero, then set Wt to one; likewise, if the height of the target rectangle TR, Ht , is zero, then set Ht to one.

Let SFW be WR /WT , where @@ -18213,7 +18214,7 @@ then the value of this term must be constrained to the interval [0…F-1], where F is the frame rate determined by the ttp:frameRate parameter as defined by . -It is considered an error if a frames term or +It is considered an error if a frames term or f (frames) metric is specified when the clock time base applies.

If a <time-expression> is expressed in terms of a clock-time and a sub-frames term is @@ -18221,9 +18222,9 @@ specified, then the value of this term must be constrained to the interval [0…S-1], where S is the sub-frame rate determined by the ttp:subFrameRate parameter as defined by . -It is considered an error if a sub-frames term is specified +It is considered an error if a sub-frames term is specified when the clock time base applies.

-

It is considered an error if the wallclock-time form of a <time-expression> +

It is considered an error if the wallclock-time form of a <time-expression> is used in a document instance and the government time base is not clock.

If the computed value of the governing time base is smpte, then (1) use of an offset-time form of <time-expression> is deprecated, and @@ -18424,7 +18425,7 @@ considered equivalent to specifying attributeName="tts:color" and <

If a keyTimes attribute is specified and the computed value of calcMode is paced, -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 considered an error and the animation must be ignored for the purpose of presentation processing.

 @@ -18472,7 +18473,7 @@ is 0;0.5;1.

If a keySplines attribute is specified and the computed value of calcMode is not spline, -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 considered an error and the animation must be ignored for the purpose of presentation processing.

 @@ -18482,7 +18483,7 @@ of time components in the computed value of t

If no keySplines attribute is specified and the computed value of calcMode is spline, -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 considered an error and the animation must be ignored for the purpose of presentation processing.

 @@ -21745,7 +21746,6 @@ following features: #presentation or #profile-version-2.

- #processorProfiles

A TTML transformation processor supports the #processorProfiles From 298eb6f96435bb022f5293f49b94dc838787aff2 Mon Sep 17 00:00:00 2001 From: Glenn Adams Date: Mon, 3 Jun 2019 11:15:23 -0600 Subject: [PATCH 2/3] Address https://github.com/w3c/ttml2/pull/1098#pullrequestreview-243035633 (#1098). --- spec/ttml2.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/ttml2.xml b/spec/ttml2.xml index b6445335f..8d6728629 100644 --- a/spec/ttml2.xml +++ b/spec/ttml2.xml @@ -16191,7 +16191,7 @@ style property in the case that it is specified along multiple reference paths.<

The use of referential styling is restricted to making reference to style element descendants of a styling element. It is considered an error to reference a style -element that is a descendant of a layout element.

+element that is a descendant of a layout element, in which case, the presentation semantics are not defined by this specification.

The use of referential styling encourages the reuse of style specifications while sacrificing locality of reference.

From 831f2532c2ffe39822a37081b9d704c4c4c0d9c2 Mon Sep 17 00:00:00 2001 From: Glenn Adams Date: Mon, 3 Jun 2019 11:21:34 -0600 Subject: [PATCH 3/3] Address https://github.com/w3c/ttml2/pull/1098#pullrequestreview-243036041. --- spec/ttml2.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/ttml2.xml b/spec/ttml2.xml index 8d6728629..43bdb54f7 100644 --- a/spec/ttml2.xml +++ b/spec/ttml2.xml @@ -16234,7 +16234,7 @@ is referred to as chained referential styling.

The use of referential styling is restricted to making reference to style element descendants of a styling element. It is considered an error to reference a style -element that is a descendant of a layout element.

+element that is a descendant of a layout element, in which case, the presentation semantics are not defined by this specification.

The use of chained referential styling encourages the grouping of style specifications into general and specific sets, which further aids in style specification reuse.