- From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 02 May 2011 19:11:57 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-lists
In directory hutz:/tmp/cvs-serv15331
Modified Files:
Overview.html Overview.src.html
Log Message:
Editorial cleanup.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.html,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -d -r1.39 -r1.40
--- Overview.html 30 Apr 2011 01:17:46 -0000 1.39
+++ Overview.html 2 May 2011 19:11:55 -0000 1.40
@@ -25,12 +25,12 @@
<h1>CSS Lists and Counters Module Level 3</h1>
- <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 30 April 2011</h2>
+ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 2 May 2011</h2>
<dl>
<dt>This version:
- <dd><!-- <a href="http://www.w3.org/TR/2011/WD-css3-lists-20110430">http://www.w3.org/TR/2011/WD-css3-lists-20110430</a></dd> -->
+ <dd><!-- <a href="http://www.w3.org/TR/2011/WD-css3-lists-20110502">http://www.w3.org/TR/2011/WD-css3-lists-20110502</a></dd> -->
<a
href="http://dev.w3.org/csswg/css3-lists/">http://dev.w3.org/csswg/css3-lists/</a>
@@ -180,19 +180,16 @@
<li><a href="#predefined-counters"><span class=secno>8. </span> Predefined
Counter Styles</a>
<ul class=toc>
- <li><a href="#decimal-counters"><span class=secno>8.1. </span> The
- ‘<code class=css>decimal</code>’ counter style</a>
-
- <li><a href="#glyph-counters"><span class=secno>8.2. </span> Glyphs</a>
+ <li><a href="#glyph-counters"><span class=secno>8.1. </span> Glyphs</a>
- <li><a href="#complex-counters"><span class=secno>8.3. </span> Complex
+ <li><a href="#complex-counters"><span class=secno>8.2. </span> Complex
counter styles</a>
<ul class=toc>
- <li><a href="#ethiopic-numeric"><span class=secno>8.3.1. </span> The
+ <li><a href="#ethiopic-numeric"><span class=secno>8.2.1. </span> The
‘<code class=property>ethiopic-numeric</code>’ counter
style</a>
- <li><a href="#cjk-counter-styles"><span class=secno>8.3.2. </span> The
+ <li><a href="#cjk-counter-styles"><span class=secno>8.2.2. </span> The
Chinese longhand counter styles</a>
</ul>
</ul>
@@ -1091,21 +1088,7 @@
require special handling beyond what can be expressed in a stylesheet,
though. Those counter styles are described in this section.
- <h3 id=decimal-counters><span class=secno>8.1. </span> The ‘<code
- class=css>decimal</code>’ counter style</h3>
-
- <p>The ‘<code class=css>decimal</code>’ counter style is the
- default fallback counter style for the ‘<code
- class=css>@counter-style</code>’ rule, and is also used in
- extraordinary situations like fallback loop. As such, it has to be
- well-defined at all times, so that a counter can always be formatted
- regardless of the validity of the defined counter styles.
-
- <p>UAs must not allow the definition of the ‘<code
- class=css>decimal</code>’ counter style given in Appendix A to be
- overridden.
-
- <h3 id=glyph-counters><span class=secno>8.2. </span> Glyphs</h3>
+ <h3 id=glyph-counters><span class=secno>8.1. </span> Glyphs</h3>
<p>CSS 2.1 defined three single-glyph counter styles (‘<code
class=css>circle</code>’, ‘<code class=css>disc</code>’,
@@ -1116,9 +1099,10 @@
<p>Appendix A gives normative definitions for these styles, but UAs may
instead default to rendering these styles using a browser-generated image
- matching the description below. If the styles are overridden, the new
- style must be honored; this relaxation of the rendering requirements
- applies only to the default value of each counter style.
+ matching the description below. This only describes the rendering of the
+ default counter styles associated with these names - if an author or user
+ creates their own counter style with one of these names (overriding the
+ UA-default version), they must be honored as normal.
<p>If the UA chooses to use an image for the default rendering of these
counter styles, the image must be scalable and designed to attractively
@@ -1138,19 +1122,22 @@
<dd>A filled square, similar to ■ U+25A0 BLACK SQUARE.
</dl>
- <h3 id=complex-counters><span class=secno>8.3. </span> Complex counter
+ <h3 id=complex-counters><span class=secno>8.2. </span> Complex counter
styles</h3>
- <p>Some real-life counter styles are unfortunately too complex to be
- accurately described using the ‘<code
- class=css>@counter-style</code>’ rule. The following styles must be
- supported as default counter styles as if they were defined by theoretical
- ‘<code class=css>@counter-style</code>’ rules placed at the
- end of the UA stylesheet defined in Appendix A, using the given name as
- the counter style name and the given algorithm to format counter values.
- They must be overrideable like any other predefined counter style.
+ <p>Nearly all counter styles can be described using the small set of
+ algorithms described by the ‘<a href="#type"><code
+ class=property>type</code></a>’ descriptor. A small handful, though,
+ require more complex handling which is too specialized to warrant crafting
+ a generalized algorithm to use in ‘<a href="#type"><code
+ class=property>type</code></a>’. Instead, their algorithms are
+ described here. Just like a counter style defined with the @counter-style
+ rule, these counter styles can be overridden by creating another
+ @counter-style rule with the same name, or can be used in the ‘<code
+ class=property>override</code>’ type to alter their descriptors
+ while keeping the algorithms described here.
- <h4 id=ethiopic-numeric><span class=secno>8.3.1. </span> The ‘<code
+ <h4 id=ethiopic-numeric><span class=secno>8.2.1. </span> The ‘<code
class=property>ethiopic-numeric</code>’ counter style</h4>
<p>The Ethiopian numbering system is defined for all positive non-zero
@@ -1317,7 +1304,8 @@
<li>Concatenate the groups into one string.
</ol>
- <p>For this system, the <a href="#lower-range-bound"><i
+ <p>For this system, the <a href="#name"><i title=counter-name>name</i></a>
+ is "ethiopian-numeric", the <a href="#lower-range-bound"><i
title=counter-lower-bound>lower range bound descriptor</i></a> is 1, the
<a href="#upper"><i title=counter-upper-bound>upper range bound
descriptor</i></a> is infinity, and the rest of the descriptors have their
@@ -1339,7 +1327,7 @@
U+137B <!-- odd --> U+137A U+136A. <!-- 90 2 --></p>
</div>
- <h4 id=cjk-counter-styles><span class=secno>8.3.2. </span> The Chinese
+ <h4 id=cjk-counter-styles><span class=secno>8.2.2. </span> The Chinese
longhand counter styles</h4>
<p>Chinese, Japanese, and Korean have longhand counter styles, which have a
@@ -1787,24 +1775,37 @@
counter styles in CSS.
<p>A <dfn id=counter-style0>counter style</dfn> defines how to construct
- the representation of a counter value. Counter styles are composed of: a
- <dfn id=name title=counter-name>name</dfn>, to identify the style; a <dfn
- id=negative-sign title=counter-negative>negative sign</dfn>, which is
- prepended or appended to the representation of a negative counter value; a
- <dfn id=prefix title=counter-prefix>prefix</dfn>, to prepend to the
- representation; a <dfn id=suffix title=counter-suffix>suffix</dfn>, to
- append to the representation; a <dfn id=fallback-style
- title=counter-fallback>fallback style</dfn>, to render the representation
- with when the counter value is outside the counter style's range or the
- counter style otherwise can't render the counter value; an <dfn id=upper
- title=counter-upper-bound>upper</dfn> and <dfn id=lower-range-bound
- title=counter-lower-bound>lower range bound</dfn>, to specify the
- (inclusive) range that the counter style can handle; and an <dfn
- id=algorithm title=counter-algorithm>algorithm</dfn> that transforms
- counter values into a string representation. The algorithm is usually
- specified implicitly by a combination of the ‘<a href="#type"><code
- class=css>type</code></a>’, ‘<a href="#glyphs"><code
- class=css>glyphs</code></a>’, and ‘<a
+ the representation of a counter value. Counter styles are composed of:
+
+ <ul>
+ <li>a <dfn id=name title=counter-name>name</dfn>, to identify the style
+
+ <li>a <dfn id=negative-sign title=counter-negative>negative sign</dfn>,
+ which is prepended or appended to the representation of a negative
+ counter value
+
+ <li>a <dfn id=prefix title=counter-prefix>prefix</dfn>, to prepend to the
+ representation
+
+ <li>a <dfn id=suffix title=counter-suffix>suffix</dfn>, to append to the
+ representation
+
+ <li>a <dfn id=fallback-style title=counter-fallback>fallback style</dfn>,
+ to render the representation with when the counter value is outside the
+ counter style's range or the counter style otherwise can't render the
+ counter value
+
+ <li>an <dfn id=upper title=counter-upper-bound>upper</dfn> and <dfn
+ id=lower-range-bound title=counter-lower-bound>lower range bound</dfn>,
+ to specify the (inclusive) range that the counter style can handle
+
+ <li>and an <dfn id=algorithm title=counter-algorithm>algorithm</dfn> that
+ transforms counter values into a string representation
+ </ul>
+
+ <p>The algorithm is usually specified implicitly by a combination of the
+ ‘<a href="#type"><code class=css>type</code></a>’, ‘<a
+ href="#glyphs"><code class=css>glyphs</code></a>’, and ‘<a
href="#additive-glyphs"><code class=css>additive-glyphs</code></a>’
properties, but some counter styles instead have their algorithm
explicitly defined.
@@ -1818,7 +1819,7 @@
}
</pre>
- <p>Each @counter-style rule specifies a value for ever counter-style
+ <p>Each @counter-style rule specifies a value for every counter-style
descriptor, either implicitly or explicitly. Those not given explicit
value in the rule take the initial value listed with each descriptor in
this specification. These descriptors apply solely within the ontext of
@@ -1837,12 +1838,10 @@
must be ignored. @counter-style rules require a ‘<a
href="#type"><code class=property>type</code></a>’ descriptor; if
this is missing the @counter-style is invalid and must be ignored. The
- <i><counter-style-name><i> must be be a valid identifier and must not
- be ‘<code class=css>decimal</code>’, ‘<a
- href="#inside"><code class=css>inside</code></a>’, ‘<a
- href="#outside"><code class=css>outside</code></a>’, or ‘<a
- href="#hanging"><code class=css>hanging</code></a>’; otherwise the
- @counter-style is invalid and must be ignored.</i></i>
+ <i><counter-style-name></i> must be be a valid identifier and must not
+ be "decimal", "default", "hanging", "inherit", "initial", "inline",
+ "inside", "none", or "outside"; otherwise the @counter-style is invalid
+ and must be ignored.
<h3 id=counter-style-type><span class=secno>9.1. </span> Counter
algorithms: the ‘<a href="#type"><code
@@ -3914,10 +3913,10 @@
<li>range, <a href="#range" title=range><strong>9.5.</strong></a>
<li>simp-chinese-formal, <a href="#simp-chinese-formal"
- title=simp-chinese-formal><strong>8.3.2.</strong></a>
+ title=simp-chinese-formal><strong>8.2.2.</strong></a>
<li>simp-chinese-informal, <a href="#simp-chinese-informal"
- title=simp-chinese-informal><strong>8.3.2.</strong></a>
+ title=simp-chinese-informal><strong>8.2.2.</strong></a>
<li><string>, <a href="#ltstring"
title="<string>"><strong>3.</strong></a>
@@ -3925,10 +3924,10 @@
<li>suffix, <a href="#suffix0" title=suffix><strong>9.4.</strong></a>
<li>trad-chinese-formal, <a href="#trad-chinese-formal"
- title=trad-chinese-formal><strong>8.3.2.</strong></a>
+ title=trad-chinese-formal><strong>8.2.2.</strong></a>
<li>trad-chinese-informal, <a href="#trad-chinese-informal"
- title=trad-chinese-informal><strong>8.3.2.</strong></a>
+ title=trad-chinese-informal><strong>8.2.2.</strong></a>
<li>type, <a href="#type" title=type><strong>9.1.</strong></a>
</ul>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.src.html,v
retrieving revision 1.80
retrieving revision 1.81
diff -u -d -r1.80 -r1.81
--- Overview.src.html 30 Apr 2011 01:17:46 -0000 1.80
+++ Overview.src.html 2 May 2011 19:11:55 -0000 1.81
@@ -730,20 +730,6 @@
in this section.
-
-<h3 id='decimal-counters'>
-The ''decimal'' counter style</h3>
-
- <p>The ''decimal'' counter style is the default fallback counter style for the
- ''@counter-style'' rule, and is also used in extraordinary situations like fallback
- loop. As such, it has to be well-defined at all times, so that a counter can
- always be formatted regardless of the validity of the defined counter styles.</p>
-
- <p>UAs must not allow the definition of the ''decimal'' counter style given in
- Appendix A to be overridden.</p>
-
-
-
<h3 id='glyph-counters'>
Glyphs</h3>
@@ -754,9 +740,10 @@
<p>Appendix A gives normative definitions for these styles, but UAs may instead
default to rendering these styles using a browser-generated image matching the
- description below. If the styles are overridden, the new style must be honored;
- this relaxation of the rendering requirements applies only to the default value
- of each counter style.</p>
+ description below. This only describes the rendering of the default counter styles
+ associated with these names - if an author or user creates their own counter style
+ with one of these names (overriding the UA-default version), they must be honored
+ as normal.</p>
<p>If the UA chooses to use an image for the default rendering of these counter
styles, the image must be scalable and designed to attractively fill a box 1em
@@ -778,12 +765,13 @@
<h3 id='complex-counters'>
Complex counter styles</h3>
- <p>Some real-life counter styles are unfortunately too complex to be accurately
- described using the ''@counter-style'' rule. The following styles must be supported
- as default counter styles as if they were defined by theoretical
- ''@counter-style'' rules placed at the end of the UA stylesheet defined in Appendix
- A, using the given name as the counter style name and the given algorithm to format
- counter values. They must be overrideable like any other predefined counter style.</p>
+ <p>Nearly all counter styles can be described using the small set of algorithms
+ described by the 'type' descriptor. A small handful, though, require more complex
+ handling which is too specialized to warrant crafting a generalized algorithm to
+ use in 'type'. Instead, their algorithms are described here. Just like a counter style
+ defined with the @counter-style rule, these counter styles can be overridden by
+ creating another @counter-style rule with the same name, or can be used in the
+ 'override' type to alter their descriptors while keeping the algorithms described here.</p>
<h4 id='ethiopic-numeric'>
@@ -893,9 +881,10 @@
<li>Concatenate the groups into one string.</li>
</ol>
- <p>For this system, the <i title='counter-lower-bound'>lower range bound descriptor</i>
- is 1, the <i title='counter-upper-bound'>upper range bound descriptor</i> is
- infinity, and the rest of the descriptors have their initial value.</p>
+ <p>For this system, the <i title='counter-name'>name</i> is "ethiopian-numeric",
+ the <i title='counter-lower-bound'>lower range bound descriptor</i> is 1, the
+ <i title='counter-upper-bound'>upper range bound descriptor</i> is infinity, and
+ the rest of the descriptors have their initial value.</p>
<p class='issue'>Is there a better suffix to use than the initial (".")? The
alphabetic ethiopic systems use a different suffix.</p>
@@ -1239,21 +1228,31 @@
exactly like the predefined counter styles in CSS.</p>
<p>A <dfn>counter style</dfn> defines how to construct the representation of a
- counter value. Counter styles are composed of:
- a <dfn title='counter-name'>name</dfn>, to identify the style;
- a <dfn title='counter-negative'>negative sign</dfn>, which is prepended or
- appended to the representation of a negative counter value;
- a <dfn title='counter-prefix'>prefix</dfn>, to prepend to the representation;
- a <dfn title='counter-suffix'>suffix</dfn>, to append to the representation;
- a <dfn title='counter-fallback'>fallback style</dfn>, to render the
- representation with when the counter value is outside the counter style's
- range or the counter style otherwise can't render the counter value;
- an <dfn title='counter-upper-bound'>upper</dfn> and
- <dfn title='counter-lower-bound'>lower range bound</dfn>, to specify the
- (inclusive) range that the counter style can handle;
- and an <dfn title='counter-algorithm'>algorithm</dfn> that transforms counter
- values into a string representation.
- The algorithm is usually specified implicitly by a combination of the ''type'',
+ counter value. Counter styles are composed of:</p>
+
+ <ul>
+ <li>a <dfn title='counter-name'>name</dfn>, to identify the style</li>
+
+ <li>a <dfn title='counter-negative'>negative sign</dfn>, which is prepended or
+ appended to the representation of a negative counter value</li>
+
+ <li>a <dfn title='counter-prefix'>prefix</dfn>, to prepend to the representation</li>
+
+ <li>a <dfn title='counter-suffix'>suffix</dfn>, to append to the representation</li>
+
+ <li>a <dfn title='counter-fallback'>fallback style</dfn>, to render the
+ representation with when the counter value is outside the counter style's
+ range or the counter style otherwise can't render the counter value</li>
+
+ <li>an <dfn title='counter-upper-bound'>upper</dfn> and
+ <dfn title='counter-lower-bound'>lower range bound</dfn>, to specify the
+ (inclusive) range that the counter style can handle</li>
+
+ <li>and an <dfn title='counter-algorithm'>algorithm</dfn> that transforms counter
+ values into a string representation</li>
+ </ul>
+
+ <p>The algorithm is usually specified implicitly by a combination of the ''type'',
''glyphs'', and ''additive-glyphs'' properties, but some counter styles
instead have their algorithm explicitly defined.</p>
@@ -1265,7 +1264,7 @@
}
</pre>
- <p>Each @counter-style rule specifies a value for ever counter-style descriptor,
+ <p>Each @counter-style rule specifies a value for every counter-style descriptor,
either implicitly or explicitly. Those not given explicit value in the rule
take the initial value listed with each descriptor in this specification.
These descriptors apply solely within the ontext of the @counter-style rule
@@ -1281,9 +1280,10 @@
parsers may ignore these rules without error. Any descriptors that are not
recognized or implemented by a given user agent must be ignored. @counter-style
rules require a 'type' descriptor; if this is missing the @counter-style is
- invalid and must be ignored. The <i><counter-style-name><i> must be be
- a valid identifier and must not be ''decimal'', ''inside'', ''outside'', or
- ''hanging''; otherwise the @counter-style is invalid and must be ignored.</p>
+ invalid and must be ignored. The <i><counter-style-name></i> must be be
+ a valid identifier and must not be "decimal", "default", "hanging", "inherit", "initial",
+ "inline", "inside", "none", or "outside"; otherwise the @counter-style is invalid and
+ must be ignored.</p>
<h3 id='counter-style-type'>
Counter algorithms: the 'type' descriptor</h3>
Received on Monday, 2 May 2011 19:11:59 UTC