Rewrite the 'defining a list item' section.

Author: tabatkins

css3-lists/Overview.html

@@ -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 17 August 2012</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 18 August 2012</h2>
 
    <dl>
     <dt>This version:
 
-    <dd><!--<a href="http://www.w3.org/TR/2012/WD-css3-lists-20120817">http://www.w3.org/TR/2012/WD-css3-lists-20120817</a>-->
+    <dd><!--<a href="http://www.w3.org/TR/2012/WD-css3-lists-20120818">http://www.w3.org/TR/2012/WD-css3-lists-20120818</a>-->
      <a
      href="http://dev.w3.org/csswg/css3-lists/">http://dev.w3.org/csswg/css3-lists/</a>
 
@@ -346,28 +346,22 @@ <h2 id=introduction><span class=secno>1. </span> Introduction</h2>
   <h2 id=declaring-a-list-item><span class=secno>2. </span> Declaring a List
    Item</h2>
 
-  <p>To declare a <dfn id=list-item>list item</dfn>, the ‘<code
-   class=property>display</code>’property must be set to ‘<code
-   class=css>list-item</code>’ or ‘<a href="#inline-list-item"><code
-   class=css>inline-list-item</code></a>’ (defined later in this section).
-   This, in addition to generating a ‘<code
-   class=css>::marker</code>’pseudo-element and enabling the properties
-   described below for that element, causes that element to increment the
-   list item counter ‘<code class=css>list-item</code>’: if the element
-   doesn't otherwise have a ‘<a href="#counter-increment"><code
-   class=property>counter-increment</code></a>’ declaration, it must act as
-   if ‘<code class=css>counter-increment: list-item</code>’ were
-   specified. (This does not affect the specified or computed values of the
-   counter properties.)
-
-  <p>The ‘<code class=css>list-item</code>’ counter is a real counter,
-   and can be directly affected using the ‘<a
-   href="#counter-increment"><code
-   class=property>counter-increment</code></a>’ and ‘<a
-   href="#counter-reset"><code class=css>counter-reset</code></a>’
-   properties. It can also be used in the ‘<code
-   class=css>counter()</code>’ and ‘<code class=css>counters()</code>’
-   functions.
+  <p> A <dfn id=list-item title="list item|list items">list item</dfn> is any
+   element with its ‘<code class=property>display</code>’ property set to
+   ‘<code class=css>list-item</code>’ or ‘<a
+   href="#inline-list-item"><code class=css>inline-list-item</code></a>’.
+   <a href="#list-item"><i>List items</i></a> generate ‘<code
+   class=css>::marker</code>’ pseudo-elements; no other elements do.
+
+  <p> Additionally, <a href="#list-item"><i>list items</i></a> automatically
+   increment the special ‘<code class=css>list-item</code>’
+   <i>counter</i>. Unless the ‘<a href="#counter-increment"><code
+   class=property>counter-increment</code></a>’ property manually specifies
+   a different increment for the ‘<code class=css>list-item</code>’
+   <i>counter</i>, it must be incremented by 1 on every <a
+   href="#list-item"><i>list item</i></a>, at the same time that
+   <i>counters</i> are normally incremented. (This has no effect on the
+   values of the ‘<code class=css>counter-*</code>’ properties.)
 
   <table class=propdef>
    <tbody>
@@ -412,15 +406,18 @@ <h2 id=declaring-a-list-item><span class=secno>2. </span> Declaring a List
      <td>same as CSS2.1
   </table>
 
-  <p>The ‘<a href="#inline-list-item"><code
+  <p> The ‘<a href="#inline-list-item"><code
    class=css>inline-list-item</code></a>’ display value makes the element a
-   list item, which means it can generate a <code class=css>::marker</code>
-   pseudo-element. The element also affects the predefined ‘<code
-   class=css>list-item</code>’ counter, as specified above. Otherwise, this
-   display value is treated identically to ‘<code
+   <a href="#list-item"><i>list item</i></a>, with the effects described
+   above. Additionally, the ‘<a href="#outside"><code
+   class=css>outside</code></a>’ value of ‘<a
+   href="#list-style-position"><code
+   class=property>list-style-position</code></a>’ computes to ‘<a
+   href="#inside"><code class=css>inside</code></a>’ on this element.
+   Otherwise, this display value is treated identically to ‘<code
    class=css>inline</code>’.
 
-  <p class=note>This display value is silly, and only necessary because we
+  <p class=note> This display value is silly, and only necessary because we
    haven't yet defined ‘<code class=property>display</code>’ to be split
    into subproperties. When that happens, "being a list item" will just be a
    property value that can apply to block, inline, and other elements.
@@ -3576,6 +3573,9 @@ <h2 class=no-num id=index>Index</h2>
    <li>list item positioning edge, <a href="#list-item-positioning-edge"
     title="list item positioning edge"><strong>7.1.</strong></a>
 
+   <li>list items, <a href="#list-item"
+    title="list items"><strong>2.</strong></a>
+
    <li>list-style, <a href="#list-style"
     title=list-style><strong>5.</strong></a>
 

css3-lists/Overview.src.html

@@ -133,12 +133,17 @@ <h2>
 <h2>
 Declaring a List Item</h2>
 
-	<p>To declare a <dfn>list item</dfn>, the 'display'property must be set to ''list-item'' or ''inline-list-item'' (defined later in this section). This, in addition to generating a ''::marker''pseudo-element and enabling the properties described below for that element, causes that element to increment the list item counter ''list-item'': if the element doesn't otherwise have a 'counter-increment' declaration, it must act as if ''counter-increment: list-item'' were specified. (This does not affect the specified or computed values of the counter properties.)
-
-	<p>The ''list-item'' counter is a real counter,
-	and can be directly affected using the 'counter-increment' and ''counter-reset'' 
-	properties. It can also be used in the ''counter()'' and ''counters()'' functions.
+	<p>
+		A <dfn title="list item|list items">list item</dfn> is any element with its 'display' property set to ''list-item'' or ''inline-list-item''.
+		<i>List items</i> generate ''::marker'' pseudo-elements;
+		no other elements do.
 
+	<p>
+		Additionally, <i>list items</i> automatically increment the special ''list-item'' <i>counter</i>.
+		Unless the 'counter-increment' property manually specifies a different increment for the ''list-item'' <i>counter</i>,
+		it must be incremented by 1 on every <i>list item</i>, 
+		at the same time that <i>counters</i> are normally incremented.
+		(This has no effect on the values of the 'counter-*' properties.)
 
 	<table class="propdef">
 		<tbody>
@@ -169,15 +174,18 @@ <h2>
 		</tbody>
 	</table>
 
-	<p>The ''inline-list-item'' display value makes the element a list item,
-	which means it can generate a <code class=css>::marker</code> pseudo-element.  The element also 
-	affects the predefined ''list-item'' counter, as specified above. Otherwise, 
-	this display value is treated identically to ''inline''.
-
-	<p class='note'>This display value is silly, and only necessary because we
-	haven't yet defined 'display' to be split into subproperties.  When that
-	happens, "being a list item" will just be a property value that can apply
-	to block, inline, and other elements.
+	<p>
+		The ''inline-list-item'' display value makes the element a <i>list item</i>,
+		with the effects described above.
+		Additionally, the ''outside'' value of 'list-style-position'
+		computes to ''inside'' on this element.
+		Otherwise, this display value is treated identically to ''inline''.
+
+	<p class='note'>
+		This display value is silly, 
+		and only necessary because we haven't yet defined 'display' to be split into subproperties.  
+		When that happens, 
+		"being a list item" will just be a property value that can apply to block, inline, and other elements.
 
 <!-- ====================================================================== -->