taskjuggler 0.0.6 → 0.0.7

data/doc/TaskJuggler/TextParser/Pattern.html

@@ -95,7 +95,7 @@
 					
 					<li><a href="#method-i-terminalSymbol%3F">#terminalSymbol?</a></li>
 					
-					<li><a href="#method-i-terminalToken">#terminalToken</a></li>
+					<li><a href="#method-i-terminalTokens">#terminalTokens</a></li>
 					
 					<li><a href="#method-i-to_s">#to_s</a></li>
 					
@@ -195,6 +195,10 @@
 				
 					<li><a href="../../TaskJuggler/DurationAttribute.html">TaskJuggler::DurationAttribute</a></li>
 				
+					<li><a href="../../TaskJuggler/FileList.html">TaskJuggler::FileList</a></li>
+				
+					<li><a href="../../TaskJuggler/FileRecord.html">TaskJuggler::FileRecord</a></li>
+				
 					<li><a href="../../TaskJuggler/FixnumAttribute.html">TaskJuggler::FixnumAttribute</a></li>
 				
 					<li><a href="../../TaskJuggler/FlagListAttribute.html">TaskJuggler::FlagListAttribute</a></li>
@@ -267,8 +271,6 @@
 				
 					<li><a href="../../TaskJuggler/Macro.html">TaskJuggler::Macro</a></li>
 				
-					<li><a href="../../TaskJuggler/MacroParser.html">TaskJuggler::MacroParser</a></li>
-				
 					<li><a href="../../TaskJuggler/MacroTable.html">TaskJuggler::MacroTable</a></li>
 				
 					<li><a href="../../TaskJuggler/ManagerResponsibilities.html">TaskJuggler::ManagerResponsibilities</a></li>
@@ -333,6 +335,8 @@
 				
 					<li><a href="../../TaskJuggler/RTFReportLink.html">TaskJuggler::RTFReportLink</a></li>
 				
+					<li><a href="../../TaskJuggler/RTFWithQuerySupport.html">TaskJuggler::RTFWithQuerySupport</a></li>
+				
 					<li><a href="../../TaskJuggler/RealFormat.html">TaskJuggler::RealFormat</a></li>
 				
 					<li><a href="../../TaskJuggler/RealFormatAttribute.html">TaskJuggler::RealFormatAttribute</a></li>
@@ -379,8 +383,6 @@
 				
 					<li><a href="../../TaskJuggler/RichTextElement.html">TaskJuggler::RichTextElement</a></li>
 				
-					<li><a href="../../TaskJuggler/RichTextException.html">TaskJuggler::RichTextException</a></li>
-				
 					<li><a href="../../TaskJuggler/RichTextFunctionExample.html">TaskJuggler::RichTextFunctionExample</a></li>
 				
 					<li><a href="../../TaskJuggler/RichTextFunctionHandler.html">TaskJuggler::RichTextFunctionHandler</a></li>
@@ -421,6 +423,8 @@
 				
 					<li><a href="../../TaskJuggler/ShiftScenario.html">TaskJuggler::ShiftScenario</a></li>
 				
+					<li><a href="../../TaskJuggler/SimpleQueryExpander.html">TaskJuggler::SimpleQueryExpander</a></li>
+				
 					<li><a href="../../TaskJuggler/SortListAttribute.html">TaskJuggler::SortListAttribute</a></li>
 				
 					<li><a href="../../TaskJuggler/SourceFileInfo.html">TaskJuggler::SourceFileInfo</a></li>
@@ -531,6 +535,8 @@
 				
 					<li><a href="../../TaskJuggler/UserManual.html">TaskJuggler::UserManual</a></li>
 				
+					<li><a href="../../TaskJuggler/VimSyntax.html">TaskJuggler::VimSyntax</a></li>
+				
 					<li><a href="../../TaskJuggler/WebServer.html">TaskJuggler::WebServer</a></li>
 				
 					<li><a href="../../TaskJuggler/WorkingHours.html">TaskJuggler::WorkingHours</a></li>
@@ -1205,12 +1211,12 @@ Returns true if the i-th token is a terminal symbol.
 			</div>
 
 		
-			<div id="terminal-oken-method" class="method-detail ">
-				<a name="method-i-terminalToken"></a>
+			<div id="terminal-okens-method" class="method-detail ">
+				<a name="method-i-terminalTokens"></a>
 
 				<div class="method-heading">
 				
-					<span class="method-name">terminalToken</span><span
+					<span class="method-name">terminalTokens</span><span
 						class="method-args">(rules, index = 0)</span>
 					<span class="method-click-advice">click to toggle source</span>
 				
@@ -1221,33 +1227,37 @@ Returns true if the i-th token is a terminal symbol.
 					<p>
 Find recursively the first terminal token of this pattern. If an index is
 specified start the search at this n-th pattern token instead of the first.
-The return value is either nil or a [ token, pattern ] tuple.
+The return value is an Array of [ token, pattern ] tuple.
 </p>
 					
 
 					
 					<div class="method-source-code"
-						id="terminal-oken-source">
+						id="terminal-okens-source">
 <pre>
      <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 146</span>
-146:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">terminalToken</span>(<span class="ruby-identifier">rules</span>, <span class="ruby-identifier">index</span> = <span class="ruby-value">0</span>)
+146:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">terminalTokens</span>(<span class="ruby-identifier">rules</span>, <span class="ruby-identifier">index</span> = <span class="ruby-value">0</span>)
 147:       <span class="ruby-comment cmt"># Terminal token start with an underscore or dollar character.</span>
-148:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>][<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">__</span> <span class="ruby-operator">||</span> <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>][<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">$$</span>
-149:         <span class="ruby-keyword kw">return</span> [ <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>].<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>, <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>].<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>), <span class="ruby-keyword kw">self</span> ]
-150:       <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>][<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">!!</span>
-151:         <span class="ruby-comment cmt"># Token starting with a bang reference another rule. We have to continue</span>
-152:         <span class="ruby-comment cmt"># the search at this rule. First, we get rid of the bang to get the rule</span>
-153:         <span class="ruby-comment cmt"># name.</span>
-154:         <span class="ruby-identifier">token</span> = <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>].<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>, <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>].<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>)
-155:         <span class="ruby-comment cmt"># Then find the rule</span>
-156:         <span class="ruby-identifier">rule</span> = <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>]
-157:         <span class="ruby-comment cmt"># The rule may only have a single pattern. If not, then this pattern has</span>
-158:         <span class="ruby-comment cmt"># no terminal token.</span>
-159:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">rule</span>.<span class="ruby-identifier">patterns</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">!=</span> <span class="ruby-value">1</span>
-160:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">rule</span>.<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">terminalToken</span>(<span class="ruby-identifier">rules</span>)
-161:       <span class="ruby-keyword kw">end</span>
-162:       <span class="ruby-keyword kw">nil</span>
-163:     <span class="ruby-keyword kw">end</span></pre>
+148:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>][<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">__</span>
+149:         <span class="ruby-keyword kw">return</span> [ [ <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>][<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">1</span>], <span class="ruby-keyword kw">self</span> ] ]
+150:       <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>][<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">$$</span>
+151:         <span class="ruby-keyword kw">return</span> []
+152:       <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>][<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">!!</span>
+153:         <span class="ruby-comment cmt"># Token starting with a bang reference another rule. We have to</span>
+154:         <span class="ruby-comment cmt"># continue the search at this rule. First, we get rid of the bang to</span>
+155:         <span class="ruby-comment cmt"># get the rule name.</span>
+156:         <span class="ruby-identifier">token</span> = <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">index</span>][<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">1</span>]
+157:         <span class="ruby-comment cmt"># Then find the rule</span>
+158:         <span class="ruby-identifier">rule</span> = <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>]
+159:         <span class="ruby-comment cmt"># The rule may only have a single pattern. If not, then this pattern</span>
+160:         <span class="ruby-comment cmt"># has no terminal token.</span>
+161:         <span class="ruby-identifier">tts</span> = []
+162:         <span class="ruby-identifier">rule</span>.<span class="ruby-identifier">patterns</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">tts</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">p</span>.<span class="ruby-identifier">terminalTokens</span>(<span class="ruby-identifier">rules</span>, <span class="ruby-value">0</span>) }
+163:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">tts</span>
+164:       <span class="ruby-keyword kw">else</span>
+165:         <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Unexpected token #{tokens[index]}&quot;</span>
+166:       <span class="ruby-keyword kw">end</span>
+167:     <span class="ruby-keyword kw">end</span></pre>
 					</div>
 					
 				</div>
@@ -1278,10 +1288,10 @@ The return value is either nil or a [ token, pattern ] tuple.
 					<div class="method-source-code"
 						id="to-s-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 247</span>
-247:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
-248:       <span class="ruby-ivar">@tokens</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">' '</span>)
-249:     <span class="ruby-keyword kw">end</span></pre>
+     <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 251</span>
+251:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
+252:       <span class="ruby-ivar">@tokens</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">' '</span>)
+253:     <span class="ruby-keyword kw">end</span></pre>
 					</div>
 					
 				</div>
@@ -1316,10 +1326,10 @@ the wrapper function that sets up the stack.
 					<div class="method-source-code"
 						id="to-syntax-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 168</span>
-168:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_syntax</span>(<span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">rules</span>, <span class="ruby-identifier">skip</span> = <span class="ruby-value">0</span>)
-169:       <span class="ruby-identifier">to_syntax_r</span>({}, <span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">rules</span>, <span class="ruby-identifier">skip</span>)
-170:     <span class="ruby-keyword kw">end</span></pre>
+     <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 172</span>
+172:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_syntax</span>(<span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">rules</span>, <span class="ruby-identifier">skip</span> = <span class="ruby-value">0</span>)
+173:       <span class="ruby-identifier">to_syntax_r</span>({}, <span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">rules</span>, <span class="ruby-identifier">skip</span>)
+174:     <span class="ruby-keyword kw">end</span></pre>
 					</div>
 					
 				</div>
@@ -1350,81 +1360,81 @@ the wrapper function that sets up the stack.
 					<div class="method-source-code"
 						id="to-syntax-r-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 172</span>
-172:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_syntax_r</span>(<span class="ruby-identifier">stack</span>, <span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">rules</span>, <span class="ruby-identifier">skip</span>)
-173:       <span class="ruby-comment cmt"># If we find ourself on the stack we hit a recursive pattern. This is used</span>
-174:       <span class="ruby-comment cmt"># in repetitions.</span>
-175:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">stack</span>[<span class="ruby-keyword kw">self</span>]
-176:         <span class="ruby-keyword kw">return</span> <span class="ruby-value str">'[, ... ]'</span>
-177:       <span class="ruby-keyword kw">end</span>
-178: 
-179:       <span class="ruby-comment cmt"># &quot;Push&quot; us on the stack.</span>
-180:       <span class="ruby-identifier">stack</span>[<span class="ruby-keyword kw">self</span>] = <span class="ruby-keyword kw">true</span>
-181: 
-182:       <span class="ruby-identifier">str</span> = <span class="ruby-value str">''</span>
-183:       <span class="ruby-identifier">first</span> = <span class="ruby-keyword kw">true</span>
-184:       <span class="ruby-comment cmt"># Analyze the tokens of the pattern skipping the first 'skip' tokens.</span>
-185:       <span class="ruby-identifier">skip</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-ivar">@lastSyntaxToken</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-186:         <span class="ruby-identifier">token</span> = <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">i</span>]
-187:         <span class="ruby-comment cmt"># If the first token is a _{ the pattern describes optional attributes.</span>
-188:         <span class="ruby-comment cmt"># They are represented by a standard idiom.</span>
-189:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">first</span>
-190:           <span class="ruby-identifier">first</span> = <span class="ruby-keyword kw">false</span>
-191:           <span class="ruby-keyword kw">return</span> <span class="ruby-value str">'{ &lt;attributes&gt; }'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">token</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'_{'</span>
-192:         <span class="ruby-keyword kw">else</span>
-193:           <span class="ruby-comment cmt"># Separate the syntax elemens by a whitespace.</span>
-194:           <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">' '</span>
-195:         <span class="ruby-keyword kw">end</span>
-196: 
-197:         <span class="ruby-identifier">typeId</span> = <span class="ruby-identifier">token</span>[<span class="ruby-value">0</span>]
-198:         <span class="ruby-identifier">token</span> = <span class="ruby-identifier">token</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>, <span class="ruby-identifier">token</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>)
-199: 
-200:         <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@args</span>[<span class="ruby-identifier">i</span>]
-201:           <span class="ruby-comment cmt"># The argument is documented in the syntax definition. We copy the</span>
-202:           <span class="ruby-comment cmt"># entry as we need to modify it.</span>
-203:           <span class="ruby-identifier">argDoc</span> = <span class="ruby-ivar">@args</span>[<span class="ruby-identifier">i</span>].<span class="ruby-identifier">dup</span>
-204: 
-205:           <span class="ruby-comment cmt"># A documented argument without a name is a terminal token. We use the</span>
-206:           <span class="ruby-comment cmt"># terminal symbol as name.</span>
-207:           <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@args</span>[<span class="ruby-identifier">i</span>].<span class="ruby-identifier">name</span>.<span class="ruby-identifier">nil?</span>
-208:             <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;#{token}&quot;</span>
-209:             <span class="ruby-identifier">argDoc</span>.<span class="ruby-identifier">name</span> = <span class="ruby-identifier">token</span>
-210:           <span class="ruby-keyword kw">else</span>
-211:             <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;&lt;#{@args[i].name}&gt;&quot;</span>
-212:           <span class="ruby-keyword kw">end</span>
-213:           <span class="ruby-identifier">addArgDoc</span>(<span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">argDoc</span>)
-214: 
-215:           <span class="ruby-comment cmt"># Documented arguments don't have the type set yet. Use the token</span>
-216:           <span class="ruby-comment cmt"># value for that.</span>
-217:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">typeId</span> <span class="ruby-operator">==</span> <span class="ruby-value">$$</span>
-218:             <span class="ruby-identifier">argDoc</span>.<span class="ruby-identifier">typeSpec</span> = <span class="ruby-node">&quot;&lt;#{token}&gt;&quot;</span>
-219:           <span class="ruby-keyword kw">end</span>
-220:         <span class="ruby-keyword kw">else</span>
-221:           <span class="ruby-comment cmt"># Undocumented tokens are recursively expanded.</span>
-222:           <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">typeId</span>
-223:           <span class="ruby-keyword kw">when</span> <span class="ruby-value">__</span>
-224:             <span class="ruby-comment cmt"># Literals are shown as such.</span>
-225:             <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">token</span>
-226:           <span class="ruby-keyword kw">when</span> <span class="ruby-value">$$</span>
-227:             <span class="ruby-comment cmt"># Variables are enclosed by angle brackets.</span>
-228:             <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">'&lt;'</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">token</span> <span class="ruby-operator">+</span> <span class="ruby-value str">'&gt;'</span>
-229:           <span class="ruby-keyword kw">when</span> <span class="ruby-value">!!</span>
-230:             <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span> <span class="ruby-operator">&amp;&amp;</span>
-231:                <span class="ruby-operator">!</span><span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">doc</span>.<span class="ruby-identifier">nil?</span>
-232:               <span class="ruby-identifier">addArgDoc</span>(<span class="ruby-identifier">argDocs</span>, <span class="ruby-constant">TokenDoc</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">keyword</span>,
-233:                                               <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>]))
-234:               <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">'&lt;'</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">keyword</span> <span class="ruby-operator">+</span> <span class="ruby-value str">'&gt;'</span>
-235:             <span class="ruby-keyword kw">else</span>
-236:               <span class="ruby-comment cmt"># References are followed recursively.</span>
-237:               <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">to_syntax</span>(<span class="ruby-identifier">stack</span>, <span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">rules</span>, <span class="ruby-value">0</span>)
-238:             <span class="ruby-keyword kw">end</span>
-239:           <span class="ruby-keyword kw">end</span>
-240:         <span class="ruby-keyword kw">end</span>
-241:       <span class="ruby-keyword kw">end</span>
-242:       <span class="ruby-comment cmt"># Remove us from the &quot;stack&quot; again.</span>
-243:       <span class="ruby-identifier">stack</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-keyword kw">self</span>)
-244:       <span class="ruby-identifier">str</span>
-245:     <span class="ruby-keyword kw">end</span></pre>
+     <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 176</span>
+176:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_syntax_r</span>(<span class="ruby-identifier">stack</span>, <span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">rules</span>, <span class="ruby-identifier">skip</span>)
+177:       <span class="ruby-comment cmt"># If we find ourself on the stack we hit a recursive pattern. This is used</span>
+178:       <span class="ruby-comment cmt"># in repetitions.</span>
+179:       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">stack</span>[<span class="ruby-keyword kw">self</span>]
+180:         <span class="ruby-keyword kw">return</span> <span class="ruby-value str">'[, ... ]'</span>
+181:       <span class="ruby-keyword kw">end</span>
+182: 
+183:       <span class="ruby-comment cmt"># &quot;Push&quot; us on the stack.</span>
+184:       <span class="ruby-identifier">stack</span>[<span class="ruby-keyword kw">self</span>] = <span class="ruby-keyword kw">true</span>
+185: 
+186:       <span class="ruby-identifier">str</span> = <span class="ruby-value str">''</span>
+187:       <span class="ruby-identifier">first</span> = <span class="ruby-keyword kw">true</span>
+188:       <span class="ruby-comment cmt"># Analyze the tokens of the pattern skipping the first 'skip' tokens.</span>
+189:       <span class="ruby-identifier">skip</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-ivar">@lastSyntaxToken</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
+190:         <span class="ruby-identifier">token</span> = <span class="ruby-ivar">@tokens</span>[<span class="ruby-identifier">i</span>]
+191:         <span class="ruby-comment cmt"># If the first token is a _{ the pattern describes optional attributes.</span>
+192:         <span class="ruby-comment cmt"># They are represented by a standard idiom.</span>
+193:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">first</span>
+194:           <span class="ruby-identifier">first</span> = <span class="ruby-keyword kw">false</span>
+195:           <span class="ruby-keyword kw">return</span> <span class="ruby-value str">'{ &lt;attributes&gt; }'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">token</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'_{'</span>
+196:         <span class="ruby-keyword kw">else</span>
+197:           <span class="ruby-comment cmt"># Separate the syntax elemens by a whitespace.</span>
+198:           <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">' '</span>
+199:         <span class="ruby-keyword kw">end</span>
+200: 
+201:         <span class="ruby-identifier">typeId</span> = <span class="ruby-identifier">token</span>[<span class="ruby-value">0</span>]
+202:         <span class="ruby-identifier">token</span> = <span class="ruby-identifier">token</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>, <span class="ruby-identifier">token</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>)
+203: 
+204:         <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@args</span>[<span class="ruby-identifier">i</span>]
+205:           <span class="ruby-comment cmt"># The argument is documented in the syntax definition. We copy the</span>
+206:           <span class="ruby-comment cmt"># entry as we need to modify it.</span>
+207:           <span class="ruby-identifier">argDoc</span> = <span class="ruby-ivar">@args</span>[<span class="ruby-identifier">i</span>].<span class="ruby-identifier">dup</span>
+208: 
+209:           <span class="ruby-comment cmt"># A documented argument without a name is a terminal token. We use the</span>
+210:           <span class="ruby-comment cmt"># terminal symbol as name.</span>
+211:           <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@args</span>[<span class="ruby-identifier">i</span>].<span class="ruby-identifier">name</span>.<span class="ruby-identifier">nil?</span>
+212:             <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;#{token}&quot;</span>
+213:             <span class="ruby-identifier">argDoc</span>.<span class="ruby-identifier">name</span> = <span class="ruby-identifier">token</span>
+214:           <span class="ruby-keyword kw">else</span>
+215:             <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;&lt;#{@args[i].name}&gt;&quot;</span>
+216:           <span class="ruby-keyword kw">end</span>
+217:           <span class="ruby-identifier">addArgDoc</span>(<span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">argDoc</span>)
+218: 
+219:           <span class="ruby-comment cmt"># Documented arguments don't have the type set yet. Use the token</span>
+220:           <span class="ruby-comment cmt"># value for that.</span>
+221:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">typeId</span> <span class="ruby-operator">==</span> <span class="ruby-value">$$</span>
+222:             <span class="ruby-identifier">argDoc</span>.<span class="ruby-identifier">typeSpec</span> = <span class="ruby-node">&quot;&lt;#{token}&gt;&quot;</span>
+223:           <span class="ruby-keyword kw">end</span>
+224:         <span class="ruby-keyword kw">else</span>
+225:           <span class="ruby-comment cmt"># Undocumented tokens are recursively expanded.</span>
+226:           <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">typeId</span>
+227:           <span class="ruby-keyword kw">when</span> <span class="ruby-value">__</span>
+228:             <span class="ruby-comment cmt"># Literals are shown as such.</span>
+229:             <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">token</span>
+230:           <span class="ruby-keyword kw">when</span> <span class="ruby-value">$$</span>
+231:             <span class="ruby-comment cmt"># Variables are enclosed by angle brackets.</span>
+232:             <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">'&lt;'</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">token</span> <span class="ruby-operator">+</span> <span class="ruby-value str">'&gt;'</span>
+233:           <span class="ruby-keyword kw">when</span> <span class="ruby-value">!!</span>
+234:             <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span> <span class="ruby-operator">&amp;&amp;</span>
+235:                <span class="ruby-operator">!</span><span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">doc</span>.<span class="ruby-identifier">nil?</span>
+236:               <span class="ruby-identifier">addArgDoc</span>(<span class="ruby-identifier">argDocs</span>, <span class="ruby-constant">TokenDoc</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">keyword</span>,
+237:                                               <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>]))
+238:               <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">'&lt;'</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">patterns</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">keyword</span> <span class="ruby-operator">+</span> <span class="ruby-value str">'&gt;'</span>
+239:             <span class="ruby-keyword kw">else</span>
+240:               <span class="ruby-comment cmt"># References are followed recursively.</span>
+241:               <span class="ruby-identifier">str</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">rules</span>[<span class="ruby-identifier">token</span>].<span class="ruby-identifier">to_syntax</span>(<span class="ruby-identifier">stack</span>, <span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">rules</span>, <span class="ruby-value">0</span>)
+242:             <span class="ruby-keyword kw">end</span>
+243:           <span class="ruby-keyword kw">end</span>
+244:         <span class="ruby-keyword kw">end</span>
+245:       <span class="ruby-keyword kw">end</span>
+246:       <span class="ruby-comment cmt"># Remove us from the &quot;stack&quot; again.</span>
+247:       <span class="ruby-identifier">stack</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-keyword kw">self</span>)
+248:       <span class="ruby-identifier">str</span>
+249:     <span class="ruby-keyword kw">end</span></pre>
 					</div>
 					
 				</div>
@@ -1461,14 +1471,14 @@ the wrapper function that sets up the stack.
 					<div class="method-source-code"
 						id="add-rg-oc-source">
 <pre>
-     <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 253</span>
-253:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">addArgDoc</span>(<span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">argDoc</span>)
-254:       <span class="ruby-identifier">raise</span> <span class="ruby-value str">'Error'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">argDoc</span>.<span class="ruby-identifier">name</span>.<span class="ruby-identifier">nil?</span>
-255:       <span class="ruby-identifier">argDocs</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ad</span><span class="ruby-operator">|</span>
-256:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ad</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">argDoc</span>.<span class="ruby-identifier">name</span>
-257:       <span class="ruby-keyword kw">end</span>
-258:       <span class="ruby-identifier">argDocs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">argDoc</span>
-259:     <span class="ruby-keyword kw">end</span></pre>
+     <span class="ruby-comment cmt"># File lib/TextParser/Pattern.rb, line 257</span>
+257:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">addArgDoc</span>(<span class="ruby-identifier">argDocs</span>, <span class="ruby-identifier">argDoc</span>)
+258:       <span class="ruby-identifier">raise</span> <span class="ruby-value str">'Error'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">argDoc</span>.<span class="ruby-identifier">name</span>.<span class="ruby-identifier">nil?</span>
+259:       <span class="ruby-identifier">argDocs</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ad</span><span class="ruby-operator">|</span>
+260:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ad</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">argDoc</span>.<span class="ruby-identifier">name</span>
+261:       <span class="ruby-keyword kw">end</span>
+262:       <span class="ruby-identifier">argDocs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">argDoc</span>
+263:     <span class="ruby-keyword kw">end</span></pre>
 					</div>
 					
 				</div>

data/doc/TaskJuggler/TextParser/Rule.html

@@ -189,6 +189,10 @@
 				
 					<li><a href="../../TaskJuggler/DurationAttribute.html">TaskJuggler::DurationAttribute</a></li>
 				
+					<li><a href="../../TaskJuggler/FileList.html">TaskJuggler::FileList</a></li>
+				
+					<li><a href="../../TaskJuggler/FileRecord.html">TaskJuggler::FileRecord</a></li>
+				
 					<li><a href="../../TaskJuggler/FixnumAttribute.html">TaskJuggler::FixnumAttribute</a></li>
 				
 					<li><a href="../../TaskJuggler/FlagListAttribute.html">TaskJuggler::FlagListAttribute</a></li>
@@ -261,8 +265,6 @@
 				
 					<li><a href="../../TaskJuggler/Macro.html">TaskJuggler::Macro</a></li>
 				
-					<li><a href="../../TaskJuggler/MacroParser.html">TaskJuggler::MacroParser</a></li>
-				
 					<li><a href="../../TaskJuggler/MacroTable.html">TaskJuggler::MacroTable</a></li>
 				
 					<li><a href="../../TaskJuggler/ManagerResponsibilities.html">TaskJuggler::ManagerResponsibilities</a></li>
@@ -327,6 +329,8 @@
 				
 					<li><a href="../../TaskJuggler/RTFReportLink.html">TaskJuggler::RTFReportLink</a></li>
 				
+					<li><a href="../../TaskJuggler/RTFWithQuerySupport.html">TaskJuggler::RTFWithQuerySupport</a></li>
+				
 					<li><a href="../../TaskJuggler/RealFormat.html">TaskJuggler::RealFormat</a></li>
 				
 					<li><a href="../../TaskJuggler/RealFormatAttribute.html">TaskJuggler::RealFormatAttribute</a></li>
@@ -373,8 +377,6 @@
 				
 					<li><a href="../../TaskJuggler/RichTextElement.html">TaskJuggler::RichTextElement</a></li>
 				
-					<li><a href="../../TaskJuggler/RichTextException.html">TaskJuggler::RichTextException</a></li>
-				
 					<li><a href="../../TaskJuggler/RichTextFunctionExample.html">TaskJuggler::RichTextFunctionExample</a></li>
 				
 					<li><a href="../../TaskJuggler/RichTextFunctionHandler.html">TaskJuggler::RichTextFunctionHandler</a></li>
@@ -415,6 +417,8 @@
 				
 					<li><a href="../../TaskJuggler/ShiftScenario.html">TaskJuggler::ShiftScenario</a></li>
 				
+					<li><a href="../../TaskJuggler/SimpleQueryExpander.html">TaskJuggler::SimpleQueryExpander</a></li>
+				
 					<li><a href="../../TaskJuggler/SortListAttribute.html">TaskJuggler::SortListAttribute</a></li>
 				
 					<li><a href="../../TaskJuggler/SourceFileInfo.html">TaskJuggler::SourceFileInfo</a></li>
@@ -525,6 +529,8 @@
 				
 					<li><a href="../../TaskJuggler/UserManual.html">TaskJuggler::UserManual</a></li>
 				
+					<li><a href="../../TaskJuggler/VimSyntax.html">TaskJuggler::VimSyntax</a></li>
+				
 					<li><a href="../../TaskJuggler/WebServer.html">TaskJuggler::WebServer</a></li>
 				
 					<li><a href="../../TaskJuggler/WorkingHours.html">TaskJuggler::WorkingHours</a></li>
@@ -820,17 +826,22 @@ be of type <a href="Pattern.html">TextParser::Pattern</a>.
 156:            <span class="ruby-node">&quot;#{@repeatable ? &quot;[repeatable]&quot; : &quot;&quot;}&quot;</span>
 157:       <span class="ruby-ivar">@patterns</span>.<span class="ruby-identifier">length</span>.<span class="ruby-identifier">times</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
 158:         <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;  Pattern: \&quot;#{@patterns[i]}\&quot;&quot;</span>
-159:         <span class="ruby-ivar">@transitions</span>[<span class="ruby-identifier">i</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">rule</span><span class="ruby-operator">|</span>
-160:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">key</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">__</span>
-161:             <span class="ruby-identifier">token</span> = <span class="ruby-value str">&quot;\&quot;&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>, <span class="ruby-identifier">key</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>) <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;\&quot;&quot;</span>
-162:           <span class="ruby-keyword kw">else</span>
-163:             <span class="ruby-identifier">token</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>, <span class="ruby-identifier">key</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>)
-164:           <span class="ruby-keyword kw">end</span>
-165:           <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;    #{token} -&gt; #{rule.name}&quot;</span>
-166:         <span class="ruby-keyword kw">end</span>
-167:       <span class="ruby-keyword kw">end</span>
-168:       <span class="ruby-identifier">puts</span>
-169:     <span class="ruby-keyword kw">end</span></pre>
+159:         <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@transitions</span>[<span class="ruby-identifier">i</span>]
+160:           <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;No transitions for this pattern!&quot;</span>
+161:           <span class="ruby-keyword kw">next</span>
+162:         <span class="ruby-keyword kw">end</span>
+163: 
+164:         <span class="ruby-ivar">@transitions</span>[<span class="ruby-identifier">i</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">rule</span><span class="ruby-operator">|</span>
+165:           <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">key</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-value">__</span>
+166:             <span class="ruby-identifier">token</span> = <span class="ruby-value str">&quot;\&quot;&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>, <span class="ruby-identifier">key</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>) <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;\&quot;&quot;</span>
+167:           <span class="ruby-keyword kw">else</span>
+168:             <span class="ruby-identifier">token</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>, <span class="ruby-identifier">key</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>)
+169:           <span class="ruby-keyword kw">end</span>
+170:           <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;    #{token} -&gt; #{rule.name}&quot;</span>
+171:         <span class="ruby-keyword kw">end</span>
+172:       <span class="ruby-keyword kw">end</span>
+173:       <span class="ruby-identifier">puts</span>
+174:     <span class="ruby-keyword kw">end</span></pre>
 					</div>
 					
 				</div>

data/doc/TaskJuggler/TextParser/StackElement.html

@@ -165,6 +165,10 @@
 				
 					<li><a href="../../TaskJuggler/DurationAttribute.html">TaskJuggler::DurationAttribute</a></li>
 				
+					<li><a href="../../TaskJuggler/FileList.html">TaskJuggler::FileList</a></li>
+				
+					<li><a href="../../TaskJuggler/FileRecord.html">TaskJuggler::FileRecord</a></li>
+				
 					<li><a href="../../TaskJuggler/FixnumAttribute.html">TaskJuggler::FixnumAttribute</a></li>
 				
 					<li><a href="../../TaskJuggler/FlagListAttribute.html">TaskJuggler::FlagListAttribute</a></li>
@@ -237,8 +241,6 @@
 				
 					<li><a href="../../TaskJuggler/Macro.html">TaskJuggler::Macro</a></li>
 				
-					<li><a href="../../TaskJuggler/MacroParser.html">TaskJuggler::MacroParser</a></li>
-				
 					<li><a href="../../TaskJuggler/MacroTable.html">TaskJuggler::MacroTable</a></li>
 				
 					<li><a href="../../TaskJuggler/ManagerResponsibilities.html">TaskJuggler::ManagerResponsibilities</a></li>
@@ -303,6 +305,8 @@
 				
 					<li><a href="../../TaskJuggler/RTFReportLink.html">TaskJuggler::RTFReportLink</a></li>
 				
+					<li><a href="../../TaskJuggler/RTFWithQuerySupport.html">TaskJuggler::RTFWithQuerySupport</a></li>
+				
 					<li><a href="../../TaskJuggler/RealFormat.html">TaskJuggler::RealFormat</a></li>
 				
 					<li><a href="../../TaskJuggler/RealFormatAttribute.html">TaskJuggler::RealFormatAttribute</a></li>
@@ -349,8 +353,6 @@
 				
 					<li><a href="../../TaskJuggler/RichTextElement.html">TaskJuggler::RichTextElement</a></li>
 				
-					<li><a href="../../TaskJuggler/RichTextException.html">TaskJuggler::RichTextException</a></li>
-				
 					<li><a href="../../TaskJuggler/RichTextFunctionExample.html">TaskJuggler::RichTextFunctionExample</a></li>
 				
 					<li><a href="../../TaskJuggler/RichTextFunctionHandler.html">TaskJuggler::RichTextFunctionHandler</a></li>
@@ -391,6 +393,8 @@
 				
 					<li><a href="../../TaskJuggler/ShiftScenario.html">TaskJuggler::ShiftScenario</a></li>
 				
+					<li><a href="../../TaskJuggler/SimpleQueryExpander.html">TaskJuggler::SimpleQueryExpander</a></li>
+				
 					<li><a href="../../TaskJuggler/SortListAttribute.html">TaskJuggler::SortListAttribute</a></li>
 				
 					<li><a href="../../TaskJuggler/SourceFileInfo.html">TaskJuggler::SourceFileInfo</a></li>
@@ -501,6 +505,8 @@
 				
 					<li><a href="../../TaskJuggler/UserManual.html">TaskJuggler::UserManual</a></li>
 				
+					<li><a href="../../TaskJuggler/VimSyntax.html">TaskJuggler::VimSyntax</a></li>
+				
 					<li><a href="../../TaskJuggler/WebServer.html">TaskJuggler::WebServer</a></li>
 				
 					<li><a href="../../TaskJuggler/WorkingHours.html">TaskJuggler::WorkingHours</a></li>