- From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 29 Aug 2011 06:29:56 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-text
In directory hutz:/tmp/cvs-serv9129
Modified Files:
Overview.html Overview.src.html
Log Message:
Remove CR issue
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.html,v
retrieving revision 1.176
retrieving revision 1.177
diff -u -d -r1.176 -r1.177
--- Overview.html 29 Aug 2011 06:11:00 -0000 1.176
+++ Overview.html 29 Aug 2011 06:29:54 -0000 1.177
@@ -386,6 +386,27 @@
the ‘<code class=property>text-shadow</code>’ property</a>
</ul>
+ <li><a href="#conformance"><span class=secno>11. </span> Conformance</a>
+ <ul class=toc>
+ <li><a href="#conventions"><span class=secno>11.1. </span> Document
+ Conventions</a>
+
+ <li><a href="#conformance-classes"><span class=secno>11.2. </span>
+ Conformance Classes</a>
+
+ <li><a href="#partial"><span class=secno>11.3. </span> Partial
+ Implementations</a>
+
+ <li><a href="#experimental"><span class=secno>11.4. </span> Experimental
+ Implementations</a>
+
+ <li><a href="#testing"><span class=secno>11.5. </span>Non-Experimental
+ Implementations</a>
+
+ <li><a href="#cr-exit-criteria"><span class=secno>11.6. </span> CR Exit
+ Criteria</a>
+ </ul>
+
<li class=no-num><a href="#acknowledgements"> Appendix A:
Acknowledgements</a>
@@ -5248,6 +5269,177 @@
class=css>text-shadow</code></a>’ property applies to both the
<code>::first-line</code> and <code>::first-letter</code> pseudo-elements.
+ <h2 id=conformance><span class=secno>11. </span> Conformance</h2>
+
+ <h3 id=conventions><span class=secno>11.1. </span> Document Conventions</h3>
+
+ <p>Conformance requirements are expressed with a combination of descriptive
+ assertions and RFC 2119 terminology. The key words “MUST”, “MUST
+ NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”,
+ “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in the
+ normative parts of this document are to be interpreted as described in RFC
+ 2119. However, for readability, these words do not appear in all uppercase
+ letters in this specification.
+
+ <p>All of the text of this specification is normative except sections
+ explicitly marked as non-normative, examples, and notes. <a
+ href="#RFC2119" rel=biblioentry>[RFC2119]<!--{{!RFC2119}}--></a>
+
+ <p>Examples in this specification are introduced with the words “for
+ example” or are set apart from the normative text with
+ <code>class="example"</code>, like this:
+
+ <div class=example>
+ <p>This is an example of an informative example.</p>
+ </div>
+
+ <p>Informative notes begin with the word “Note” and are set apart from
+ the normative text with <code>class="note"</code>, like this:
+
+ <p class=note>Note, this is an informative note.
+
+ <h3 id=conformance-classes><span class=secno>11.2. </span> Conformance
+ Classes</h3>
+
+ <p>Conformance to CSS Text Level 3 is defined for three conformance
+ classes:
+
+ <dl>
+ <dt><dfn id=style-sheet title="style sheet!!as conformance class">style
+ sheet</dfn>
+
+ <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS
+ style sheet</a>.
+
+ <dt><dfn id=renderer>renderer</dfn>
+
+ <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
+ that interprets the semantics of a style sheet and renders documents that
+ use them.
+
+ <dt><dfn id=authoring-tool>authoring tool</dfn>
+
+ <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
+ that writes a style sheet.
+ </dl>
+
+ <p>A style sheet is conformant to CSS Text Level 3 if all of its
+ declarations that use properties defined in this module have values that
+ are valid according to the generic CSS grammar and the individual grammars
+ of each property as given in this module.
+
+ <p>A renderer is conformant to CSS Text Level 3 if, in addition to
+ interpreting the style sheet as defined by the appropriate specifications,
+ it supports all the features defined by CSS Text Level 3 by parsing them
+ correctly and rendering the document accordingly. However, the inability
+ of a UA to correctly render a document due to limitations of the device
+ does not make the UA non-conformant. (For example, a UA is not required to
+ render color on a monochrome monitor.)
+
+ <p>An authoring tool is conformant to CSS Text Level 3 if it writes style
+ sheets that are syntactically correct according to the generic CSS grammar
+ and the individual grammars of each feature in this module, and meet all
+ other conformance requirements of style sheets as described in this
+ module.
+
+ <h3 id=partial><span class=secno>11.3. </span> Partial Implementations</h3>
+
+ <p>So that authors can exploit the forward-compatible parsing rules to
+ assign fallback values, CSS renderers <strong>must</strong> treat as
+ invalid (and <a
+ href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignore as
+ appropriate</a>) any at-rules, properties, property values, keywords, and
+ other syntactic constructs for which they have no usable level of support.
+ In particular, user agents <strong>must not</strong> selectively ignore
+ unsupported component values and honor supported values in a single
+ multi-value property declaration: if any value is considered invalid (as
+ unsupported values must be), CSS requires that the entire declaration be
+ ignored.
+
+ <h3 id=experimental><span class=secno>11.4. </span> Experimental
+ Implementations</h3>
+
+ <p>To avoid clashes with future CSS features, the CSS2.1 specification
+ reserves a <a
+ href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
+ syntax</a> for proprietary and experimental extensions to CSS.
+
+ <p>Prior to a specification reaching the Candidate Recommendation stage in
+ the W3C process, all implementations of a CSS feature are considered
+ experimental. The CSS Working Group recommends that implementations use a
+ vendor-prefixed syntax for such features, including those in W3C Working
+ Drafts. This avoids incompatibilities with future changes in the draft.
+
+ <h3 id=testing><span class=secno>11.5. </span>Non-Experimental
+ Implementations</h3>
+
+ <p>Once a specification reaches the Candidate Recommendation stage,
+ non-experimental implementations are possible, and implementors should
+ release an unprefixed implementation of any CR-level feature they can
+ demonstrate to be correctly implemented according to spec.
+
+ <p>To establish and maintain the interoperability of CSS across
+ implementations, the CSS Working Group requests that non-experimental CSS
+ renderers submit an implementation report (and, if necessary, the
+ testcases used for that implementation report) to the W3C before releasing
+ an unprefixed implementation of any CSS features. Testcases submitted to
+ W3C are subject to review and correction by the CSS Working Group.
+
+ <p>Further information on submitting testcases and implementation reports
+ can be found from on the CSS Working Group's website at <a
+ href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
+ Questions should be directed to the <a
+ href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
+ mailing list.
+
+ <h3 id=cr-exit-criteria><span class=secno>11.6. </span> CR Exit Criteria</h3>
+
+ <p> For this specification to be advanced to Proposed Recommendation, there
+ must be at least two independent, interoperable implementations of each
+ feature. Each feature may be implemented by a different set of products,
+ there is no requirement that all features be implemented by a single
+ product. For the purposes of this criterion, we define the following
+ terms:
+
+ <dl>
+ <dt>independent
+
+ <dd>each implementation must be developed by a different party and cannot
+ share, reuse, or derive from code used by another qualifying
+ implementation. Sections of code that have no bearing on the
+ implementation of this specification are exempt from this requirement.
+
+ <dt>interoperable
+
+ <dd>passing the respective test case(s) in the official CSS test suite,
+ or, if the implementation is not a Web browser, an equivalent test. Every
+ relevant test in the test suite should have an equivalent test created if
+ such a user agent (UA) is to be used to claim interoperability. In
+ addition if such a UA is to be used to claim interoperability, then there
+ must one or more additional UAs which can also pass those equivalent
+ tests in the same way for the purpose of interoperability. The equivalent
+ tests must be made publicly available for the purposes of peer review.
+
+ <dt>implementation
+
+ <dd>a user agent which:
+ <ol class=inline>
+ <li>implements the specification.
+
+ <li>is available to the general public. The implementation may be a
+ shipping product or other publicly available version (i.e., beta
+ version, preview release, or “nightly build”). Non-shipping product
+ releases must have implemented the feature(s) for a period of at least
+ one month in order to demonstrate stability.
+
+ <li>is not experimental (i.e., a version specifically designed to pass
+ the test suite and is not intended for normal usage going forward).
+ </ol>
+ </dl>
+
+ <p>The specification will remain Candidate Recommendation for at least six
+ months.
+
<h2 class=no-num id=acknowledgements> Appendix A: Acknowledgements</h2>
<p>This specification would not have been possible without the help from:
@@ -5300,6 +5492,15 @@
</dd>
<!---->
+ <dt id=RFC2119>[RFC2119]
+
+ <dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key
+ words for use in RFCs to Indicate Requirement Levels.</cite></a> Internet
+ RFC 2119. URL: <a
+ href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
+ </dd>
+ <!---->
+
<dt id=UAX11>[UAX11]
<dd>Asmus Freytag. <a
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.src.html,v
retrieving revision 1.274
retrieving revision 1.275
diff -u -d -r1.274 -r1.275
--- Overview.src.html 29 Aug 2011 06:11:00 -0000 1.274
+++ Overview.src.html 29 Aug 2011 06:29:54 -0000 1.275
@@ -3943,6 +3943,175 @@
<code>::first-line</code> and <code>::first-letter</code>
pseudo-elements.</p>
+<h2 id="conformance">
+Conformance</h2>
+
+<h3 id="conventions">
+Document Conventions</h3>
+
+ <p>Conformance requirements are expressed with a combination of
+ descriptive assertions and RFC 2119 terminology. The key words “MUST”,
+ “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”,
+ “RECOMMENDED”, “MAY”, and “OPTIONAL” in the normative parts of this
+ document are to be interpreted as described in RFC 2119.
+ However, for readability, these words do not appear in all uppercase
+ letters in this specification.
+
+ <p>All of the text of this specification is normative except sections
+ explicitly marked as non-normative, examples, and notes. [[!RFC2119]]</p>
+
+ <p>Examples in this specification are introduced with the words “for example”
+ or are set apart from the normative text with <code>class="example"</code>,
+ like this:
+
+ <div class="example">
+ <p>This is an example of an informative example.</p>
+ </div>
+
+ <p>Informative notes begin with the word “Note” and are set apart from the
+ normative text with <code>class="note"</code>, like this:
+
+ <p class="note">Note, this is an informative note.</p>
+
+<h3 id="conformance-classes">
+Conformance Classes</h3>
+
+ <p>Conformance to CSS Text Level 3
+ is defined for three conformance classes:
+ <dl>
+ <dt><dfn title="style sheet!!as conformance class">style sheet</dfn>
+ <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS
+ style sheet</a>.
+ <dt><dfn>renderer</dfn></dt>
+ <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
+ that interprets the semantics of a style sheet and renders
+ documents that use them.
+ <dt><dfn id="authoring-tool">authoring tool</dfn></dt>
+ <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
+ that writes a style sheet.
+ </dl>
+
+ <p>A style sheet is conformant to CSS Text Level 3
+ if all of its declarations that use properties defined in this module
+ have values that are valid according to the generic CSS grammar and the
+ individual grammars of each property as given in this module.
+
+ <p>A renderer is conformant to CSS Text Level 3
+ if, in addition to interpreting the style sheet as defined by the
+ appropriate specifications, it supports all the features defined
+ by CSS Text Level 3 by parsing them correctly
+ and rendering the document accordingly. However, the inability of a
+ UA to correctly render a document due to limitations of the device
+ does not make the UA non-conformant. (For example, a UA is not
+ required to render color on a monochrome monitor.)
+
+ <p>An authoring tool is conformant to CSS Text Level 3
+ if it writes style sheets that are syntactically correct according to the
+ generic CSS grammar and the individual grammars of each feature in
+ this module, and meet all other conformance requirements of style sheets
+ as described in this module.
+
+<h3 id="partial">
+Partial Implementations</h3>
+
+ <p>So that authors can exploit the forward-compatible parsing rules to
+ assign fallback values, CSS renderers <strong>must</strong>
+ treat as invalid (and <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignore
+ as appropriate</a>) any at-rules, properties, property values, keywords,
+ and other syntactic constructs for which they have no usable level of
+ support. In particular, user agents <strong>must not</strong> selectively
+ ignore unsupported component values and honor supported values in a single
+ multi-value property declaration: if any value is considered invalid
+ (as unsupported values must be), CSS requires that the entire declaration
+ be ignored.</p>
+
+<h3 id="experimental">
+Experimental Implementations</h3>
+
+ <p>To avoid clashes with future CSS features, the CSS2.1 specification
+ reserves a <a href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
+ syntax</a> for proprietary and experimental extensions to CSS.
+
+ <p>Prior to a specification reaching the Candidate Recommendation stage
+ in the W3C process, all implementations of a CSS feature are considered
+ experimental. The CSS Working Group recommends that implementations
+ use a vendor-prefixed syntax for such features, including those in
+ W3C Working Drafts. This avoids incompatibilities with future changes
+ in the draft.
+ </p>
+
+<h3 id="testing">Non-Experimental Implementations</h3>
+
+ <p>Once a specification reaches the Candidate Recommendation stage,
+ non-experimental implementations are possible, and implementors should
+ release an unprefixed implementation of any CR-level feature they
+ can demonstrate to be correctly implemented according to spec.
+
+ <p>To establish and maintain the interoperability of CSS across
+ implementations, the CSS Working Group requests that non-experimental
+ CSS renderers submit an implementation report (and, if necessary, the
+ testcases used for that implementation report) to the W3C before
+ releasing an unprefixed implementation of any CSS features. Testcases
+ submitted to W3C are subject to review and correction by the CSS
+ Working Group.
+
+ <p>Further information on submitting testcases and implementation reports
+ can be found from on the CSS Working Group's website at
+ <a href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
+ Questions should be directed to the
+ <a href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
+ mailing list.
+
+<h3 id="cr-exit-criteria">
+CR Exit Criteria</h3>
+
+ <p>
+ For this specification to be advanced to Proposed Recommendation,
+ there must be at least two independent, interoperable implementations
+ of each feature. Each feature may be implemented by a different set of
+ products, there is no requirement that all features be implemented by
+ a single product. For the purposes of this criterion, we define the
+ following terms:
+
+ <dl>
+ <dt>independent <dd>each implementation must be developed by a
+ different party and cannot share, reuse, or derive from code
+ used by another qualifying implementation. Sections of code that
+ have no bearing on the implementation of this specification are
+ exempt from this requirement.
+
+ <dt>interoperable <dd>passing the respective test case(s) in the
+ official CSS test suite, or, if the implementation is not a Web
+ browser, an equivalent test. Every relevant test in the test
+ suite should have an equivalent test created if such a user
+ agent (UA) is to be used to claim interoperability. In addition
+ if such a UA is to be used to claim interoperability, then there
+ must one or more additional UAs which can also pass those
+ equivalent tests in the same way for the purpose of
+ interoperability. The equivalent tests must be made publicly
+ available for the purposes of peer review.
+
+ <dt>implementation <dd>a user agent which:
+
+ <ol class=inline>
+ <li>implements the specification.
+
+ <li>is available to the general public. The implementation may
+ be a shipping product or other publicly available version
+ (i.e., beta version, preview release, or “nightly build”).
+ Non-shipping product releases must have implemented the
+ feature(s) for a period of at least one month in order to
+ demonstrate stability.
+
+ <li>is not experimental (i.e., a version specifically designed
+ to pass the test suite and is not intended for normal usage
+ going forward).
+ </ol>
+ </dl>
+
+ <p>The specification will remain Candidate Recommendation for at least
+ six months.
+
<h2 class="no-num" id="acknowledgements">
Appendix A: Acknowledgements</h2>
Received on Monday, 29 August 2011 06:29:59 UTC