Start on parser.

--HG--
extra : rebase_source : fd77a74b7e66794aba3adace75ca600dddf51f4c

Author: tabatkins

css3-syntax/Overview.html

@@ -36,13 +36,13 @@
 
    <h1>CSS Syntax Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 16 April 2012</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 17 April 2012</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a class=replaceme
-     href="http://www.w3.org/TR/2012/ED-cssN-FIXME-20120416/">http://www.w3.org/TR/2012/ED-cssN-FIXME-20120416/</a>
+     href="http://www.w3.org/TR/2012/ED-cssN-FIXME-20120417/">http://www.w3.org/TR/2012/ED-cssN-FIXME-20120417/</a>
 
 
     <dt>Latest version:
@@ -267,6 +267,15 @@ <h2 class="no-num no-toc" id=contents> Table of contents</h2>
 
      <li><a href="#tree-construction"><span class=secno>3.5. </span> Tree
       Construction</a>
+      <ul class=toc>
+       <li><a href="#creating-and-inserting-rules"><span class=secno>3.5.1.
+        </span> Creating and Inserting Rules</a>
+
+       <li><a href="#terms"><span class=secno>3.5.2. </span> Terms</a>
+
+       <li><a href="#top-level-insertion-mode-"><span class=secno>3.5.3.
+        </span> Top-level insertion mode </a>
+      </ul>
     </ul>
 
    <li><a href="#conformance"><span class=secno>4. </span> Conformance</a>
@@ -1821,7 +1830,63 @@ <h4 id=set-the-unicode-range-tokens-range><span class=secno>3.4.26. </span>
   <h3 id=tree-construction><span class=secno>3.5. </span> Tree Construction</h3>
 
   <p> The input to the tree construction stage is a sequence of tokens from
-   the tokenization stage. <!--
+   the tokenization stage. The tree construction stage is associated with a
+   stylesheet (sometimes a full CSSStyleSheet object, other times a "virtual"
+   stylesheet). The "output" of this stage consists of dynamically modifying
+   or extending that stylesheet's CSSOM.
+
+  <h4 id=creating-and-inserting-rules><span class=secno>3.5.1. </span>
+   Creating and Inserting Rules</h4>
+
+  <p> ...
+
+  <h4 id=terms><span class=secno>3.5.2. </span> Terms</h4>
+
+  <dl>
+   <dt><dfn id=stack-of-pending-rules>Stack of pending rules</dfn>
+
+   <dd> ...
+
+   <dt><dfn id=stack-of-open-blocks>Stack of open blocks</dfn>
+  </dl>
+
+  <h4 id=top-level-insertion-mode-><span class=secno>3.5.3. </span> <dfn
+   id=top-level-insertion-mode>Top-level insertion mode</dfn></h4>
+
+  <p> Consume the next input token.
+
+  <dl>
+   <dt>cdo token
+
+   <dt>cdc token
+
+   <dt>whitespace token
+
+   <dd> Do nothing. Remain in this mode.
+
+   <dt>at-keyword token
+
+   <dd> If the at-keyword's value is the name of an at-rule that the UA
+    recognizes, create a new <i>AtRule</i> rule and push it onto the <a
+    href="#stack-of-pending-rules"><i>stack of pending rules</i></a>. Switch
+    to the <i>after at-keyword insertion mode</i>.
+    <p> Otherwise, this is a <i>parse error</i>. Switch to the <i>at-rule
+     error mode</i>.
+
+   <dt>start-block token
+
+   <dd> This is a <i>parse error</i>. Push the token onto the <a
+    href="#stack-of-open-blocks"><i>stack of open blocks</i></a>. Switch to
+    the <i>block error mode</i>.
+
+   <dt>anything else
+
+   <dd> Create a new <i>Style</i> rule and append it to the <a
+    href="#stack-of-pending-rules"><i>stack of pending rules</i></a>. Switch
+    to the <i>in selector mode</i>. Reprocess the <i>current input token</i>.
+    
+  </dl>
+  <!--
     
 TTTTTTTTTTTTTTTTTTTTTTTHHHHHHHHH     HHHHHHHHHEEEEEEEEEEEEEEEEEEEEEE
 T:::::::::::::::::::::TH:::::::H     H:::::::HE::::::::::::::::::::E
@@ -1859,7 +1924,6 @@ <h3 id=tree-construction><span class=secno>3.5. </span> Tree Construction</h3>
 E::::::::::::::::::::EN::::::N        N::::::ND::::::::::::DDD     
 EEEEEEEEEEEEEEEEEEEEEENNNNNNNN         NNNNNNNDDDDDDDDDDDDD        
 -->
-   
 
   <h2 id=conformance><span class=secno>4. </span> Conformance</h2>
 
@@ -2168,6 +2232,12 @@ <h2 class=no-num id=index> Index</h2>
    <li>Single-quote-string state, <a href="#single-quote-string-state0"
     title="Single-quote-string state"><strong>3.4.5.</strong></a>
 
+   <li>Stack of open blocks, <a href="#stack-of-open-blocks"
+    title="Stack of open blocks"><strong>3.5.2.</strong></a>
+
+   <li>Stack of pending rules, <a href="#stack-of-pending-rules"
+    title="Stack of pending rules"><strong>3.5.2.</strong></a>
+
    <li>start of the range, <a href="#start-of-the-range"
     title="start of the range"><strong>3.4.26.</strong></a>
 
@@ -2180,6 +2250,9 @@ <h2 class=no-num id=index> Index</h2>
    <li>supports scientific notation, <a href="#supports-scientific-notation"
     title="supports scientific notation"><strong>3.4.1.</strong></a>
 
+   <li>Top-level insertion mode, <a href="#top-level-insertion-mode"
+    title="Top-level insertion mode"><strong>3.5.3.</strong></a>
+
    <li>transform function whitespace, <a
     href="#transform-function-whitespace"
     title="transform function whitespace"><strong>3.4.1.</strong></a>

css3-syntax/Overview.src.html

@@ -1857,6 +1857,66 @@ <h3>
 
 	<p>
 		The input to the tree construction stage is a sequence of tokens from the tokenization stage.
+		The tree construction stage is associated with a stylesheet
+		(sometimes a full CSSStyleSheet object, other times a "virtual" stylesheet).
+		The "output" of this stage consists of dynamically modifying or extending that stylesheet's CSSOM.
+
+<h4>
+Creating and Inserting Rules</h4>
+	
+	<p>
+		...
+
+<h4>
+Terms</h4>
+
+	<dl>
+		<dt><dfn>Stack of pending rules</dfn>
+		<dd>
+			...
+
+		<dt><dfn>Stack of open blocks</dfn>
+	</dl>
+
+<h4>
+<dfn>Top-level insertion mode</dfn>
+
+	<p>
+		Consume the next input token.
+
+	<dl>
+		<dt>cdo token
+		<dt>cdc token
+		<dt>whitespace token
+		<dd>
+			Do nothing.
+			Remain in this mode.
+
+		<dt>at-keyword token
+		<dd>
+			If the at-keyword's value is the name of an at-rule that the UA recognizes,
+			create a new <i>AtRule</i> rule
+			and push it onto the <i>stack of pending rules</i>.
+			Switch to the <i>after at-keyword insertion mode</i>.
+
+			<p>
+				Otherwise, this is a <i>parse error</i>.
+				Switch to the <i>at-rule error mode</i>.
+
+		<dt>start-block token
+		<dd>
+			This is a <i>parse error</i>.
+			Push the token onto the <i>stack of open blocks</i>.
+			Switch to the <i>block error mode</i>.
+
+		<dt>anything else
+		<dd>
+			Create a new <i>Style</i> rule
+			and append it to the <i>stack of pending rules</i>.
+			Switch to the <i>in selector mode</i>.
+			Reprocess the <i>current input token</i>.
+	</dl>
+
 
 
 <!--