about summary refs log tree commit diff stats
diff options
context:
space:
mode:
authorKartik Agaram <vc@akkartik.com>2020-03-14 01:25:34 -0700
committerKartik Agaram <vc@akkartik.com>2020-03-14 01:25:34 -0700
commit6db056110bc9bab90092b29908085a9befd5956e (patch)
treec1ceacd04766cb12e60cd0c11d8547d7d4529e93
parent9428990bd6e61988df23811205504a5c63a348e1 (diff)
downloadmu-6db056110bc9bab90092b29908085a9befd5956e.tar.gz
6144
-rw-r--r--apps/factorial.mu14
-rw-r--r--html/apps/factorial.mu.html106
2 files changed, 66 insertions, 54 deletions
diff --git a/apps/factorial.mu b/apps/factorial.mu
index 722c9e6c..83b2bedf 100644
--- a/apps/factorial.mu
+++ b/apps/factorial.mu
@@ -1,7 +1,13 @@
-# usage:
-#   ./translate_mu apps/factorial.mu
-#   ./a.elf test  # to run tests
-#   ./a.elf       # to run factorial(5)
+# compute the factorial of 5, and return the result in the exit code
+#
+# To run:
+#   $ ./translate_mu apps/factorial.mu
+#   $ ./a.elf
+#   $ echo $?
+#   120
+#
+# You can also run the automated test suite:
+#   $ ./a.elf test
 #
 # Compare apps/factorial4.subx
 
diff --git a/html/apps/factorial.mu.html b/html/apps/factorial.mu.html
index 2b8d1f0c..bb402fdd 100644
--- a/html/apps/factorial.mu.html
+++ b/html/apps/factorial.mu.html
@@ -56,56 +56,62 @@ if ('onhashchange' in window) {
 <body onload='JumpToLine();'>
 <a href='https://github.com/akkartik/mu/blob/master/apps/factorial.mu'>https://github.com/akkartik/mu/blob/master/apps/factorial.mu</a>
 <pre id='vimCodeElement'>
-<span id="L1" class="LineNr"> 1 </span><span class="Comment"># usage:</span>
-<span id="L2" class="LineNr"> 2 </span><span class="Comment">#   ./translate_mu apps/factorial.mu</span>
-<span id="L3" class="LineNr"> 3 </span><span class="Comment">#   ./a.elf test  # to run tests</span>
-<span id="L4" class="LineNr"> 4 </span><span class="Comment">#   ./a.elf       # to run factorial(5)</span>
-<span id="L5" class="LineNr"> 5 </span><span class="Comment">#</span>
-<span id="L6" class="LineNr"> 6 </span><span class="Comment"># Compare apps/factorial4.subx</span>
-<span id="L7" class="LineNr"> 7 </span>
-<span id="L8" class="LineNr"> 8 </span><span class="PreProc">fn</span> <a href='factorial.mu.html#L8'>factorial</a> n: int<span class="PreProc"> -&gt; </span>result/<span class="Constant">eax</span>: int <span class="Delimiter">{</span>
-<span id="L9" class="LineNr"> 9 </span>  compare n <span class="Constant">1</span>
-<span id="L10" class="LineNr">10 </span>  <span class="Delimiter">{</span>
-<span id="L11" class="LineNr">11 </span>    <span class="Identifier">break-if-&gt;</span>
-<span id="L12" class="LineNr">12 </span>    result <span class="Special">&lt;-</span> copy <span class="Constant">1</span>
-<span id="L13" class="LineNr">13 </span>  <span class="Delimiter">}</span>
-<span id="L14" class="LineNr">14 </span>  <span class="Delimiter">{</span>
-<span id="L15" class="LineNr">15 </span>    <span class="Identifier">break-if-&lt;=</span>
-<span id="L16" class="LineNr">16 </span>    <span class="PreProc">var</span> tmp/<span class="Constant">ecx</span>: int <span class="Special">&lt;-</span> copy n
-<span id="L17" class="LineNr">17 </span>    tmp <span class="Special">&lt;-</span> decrement
-<span id="L18" class="LineNr">18 </span>    result <span class="Special">&lt;-</span> <a href='factorial.mu.html#L8'>factorial</a> tmp
-<span id="L19" class="LineNr">19 </span>    result <span class="Special">&lt;-</span> multiply n
-<span id="L20" class="LineNr">20 </span>  <span class="Delimiter">}</span>
-<span id="L21" class="LineNr">21 </span><span class="Delimiter">}</span>
-<span id="L22" class="LineNr">22 </span>
-<span id="L23" class="LineNr">23 </span><span class="PreProc">fn</span> <a href='factorial.mu.html#L23'>test-factorial</a> <span class="Delimiter">{</span>
-<span id="L24" class="LineNr">24 </span>  <span class="PreProc">var</span> result/<span class="Constant">eax</span>: int <span class="Special">&lt;-</span> <a href='factorial.mu.html#L8'>factorial</a> <span class="Constant">5</span>
-<span id="L25" class="LineNr">25 </span>  <a href='../051test.subx.html#L24'>check-ints-equal</a> result <span class="Constant">0x78</span> <span class="Constant">&quot;F - test-factorial&quot;</span>
-<span id="L26" class="LineNr">26 </span><span class="Delimiter">}</span>
-<span id="L27" class="LineNr">27 </span>
-<span id="L28" class="LineNr">28 </span><span class="PreProc">fn</span> main args: (addr array kernel-string)<span class="PreProc"> -&gt; </span>exit-status/<span class="Constant">ebx</span>: int <span class="Delimiter">{</span>
-<span id="L29" class="LineNr">29 </span>  <span class="PreProc">var</span> a/<span class="Constant">eax</span>: (addr array kernel-string) <span class="Special">&lt;-</span> copy args
-<span id="L30" class="LineNr">30 </span>  <span class="PreProc">var</span> tmp/<span class="Constant">ecx</span>: int <span class="Special">&lt;-</span> length a
-<span id="L31" class="LineNr">31 </span>  $main-body: <span class="Delimiter">{</span>
-<span id="L32" class="LineNr">32 </span>    compare tmp, <span class="Constant">1</span>
-<span id="L33" class="LineNr">33 </span>    <span class="Comment"># if (len(args) == 1) factorial(5)</span>
-<span id="L34" class="LineNr">34 </span>    <span class="Delimiter">{</span>
-<span id="L35" class="LineNr">35 </span>      <span class="Identifier">break-if-!=</span>
-<span id="L36" class="LineNr">36 </span>      <span class="PreProc">var</span> tmp/<span class="Constant">eax</span>: int <span class="Special">&lt;-</span> <a href='factorial.mu.html#L8'>factorial</a> <span class="Constant">5</span>
-<span id="L37" class="LineNr">37 </span>      exit-status <span class="Special">&lt;-</span> copy tmp
-<span id="L38" class="LineNr">38 </span>      <span class="Identifier">break</span> $main-body
-<span id="L39" class="LineNr">39 </span>    <span class="Delimiter">}</span>
-<span id="L40" class="LineNr">40 </span>    <span class="Comment"># if (args[1] == &quot;test&quot;) run-tests()</span>
-<span id="L41" class="LineNr">41 </span>    <span class="PreProc">var</span> tmp2/<span class="Constant">ecx</span>: (addr kernel-string) <span class="Special">&lt;-</span> index a, <span class="Constant">1</span>
-<span id="L42" class="LineNr">42 </span>    <span class="PreProc">var</span> tmp3/<span class="Constant">eax</span>: boolean <span class="Special">&lt;-</span> <a href='../052kernel-string-equal.subx.html#L33'>kernel-string-equal?</a> *tmp2, <span class="Constant">&quot;test&quot;</span>
-<span id="L43" class="LineNr">43 </span>    compare tmp3, <span class="Constant">0</span>
-<span id="L44" class="LineNr">44 </span>    <span class="Delimiter">{</span>
-<span id="L45" class="LineNr">45 </span>      <span class="Identifier">break-if-=</span>
-<span id="L46" class="LineNr">46 </span>      run-tests
-<span id="L47" class="LineNr">47 </span>      exit-status <span class="Special">&lt;-</span> copy <span class="Constant">0</span>  <span class="Comment"># TODO: get at Num-test-failures somehow</span>
-<span id="L48" class="LineNr">48 </span>    <span class="Delimiter">}</span>
-<span id="L49" class="LineNr">49 </span>  <span class="Delimiter">}</span>
-<span id="L50" class="LineNr">50 </span><span class="Delimiter">}</span>
+<span id="L1" class="LineNr"> 1 </span><span class="Comment"># compute the factorial of 5, and return the result in the exit code</span>
+<span id="L2" class="LineNr"> 2 </span><span class="Comment">#</span>
+<span id="L3" class="LineNr"> 3 </span><span class="Comment"># To run:</span>
+<span id="L4" class="LineNr"> 4 </span><span class="Comment">#   $ ./translate_mu apps/factorial.mu</span>
+<span id="L5" class="LineNr"> 5 </span><span class="Comment">#   $ ./a.elf</span>
+<span id="L6" class="LineNr"> 6 </span><span class="Comment">#   $ echo $?</span>
+<span id="L7" class="LineNr"> 7 </span><span class="Comment">#   120</span>
+<span id="L8" class="LineNr"> 8 </span><span class="Comment">#</span>
+<span id="L9" class="LineNr"> 9 </span><span class="Comment"># You can also run the automated test suite:</span>
+<span id="L10" class="LineNr">10 </span><span class="Comment">#   $ ./a.elf test</span>
+<span id="L11" class="LineNr">11 </span><span class="Comment">#</span>
+<span id="L12" class="LineNr">12 </span><span class="Comment"># Compare apps/factorial4.subx</span>
+<span id="L13" class="LineNr">13 </span>
+<span id="L14" class="LineNr">14 </span><span class="PreProc">fn</span> <a href='factorial.mu.html#L14'>factorial</a> n: int<span class="PreProc"> -&gt; </span>result/<span class="Constant">eax</span>: int <span class="Delimiter">{</span>
+<span id="L15" class="LineNr">15 </span>  compare n <span class="Constant">1</span>
+<span id="L16" class="LineNr">16 </span>  <span class="Delimiter">{</span>
+<span id="L17" class="LineNr">17 </span>    <span class="Identifier">break-if-&gt;</span>
+<span id="L18" class="LineNr">18 </span>    result <span class="Special">&lt;-</span> copy <span class="Constant">1</span>
+<span id="L19" class="LineNr">19 </span>  <span class="Delimiter">}</span>
+<span id="L20" class="LineNr">20 </span>  <span class="Delimiter">{</span>
+<span id="L21" class="LineNr">21 </span>    <span class="Identifier">break-if-&lt;=</span>
+<span id="L22" class="LineNr">22 </span>    <span class="PreProc">var</span> tmp/<span class="Constant">ecx</span>: int <span class="Special">&lt;-</span> copy n
+<span id="L23" class="LineNr">23 </span>    tmp <span class="Special">&lt;-</span> decrement
+<span id="L24" class="LineNr">24 </span>    result <span class="Special">&lt;-</span> <a href='factorial.mu.html#L14'>factorial</a> tmp
+<span id="L25" class="LineNr">25 </span>    result <span class="Special">&lt;-</span> multiply n
+<span id="L26" class="LineNr">26 </span>  <span class="Delimiter">}</span>
+<span id="L27" class="LineNr">27 </span><span class="Delimiter">}</span>
+<span id="L28" class="LineNr">28 </span>
+<span id="L29" class="LineNr">29 </span><span class="PreProc">fn</span> <a href='factorial.mu.html#L29'>test-factorial</a> <span class="Delimiter">{</span>
+<span id="L30" class="LineNr">30 </span>  <span class="PreProc">var</span> result/<span class="Constant">eax</span>: int <span class="Special">&lt;-</span> <a href='factorial.mu.html#L14'>factorial</a> <span class="Constant">5</span>
+<span id="L31" class="LineNr">31 </span>  <a href='../051test.subx.html#L24'>check-ints-equal</a> result <span class="Constant">0x78</span> <span class="Constant">&quot;F - test-factorial&quot;</span>
+<span id="L32" class="LineNr">32 </span><span class="Delimiter">}</span>
+<span id="L33" class="LineNr">33 </span>
+<span id="L34" class="LineNr">34 </span><span class="PreProc">fn</span> main args: (addr array kernel-string)<span class="PreProc"> -&gt; </span>exit-status/<span class="Constant">ebx</span>: int <span class="Delimiter">{</span>
+<span id="L35" class="LineNr">35 </span>  <span class="PreProc">var</span> a/<span class="Constant">eax</span>: (addr array kernel-string) <span class="Special">&lt;-</span> copy args
+<span id="L36" class="LineNr">36 </span>  <span class="PreProc">var</span> tmp/<span class="Constant">ecx</span>: int <span class="Special">&lt;-</span> length a
+<span id="L37" class="LineNr">37 </span>  $main-body: <span class="Delimiter">{</span>
+<span id="L38" class="LineNr">38 </span>    compare tmp, <span class="Constant">1</span>
+<span id="L39" class="LineNr">39 </span>    <span class="Comment"># if (len(args) == 1) factorial(5)</span>
+<span id="L40" class="LineNr">40 </span>    <span class="Delimiter">{</span>
+<span id="L41" class="LineNr">41 </span>      <span class="Identifier">break-if-!=</span>
+<span id="L42" class="LineNr">42 </span>      <span class="PreProc">var</span> tmp/<span class="Constant">eax</span>: int <span class="Special">&lt;-</span> <a href='factorial.mu.html#L14'>factorial</a> <span class="Constant">5</span>
+<span id="L43" class="LineNr">43 </span>      exit-status <span class="Special">&lt;-</span> copy tmp
+<span id="L44" class="LineNr">44 </span>      <span class="Identifier">break</span> $main-body
+<span id="L45" class="LineNr">45 </span>    <span class="Delimiter">}</span>
+<span id="L46" class="LineNr">46 </span>    <span class="Comment"># if (args[1] == &quot;test&quot;) run-tests()</span>
+<span id="L47" class="LineNr">47 </span>    <span class="PreProc">var</span> tmp2/<span class="Constant">ecx</span>: (addr kernel-string) <span class="Special">&lt;-</span> index a, <span class="Constant">1</span>
+<span id="L48" class="LineNr">48 </span>    <span class="PreProc">var</span> tmp3/<span class="Constant">eax</span>: boolean <span class="Special">&lt;-</span> <a href='../052kernel-string-equal.subx.html#L33'>kernel-string-equal?</a> *tmp2, <span class="Constant">&quot;test&quot;</span>
+<span id="L49" class="LineNr">49 </span>    compare tmp3, <span class="Constant">0</span>
+<span id="L50" class="LineNr">50 </span>    <span class="Delimiter">{</span>
+<span id="L51" class="LineNr">51 </span>      <span class="Identifier">break-if-=</span>
+<span id="L52" class="LineNr">52 </span>      run-tests
+<span id="L53" class="LineNr">53 </span>      exit-status <span class="Special">&lt;-</span> copy <span class="Constant">0</span>  <span class="Comment"># TODO: get at Num-test-failures somehow</span>
+<span id="L54" class="LineNr">54 </span>    <span class="Delimiter">}</span>
+<span id="L55" class="LineNr">55 </span>  <span class="Delimiter">}</span>
+<span id="L56" class="LineNr">56 </span><span class="Delimiter">}</span>
 </pre>
 </body>
 </html>