Skip to content

Commit aa49914

Browse files
committed
Remove CR issue
1 parent bf75b8b commit aa49914

2 files changed

Lines changed: 370 additions & 0 deletions

File tree

css3-text/Overview.html

Lines changed: 201 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -386,6 +386,27 @@ <h2 class="no-num no-toc" id=contents>Table of Contents</h2>
386386
the &lsquo;<code class=property>text-shadow</code>&rsquo; property</a>
387387
</ul>
388388

389+
<li><a href="#conformance"><span class=secno>11. </span> Conformance</a>
390+
<ul class=toc>
391+
<li><a href="#conventions"><span class=secno>11.1. </span> Document
392+
Conventions</a>
393+
394+
<li><a href="#conformance-classes"><span class=secno>11.2. </span>
395+
Conformance Classes</a>
396+
397+
<li><a href="#partial"><span class=secno>11.3. </span> Partial
398+
Implementations</a>
399+
400+
<li><a href="#experimental"><span class=secno>11.4. </span> Experimental
401+
Implementations</a>
402+
403+
<li><a href="#testing"><span class=secno>11.5. </span>Non-Experimental
404+
Implementations</a>
405+
406+
<li><a href="#cr-exit-criteria"><span class=secno>11.6. </span> CR Exit
407+
Criteria</a>
408+
</ul>
409+
389410
<li class=no-num><a href="#acknowledgements"> Appendix A:
390411
Acknowledgements</a>
391412

@@ -5248,6 +5269,177 @@ <h3 id=text-shadow><span class=secno>10.3. </span> Text Shadows: the
52485269
class=css>text-shadow</code></a>&rsquo; property applies to both the
52495270
<code>::first-line</code> and <code>::first-letter</code> pseudo-elements.
52505271

5272+
<h2 id=conformance><span class=secno>11. </span> Conformance</h2>
5273+
5274+
<h3 id=conventions><span class=secno>11.1. </span> Document Conventions</h3>
5275+
5276+
<p>Conformance requirements are expressed with a combination of descriptive
5277+
assertions and RFC 2119 terminology. The key words “MUST”, “MUST
5278+
NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”,
5279+
“SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in the
5280+
normative parts of this document are to be interpreted as described in RFC
5281+
2119. However, for readability, these words do not appear in all uppercase
5282+
letters in this specification.
5283+
5284+
<p>All of the text of this specification is normative except sections
5285+
explicitly marked as non-normative, examples, and notes. <a
5286+
href="#RFC2119" rel=biblioentry>[RFC2119]<!--{{!RFC2119}}--></a>
5287+
5288+
<p>Examples in this specification are introduced with the words “for
5289+
example” or are set apart from the normative text with
5290+
<code>class="example"</code>, like this:
5291+
5292+
<div class=example>
5293+
<p>This is an example of an informative example.</p>
5294+
</div>
5295+
5296+
<p>Informative notes begin with the word “Note” and are set apart from
5297+
the normative text with <code>class="note"</code>, like this:
5298+
5299+
<p class=note>Note, this is an informative note.
5300+
5301+
<h3 id=conformance-classes><span class=secno>11.2. </span> Conformance
5302+
Classes</h3>
5303+
5304+
<p>Conformance to CSS Text Level 3 is defined for three conformance
5305+
classes:
5306+
5307+
<dl>
5308+
<dt><dfn id=style-sheet title="style sheet!!as conformance class">style
5309+
sheet</dfn>
5310+
5311+
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS
5312+
style sheet</a>.
5313+
5314+
<dt><dfn id=renderer>renderer</dfn>
5315+
5316+
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
5317+
that interprets the semantics of a style sheet and renders documents that
5318+
use them.
5319+
5320+
<dt><dfn id=authoring-tool>authoring tool</dfn>
5321+
5322+
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
5323+
that writes a style sheet.
5324+
</dl>
5325+
5326+
<p>A style sheet is conformant to CSS Text Level 3 if all of its
5327+
declarations that use properties defined in this module have values that
5328+
are valid according to the generic CSS grammar and the individual grammars
5329+
of each property as given in this module.
5330+
5331+
<p>A renderer is conformant to CSS Text Level 3 if, in addition to
5332+
interpreting the style sheet as defined by the appropriate specifications,
5333+
it supports all the features defined by CSS Text Level 3 by parsing them
5334+
correctly and rendering the document accordingly. However, the inability
5335+
of a UA to correctly render a document due to limitations of the device
5336+
does not make the UA non-conformant. (For example, a UA is not required to
5337+
render color on a monochrome monitor.)
5338+
5339+
<p>An authoring tool is conformant to CSS Text Level 3 if it writes style
5340+
sheets that are syntactically correct according to the generic CSS grammar
5341+
and the individual grammars of each feature in this module, and meet all
5342+
other conformance requirements of style sheets as described in this
5343+
module.
5344+
5345+
<h3 id=partial><span class=secno>11.3. </span> Partial Implementations</h3>
5346+
5347+
<p>So that authors can exploit the forward-compatible parsing rules to
5348+
assign fallback values, CSS renderers <strong>must</strong> treat as
5349+
invalid (and <a
5350+
href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignore as
5351+
appropriate</a>) any at-rules, properties, property values, keywords, and
5352+
other syntactic constructs for which they have no usable level of support.
5353+
In particular, user agents <strong>must not</strong> selectively ignore
5354+
unsupported component values and honor supported values in a single
5355+
multi-value property declaration: if any value is considered invalid (as
5356+
unsupported values must be), CSS requires that the entire declaration be
5357+
ignored.
5358+
5359+
<h3 id=experimental><span class=secno>11.4. </span> Experimental
5360+
Implementations</h3>
5361+
5362+
<p>To avoid clashes with future CSS features, the CSS2.1 specification
5363+
reserves a <a
5364+
href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
5365+
syntax</a> for proprietary and experimental extensions to CSS.
5366+
5367+
<p>Prior to a specification reaching the Candidate Recommendation stage in
5368+
the W3C process, all implementations of a CSS feature are considered
5369+
experimental. The CSS Working Group recommends that implementations use a
5370+
vendor-prefixed syntax for such features, including those in W3C Working
5371+
Drafts. This avoids incompatibilities with future changes in the draft.
5372+
5373+
<h3 id=testing><span class=secno>11.5. </span>Non-Experimental
5374+
Implementations</h3>
5375+
5376+
<p>Once a specification reaches the Candidate Recommendation stage,
5377+
non-experimental implementations are possible, and implementors should
5378+
release an unprefixed implementation of any CR-level feature they can
5379+
demonstrate to be correctly implemented according to spec.
5380+
5381+
<p>To establish and maintain the interoperability of CSS across
5382+
implementations, the CSS Working Group requests that non-experimental CSS
5383+
renderers submit an implementation report (and, if necessary, the
5384+
testcases used for that implementation report) to the W3C before releasing
5385+
an unprefixed implementation of any CSS features. Testcases submitted to
5386+
W3C are subject to review and correction by the CSS Working Group.
5387+
5388+
<p>Further information on submitting testcases and implementation reports
5389+
can be found from on the CSS Working Group's website at <a
5390+
href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
5391+
Questions should be directed to the <a
5392+
href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
5393+
mailing list.
5394+
5395+
<h3 id=cr-exit-criteria><span class=secno>11.6. </span> CR Exit Criteria</h3>
5396+
5397+
<p> For this specification to be advanced to Proposed Recommendation, there
5398+
must be at least two independent, interoperable implementations of each
5399+
feature. Each feature may be implemented by a different set of products,
5400+
there is no requirement that all features be implemented by a single
5401+
product. For the purposes of this criterion, we define the following
5402+
terms:
5403+
5404+
<dl>
5405+
<dt>independent
5406+
5407+
<dd>each implementation must be developed by a different party and cannot
5408+
share, reuse, or derive from code used by another qualifying
5409+
implementation. Sections of code that have no bearing on the
5410+
implementation of this specification are exempt from this requirement.
5411+
5412+
<dt>interoperable
5413+
5414+
<dd>passing the respective test case(s) in the official CSS test suite,
5415+
or, if the implementation is not a Web browser, an equivalent test. Every
5416+
relevant test in the test suite should have an equivalent test created if
5417+
such a user agent (UA) is to be used to claim interoperability. In
5418+
addition if such a UA is to be used to claim interoperability, then there
5419+
must one or more additional UAs which can also pass those equivalent
5420+
tests in the same way for the purpose of interoperability. The equivalent
5421+
tests must be made publicly available for the purposes of peer review.
5422+
5423+
<dt>implementation
5424+
5425+
<dd>a user agent which:
5426+
<ol class=inline>
5427+
<li>implements the specification.
5428+
5429+
<li>is available to the general public. The implementation may be a
5430+
shipping product or other publicly available version (i.e., beta
5431+
version, preview release, or “nightly build”). Non-shipping product
5432+
releases must have implemented the feature(s) for a period of at least
5433+
one month in order to demonstrate stability.
5434+
5435+
<li>is not experimental (i.e., a version specifically designed to pass
5436+
the test suite and is not intended for normal usage going forward).
5437+
</ol>
5438+
</dl>
5439+
5440+
<p>The specification will remain Candidate Recommendation for at least six
5441+
months.
5442+
52515443
<h2 class=no-num id=acknowledgements> Appendix A: Acknowledgements</h2>
52525444

52535445
<p>This specification would not have been possible without the help from:
@@ -5300,6 +5492,15 @@ <h3 class=no-num id=normative-ref>Normative references</h3>
53005492
</dd>
53015493
<!---->
53025494

5495+
<dt id=RFC2119>[RFC2119]
5496+
5497+
<dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key
5498+
words for use in RFCs to Indicate Requirement Levels.</cite></a> Internet
5499+
RFC 2119. URL: <a
5500+
href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
5501+
</dd>
5502+
<!---->
5503+
53035504
<dt id=UAX11>[UAX11]
53045505

53055506
<dd>Asmus Freytag. <a

css3-text/Overview.src.html

Lines changed: 169 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3943,6 +3943,175 @@ <h3 id="text-shadow">
39433943
<code>::first-line</code> and <code>::first-letter</code>
39443944
pseudo-elements.</p>
39453945

3946+
<h2 id="conformance">
3947+
Conformance</h2>
3948+
3949+
<h3 id="conventions">
3950+
Document Conventions</h3>
3951+
3952+
<p>Conformance requirements are expressed with a combination of
3953+
descriptive assertions and RFC 2119 terminology. The key words “MUST”,
3954+
“MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”,
3955+
“RECOMMENDED”, “MAY”, and “OPTIONAL” in the normative parts of this
3956+
document are to be interpreted as described in RFC 2119.
3957+
However, for readability, these words do not appear in all uppercase
3958+
letters in this specification.
3959+
3960+
<p>All of the text of this specification is normative except sections
3961+
explicitly marked as non-normative, examples, and notes. [[!RFC2119]]</p>
3962+
3963+
<p>Examples in this specification are introduced with the words “for example”
3964+
or are set apart from the normative text with <code>class="example"</code>,
3965+
like this:
3966+
3967+
<div class="example">
3968+
<p>This is an example of an informative example.</p>
3969+
</div>
3970+
3971+
<p>Informative notes begin with the word “Note” and are set apart from the
3972+
normative text with <code>class="note"</code>, like this:
3973+
3974+
<p class="note">Note, this is an informative note.</p>
3975+
3976+
<h3 id="conformance-classes">
3977+
Conformance Classes</h3>
3978+
3979+
<p>Conformance to CSS Text Level 3
3980+
is defined for three conformance classes:
3981+
<dl>
3982+
<dt><dfn title="style sheet!!as conformance class">style sheet</dfn>
3983+
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS
3984+
style sheet</a>.
3985+
<dt><dfn>renderer</dfn></dt>
3986+
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
3987+
that interprets the semantics of a style sheet and renders
3988+
documents that use them.
3989+
<dt><dfn id="authoring-tool">authoring tool</dfn></dt>
3990+
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
3991+
that writes a style sheet.
3992+
</dl>
3993+
3994+
<p>A style sheet is conformant to CSS Text Level 3
3995+
if all of its declarations that use properties defined in this module
3996+
have values that are valid according to the generic CSS grammar and the
3997+
individual grammars of each property as given in this module.
3998+
3999+
<p>A renderer is conformant to CSS Text Level 3
4000+
if, in addition to interpreting the style sheet as defined by the
4001+
appropriate specifications, it supports all the features defined
4002+
by CSS Text Level 3 by parsing them correctly
4003+
and rendering the document accordingly. However, the inability of a
4004+
UA to correctly render a document due to limitations of the device
4005+
does not make the UA non-conformant. (For example, a UA is not
4006+
required to render color on a monochrome monitor.)
4007+
4008+
<p>An authoring tool is conformant to CSS Text Level 3
4009+
if it writes style sheets that are syntactically correct according to the
4010+
generic CSS grammar and the individual grammars of each feature in
4011+
this module, and meet all other conformance requirements of style sheets
4012+
as described in this module.
4013+
4014+
<h3 id="partial">
4015+
Partial Implementations</h3>
4016+
4017+
<p>So that authors can exploit the forward-compatible parsing rules to
4018+
assign fallback values, CSS renderers <strong>must</strong>
4019+
treat as invalid (and <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignore
4020+
as appropriate</a>) any at-rules, properties, property values, keywords,
4021+
and other syntactic constructs for which they have no usable level of
4022+
support. In particular, user agents <strong>must not</strong> selectively
4023+
ignore unsupported component values and honor supported values in a single
4024+
multi-value property declaration: if any value is considered invalid
4025+
(as unsupported values must be), CSS requires that the entire declaration
4026+
be ignored.</p>
4027+
4028+
<h3 id="experimental">
4029+
Experimental Implementations</h3>
4030+
4031+
<p>To avoid clashes with future CSS features, the CSS2.1 specification
4032+
reserves a <a href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
4033+
syntax</a> for proprietary and experimental extensions to CSS.
4034+
4035+
<p>Prior to a specification reaching the Candidate Recommendation stage
4036+
in the W3C process, all implementations of a CSS feature are considered
4037+
experimental. The CSS Working Group recommends that implementations
4038+
use a vendor-prefixed syntax for such features, including those in
4039+
W3C Working Drafts. This avoids incompatibilities with future changes
4040+
in the draft.
4041+
</p>
4042+
4043+
<h3 id="testing">Non-Experimental Implementations</h3>
4044+
4045+
<p>Once a specification reaches the Candidate Recommendation stage,
4046+
non-experimental implementations are possible, and implementors should
4047+
release an unprefixed implementation of any CR-level feature they
4048+
can demonstrate to be correctly implemented according to spec.
4049+
4050+
<p>To establish and maintain the interoperability of CSS across
4051+
implementations, the CSS Working Group requests that non-experimental
4052+
CSS renderers submit an implementation report (and, if necessary, the
4053+
testcases used for that implementation report) to the W3C before
4054+
releasing an unprefixed implementation of any CSS features. Testcases
4055+
submitted to W3C are subject to review and correction by the CSS
4056+
Working Group.
4057+
4058+
<p>Further information on submitting testcases and implementation reports
4059+
can be found from on the CSS Working Group's website at
4060+
<a href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
4061+
Questions should be directed to the
4062+
<a href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
4063+
mailing list.
4064+
4065+
<h3 id="cr-exit-criteria">
4066+
CR Exit Criteria</h3>
4067+
4068+
<p>
4069+
For this specification to be advanced to Proposed Recommendation,
4070+
there must be at least two independent, interoperable implementations
4071+
of each feature. Each feature may be implemented by a different set of
4072+
products, there is no requirement that all features be implemented by
4073+
a single product. For the purposes of this criterion, we define the
4074+
following terms:
4075+
4076+
<dl>
4077+
<dt>independent <dd>each implementation must be developed by a
4078+
different party and cannot share, reuse, or derive from code
4079+
used by another qualifying implementation. Sections of code that
4080+
have no bearing on the implementation of this specification are
4081+
exempt from this requirement.
4082+
4083+
<dt>interoperable <dd>passing the respective test case(s) in the
4084+
official CSS test suite, or, if the implementation is not a Web
4085+
browser, an equivalent test. Every relevant test in the test
4086+
suite should have an equivalent test created if such a user
4087+
agent (UA) is to be used to claim interoperability. In addition
4088+
if such a UA is to be used to claim interoperability, then there
4089+
must one or more additional UAs which can also pass those
4090+
equivalent tests in the same way for the purpose of
4091+
interoperability. The equivalent tests must be made publicly
4092+
available for the purposes of peer review.
4093+
4094+
<dt>implementation <dd>a user agent which:
4095+
4096+
<ol class=inline>
4097+
<li>implements the specification.
4098+
4099+
<li>is available to the general public. The implementation may
4100+
be a shipping product or other publicly available version
4101+
(i.e., beta version, preview release, or “nightly build”).
4102+
Non-shipping product releases must have implemented the
4103+
feature(s) for a period of at least one month in order to
4104+
demonstrate stability.
4105+
4106+
<li>is not experimental (i.e., a version specifically designed
4107+
to pass the test suite and is not intended for normal usage
4108+
going forward).
4109+
</ol>
4110+
</dl>
4111+
4112+
<p>The specification will remain Candidate Recommendation for at least
4113+
six months.
4114+
39464115
<h2 class="no-num" id="acknowledgements">
39474116
Appendix A: Acknowledgements</h2>
39484117

0 commit comments

Comments
 (0)