From c60d54d00992906467f004aad692e0bf3b370ed9 Mon Sep 17 00:00:00 2001
From: Simon Forman <sforman@hushmail.com>
Date: Wed, 6 Jun 2018 11:32:19 -0700
Subject: [PATCH] Minor docs edits.

---
 .../_build/html/_modules/joy/library.html         | 15 +++++++++++++--
 docs/sphinx_docs/_build/html/library.html         | 11 ++++++++++-
 joy/library.py                                    | 15 +++++++++++++--
 3 files changed, 36 insertions(+), 5 deletions(-)

diff --git a/docs/sphinx_docs/_build/html/_modules/joy/library.html b/docs/sphinx_docs/_build/html/_modules/joy/library.html
index b0d5920..aa2024e 100644
--- a/docs/sphinx_docs/_build/html/_modules/joy/library.html
+++ b/docs/sphinx_docs/_build/html/_modules/joy/library.html
@@ -678,7 +678,14 @@
 <div class="viewcode-block" id="concat"><a class="viewcode-back" href="../../library.html#joy.library.concat">[docs]</a><span class="nd">@inscribe</span>
 <span class="nd">@SimpleFunctionWrapper</span>
 <span class="k">def</span> <span class="nf">concat</span><span class="p">(</span><span class="n">S</span><span class="p">):</span>
-  <span class="sd">&#39;&#39;&#39;Concatinate the two lists on the top of the stack.&#39;&#39;&#39;</span>
+  <span class="sd">&#39;&#39;&#39;Concatinate the two lists on the top of the stack.</span>
+<span class="sd">  ::</span>
+
+<span class="sd">       [a b c] [d e f] concat</span>
+<span class="sd">    ----------------------------</span>
+<span class="sd">           [a b c d e f]</span>
+
+<span class="sd">&#39;&#39;&#39;</span>
   <span class="p">(</span><span class="n">tos</span><span class="p">,</span> <span class="p">(</span><span class="n">second</span><span class="p">,</span> <span class="n">stack</span><span class="p">))</span> <span class="o">=</span> <span class="n">S</span>
   <span class="k">for</span> <span class="n">term</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">iter_stack</span><span class="p">(</span><span class="n">second</span><span class="p">))):</span>
     <span class="n">tos</span> <span class="o">=</span> <span class="n">term</span><span class="p">,</span> <span class="n">tos</span>
@@ -691,7 +698,11 @@
   <span class="sd">&#39;&#39;&#39;Like concat but reverses the top list into the second.</span>
 <span class="sd">  ::</span>
 
-<span class="sd">    shunt == [swons] step</span>
+<span class="sd">    shunt == [swons] step == reverse swap concat</span>
+
+<span class="sd">       [a b c] [d e f] shunt</span>
+<span class="sd">    ---------------------------</span>
+<span class="sd">         [f e d a b c] </span>
 
 <span class="sd">  &#39;&#39;&#39;</span>
   <span class="p">(</span><span class="n">tos</span><span class="p">,</span> <span class="p">(</span><span class="n">second</span><span class="p">,</span> <span class="n">stack</span><span class="p">))</span> <span class="o">=</span> <span class="n">stack</span>
diff --git a/docs/sphinx_docs/_build/html/library.html b/docs/sphinx_docs/_build/html/library.html
index cc1198d..588a05c 100644
--- a/docs/sphinx_docs/_build/html/library.html
+++ b/docs/sphinx_docs/_build/html/library.html
@@ -217,6 +217,11 @@ one of the three depending on the results of comparing the two values:</p>
 <dt id="joy.library.concat">
 <code class="descclassname">joy.library.</code><code class="descname">concat</code><span class="sig-paren">(</span><em>stack</em>, <em>expression</em>, <em>dictionary</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/joy/library.html#concat"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#joy.library.concat" title="Permalink to this definition">¶</a></dt>
 <dd><p>Concatinate the two lists on the top of the stack.</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>   <span class="p">[</span><span class="n">a</span> <span class="n">b</span> <span class="n">c</span><span class="p">]</span> <span class="p">[</span><span class="n">d</span> <span class="n">e</span> <span class="n">f</span><span class="p">]</span> <span class="n">concat</span>
+<span class="o">----------------------------</span>
+       <span class="p">[</span><span class="n">a</span> <span class="n">b</span> <span class="n">c</span> <span class="n">d</span> <span class="n">e</span> <span class="n">f</span><span class="p">]</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="function">
@@ -640,7 +645,11 @@ Boolean value (so empty string, zero, etc. are counted as false, etc.)</p>
 <dt id="joy.library.shunt">
 <code class="descclassname">joy.library.</code><code class="descname">shunt</code><span class="sig-paren">(</span><em>stack</em>, <em>expression</em>, <em>dictionary</em><span class="sig-paren">)</span><a class="reference internal" href="_modules/joy/library.html#shunt"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#joy.library.shunt" title="Permalink to this definition">¶</a></dt>
 <dd><p>Like concat but reverses the top list into the second.</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">shunt</span> <span class="o">==</span> <span class="p">[</span><span class="n">swons</span><span class="p">]</span> <span class="n">step</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">shunt</span> <span class="o">==</span> <span class="p">[</span><span class="n">swons</span><span class="p">]</span> <span class="n">step</span> <span class="o">==</span> <span class="n">reverse</span> <span class="n">swap</span> <span class="n">concat</span>
+
+   <span class="p">[</span><span class="n">a</span> <span class="n">b</span> <span class="n">c</span><span class="p">]</span> <span class="p">[</span><span class="n">d</span> <span class="n">e</span> <span class="n">f</span><span class="p">]</span> <span class="n">shunt</span>
+<span class="o">---------------------------</span>
+     <span class="p">[</span><span class="n">f</span> <span class="n">e</span> <span class="n">d</span> <span class="n">a</span> <span class="n">b</span> <span class="n">c</span><span class="p">]</span> 
 </pre></div>
 </div>
 </dd></dl>
diff --git a/joy/library.py b/joy/library.py
index 3157dc8..081e982 100644
--- a/joy/library.py
+++ b/joy/library.py
@@ -645,7 +645,14 @@ def reverse(S):
 @inscribe
 @SimpleFunctionWrapper
 def concat(S):
-  '''Concatinate the two lists on the top of the stack.'''
+  '''Concatinate the two lists on the top of the stack.
+  ::
+
+       [a b c] [d e f] concat
+    ----------------------------
+           [a b c d e f]
+
+'''
   (tos, (second, stack)) = S
   for term in reversed(list(iter_stack(second))):
     tos = term, tos
@@ -658,7 +665,11 @@ def shunt(stack):
   '''Like concat but reverses the top list into the second.
   ::
 
-    shunt == [swons] step
+    shunt == [swons] step == reverse swap concat
+
+       [a b c] [d e f] shunt
+    ---------------------------
+         [f e d a b c] 
 
   '''
   (tos, (second, stack)) = stack