Skip to content

Commit 7e0ba00

Browse files
committed
[css-text] Export some terms. Remove duplicate boilerplate.
--HG-- extra : rebase_source : 00b1f40ffb6ae9410162db56c779c7cd9131b7ad
1 parent 81dbfe6 commit 7e0ba00

2 files changed

Lines changed: 160 additions & 519 deletions

File tree

css-text/Overview.bs

Lines changed: 3 additions & 177 deletions
Original file line numberDiff line numberDiff line change
@@ -796,7 +796,7 @@ Languages and Typesetting</h4>
796796
it is a <dfn>soft wrap break</dfn>.
797797
The process of breaking inline-level content into lines is called <dfn title="line-breaking-process">line breaking</dfn>.
798798

799-
<p>Wrapping is only performed at an allowed break point, called a <dfn>soft wrap opportunity</dfn>.
799+
<p>Wrapping is only performed at an allowed break point, called a <dfn export>soft wrap opportunity</dfn>.
800800

801801
<p>In most writing systems,
802802
in the absence of hyphenation a <i>soft wrap opportunity</i> occurs only at word boundaries.
@@ -1142,7 +1142,7 @@ Line Breaking Details</h3>
11421142

11431143
<h2 id="hyphenation">Breaking Within Words</h2>
11441144

1145-
<p><dfn title="hyphenation|hyphenate">Hyphenation</dfn>
1145+
<p><dfn id=hyphenate title="hyphenation|hyphenate">Hyphenation</dfn>
11461146
allows the controlled splitting of words
11471147
to improve the layout of paragraphs,
11481148
typically splitting words at syllabic or morphemic boundaries
@@ -1669,7 +1669,7 @@ Expanding and Compressing Text</h4>
16691669
The user agent may alternatively distribute negative space,
16701670
putting more content on the line than would otherwise fit under normal spacing conditions.
16711671

1672-
<p>A <span id="expansion-opportunity"><dfn>justification opportunity</dfn></span> is
1672+
<p>A <span id="expansion-opportunity"><dfn export>justification opportunity</dfn></span> is
16731673
a point where the justification algorithm may alter spacing within the text.
16741674
A justification opportunity can be provided by a single <i>visually-perceived character</i>
16751675
(such as a <i>word separator</i>),
@@ -2639,177 +2639,3 @@ Changes</h2>
26392639
<li>Clarified the behavior of 'text-align' for too long lines.
26402640
<li>Clarified the interaction of 'word-break' and 'line-break'.
26412641
</ul>
2642-
2643-
2644-
<h2 id="conformance" class="no-num">
2645-
Conformance</h2>
2646-
2647-
<h3 id="conventions" class="no-num">
2648-
Document Conventions</h3>
2649-
2650-
<p>Conformance requirements are expressed with a combination of
2651-
descriptive assertions and RFC 2119 terminology. The key words “MUST”,
2652-
“MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”,
2653-
“RECOMMENDED”, “MAY”, and “OPTIONAL” in the normative parts of this
2654-
document are to be interpreted as described in RFC 2119.
2655-
However, for readability, these words do not appear in all uppercase
2656-
letters in this specification.
2657-
2658-
<p>All of the text of this specification is normative except sections
2659-
explicitly marked as non-normative, examples, and notes. [[!RFC2119]]</p>
2660-
2661-
<p>Examples in this specification are introduced with the words “for example”
2662-
or are set apart from the normative text with <code>class="example"</code>,
2663-
like this:
2664-
2665-
<div class="example">
2666-
<p>This is an example of an informative example.</p>
2667-
</div>
2668-
2669-
<p>Informative notes begin with the word “Note” and are set apart from the
2670-
normative text with <code>class="note"</code>, like this:
2671-
2672-
<p class="note">Note, this is an informative note.</p>
2673-
2674-
<h3 id="conformance-classes" class="no-num">
2675-
Conformance Classes</h3>
2676-
2677-
<p>Conformance to CSS Text Level 3
2678-
is defined for three conformance classes:
2679-
<dl>
2680-
<dt><dfn title="style sheet!!as conformance class">style sheet</dfn>
2681-
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS
2682-
style sheet</a>.
2683-
<dt><dfn>renderer</dfn></dt>
2684-
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
2685-
that interprets the semantics of a style sheet and renders
2686-
documents that use them.
2687-
<dt><dfn id="authoring-tool">authoring tool</dfn></dt>
2688-
<dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a>
2689-
that writes a style sheet.
2690-
</dl>
2691-
2692-
<p>A style sheet is conformant to CSS Text Level 3
2693-
if all of its declarations that use properties defined in this module
2694-
have values that are valid according to the generic CSS grammar and the
2695-
individual grammars of each property as given in this module.
2696-
2697-
<p>A renderer is conformant to CSS Text Level 3
2698-
if, in addition to interpreting the style sheet as defined by the
2699-
appropriate specifications, it supports all the features defined
2700-
by CSS Text Level 3 by parsing them correctly
2701-
and rendering the document accordingly. However, the inability of a
2702-
UA to correctly render a document due to limitations of the device
2703-
does not make the UA non-conformant. (For example, a UA is not
2704-
required to render color on a monochrome monitor.)
2705-
2706-
<p>An authoring tool is conformant to CSS Text Level 3
2707-
if it writes style sheets that are syntactically correct according to the
2708-
generic CSS grammar and the individual grammars of each feature in
2709-
this module, and meet all other conformance requirements of style sheets
2710-
as described in this module.
2711-
2712-
<h3 id="partial" class="no-num">
2713-
Partial Implementations</h3>
2714-
2715-
<p>So that authors can exploit the forward-compatible parsing rules to
2716-
assign fallback values, CSS renderers <strong>must</strong>
2717-
treat as invalid (and <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignore
2718-
as appropriate</a>) any at-rules, properties, property values, keywords,
2719-
and other syntactic constructs for which they have no usable level of
2720-
support. In particular, user agents <strong>must not</strong> selectively
2721-
ignore unsupported component values and honor supported values in a single
2722-
multi-value property declaration: if any value is considered invalid
2723-
(as unsupported values must be), CSS requires that the entire declaration
2724-
be ignored.</p>
2725-
2726-
<h3 id="experimental" class="no-num">
2727-
Experimental Implementations</h3>
2728-
2729-
<p>To avoid clashes with future CSS features, the CSS2.1 specification
2730-
reserves a <a href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed
2731-
syntax</a> for proprietary and experimental extensions to CSS.
2732-
2733-
<p>Prior to a specification reaching the Candidate Recommendation stage
2734-
in the W3C process, all implementations of a CSS feature are considered
2735-
experimental. The CSS Working Group recommends that implementations
2736-
use a vendor-prefixed syntax for such features, including those in
2737-
W3C Working Drafts. This avoids incompatibilities with future changes
2738-
in the draft.
2739-
</p>
2740-
2741-
<h3 id="testing" class="no-num">
2742-
Non-Experimental Implementations</h3>
2743-
2744-
<p>Once a specification reaches the Candidate Recommendation stage,
2745-
non-experimental implementations are possible, and implementors should
2746-
release an unprefixed implementation of any CR-level feature they
2747-
can demonstrate to be correctly implemented according to spec.
2748-
2749-
<p>To establish and maintain the interoperability of CSS across
2750-
implementations, the CSS Working Group requests that non-experimental
2751-
CSS renderers submit an implementation report (and, if necessary, the
2752-
testcases used for that implementation report) to the W3C before
2753-
releasing an unprefixed implementation of any CSS features. Testcases
2754-
submitted to W3C are subject to review and correction by the CSS
2755-
Working Group.
2756-
2757-
<p>Further information on submitting testcases and implementation reports
2758-
can be found from on the CSS Working Group's website at
2759-
<a href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>.
2760-
Questions should be directed to the
2761-
<a href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
2762-
mailing list.
2763-
2764-
<h3 id="cr-exit-criteria" class="no-num">
2765-
CR Exit Criteria</h3>
2766-
2767-
<p>
2768-
For this specification to be advanced to Proposed Recommendation,
2769-
there must be at least two independent, interoperable implementations
2770-
of each feature. Each feature may be implemented by a different set of
2771-
products, there is no requirement that all features be implemented by
2772-
a single product. For the purposes of this criterion, we define the
2773-
following terms:
2774-
2775-
<dl>
2776-
<dt>independent <dd>each implementation must be developed by a
2777-
different party and cannot share, reuse, or derive from code
2778-
used by another qualifying implementation. Sections of code that
2779-
have no bearing on the implementation of this specification are
2780-
exempt from this requirement.
2781-
2782-
<dt>interoperable <dd>passing the respective test case(s) in the
2783-
official CSS test suite, or, if the implementation is not a Web
2784-
browser, an equivalent test. Every relevant test in the test
2785-
suite should have an equivalent test created if such a user
2786-
agent (UA) is to be used to claim interoperability. In addition
2787-
if such a UA is to be used to claim interoperability, then there
2788-
must one or more additional UAs which can also pass those
2789-
equivalent tests in the same way for the purpose of
2790-
interoperability. The equivalent tests must be made publicly
2791-
available for the purposes of peer review.
2792-
2793-
<dt>implementation <dd>a user agent which:
2794-
2795-
<ol class=inline>
2796-
<li>implements the specification.
2797-
2798-
<li>is available to the general public. The implementation may
2799-
be a shipping product or other publicly available version
2800-
(i.e., beta version, preview release, or “nightly build”).
2801-
Non-shipping product releases must have implemented the
2802-
feature(s) for a period of at least one month in order to
2803-
demonstrate stability.
2804-
2805-
<li>is not experimental (i.e., a version specifically designed
2806-
to pass the test suite and is not intended for normal usage
2807-
going forward).
2808-
</ol>
2809-
</dl>
2810-
2811-
<p>The specification will remain Candidate Recommendation for at least
2812-
six months.
2813-
2814-
</body>
2815-
</html>

0 commit comments

Comments
 (0)