Changeset 2161 for trunk/kBuild/doc

Timestamp:

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

Author:

bird

Message:

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

Location:

trunk/kBuild/doc

Files:

• QuickReference-kmk.html (modified) (1 diff)
• QuickReference-kmk.txt (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>,

trunk/kBuild/doc/QuickReference-kmk.txt

@@ -555 +555 @@
         $(value var)
 
-    Evaluate ``text`` with ``var`` bound to each word in ``words``, and
+    Evaluate ``body`` with ``var`` bound to each word in ``words``, and
     concatenate the results (spaced)::
 
-        $(foreach var,words,text)
+        $(foreach var,words,body)
+
+    C-style for-loop. Start by evaluating ``init``. Each iteration will
+    first check whether the ``condition`` (``kmk``-expression) is true,
+    then expand ``body`` concatenating the result to the previous iterations
+    (spaced), and finally evaluate ``next``::
+
+        $(for init,conditions,next,body)
+
+    C-style while-loop. Each iteration will check whether the ``condition``
+    (``kmk``-expression) is true, then expand ``body`` concatenating the
+    result to the previous iterations::
+
+        $(while conditions,body)
 
     Evaluate the variable ``var`` replacing any references to ``$(1)``,