Skip to content

Commit 760a682

Browse files
committed
remove text that is already covered
1 parent 9db1556 commit 760a682

2 files changed

Lines changed: 5 additions & 133 deletions

File tree

cssom/Overview.html

Lines changed: 2 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -3572,19 +3572,6 @@ <h4 id=serializing-css-values><span class=secno>6.6.2. </span>Serializing
35723572
href="#escape-a-string" title="escape a string">escaped</a> value of the
35733573
given string, followed by '<code>")</code>'.</p>
35743574
<!--
3575-
<ol>
3576-
<li><p>Relative lengths (<code>em</code>, <code>ex</code>, <code>px</code>,
3577-
all the font-size keywords and <code>%</code>) do not have their units
3578-
changed. However, absolute lengths must be given in millimeters. For example,
3579-
the canonical version of <code>+012.0pt</code> is <code>4.2333mm</code> (give
3580-
or take a few significant figures). <span class="note"><em>Computed</em>
3581-
values may well be in different units than the specified value. User agents
3582-
are to use <code>px</code> as their final units for computed length
3583-
values.</span></p></li>
3584-
3585-
<li><p>When a <code>&lt;length></code> of zero is given change it to
3586-
"<code>0px</code>"</p></li>
3587-
35883575
<li>
35893576
<p>A <code>&lt;color></code> value is canonicalized as follows:</p>
35903577
@@ -3622,29 +3609,6 @@ <h4 id=serializing-css-values><span class=secno>6.6.2. </span>Serializing
36223609
</dl>
36233610
</li>
36243611
3625-
<li><p>Angles are canonicalized to <code>deg</code> and normalized to the
3626-
range of their property. For example, <code>azimuth: 700grad</code> would be
3627-
canonicalized to <code>azimuth: 270deg</code>. This also applies to angle
3628-
keywords as used in the <code>elevation</code> and <code>azimuth</code>
3629-
properties, they are canonicalized to their value in degrees.</p></li>
3630-
3631-
<li><p>Times are canonicalized to seconds (<code>s</code>).</p></li>
3632-
3633-
<li><p>Frequencies are canonicalized to Hertz (<code>Hz</code>).</p></li>
3634-
3635-
<li><p>For all integers and real numbers, including those with units, these
3636-
canonicalization steps <em class="ct">must</em> be followed: If the number
3637-
is <code>0</code>, the canonical result is the literal string <code>0</code>
3638-
plus any units (for lengths, the unit identifier will have been removed
3639-
before this step). Otherwise, leading <!- -and trailing - ->zeros
3640-
<em class="ct">must</em> be omitted, any leading <code>+</code>
3641-
<em class="ct">must</em> be omitted, the decimal point in a real number
3642-
<em class="ct">must</em> be omitted unless there is a fractional part, and if
3643-
the number is in the range <code>-1 &lt; <var title="">x</var> &lt; 1</code>, then one
3644-
leading <code>0</code> <em class="ct">must</em> be inserted before the
3645-
decimal point. The number of given significant figures is completely user
3646-
agent dependent.</p></li>
3647-
36483612
<li><p>Where multiple values may appear in any order without changing the
36493613
meaning of the value (typically represented by a double bar <code>||</code>
36503614
in the value syntax), user agents are to use the canonical order as given in
@@ -3660,21 +3624,7 @@ <h4 id=serializing-css-values><span class=secno>6.6.2. </span>Serializing
36603624
36613625
<li><p><code>&lt;specific-voice></code> and <code>&lt;family-name</code>
36623626
values are to be quoted.</p></li>
3663-
3664-
<li><p>Double quotes (rather than single quotes) <em class="ct">shall</em> be
3665-
used for string quotation. (When changing from single quotes to double
3666-
quotes, double quotes already in the string are escaped.)</p></li>
3667-
3668-
<li><p>The quotes in the <code>&lt;uri></code> form should be removed.
3669-
(Parenthesises that were in the string, along with any other characters not
3670-
legal when the string is not quoted (such as commas), must be
3671-
escaped.)</p></li>
3672-
3673-
<li><p>Unnecessary escapes should be removed. (For example, <code>\z</code>
3674-
should be represented as <code>z</code>. This extends to unescaping UNICODE
3675-
escapes, except, of course, if the encoding cannot contain those
3676-
characters!)</p></li>
3677-
3627+
36783628
<li><p>Where components of the value may be dropped without changing the
36793629
meaning of the value (for example, initial values in shorthand properties),
36803630
then they should be removed. If this would remove all the values, then the
@@ -3683,7 +3633,7 @@ <h4 id=serializing-css-values><span class=secno>6.6.2. </span>Serializing
36833633
<code>background-color</code> is the first component of the value; for
36843634
<code>border</code> it would be <code>0</code> since the first component of
36853635
that value is <code>border-width</code>).</p></li>
3686-
3636+
36873637
<li>
36883638
<p>A single space should be added after each comma that is not part of a
36893639
string, except where that would change the meaning of the value. For
@@ -3696,20 +3646,6 @@ <h4 id=serializing-css-values><span class=secno>6.6.2. </span>Serializing
36963646
<pre>foo, bar, baz</pre>
36973647
</li>
36983648
3699-
<li>
3700-
<p>Whenever case is insensitive, for example in property or counter names,
3701-
the text should be changed to the canonical case as given in the syntax
3702-
definition. For example, the canonical value of:</p>
3703-
3704-
<pre>COUNTER( PAR-NUM,UPPER-ROMAN ) DISC</pre>
3705-
3706-
<p>is:</p>
3707-
3708-
<pre>counter(par-num, upper-roman) disc</pre>
3709-
3710-
<p>but the color <code>WINDOWTEXT</code> becomes
3711-
<code>WindowText</code>.</p>
3712-
</li>
37133649
</ol>
37143650
-->
37153651

cssom/Overview.src.html

Lines changed: 3 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1902,7 +1902,7 @@ <h3>CSS Declaration Blocks</h3>
19021902

19031903
<p class="XXX">To
19041904
<dfn id="serialize-a-css-declaration-block">serialize a CSS declaration block</dfn>
1905-
...</p>
1905+
...</p>
19061906

19071907

19081908

@@ -2236,19 +2236,6 @@ <h4>Serializing CSS Values</h4>
22362236
followed by '<code>")</code>'.</p>
22372237

22382238
<!--
2239-
<ol>
2240-
<li><p>Relative lengths (<code>em</code>, <code>ex</code>, <code>px</code>,
2241-
all the font-size keywords and <code>%</code>) do not have their units
2242-
changed. However, absolute lengths must be given in millimeters. For example,
2243-
the canonical version of <code>+012.0pt</code> is <code>4.2333mm</code> (give
2244-
or take a few significant figures). <span class="note"><em>Computed</em>
2245-
values may well be in different units than the specified value. User agents
2246-
are to use <code>px</code> as their final units for computed length
2247-
values.</span></p></li>
2248-
2249-
<li><p>When a <code>&lt;length></code> of zero is given change it to
2250-
"<code>0px</code>"</p></li>
2251-
22522239
<li>
22532240
<p>A <code>&lt;color></code> value is canonicalized as follows:</p>
22542241
@@ -2286,29 +2273,6 @@ <h4>Serializing CSS Values</h4>
22862273
</dl>
22872274
</li>
22882275
2289-
<li><p>Angles are canonicalized to <code>deg</code> and normalized to the
2290-
range of their property. For example, <code>azimuth: 700grad</code> would be
2291-
canonicalized to <code>azimuth: 270deg</code>. This also applies to angle
2292-
keywords as used in the <code>elevation</code> and <code>azimuth</code>
2293-
properties, they are canonicalized to their value in degrees.</p></li>
2294-
2295-
<li><p>Times are canonicalized to seconds (<code>s</code>).</p></li>
2296-
2297-
<li><p>Frequencies are canonicalized to Hertz (<code>Hz</code>).</p></li>
2298-
2299-
<li><p>For all integers and real numbers, including those with units, these
2300-
canonicalization steps <em class="ct">must</em> be followed: If the number
2301-
is <code>0</code>, the canonical result is the literal string <code>0</code>
2302-
plus any units (for lengths, the unit identifier will have been removed
2303-
before this step). Otherwise, leading <!- -and trailing - ->zeros
2304-
<em class="ct">must</em> be omitted, any leading <code>+</code>
2305-
<em class="ct">must</em> be omitted, the decimal point in a real number
2306-
<em class="ct">must</em> be omitted unless there is a fractional part, and if
2307-
the number is in the range <code>-1 &lt; <var title="">x</var> &lt; 1</code>, then one
2308-
leading <code>0</code> <em class="ct">must</em> be inserted before the
2309-
decimal point. The number of given significant figures is completely user
2310-
agent dependent.</p></li>
2311-
23122276
<li><p>Where multiple values may appear in any order without changing the
23132277
meaning of the value (typically represented by a double bar <code>||</code>
23142278
in the value syntax), user agents are to use the canonical order as given in
@@ -2324,21 +2288,7 @@ <h4>Serializing CSS Values</h4>
23242288
23252289
<li><p><code>&lt;specific-voice></code> and <code>&lt;family-name</code>
23262290
values are to be quoted.</p></li>
2327-
2328-
<li><p>Double quotes (rather than single quotes) <em class="ct">shall</em> be
2329-
used for string quotation. (When changing from single quotes to double
2330-
quotes, double quotes already in the string are escaped.)</p></li>
2331-
2332-
<li><p>The quotes in the <code>&lt;uri></code> form should be removed.
2333-
(Parenthesises that were in the string, along with any other characters not
2334-
legal when the string is not quoted (such as commas), must be
2335-
escaped.)</p></li>
2336-
2337-
<li><p>Unnecessary escapes should be removed. (For example, <code>\z</code>
2338-
should be represented as <code>z</code>. This extends to unescaping UNICODE
2339-
escapes, except, of course, if the encoding cannot contain those
2340-
characters!)</p></li>
2341-
2291+
23422292
<li><p>Where components of the value may be dropped without changing the
23432293
meaning of the value (for example, initial values in shorthand properties),
23442294
then they should be removed. If this would remove all the values, then the
@@ -2347,7 +2297,7 @@ <h4>Serializing CSS Values</h4>
23472297
<code>background-color</code> is the first component of the value; for
23482298
<code>border</code> it would be <code>0</code> since the first component of
23492299
that value is <code>border-width</code>).</p></li>
2350-
2300+
23512301
<li>
23522302
<p>A single space should be added after each comma that is not part of a
23532303
string, except where that would change the meaning of the value. For
@@ -2360,20 +2310,6 @@ <h4>Serializing CSS Values</h4>
23602310
<pre>foo, bar, baz</pre>
23612311
</li>
23622312
2363-
<li>
2364-
<p>Whenever case is insensitive, for example in property or counter names,
2365-
the text should be changed to the canonical case as given in the syntax
2366-
definition. For example, the canonical value of:</p>
2367-
2368-
<pre>COUNTER( PAR-NUM,UPPER-ROMAN ) DISC</pre>
2369-
2370-
<p>is:</p>
2371-
2372-
<pre>counter(par-num, upper-roman) disc</pre>
2373-
2374-
<p>but the color <code>WINDOWTEXT</code> becomes
2375-
<code>WindowText</code>.</p>
2376-
</li>
23772313
</ol>
23782314
-->
23792315

0 commit comments

Comments
 (0)