taskjuggler 0.0.2 → 0.0.3

data/doc/classes/TaskJuggler/TextParser.html

@@ -53,9 +53,9 @@
             <td>
 
 
-                <a href="../../files/lib/TextParser_rb.html">
+                <a href="../../files/lib/TextParser/StackElement_rb.html">
 
-                lib/TextParser.rb
+                lib/TextParser/StackElement.rb
 
                 </a>
 
@@ -63,9 +63,9 @@
         <br />
 
 
-                <a href="../../files/lib/TextParser/Pattern_rb.html">
+                <a href="../../files/lib/TextParser/TokenDoc_rb.html">
 
-                lib/TextParser/Pattern.rb
+                lib/TextParser/TokenDoc.rb
 
                 </a>
 
@@ -83,9 +83,9 @@
         <br />
 
 
-                <a href="../../files/lib/TextParser/TokenDoc_rb.html">
+                <a href="../../files/lib/TextParser/Pattern_rb.html">
 
-                lib/TextParser/TokenDoc.rb
+                lib/TextParser/Pattern.rb
 
                 </a>
 
@@ -93,9 +93,9 @@
         <br />
 
 
-                <a href="../../files/lib/TextParser/StackElement_rb.html">
+                <a href="../../files/lib/TextParser_rb.html">
 
-                lib/TextParser/StackElement.rb
+                lib/TextParser.rb
 
                 </a>
 
@@ -110,8 +110,12 @@
             <td><strong>Parent:</strong></td>
             <td>
 
+                <a href="../Object.html">
+
                 Object
 
+               </a>
+
             </td>
         </tr>
 
@@ -125,16 +129,36 @@
 
     <div id="description">
       <p>
-encoding: UTF-8
+The <a href="TextParser.html">TextParser</a> implements a regular LALR
+parser. But it uses a recursive rule traversor instead of the more commonly
+found state machine generated by yacc-like tools. Since stack depths is not
+really an issue with a Ruby implementation this approach has one big
+advantage. The syntax of the parser can be modified during parsing. This
+allows support for languages that can extend themself. The <a
+href="../TaskJuggler.html">TaskJuggler</a> syntax is such an beast.
+Traditional yacc generated parsers would fail with such a syntax.
 </p>
-<h1>TextParser/StackElement.rb &#8212; The <a href="../TaskJuggler.html">TaskJuggler</a> III <a href="Project.html">Project</a> Management Software</h1>
 <p>
-Copyright &#169; 2006, 2007, 2008, 2009 by Chris Schlaeger <cs@kde.org>
+This class is just a base class. A complete parser would derive from this
+class and implement the rule set and the functions _nextToken()_ and
+_returnToken()_. It also needs to set the array <em>variables</em> to
+declare all variables ($SOMENAME) that the scanner may deliver.
 </p>
 <p>
-This program is free software; you can redistribute it and/or modify it
-under the terms of version 2 of the GNU General Public License as published
-by the Free Software Foundation.
+To describe the syntax the functions <a
+href="TextParser.html#M000241">TextParser#pattern</a>, <a
+href="TextParser.html#M000242">TextParser#optional</a> and <a
+href="TextParser.html#M000243">TextParser#repeatable</a> can be used. When
+the rule set is changed during parsing, <a
+href="TextParser.html#M000244">TextParser#updateParserTables</a> must be
+called to make the changes effective. The parser can also document the
+syntax automatically. To document a pattern, the functions TextParser#doc,
+TextParser#descr, TextParser#also and TextParser#arg can be used.
+</p>
+<p>
+To start parsing the input the function <a
+href="TextParser.html#M000245">TextParser#parse</a> needs to be called with
+the name of the start rule.
 </p>
 
     </div>
@@ -147,27 +171,29 @@ by the Free Software Foundation.
 
       <div class="name-list">
 
-        <a href="#M000459">error</a>&nbsp;&nbsp;
+        <a href="#M000248">error</a>&nbsp;&nbsp;
+
+        <a href="#M000239">initRules</a>&nbsp;&nbsp;
 
-        <a href="#M000450">initRules</a>&nbsp;&nbsp;
+        <a href="#M000247">matchingRules</a>&nbsp;&nbsp;
 
-        <a href="#M000458">matchingRules</a>&nbsp;&nbsp;
+        <a href="#M000238">new</a>&nbsp;&nbsp;
 
-        <a href="#M000449">new</a>&nbsp;&nbsp;
+        <a href="#M000240">newRule</a>&nbsp;&nbsp;
 
-        <a href="#M000451">newRule</a>&nbsp;&nbsp;
+        <a href="#M000242">optional</a>&nbsp;&nbsp;
 
-        <a href="#M000453">optional</a>&nbsp;&nbsp;
+        <a href="#M000245">parse</a>&nbsp;&nbsp;
 
-        <a href="#M000456">parse</a>&nbsp;&nbsp;
+        <a href="#M000241">pattern</a>&nbsp;&nbsp;
 
-        <a href="#M000452">pattern</a>&nbsp;&nbsp;
+        <a href="#M000243">repeatable</a>&nbsp;&nbsp;
 
-        <a href="#M000454">repeatable</a>&nbsp;&nbsp;
+        <a href="#M000246">sourceFileInfo</a>&nbsp;&nbsp;
 
-        <a href="#M000457">sourceFileInfo</a>&nbsp;&nbsp;
+        <a href="#M000244">updateParserTables</a>&nbsp;&nbsp;
 
-        <a href="#M000455">updateParserTables</a>&nbsp;&nbsp;
+        <a href="#M000249">warning</a>&nbsp;&nbsp;
 
       </div>
     </div>
@@ -217,12 +243,12 @@ Class <a href="TextParser/TokenDoc.html" class="link">TaskJuggler::TextParser::T
       <h3 class="section-bar">Public Class methods</h3>
 
 
-      <div id="method-M000449" class="method-detail">
-        <a name="M000449"></a>
+      <div id="method-M000238" class="method-detail">
+        <a name="M000238"></a>
 
         <div class="method-heading">
 
-          <a href="#M000449" class="method-signature">
+          <a href="#M000238" class="method-signature">
 
           <span class="method-name">new</span><span class="method-args">()</span>
 
@@ -237,8 +263,8 @@ Create a new <a href="TextParser.html">TextParser</a> object.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000449-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000449-source">
+            onclick="toggleCode('M000238-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000238-source">
 <pre>
     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 70</span>
 70:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>
@@ -260,12 +286,12 @@ Create a new <a href="TextParser.html">TextParser</a> object.
       <h3 class="section-bar">Public Instance methods</h3>
 
 
-      <div id="method-M000459" class="method-detail">
-        <a name="M000459"></a>
+      <div id="method-M000248" class="method-detail">
+        <a name="M000248"></a>
 
         <div class="method-heading">
 
-          <a href="#M000459" class="method-signature">
+          <a href="#M000248" class="method-signature">
 
           <span class="method-name">error</span><span class="method-args">(id, text, property = nil)</span>
 
@@ -276,13 +302,13 @@ Create a new <a href="TextParser.html">TextParser</a> object.
         <div class="method-description">
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000459-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000459-source">
+            onclick="toggleCode('M000248-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000248-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 174</span>
-174:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">error</span>(<span class="ruby-identifier">id</span>, <span class="ruby-identifier">text</span>, <span class="ruby-identifier">property</span> = <span class="ruby-keyword kw">nil</span>)
-175:       <span class="ruby-ivar">@scanner</span>.<span class="ruby-identifier">error</span>(<span class="ruby-identifier">id</span>, <span class="ruby-identifier">text</span>, <span class="ruby-identifier">property</span>)
-176:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 181</span>
+181:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">error</span>(<span class="ruby-identifier">id</span>, <span class="ruby-identifier">text</span>, <span class="ruby-identifier">property</span> = <span class="ruby-keyword kw">nil</span>)
+182:       <span class="ruby-ivar">@scanner</span>.<span class="ruby-identifier">error</span>(<span class="ruby-identifier">id</span>, <span class="ruby-identifier">text</span>, <span class="ruby-identifier">property</span>)
+183:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
 
@@ -290,12 +316,12 @@ Create a new <a href="TextParser.html">TextParser</a> object.
       </div>
 
 
-      <div id="method-M000450" class="method-detail">
-        <a name="M000450"></a>
+      <div id="method-M000239" class="method-detail">
+        <a name="M000239"></a>
 
         <div class="method-heading">
 
-          <a href="#M000450" class="method-signature">
+          <a href="#M000239" class="method-signature">
 
           <span class="method-name">initRules</span><span class="method-args">()</span>
 
@@ -311,8 +337,8 @@ rules.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000450-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000450-source">
+            onclick="toggleCode('M000239-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000239-source">
 <pre>
     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 81</span>
 81:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initRules</span>
@@ -332,12 +358,12 @@ rules.
       </div>
 
 
-      <div id="method-M000458" class="method-detail">
-        <a name="M000458"></a>
+      <div id="method-M000247" class="method-detail">
+        <a name="M000247"></a>
 
         <div class="method-heading">
 
-          <a href="#M000458" class="method-signature">
+          <a href="#M000247" class="method-signature">
 
           <span class="method-name">matchingRules</span><span class="method-args">(keyword)</span>
 
@@ -348,18 +374,18 @@ rules.
         <div class="method-description">
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000458-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000458-source">
+            onclick="toggleCode('M000247-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000247-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 165</span>
-165:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">matchingRules</span>(<span class="ruby-identifier">keyword</span>)
-166:       <span class="ruby-identifier">matches</span> = []
-167:       <span class="ruby-ivar">@rules</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">name</span>, <span class="ruby-identifier">rule</span><span class="ruby-operator">|</span>
-168:         <span class="ruby-identifier">patIdx</span> = <span class="ruby-identifier">rule</span>.<span class="ruby-identifier">matchingPatternIndex</span>(<span class="ruby-value str">'_'</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">keyword</span>)
-169:         <span class="ruby-identifier">matches</span> <span class="ruby-operator">&lt;&lt;</span> [ <span class="ruby-identifier">rule</span>, <span class="ruby-identifier">patIdx</span> ] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">patIdx</span>
-170:       <span class="ruby-keyword kw">end</span>
-171:       <span class="ruby-identifier">matches</span>
-172:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 172</span>
+172:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">matchingRules</span>(<span class="ruby-identifier">keyword</span>)
+173:       <span class="ruby-identifier">matches</span> = []
+174:       <span class="ruby-ivar">@rules</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">name</span>, <span class="ruby-identifier">rule</span><span class="ruby-operator">|</span>
+175:         <span class="ruby-identifier">patIdx</span> = <span class="ruby-identifier">rule</span>.<span class="ruby-identifier">matchingPatternIndex</span>(<span class="ruby-value str">'_'</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">keyword</span>)
+176:         <span class="ruby-identifier">matches</span> <span class="ruby-operator">&lt;&lt;</span> [ <span class="ruby-identifier">rule</span>, <span class="ruby-identifier">patIdx</span> ] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">patIdx</span>
+177:       <span class="ruby-keyword kw">end</span>
+178:       <span class="ruby-identifier">matches</span>
+179:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
 
@@ -367,14 +393,14 @@ rules.
       </div>
 
 
-      <div id="method-M000451" class="method-detail">
-        <a name="M000451"></a>
+      <div id="method-M000240" class="method-detail">
+        <a name="M000240"></a>
 
         <div class="method-heading">
 
-          <a href="#M000451" class="method-signature">
+          <a href="#M000240" class="method-signature">
 
-          <span class="method-name">newRule</span><span class="method-args">(name)</span>
+          <span class="method-name">newRule</span><span class="method-args">(name) {|| ...}</span>
 
           </a>
 
@@ -385,22 +411,29 @@ rules.
           <p>
 Add a new rule to the rule set. <em>name</em> must be a unique identifier.
 The function also sets the class variable @cr to the new rule. Subsequent
-calls to <a href="TextParser.html#M000452">TextParser#pattern</a>, <a
-href="TextParser.html#M000453">TextParser#optional</a> or <a
-href="TextParser.html#M000454">TextParser#repeatable</a> will then
+calls to <a href="TextParser.html#M000241">TextParser#pattern</a>, <a
+href="TextParser.html#M000242">TextParser#optional</a> or <a
+href="TextParser.html#M000243">TextParser#repeatable</a> will then
 implicitely operate on the most recently added rule.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000451-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000451-source">
+            onclick="toggleCode('M000240-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000240-source">
 <pre>
      <span class="ruby-comment cmt"># File lib/TextParser.rb, line 97</span>
  97:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">newRule</span>(<span class="ruby-identifier">name</span>)
  98:       <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Fatal Error: Rule #{name} already exists&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@rules</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">name</span>)
  99: 
-100:       <span class="ruby-ivar">@rules</span>[<span class="ruby-identifier">name</span>] = <span class="ruby-ivar">@cr</span> = <span class="ruby-constant">TextParser</span><span class="ruby-operator">::</span><span class="ruby-constant">Rule</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">name</span>)
-101:     <span class="ruby-keyword kw">end</span>
+100:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
+101:         <span class="ruby-identifier">saveCr</span> = <span class="ruby-ivar">@cr</span>
+102:         <span class="ruby-ivar">@rules</span>[<span class="ruby-identifier">name</span>] = <span class="ruby-ivar">@cr</span> = <span class="ruby-constant">TextParser</span><span class="ruby-operator">::</span><span class="ruby-constant">Rule</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">name</span>)
+103:         <span class="ruby-keyword kw">yield</span>
+104:         <span class="ruby-ivar">@cr</span> = <span class="ruby-identifier">saveCr</span>
+105:       <span class="ruby-keyword kw">else</span>
+106:         <span class="ruby-ivar">@rules</span>[<span class="ruby-identifier">name</span>] = <span class="ruby-ivar">@cr</span> = <span class="ruby-constant">TextParser</span><span class="ruby-operator">::</span><span class="ruby-constant">Rule</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">name</span>)
+107:       <span class="ruby-keyword kw">end</span>
+108:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
 
@@ -408,12 +441,12 @@ implicitely operate on the most recently added rule.
       </div>
 
 
-      <div id="method-M000453" class="method-detail">
-        <a name="M000453"></a>
+      <div id="method-M000242" class="method-detail">
+        <a name="M000242"></a>
 
         <div class="method-heading">
 
-          <a href="#M000453" class="method-signature">
+          <a href="#M000242" class="method-signature">
 
           <span class="method-name">optional</span><span class="method-args">()</span>
 
@@ -429,13 +462,13 @@ elements.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000453-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000453-source">
+            onclick="toggleCode('M000242-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000242-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 120</span>
-120:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">optional</span>
-121:       <span class="ruby-ivar">@cr</span>.<span class="ruby-identifier">setOptional</span>
-122:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 127</span>
+127:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">optional</span>
+128:       <span class="ruby-ivar">@cr</span>.<span class="ruby-identifier">setOptional</span>
+129:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
 
@@ -443,14 +476,14 @@ elements.
       </div>
 
 
-      <div id="method-M000456" class="method-detail">
-        <a name="M000456"></a>
+      <div id="method-M000245" class="method-detail">
+        <a name="M000245"></a>
 
         <div class="method-heading">
 
-          <a href="#M000456" class="method-signature">
+          <a href="#M000245" class="method-signature">
 
-          <span class="method-name">parse</span><span class="method-args">(ruleName, enforceEndOfFile = true)</span>
+          <span class="method-name">parse</span><span class="method-args">(ruleName)</span>
 
           </a>
 
@@ -465,23 +498,23 @@ top-level parser rule that was specified by <em>ruleName</em>.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000456-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000456-source">
+            onclick="toggleCode('M000245-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000245-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 143</span>
-143:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">parse</span>(<span class="ruby-identifier">ruleName</span>, <span class="ruby-identifier">enforceEndOfFile</span> = <span class="ruby-keyword kw">true</span>)
-144:       <span class="ruby-ivar">@stack</span> = []
-145:       <span class="ruby-ivar">@@expectedTokens</span> = []
-146:       <span class="ruby-identifier">updateParserTables</span>
-147:       <span class="ruby-keyword kw">begin</span>
-148:         <span class="ruby-identifier">result</span> = <span class="ruby-identifier">parseRule</span>(<span class="ruby-ivar">@rules</span>[<span class="ruby-identifier">ruleName</span>])
-149:       <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">TjException</span>
-150:         <span class="ruby-comment cmt"># error('parse_error', $!.message)</span>
-151:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
-152:       <span class="ruby-keyword kw">end</span>
-153: 
-154:       <span class="ruby-identifier">result</span>
-155:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 150</span>
+150:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">parse</span>(<span class="ruby-identifier">ruleName</span>)
+151:       <span class="ruby-ivar">@stack</span> = []
+152:       <span class="ruby-ivar">@@expectedTokens</span> = []
+153:       <span class="ruby-identifier">updateParserTables</span>
+154:       <span class="ruby-keyword kw">begin</span>
+155:         <span class="ruby-identifier">result</span> = <span class="ruby-identifier">parseRule</span>(<span class="ruby-ivar">@rules</span>[<span class="ruby-identifier">ruleName</span>])
+156:       <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">TjException</span>
+157:         <span class="ruby-comment cmt"># error('parse_error', $!.message)</span>
+158:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
+159:       <span class="ruby-keyword kw">end</span>
+160: 
+161:       <span class="ruby-identifier">result</span>
+162:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
 
@@ -489,12 +522,12 @@ top-level parser rule that was specified by <em>ruleName</em>.
       </div>
 
 
-      <div id="method-M000452" class="method-detail">
-        <a name="M000452"></a>
+      <div id="method-M000241" class="method-detail">
+        <a name="M000241"></a>
 
         <div class="method-heading">
 
-          <a href="#M000452" class="method-signature">
+          <a href="#M000241" class="method-signature">
 
           <span class="method-name">pattern</span><span class="method-args">(tokens, func = nil)</span>
 
@@ -527,13 +560,13 @@ completed the processing of this rule.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000452-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000452-source">
+            onclick="toggleCode('M000241-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000241-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 114</span>
-114:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pattern</span>(<span class="ruby-identifier">tokens</span>, <span class="ruby-identifier">func</span> = <span class="ruby-keyword kw">nil</span>)
-115:       <span class="ruby-ivar">@cr</span>.<span class="ruby-identifier">addPattern</span>(<span class="ruby-constant">TextParser</span><span class="ruby-operator">::</span><span class="ruby-constant">Pattern</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">tokens</span>, <span class="ruby-identifier">func</span>))
-116:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 121</span>
+121:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pattern</span>(<span class="ruby-identifier">tokens</span>, <span class="ruby-identifier">func</span> = <span class="ruby-keyword kw">nil</span>)
+122:       <span class="ruby-ivar">@cr</span>.<span class="ruby-identifier">addPattern</span>(<span class="ruby-constant">TextParser</span><span class="ruby-operator">::</span><span class="ruby-constant">Pattern</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">tokens</span>, <span class="ruby-identifier">func</span>))
+123:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
 
@@ -541,12 +574,12 @@ completed the processing of this rule.
       </div>
 
 
-      <div id="method-M000454" class="method-detail">
-        <a name="M000454"></a>
+      <div id="method-M000243" class="method-detail">
+        <a name="M000243"></a>
 
         <div class="method-heading">
 
-          <a href="#M000454" class="method-signature">
+          <a href="#M000243" class="method-signature">
 
           <span class="method-name">repeatable</span><span class="method-args">()</span>
 
@@ -562,13 +595,13 @@ elements.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000454-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000454-source">
+            onclick="toggleCode('M000243-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000243-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 126</span>
-126:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">repeatable</span>
-127:       <span class="ruby-ivar">@cr</span>.<span class="ruby-identifier">setRepeatable</span>
-128:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 133</span>
+133:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">repeatable</span>
+134:       <span class="ruby-ivar">@cr</span>.<span class="ruby-identifier">setRepeatable</span>
+135:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
 
@@ -576,12 +609,12 @@ elements.
       </div>
 
 
-      <div id="method-M000457" class="method-detail">
-        <a name="M000457"></a>
+      <div id="method-M000246" class="method-detail">
+        <a name="M000246"></a>
 
         <div class="method-heading">
 
-          <a href="#M000457" class="method-signature">
+          <a href="#M000246" class="method-signature">
 
           <span class="method-name">sourceFileInfo</span><span class="method-args">()</span>
 
@@ -599,14 +632,14 @@ nil if we don&#8217;t have a current position.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000457-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000457-source">
+            onclick="toggleCode('M000246-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000246-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 160</span>
-160:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sourceFileInfo</span>
-161:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@stack</span>.<span class="ruby-identifier">empty?</span>
-162:       <span class="ruby-ivar">@stack</span>.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">sourceFileInfo</span>
-163:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 167</span>
+167:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sourceFileInfo</span>
+168:       <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@stack</span>.<span class="ruby-identifier">empty?</span>
+169:       <span class="ruby-ivar">@stack</span>.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">sourceFileInfo</span>
+170:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
 
@@ -614,12 +647,12 @@ nil if we don&#8217;t have a current position.
       </div>
 
 
-      <div id="method-M000455" class="method-detail">
-        <a name="M000455"></a>
+      <div id="method-M000244" class="method-detail">
+        <a name="M000244"></a>
 
         <div class="method-heading">
 
-          <a href="#M000455" class="method-signature">
+          <a href="#M000244" class="method-signature">
 
           <span class="method-name">updateParserTables</span><span class="method-args">()</span>
 
@@ -632,21 +665,51 @@ nil if we don&#8217;t have a current position.
           <p>
 This function needs to be called whenever new rules or patterns have been
 added and before the next call to <a
-href="TextParser.html#M000456">TextParser#parse</a>.
+href="TextParser.html#M000245">TextParser#parse</a>.
 </p>
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000455-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000455-source">
+            onclick="toggleCode('M000244-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000244-source">
+<pre>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 139</span>
+139:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">updateParserTables</span>
+140:       <span class="ruby-ivar">@rules</span>.<span class="ruby-identifier">each_value</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">rule</span><span class="ruby-operator">|</span> <span class="ruby-identifier">rule</span>.<span class="ruby-identifier">transitions</span> = {} }
+141:       <span class="ruby-ivar">@rules</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">rule</span><span class="ruby-operator">|</span>
+142:         <span class="ruby-identifier">getTransitions</span>(<span class="ruby-identifier">rule</span>)
+143:         <span class="ruby-identifier">checkRule</span>(<span class="ruby-identifier">rule</span>)
+144:       <span class="ruby-keyword kw">end</span>
+145:     <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+
+        </div>
+      </div>
+
+
+      <div id="method-M000249" class="method-detail">
+        <a name="M000249"></a>
+
+        <div class="method-heading">
+
+          <a href="#M000249" class="method-signature">
+
+          <span class="method-name">warning</span><span class="method-args">(id, text, property = nil)</span>
+
+          </a>
+
+        </div>
+
+        <div class="method-description">
+
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000249-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000249-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 132</span>
-132:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">updateParserTables</span>
-133:       <span class="ruby-ivar">@rules</span>.<span class="ruby-identifier">each_value</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">rule</span><span class="ruby-operator">|</span> <span class="ruby-identifier">rule</span>.<span class="ruby-identifier">transitions</span> = {} }
-134:       <span class="ruby-ivar">@rules</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">rule</span><span class="ruby-operator">|</span>
-135:         <span class="ruby-identifier">getTransitions</span>(<span class="ruby-identifier">rule</span>)
-136:         <span class="ruby-identifier">checkRule</span>(<span class="ruby-identifier">rule</span>)
-137:       <span class="ruby-keyword kw">end</span>
-138:     <span class="ruby-keyword kw">end</span>
+     <span class="ruby-comment cmt"># File lib/TextParser.rb, line 185</span>
+185:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">warning</span>(<span class="ruby-identifier">id</span>, <span class="ruby-identifier">text</span>, <span class="ruby-identifier">property</span> = <span class="ruby-keyword kw">nil</span>)
+186:       <span class="ruby-ivar">@scanner</span>.<span class="ruby-identifier">warning</span>(<span class="ruby-identifier">id</span>, <span class="ruby-identifier">text</span>, <span class="ruby-identifier">property</span>)
+187:     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>