Changeset 2163 for trunk/kBuild/doc

Timestamp:

Dec 30, 2008, 1:57:13 AM (17 years ago)

Author:

bird

Message:

kmk: Added a $(select ) function for handling switch like stuff. Fixes #74.

Location:

trunk/kBuild/doc

Files:

• QuickReference-kmk.html (modified) (2 diffs)
• QuickReference-kmk.txt (modified) (2 diffs)

trunk/kBuild/doc/QuickReference-kmk.html

@@ -841 +841 @@
 </pre>
 </blockquote>
-<p>(Mostly) Boolean Functions:</p>
+<p>Boolean and Conditional Functions:</p>
 <blockquote>
 <p>Condition is false if the <tt class="docutils literal"><span class="pre">condition</span></tt> evaluates to an empty string
@@ -879 +879 @@
 <p>Same as <tt class="docutils literal"><span class="pre">$(if</span> <span class="pre">)</span></tt> execpt that the condition is a <tt class="docutils literal"><span class="pre">kmk</span></tt> expression:</p>
 <pre class="literal-block">
-$(if kmk-expression,true-part[,false-part])
+$(if-expr kmk-expression,true-part[,false-part])
+</pre>
+<p>Select the first true condition (<tt class="docutils literal"><span class="pre">kmk</span></tt> expression) and expand the
+following body. Special condition strings <tt class="docutils literal"><span class="pre">default</span></tt> and <tt class="docutils literal"><span class="pre">otherwise</span></tt>:</p>
+<pre class="literal-block">
+$(select when1-cond, when1-body[, whenN-cond, whenN-body])
 </pre>
 <p>Evalutate the <tt class="docutils literal"><span class="pre">kmk</span></tt> expression returning what it evalues as. This is

trunk/kBuild/doc/QuickReference-kmk.txt

@@ -482 +482 @@
 
 
-(Mostly) Boolean Functions:
+Boolean and Conditional Functions:
 
     Condition is false if the ``condition`` evaluates to an empty string
@@ -521 +521 @@
     Same as ``$(if )`` execpt that the condition is a ``kmk`` expression::
 
-        $(if kmk-expression,true-part[,false-part])
+        $(if-expr kmk-expression,true-part[,false-part])
+
+    Select the first true condition (``kmk`` expression) and expand the
+    following body. Special condition strings ``default`` and ``otherwise``::
+
+        $(select when1-cond, when1-body[, whenN-cond, whenN-body])
 
     Evalutate the ``kmk`` expression returning what it evalues as. This is