Changeset 2161 for trunk/kBuild/doc/QuickReference-kmk.html

Timestamp:

Dec 29, 2008, 11:20:11 PM (17 years ago)

Author:

bird

Message:

kmk: Implemented $(for ) and $(while ) loops (C-style). Fixes #73.

File:

• trunk/kBuild/doc/QuickReference-kmk.html (modified) (1 diff)

trunk/kBuild/doc/QuickReference-kmk.html

@@ -913 +913 @@
 $(value var)
 </pre>
-<p>Evaluate <tt class="docutils literal"><span class="pre">text</span></tt> with <tt class="docutils literal"><span class="pre">var</span></tt> bound to each word in <tt class="docutils literal"><span class="pre">words</span></tt>, and
+<p>Evaluate <tt class="docutils literal"><span class="pre">body</span></tt> with <tt class="docutils literal"><span class="pre">var</span></tt> bound to each word in <tt class="docutils literal"><span class="pre">words</span></tt>, and
 concatenate the results (spaced):</p>
 <pre class="literal-block">
-$(foreach var,words,text)
+$(foreach var,words,body)
+</pre>
+<p>C-style for-loop. Start by evaluating <tt class="docutils literal"><span class="pre">init</span></tt>. Each iteration will
+first check whether the <tt class="docutils literal"><span class="pre">condition</span></tt> (<tt class="docutils literal"><span class="pre">kmk</span></tt>-expression) is true,
+then expand <tt class="docutils literal"><span class="pre">body</span></tt> concatenating the result to the previous iterations
+(spaced), and finally evaluate <tt class="docutils literal"><span class="pre">next</span></tt>:</p>
+<pre class="literal-block">
+$(for init,conditions,next,body)
+</pre>
+<p>C-style while-loop. Each iteration will check whether the <tt class="docutils literal"><span class="pre">condition</span></tt>
+(<tt class="docutils literal"><span class="pre">kmk</span></tt>-expression) is true, then expand <tt class="docutils literal"><span class="pre">body</span></tt> concatenating the
+result to the previous iterations:</p>
+<pre class="literal-block">
+$(while conditions,body)
 </pre>
 <p>Evaluate the variable <tt class="docutils literal"><span class="pre">var</span></tt> replacing any references to <tt class="docutils literal"><span class="pre">$(1)</span></tt>,