Added an example for position:marker.

Author: tabatkins

css3-lists/Overview.html

@@ -1237,6 +1237,51 @@ <h3 id=position-marker><span class=secno>7.1. </span> The &lsquo;<code
    the top, right, bottom, and left edges (respectively) of the element
    itself, similar to how relative positioning works.
 
+  <div class=example>
+   <p>&lsquo;<code class=css>position:marker</code>&rsquo; can be used when
+    the precise list marker is important for the content, not a stylistic
+    choice, but the normal <em>appearance</em> of lists is still desired. For
+    example, this trimmed snippet of the US Code of Laws may be marked up as
+    the following in HTML:</p>
+
+   <pre>
+&lt;style>
+ol { list-style: none; }
+.marker { position: marker; }
+&lt;/style>
+&lt;ol>
+   &lt;li>
+      &lt;span class='marker'>(a)&lt;/span> Definitions.— For purposes of this section—
+      &lt;ol>
+         &lt;li>&lt;span class='marker'>(1)&lt;/span> the term “agency” means agency as...&lt;/li>
+         &lt;li>&lt;span class='marker'>(2)&lt;/span> the term “individual” means a citizen...&lt;/li>
+      &lt;/ol>
+   &lt;/li>
+   &lt;li>
+      &lt;span class='marker'>(b)&lt;/span> Conditions of Disclosure.— No agency shall disclose...
+      &lt;ol>
+         &lt;li>&lt;span class='marker'>(1)&lt;/span> to those officers and employees of the agency which...&lt;/li>
+         &lt;li>&lt;span class='marker'>(2)&lt;/span> required under section 552 of this title;&lt;/li>
+      &lt;/ol>
+   &lt;/li>
+&lt;/ol></pre>
+
+   <p>The preceding document should render something like this:</p>
+
+   <pre>
+ (a) Definitions.— For purposes of this section—
+     (1) the term “agency” means agency as...
+     (2) the term “individual” means a citizen...
+ (b) Conditions of Disclosure.— No agency shall disclose...
+     (1) to those officers and employees of the agency which...
+     (2) required under section 552 of this title;</pre>
+
+   <p>Importantly, it will <strong>always</strong> be presented something
+    like that, with those exact list markers, even if the stylesheet is
+    unavailable, so other documents can refer to those list markers and be
+    confident that the reference will always be resolvable.</p>
+  </div>
+
   <h3 id=marker-attachment><span class=secno>7.2. </span> The &lsquo;<a
    href="#marker-attachment0"><code
    class=property>marker-attachment</code></a>&rsquo; property</h3>

css3-lists/Overview.src.html

@@ -703,6 +703,44 @@ <h3 id='position-marker'>
 
 	<p>The 'top', 'right', 'bottom', and 'left' properties specify offsets relative to the top, right, bottom, and left edges (respectively) of the element itself, similar to how relative positioning works.</p>
 
+	<div class='example'>
+		<p>''position:marker'' can be used when the precise list marker is important for the content, not a stylistic choice, but the normal <em>appearance</em> of lists is still desired.  For example, this trimmed snippet of the US Code of Laws may be marked up as the following in HTML:</p>
+
+		<pre>
+&lt;style>
+ol { list-style: none; }
+.marker { position: marker; }
+&lt;/style>
+&lt;ol>
+   &lt;li>
+      &lt;span class='marker'>(a)&lt;/span> Definitions.— For purposes of this section—
+      &lt;ol>
+         &lt;li>&lt;span class='marker'>(1)&lt;/span> the term “agency” means agency as...&lt;/li>
+         &lt;li>&lt;span class='marker'>(2)&lt;/span> the term “individual” means a citizen...&lt;/li>
+      &lt;/ol>
+   &lt;/li>
+   &lt;li>
+      &lt;span class='marker'>(b)&lt;/span> Conditions of Disclosure.— No agency shall disclose...
+      &lt;ol>
+         &lt;li>&lt;span class='marker'>(1)&lt;/span> to those officers and employees of the agency which...&lt;/li>
+         &lt;li>&lt;span class='marker'>(2)&lt;/span> required under section 552 of this title;&lt;/li>
+      &lt;/ol>
+   &lt;/li>
+&lt;/ol></pre>
+
+		<p>The preceding document should render something like this:</p>
+
+		<pre>
+ (a) Definitions.— For purposes of this section—
+     (1) the term “agency” means agency as...
+     (2) the term “individual” means a citizen...
+ (b) Conditions of Disclosure.— No agency shall disclose...
+     (1) to those officers and employees of the agency which...
+     (2) required under section 552 of this title;</pre>
+
+		<p>Importantly, it will <strong>always</strong> be presented something like that, with those exact list markers, even if the stylesheet is unavailable, so other documents can refer to those list markers and be confident that the reference will always be resolvable.</p>
+	</div>
+
 <h3 id='marker-attachment'>
 The 'marker-attachment' property</h3>