Skip to content

Commit 781973e

Browse files
committed
[css-ui-3] Rephrase the at-risk section to clarify
1 parent c62f73d commit 781973e

File tree

2 files changed

+22
-19
lines changed

2 files changed

+22
-19
lines changed

css-ui/Overview.bs

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,10 @@ Link Defaults: css-writing-modes-3 (dfn) end
3131
Ignored Terms: outline-top
3232
Ignored Terms: outline-left
3333
Ignored Terms: ime-mode
34-
At Risk: 'caret-color' property
35-
At Risk: 'text-overflow' property value: <<string>>
36-
At Risk: 'text-overflow' property 2-value syntax and definition
37-
At Risk: constraints on 'outline-offset' property negative values
34+
At Risk: The 'caret-color' property
35+
At Risk: The <a href="#overflow-string">&lt;string&gt;</a> value of the 'text-overflow' property
36+
At Risk: The 2-value syntax of the 'text-overflow' property
37+
At Risk: Constraints on <a href="#negative-offset">negative values</a> of the 'outline-offset' property being expressed with MUST rather than with SHOULD
3838
</pre>
3939

4040
<pre class="anchors">
@@ -471,7 +471,7 @@ the following rule can be used:
471471
</code></pre>
472472
</div>
473473

474-
Negative values must cause the outline
474+
<p id=negative-offset>Negative values must cause the outline
475475
to shrink into the border box.
476476
Both the height and the width of outside of the shape
477477
drawn by the outline must not become smaller
@@ -482,7 +482,8 @@ User Agents must apply this constraint
482482
independently in each dimension.
483483
If the outline is drawn as multiple disconnected shapes,
484484
this constraint applies to each shape separately.
485-
Negative value constraints are an at risk feature due to
485+
486+
Note: Negative value constraints are an at risk feature due to
486487
<a href="https://lists.w3.org/Archives/Public/www-style/2014Dec/0033.html">interoperability problems</a>, and thus might be dropped from a must to a should.
487488

488489

@@ -656,18 +657,18 @@ or a single word is too long to fit).
656657
Values have the following meanings:
657658

658659
<dl data-dfn-for="overflow" class="valuedef">
659-
<dt><dfn>clip</dfn></dt>
660+
<dt id=overflow-clip><dfn>clip</dfn></dt>
660661
<dd>Clip inline content that overflows its block container element. Characters may be only partially rendered.</dd>
661662

662-
<dt><dfn>ellipsis</dfn></dt>
663+
<dt id=overflow-ellipsis><dfn>ellipsis</dfn></dt>
663664
<dd>
664665
Render an ellipsis character (U+2026)
665666
to represent clipped inline content.
666667
Implementations may substitute a more language, script, or writing-mode appropriate
667668
ellipsis character,
668669
or three dots "..." if the ellipsis character is unavailable.
669670
</dd>
670-
<dt><<string>></dt>
671+
<dt id=overflow-string><<string>></dt>
671672
<dd>
672673
Render the given string to represent clipped inline content.
673674
The given string is treated as an independent paragraph

css-ui/Overview.html

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -322,10 +322,10 @@ <h2 class="no-num no-toc no-ref heading settled" id="status"><span class="conten
322322
<p>The following features are at-risk, and may be dropped during the CR period:
323323
</p>
324324
<ul>
325-
<li><a class="property" data-link-type="propdesc" href="#propdef-caret-color">caret-color</a> property
326-
<li><a class="property" data-link-type="propdesc" href="#propdef-text-overflow">text-overflow</a> property value: <a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-values-3/#string-value">&lt;string></a>
327-
<li><a class="property" data-link-type="propdesc" href="#propdef-text-overflow">text-overflow</a> property 2-value syntax and definition
328-
<li>constraints on <a class="property" data-link-type="propdesc" href="#propdef-outline-offset">outline-offset</a> property negative values
325+
<li>The <a class="property" data-link-type="propdesc" href="#propdef-caret-color">caret-color</a> property
326+
<li>The <a href="#overflow-string">&lt;string></a> value of the <a class="property" data-link-type="propdesc" href="#propdef-text-overflow">text-overflow</a> property
327+
<li>The 2-value syntax of the <a class="property" data-link-type="propdesc" href="#propdef-text-overflow">text-overflow</a> property
328+
<li>Constraints on <a href="#negative-offset">negative values</a> of the <a class="property" data-link-type="propdesc" href="#propdef-outline-offset">outline-offset</a> property being expressed with MUST rather than with SHOULD
329329
</ul></div>
330330

331331

@@ -1469,7 +1469,7 @@ <h3 class="heading settled" data-level="4.5" id="outline-offset"><span class="se
14691469
</div>
14701470

14711471

1472-
<p>Negative values must cause the outline
1472+
<p id="negative-offset">Negative values must cause the outline
14731473
to shrink into the border box.
14741474
Both the height and the width of outside of the shape
14751475
drawn by the outline must not become smaller
@@ -1480,7 +1480,9 @@ <h3 class="heading settled" data-level="4.5" id="outline-offset"><span class="se
14801480
independently in each dimension.
14811481
If the outline is drawn as multiple disconnected shapes,
14821482
this constraint applies to each shape separately.
1483-
Negative value constraints are an at risk feature due to
1483+
1484+
</p>
1485+
<p class="note" role="note">Note: Negative value constraints are an at risk feature due to
14841486
<a href="https://lists.w3.org/Archives/Public/www-style/2014Dec/0033.html">interoperability problems</a>, and thus might be dropped from a must to a should.</p>
14851487

14861488

@@ -1689,7 +1691,7 @@ <h3 class="heading settled" data-level="5.2" id="text-overflow"><span class="sec
16891691
<td> [
16901692
clip |
16911693
ellipsis |
1692-
<a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-values-3/#string-value" title="Expands to: ">&lt;string></a>
1694+
<a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-values-3/#string-value">&lt;string></a>
16931695
]{1,2}
16941696

16951697

@@ -1753,12 +1755,12 @@ <h3 class="heading settled" data-level="5.2" id="text-overflow"><span class="sec
17531755

17541756
<dl class="valuedef">
17551757

1756-
<dt><dfn data-dfn-for="overflow" data-dfn-type="dfn" data-noexport="" id="clip">clip<a class="self-link" href="#clip"></a></dfn>
1758+
<dt id="overflow-clip"><a class="self-link" href="#overflow-clip"></a><dfn data-dfn-for="overflow" data-dfn-type="dfn" data-noexport="" id="clip">clip<a class="self-link" href="#clip"></a></dfn>
17571759

17581760
<dd>Clip inline content that overflows its block container element. Characters may be only partially rendered.
17591761

17601762

1761-
<dt><dfn data-dfn-for="overflow" data-dfn-type="dfn" data-noexport="" id="ellipsis">ellipsis<a class="self-link" href="#ellipsis"></a></dfn>
1763+
<dt id="overflow-ellipsis"><a class="self-link" href="#overflow-ellipsis"></a><dfn data-dfn-for="overflow" data-dfn-type="dfn" data-noexport="" id="ellipsis">ellipsis<a class="self-link" href="#ellipsis"></a></dfn>
17621764

17631765
<dd>
17641766
Render an ellipsis character (U+2026)
@@ -1768,7 +1770,7 @@ <h3 class="heading settled" data-level="5.2" id="text-overflow"><span class="sec
17681770
or three dots "..." if the ellipsis character is unavailable.
17691771

17701772

1771-
<dt><a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-values-3/#string-value" title="Expands to: ">&lt;string></a>
1773+
<dt id="overflow-string"><a class="self-link" href="#overflow-string"></a><a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-values-3/#string-value" title="Expands to: ">&lt;string></a>
17721774

17731775
<dd>
17741776
Render the given string to represent clipped inline content.

0 commit comments

Comments
 (0)