Skip to content

Commit 4f427e4

Browse files
committed
[css-exclusions] change to generated conformance sections
1 parent d431723 commit 4f427e4

2 files changed

Lines changed: 74 additions & 289 deletions

File tree

css-exclusions/Exclusions.src.html

Lines changed: 6 additions & 152 deletions
Original file line numberDiff line numberDiff line change
@@ -1921,157 +1921,11 @@ <h4 id="shape-padding-property">The 'shape-padding' Property</h4>
19211921
outside the element.</div>
19221922

19231923
<!-- End section "Shapes" -->
1924+
19241925
<h2 id="conformance">Conformance</h2>
1925-
<h3 id="conventions">Document Conventions</h3>
1926-
<p>
1927-
Conformance requirements are expressed with a combination of descriptive assertions
1928-
and RFC 2119 terminology. The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”,
1929-
“SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in the
1930-
normative parts of this document are to be interpreted as described in RFC 2119.
1931-
However, for readability, these words do not appear in all uppercase letters in
1932-
this specification.
1933-
</p>
1934-
<p>
1935-
All of the text of this specification is normative except sections explicitly marked
1936-
as non-normative, examples, and notes. [[!RFC2119]]
1937-
</p>
1938-
<p>
1939-
Examples in this specification are introduced with the words “for example” or are
1940-
set apart from the normative text with <code>class="example"</code>, like this:
1941-
</p>
1942-
<div class="example">
1943-
<p>This is an example of an informative example.</p>
1944-
</div>
1945-
<p>
1946-
Informative notes begin with the word “Note” and are set apart from the normative
1947-
text with <code>class="note"</code>, like this:
1948-
</p>
1949-
<p class="note">Note, this is an informative note.</p>
1950-
<h3 id="conformance-classes">Conformance Classes</h3>
1951-
<p>Conformance to CSS Exclusions and Shapes is defined for three conformance classes:</p>
1952-
<dl>
1953-
<dt><dfn title="style sheet!!as conformance class">style sheet</dfn></dt>
1954-
<dd>
1955-
A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS style sheet</a>.</dd>
1956-
<dt><dfn>renderer</dfn></dt>
1957-
<dd>
1958-
A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a> that interprets
1959-
the semantics of a style sheet and renders documents that use them.</dd>
1960-
<dt><dfn id="authoring-tool">authoring tool</dfn></dt>
1961-
<dd>
1962-
A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a> that writes
1963-
a style sheet.</dd>
1964-
</dl>
1965-
<p>
1966-
A style sheet is conformant to CSS Exclusions and Shapes if all of its declarations
1967-
that use properties defined in this module have values that are valid according
1968-
to the generic CSS grammar and the individual grammars of each property as given
1969-
in this module.
1970-
</p>
1971-
<p>
1972-
A renderer is conformant to CSS Exclusions and Shapes if, in addition to interpreting
1973-
the style sheet as defined by the appropriate specifications, it supports all the
1974-
features defined by CSS Exclusions and Shapes by parsing them correctly and rendering
1975-
the document accordingly. However, the inability of a UA to correctly render a document
1976-
due to limitations of the device does not make the UA non-conformant. (For example,
1977-
a UA is not required to render color on a monochrome monitor.)
1978-
</p>
1979-
<p>
1980-
An authoring tool is conformant to CSS Exclusions and Shapes if it writes style
1981-
sheets that are syntactically correct according to the generic CSS grammar and the
1982-
individual grammars of each feature in this module, and meet all other conformance
1983-
requirements of style sheets as described in this module.
1984-
</p>
1985-
<h3 id="partial">
1986-
Partial Implementations</h3>
1987-
<p>
1988-
So that authors can exploit the forward-compatible parsing rules to assign fallback
1989-
values, CSS renderers <strong>must</strong> treat as invalid (and <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">
1990-
ignore as appropriate</a>) any at-rules, properties, property values, keywords,
1991-
and other syntactic constructs for which they have no usable level of support. In
1992-
particular, user agents <strong>must not</strong> selectively ignore unsupported
1993-
component values and honor supported values in a single multi-value property declaration:
1994-
if any value is considered invalid (as unsupported values must be), CSS requires
1995-
that the entire declaration be ignored.
1996-
</p>
1997-
<h3 id="experimental">
1998-
Experimental Implementations</h3>
1999-
<p>
2000-
To avoid clashes with future CSS features, the CSS2.1 specification reserves a <a
2001-
href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed syntax</a>
2002-
for proprietary and experimental extensions to CSS.</p>
2003-
<p>
2004-
Prior to a specification reaching the Candidate Recommendation stage in the W3C
2005-
process, all implementations of a CSS feature are considered experimental. The CSS
2006-
Working Group recommends that implementations use a vendor-prefixed syntax for such
2007-
features, including those in W3C Working Drafts. This avoids incompatibilities with
2008-
future changes in the draft.
2009-
</p>
2010-
<h3 id="testing">
2011-
Non-Experimental Implementations</h3>
2012-
<p>
2013-
Once a specification reaches the Candidate Recommendation stage, non-experimental
2014-
implementations are possible, and implementors should release an unprefixed implementation
2015-
of any CR-level feature they can demonstrate to be correctly implemented according
2016-
to spec.
2017-
</p>
2018-
<p>
2019-
To establish and maintain the interoperability of CSS across implementations, the
2020-
CSS Working Group requests that non-experimental CSS renderers submit an implementation
2021-
report (and, if necessary, the testcases used for that implementation report) to
2022-
the W3C before releasing an unprefixed implementation of any CSS features. Testcases
2023-
submitted to W3C are subject to review and correction by the CSS Working Group.
2024-
</p>
2025-
<p>
2026-
Further information on submitting testcases and implementation reports can be found
2027-
from on the CSS Working Group's website at <a href="http://www.w3.org/Style/CSS/Test/">
2028-
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">
2029-
public-css-testsuite@w3.org</a> mailing list.
2030-
</p>
2031-
<h3 id="cr-exit-criteria">
2032-
CR Exit Criteria</h3>
2033-
<p>
2034-
For this specification to be advanced to Proposed Recommendation, there must be
2035-
at least two independent, interoperable implementations of each feature. Each feature
2036-
may be implemented by a different set of products, there is no requirement that
2037-
all features be implemented by a single product. For the purposes of this criterion,
2038-
we define the following terms:
2039-
</p>
2040-
<dl>
2041-
<dt>independent </dt>
2042-
<dd>
2043-
each implementation must be developed by a different party and cannot share, reuse,
2044-
or derive from code used by another qualifying implementation. Sections of code
2045-
that have no bearing on the implementation of this specification are exempt from
2046-
this requirement.</dd>
2047-
<dt>interoperable</dt>
2048-
<dd>
2049-
passing the respective test case(s) in the official CSS test suite, or, if the implementation
2050-
is not a Web browser, an equivalent test. Every relevant test in the test suite
2051-
should have an equivalent test created if such a user agent (UA) is to be used to
2052-
claim interoperability. In addition if such a UA is to be used to claim interoperability,
2053-
then there must one or more additional UAs which can also pass those equivalent
2054-
tests in the same way for the purpose of interoperability. The equivalent tests
2055-
must be made publicly available for the purposes of peer review.
2056-
</dd>
2057-
<dt>implementation</dt>
2058-
<dd>
2059-
a user agent which:
2060-
<ol class="inline">
2061-
<li>implements the specification.</li>
2062-
<li>is available to the general public. The implementation may be a shipping product
2063-
or other publicly available version (i.e., beta version, preview release, or “nightly
2064-
build”). Non-shipping product releases must have implemented the feature(s) for
2065-
a period of at least one month in order to demonstrate stability.</li>
2066-
<li>is not experimental (i.e., a version specifically designed to pass the test suite
2067-
and is not intended for normal usage going forward).</li>
2068-
</ol>
2069-
</dd>
2070-
</dl>
2071-
<p>
2072-
The specification will remain Candidate Recommendation for at least six months.
2073-
</p>
2074-
<h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
1926+
<!--conformance-->
1927+
1928+
<h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
20751929
<p>This specification is made possible by input from
20761930
Andrei Bucur,
20771931
Alexandru Chiculita,
@@ -2119,7 +1973,7 @@ <h2 class="no-num" id="property-index">Property index</h2>
21191973

21201974
<h2 class="no-num" id="change-log">Change Log</h2>
21211975

2122-
<h3>Since <a href="http://www.w3.org/TR/2012/WD-css3-exclusions-20120503/">May 3rd 2012</a></h3>
1976+
<h3 class="no-num" >Since <a href="http://www.w3.org/TR/2012/WD-css3-exclusions-20120503/">May 3rd 2012</a></h3>
21231977
<ul>
21241978
<li>Changed shape-inside to contribute to the wrapping context</li>
21251979
<li>Defined exclusion edges relative to wrapping content's writing mode</li>
@@ -2133,7 +1987,7 @@ <h3>Since <a href="http://www.w3.org/TR/2012/WD-css3-exclusions-20120503/">May 3
21331987
<li>Removed wrap shorthand.</li>
21341988
</ul>
21351989

2136-
<h3>Since <a href="http://www.w3.org/TR/2011/WD-css3-exclusions-20111213/">December 13th 2011</a></h3>
1990+
<h3 class="no-num" >Since <a href="http://www.w3.org/TR/2011/WD-css3-exclusions-20111213/">December 13th 2011</a></h3>
21371991
<ul>
21381992
<li>Clarified processing model.</li>
21391993
<li>Clarified interaction with floats.</li>

0 commit comments

Comments
 (0)