Separate pages on primitive functions and types from README

author: Marshall Lochbaum <mwlochbaum@gmail.com> 2020-08-19 22:52:18 -0400
committer: Marshall Lochbaum <mwlochbaum@gmail.com> 2020-08-19 22:54:23 -0400
commit: 4739618a7f14a224274c40e43471a7fd0bba6c9f (patch)
tree: 890147ca6367251feaa435b10dd873c5a2e2627c /docs
parent: 0135f65e0baec4d7913c9619b0fae6d1eb867a17 (diff)
5 files changed, 360 insertions, 347 deletions
diff --git a/docs/doc/index.html b/docs/doc/index.html
index d54d5247..758a9696 100644
--- a/docs/doc/index.html
+++ b/docs/doc/index.html
@@ -5,6 +5,8 @@
 <p>Overview:</p>
 <ul>
 <li><a href="syntax.html">Syntax</a></li>
+<li><a href="types.html">Types</a></li>
+<li><a href="primitive.html">Primitives</a></li>
 </ul>
 <p>Concepts:</p>
 <ul>
diff --git a/docs/doc/primitive.html b/docs/doc/primitive.html
new file mode 100644
index 00000000..a245632e
--- /dev/null
+++ b/docs/doc/primitive.html
@@ -0,0 +1,336 @@
+<head><link href="../style.css" rel="stylesheet"/></head>
+<div class="nav"><a href="https://github.com/mlochbaum/BQN">BQN</a></div>
+<h1 id="bqn-primitives">BQN primitives</h1>
+<p><em>Primitives</em> are functions and modifiers that are built into the language.</p>
+<h2 id="functions">Functions</h2>
+<p>Functions that have significant differences from APL functions are marked with an asterisk. Links for these entries go to dedicated BQN documentation while other links go to the APL Wiki.</p>
+<table>
+<thead>
+<tr>
+<th>Glyph</th>
+<th>Monadic</th>
+<th>Dyadic</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code><span class='Function'>+</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Conjugate">Conjugate</a></td>
+<td><a href="https://aplwiki.com/wiki/Add">Add</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>-</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Negate">Negate</a></td>
+<td><a href="https://aplwiki.com/wiki/Subtract">Subtract</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>×</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Signum">Sign</a></td>
+<td><a href="https://aplwiki.com/wiki/Times">Multiply</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>÷</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Reciprocal">Reciprocal</a></td>
+<td><a href="https://aplwiki.com/wiki/Divide">Divide</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⋆</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Exponential">Exponential</a></td>
+<td><a href="https://aplwiki.com/wiki/Power_(function)">Power</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>√</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Square_Root">Square Root</a></td>
+<td><a href="https://aplwiki.com/wiki/Root">Root</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⌊</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Floor">Floor</a></td>
+<td><a href="https://aplwiki.com/wiki/Minimum">Minimum</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⌈</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Ceiling">Ceiling</a></td>
+<td><a href="https://aplwiki.com/wiki/Maximum">Maximum</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>∧</span></code></td>
+<td>Sort Up</td>
+<td><a href="logic.html">And</a>*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>∨</span></code></td>
+<td>Sort Down</td>
+<td><a href="logic.html">Or</a>*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>¬</span></code></td>
+<td><a href="logic.html">Not</a>*</td>
+<td><a href="logic.html">Span</a>*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>|</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Magnitude">Absolute Value</a></td>
+<td><a href="https://aplwiki.com/wiki/Residue">Modulus</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>≤</span></code></td>
+<td></td>
+<td><a href="https://aplwiki.com/wiki/Less_than_or_Equal_to">Less Than or Equal to</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>&lt;</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Enclose">Enclose</a></td>
+<td><a href="https://aplwiki.com/wiki/Less_than">Less Than</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>&gt;</span></code></td>
+<td><a href="couple.html">Merge</a>*</td>
+<td><a href="https://aplwiki.com/wiki/Greater_than">Greater Than</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>≥</span></code></td>
+<td></td>
+<td><a href="https://aplwiki.com/wiki/Greater_than_or_Equal_to">Greater Than or Equal to</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>=</span></code></td>
+<td>Rank</td>
+<td><a href="https://aplwiki.com/wiki/Equal_to">Equals</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>≠</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Tally">Length</a></td>
+<td><a href="https://aplwiki.com/wiki/Not_Equal_to">Not Equals</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>≡</span></code></td>
+<td><a href="depth.html">Depth</a>*</td>
+<td><a href="https://aplwiki.com/wiki/Match">Match</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>≢</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Shape">Shape</a></td>
+<td><a href="https://aplwiki.com/wiki/Not_Match">Not Match</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⊣</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Identity">Identity</a></td>
+<td><a href="https://aplwiki.com/wiki/Identity">Left</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⊢</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Identity">Identity</a></td>
+<td><a href="https://aplwiki.com/wiki/Identity">Right</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⥊</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Ravel">Deshape</a></td>
+<td><a href="https://aplwiki.com/wiki/Reshape">Reshape</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>∾</span></code></td>
+<td><a href="join.html">Join</a>*</td>
+<td><a href="https://aplwiki.com/wiki/Catenate">Join to</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>≍</span></code></td>
+<td><a href="couple.html">Solo</a>*</td>
+<td><a href="couple.html">Couple</a>*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>↑</span></code></td>
+<td><a href="prefixes.html">Prefixes</a>*</td>
+<td><a href="https://aplwiki.com/wiki/Take">Take</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>↓</span></code></td>
+<td><a href="prefixes.html">Suffixes</a>*</td>
+<td><a href="https://aplwiki.com/wiki/Drop">Drop</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>↕</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Index_Generator">Range</a></td>
+<td><a href="windows.html">Windows</a>*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>⌽</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Reverse">Reverse</a></td>
+<td><a href="https://aplwiki.com/wiki/Rotate">Rotate</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⍉</span></code></td>
+<td><a href="transpose.html">Transpose</a>*</td>
+<td><a href="transpose.html">Reorder axes</a>*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>/</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Indices">Indices</a></td>
+<td><a href="https://aplwiki.com/wiki/Replicate">Replicate</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⍋</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Grade">Grade Up</a></td>
+<td><a href="https://aplwiki.com/wiki/Interval_Index">Bins Up</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⍒</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Grade">Grade Down</a></td>
+<td><a href="https://aplwiki.com/wiki/Interval_Index">Bins Down</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⊏</span></code></td>
+<td>First Cell*</td>
+<td>Select*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>⊑</span></code></td>
+<td><a href="https://aplwiki.com/wiki/First">First</a></td>
+<td>Pick*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>⊐</span></code></td>
+<td></td>
+<td><a href="https://aplwiki.com/wiki/Index_Of">Index of</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⊒</span></code></td>
+<td>Occurrence Count*</td>
+<td>Progressive Index of*</td>
+</tr>
+<tr>
+<td><code><span class='Function'>∊</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Nub_Sieve">Unique Mask</a></td>
+<td><a href="https://aplwiki.com/wiki/Membership">Member of</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⍷</span></code></td>
+<td><a href="https://aplwiki.com/wiki/Unique">Deduplicate</a></td>
+<td><a href="https://aplwiki.com/wiki/Find">Find</a></td>
+</tr>
+<tr>
+<td><code><span class='Function'>⊔</span></code></td>
+<td><a href="group.html">Group Indices</a>*</td>
+<td><a href="group.html">Group</a>*</td>
+</tr>
+</tbody>
+</table>
+<h2 id="modifiers">Modifiers</h2>
+<p><em>Combinators</em> only control the application of functions. Because a non-function operand applies as a constant function, some combinators have extra meanings when passed a constant. For example, <code><span class='Number'>0</span><span class='Modifier'>˜</span></code> is the constant function that always returns 0 and <code><span class='Number'>0</span><span class='Modifier2'>⊸</span><span class='Function'>&lt;</span></code> is the function that tests whether its right argument is greater than 0.</p>
+<table>
+<thead>
+<tr>
+<th>Glyph</th>
+<th>Name(s)</th>
+<th>Definition</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code><span class='Modifier'>˜</span></code></td>
+<td>Self/Swap</td>
+<td><code><span class='Brace'>{</span><span class='Value'>𝕩</span><span class='Function'>𝔽</span><span class='Value'>𝕨</span><span class='Function'>⊣</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
+<td>Duplicate one argument or exchange two</td>
+</tr>
+<tr>
+<td><code><span class='Modifier2'>∘</span></code></td>
+<td>Atop</td>
+<td><code><span class='Brace'>{</span><span class='Function'>𝔽</span><span class='Value'>𝕨</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
+<td>Apply <code><span class='Function'>𝔾</span></code> to both arguments and <code><span class='Function'>𝔽</span></code> to the result</td>
+</tr>
+<tr>
+<td><code><span class='Modifier2'>○</span></code></td>
+<td>Over</td>
+<td><code><span class='Brace'>{</span><span class='Paren'>(</span><span class='Function'>𝔾</span><span class='Value'>𝕨</span><span class='Paren'>)</span><span class='Function'>𝔽𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
+<td>Apply <code><span class='Function'>𝔾</span></code> to each argument and <code><span class='Function'>𝔽</span></code> to the results</td>
+</tr>
+<tr>
+<td><code><span class='Modifier2'>⊸</span></code></td>
+<td>Before/Bind</td>
+<td><code><span class='Brace'>{</span><span class='Paren'>(</span><span class='Function'>𝔽</span><span class='Value'>𝕨</span><span class='Function'>⊣</span><span class='Value'>𝕩</span><span class='Paren'>)</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
+<td><code><span class='Function'>𝔾</span></code>'s left argument comes from <code><span class='Function'>𝔽</span></code></td>
+</tr>
+<tr>
+<td><code><span class='Modifier2'>⟜</span></code></td>
+<td>After/Bind</td>
+<td><code><span class='Brace'>{</span><span class='Paren'>(</span><span class='Value'>𝕨</span><span class='Function'>⊣</span><span class='Value'>𝕩</span><span class='Paren'>)</span><span class='Function'>𝔽𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
+<td><code><span class='Function'>𝔽</span></code>'s right argument comes from <code><span class='Function'>𝔾</span></code></td>
+</tr>
+<tr>
+<td><code><span class='Modifier2'>⌾</span></code></td>
+<td>Under</td>
+<td><code><span class='Brace'>{</span><span class='Function'>𝔾</span><span class='Modifier'>⁼</span><span class='Modifier2'>∘</span><span class='Function'>𝔽</span><span class='Modifier2'>○</span><span class='Function'>𝔾</span><span class='Brace'>}</span></code> OR <code><span class='Brace'>{</span><span class='Paren'>(</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Paren'>)</span><span class='Gets'>↩</span><span class='Value'>𝕨</span><span class='Function'>𝔽</span><span class='Modifier2'>○</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Separator'>⋄</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
+<td>Apply <code><span class='Function'>𝔽</span></code> over <code><span class='Function'>𝔾</span></code>, then undo <code><span class='Function'>𝔾</span></code></td>
+</tr>
+<tr>
+<td><code><span class='Modifier2'>⊘</span></code></td>
+<td>Valences</td>
+<td><code><span class='Brace'>{</span><span class='Function'>𝔽</span><span class='Value'>𝕩;𝕨</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
+<td>Apply <code><span class='Function'>𝔽</span></code> if there's one argument but <code><span class='Function'>𝔾</span></code> if there are two</td>
+</tr>
+<tr>
+<td><code><span class='Modifier2'>◶</span></code></td>
+<td>Choose</td>
+<td><code><span class='Brace'>{</span><span class='Value'>f</span><span class='Gets'>←</span><span class='Paren'>(</span><span class='Value'>𝕨</span><span class='Function'>𝔽</span><span class='Value'>𝕩</span><span class='Paren'>)</span><span class='Function'>⊑</span><span class='Value'>𝕘</span> <span class='Separator'>⋄</span> <span class='Value'>𝕨</span><span class='Function'>F</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
+<td>Select one of the functions in list <code><span class='Value'>𝕘</span></code> based on <code><span class='Function'>𝔽</span></code></td>
+</tr>
+</tbody>
+</table>
+<p>Choose isn't really a combinator since it calls the function <code><span class='Function'>⊑</span></code>, and Under is not a true combinator since it has an &quot;undo&quot; step at the end. This step might be implemented using the left operand's inverse (<em>computational</em> Under) or its structural properties (<em>structural</em> Under).</p>
+<p>Other modifiers control array traversal and iteration. In three cases a simpler 1-modifier is paired with a generalized 2-modifier: in each case the 1-modifier happens to be the same as the 2-modifier with a right operand of <code><span class='Number'>¯1</span></code>.</p>
+<table>
+<thead>
+<tr>
+<th>1-Modifier</th>
+<th>Name</th>
+<th>2-Modifier</th>
+<th>Name</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code><span class='Modifier'>˘</span></code></td>
+<td>Cells</td>
+<td><code><span class='Modifier2'>⎉</span></code></td>
+<td>Rank</td>
+</tr>
+<tr>
+<td><code><span class='Modifier'>¨</span></code></td>
+<td>Each</td>
+<td><code><span class='Modifier2'>⚇</span></code></td>
+<td>Depth</td>
+</tr>
+<tr>
+<td><code><span class='Modifier'>⌜</span></code></td>
+<td>Table</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td><code><span class='Modifier'>⁼</span></code></td>
+<td>Undo</td>
+<td><code><span class='Modifier2'>⍟</span></code></td>
+<td>Repeat</td>
+</tr>
+<tr>
+<td><code><span class='Modifier'>´</span></code></td>
+<td>Fold</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td><code><span class='Modifier'>˝</span></code></td>
+<td>Insert</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
+<td><code><span class='Modifier'>`</span></code></td>
+<td>Scan</td>
+<td></td>
+<td></td>
+</tr>
+</tbody>
+</table>
+
diff --git a/docs/doc/types.html b/docs/doc/types.html
new file mode 100644
index 00000000..465b20d8
--- /dev/null
+++ b/docs/doc/types.html
@@ -0,0 +1,17 @@
+<head><link href="../style.css" rel="stylesheet"/></head>
+<div class="nav"><a href="https://github.com/mlochbaum/BQN">BQN</a></div>
+<h1 id="types">Types</h1>
+<p>BQN supports the following fundamental types:</p>
+<ul>
+<li>Number (complex with 64-bit float precision)</li>
+<li>Character (Unicode code point)</li>
+<li>Array</li>
+<li>Function</li>
+<li>1-Modifier</li>
+<li>2-Modifier</li>
+</ul>
+<p>All of these types are immutable, and immutable types should be the default for BQN. The only mutable type likely to be added is the namespace or scope.</p>
+<h2 id="array-model">Array model</h2>
+<p>Most of BQN's functionality deals with the manipulation of multidimensional arrays. However, it discards many of the complications of traditional APL <a href="https://aplwiki.com/wiki/Array_model">array models</a>. Unlike in APL, non-array data is possible, and common: numbers, characters, and functions are not arrays. This avoids some difficulties that show up when trying to treat scalar arrays as the fundamental unit; in particular, there is no &quot;floating&quot; so a value is always different from a scalar array that contains it. This system has been <a href="https://dl.acm.org/doi/abs/10.1145/586656.586663">proposed</a> in APL's past under the name <strong>based array theory</strong>.</p>
+<p>Currently, the intention is that arrays will not have prototypes, so that all empty arrays of the same shape behave identically. Different elements of an array should not influence each other. While some APLs force numbers placed in the same array to a common representation, which may have different precision properties, BQN will enforce 64-bit floating-point precision, and only use representations or methods compatible with it (for example, integers up to 32 bits).</p>
+
diff --git a/docs/index.html b/docs/index.html
index 54c04f47..ec450d92 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -30,350 +30,8 @@
 </span>144
 </pre>
 <p>For longer samples, you can <a href="https://github.com/mlochbaum/BQN/blob/master/src/c.bqn">gaze into the abyss</a> that is the self-hosted compiler, or the <a href="https://github.com/mlochbaum/BQN/blob/master/src/r.bqn">shallower but wider abyss</a> of the runtime, or take a look at the friendlier <a href="https://github.com/mlochbaum/BQN/blob/master/md.bqn">markdown processor</a> used to format and highlight documentation files. There are also <a href="https://github.com/mlochbaum/BQN/blob/master/examples/fifty.bqn">some translations</a> from <a href="https://www.jsoftware.com/papers/50/">&quot;A History of APL in 50 Functions&quot;</a> here.</p>
-<h2 id="array-model">Array model</h2>
-<p>Most of BQN's functionality deals with the manipulation of multidimensional arrays. However, it discards many of the complications of traditional APL <a href="https://aplwiki.com/wiki/Array_model">array models</a>. Unlike in APL, non-array data is possible, and common: numbers, characters, and functions are not arrays (see the full list of <a href="#types">types</a> below). This avoids some difficulties that show up when trying to treat scalar arrays as the fundamental unit; in particular, there is no &quot;floating&quot; so a value is always different from a scalar array that contains it. This system has been <a href="https://dl.acm.org/doi/abs/10.1145/586656.586663">proposed</a> in APL's past under the name <strong>based array theory</strong>.</p>
-<p>Currently, the intention is that arrays will not have prototypes, so that all empty arrays of the same shape behave identically. Different elements of an array should not influence each other. While some APLs force numbers placed in the same array to a common representation, which may have different precision properties, BQN will enforce 64-bit floating-point precision, and only use representations or methods compatible with it (for example, integers up to 32 bits).</p>
-<h2 id="built-in-operations">Built-in operations</h2>
-<h3 id="functions">Functions</h3>
-<p>Functions that have significant differences from APL functions are marked with an asterisk. Links for these entries go to dedicated BQN documentation while other links go to the APL Wiki.</p>
-<table>
-<thead>
-<tr>
-<th>Glyph</th>
-<th>Monadic</th>
-<th>Dyadic</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code><span class='Function'>+</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Conjugate">Conjugate</a></td>
-<td><a href="https://aplwiki.com/wiki/Add">Add</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>-</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Negate">Negate</a></td>
-<td><a href="https://aplwiki.com/wiki/Subtract">Subtract</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>×</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Signum">Sign</a></td>
-<td><a href="https://aplwiki.com/wiki/Times">Multiply</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>÷</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Reciprocal">Reciprocal</a></td>
-<td><a href="https://aplwiki.com/wiki/Divide">Divide</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⋆</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Exponential">Exponential</a></td>
-<td><a href="https://aplwiki.com/wiki/Power_(function)">Power</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>√</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Square_Root">Square Root</a></td>
-<td><a href="https://aplwiki.com/wiki/Root">Root</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⌊</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Floor">Floor</a></td>
-<td><a href="https://aplwiki.com/wiki/Minimum">Minimum</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⌈</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Ceiling">Ceiling</a></td>
-<td><a href="https://aplwiki.com/wiki/Maximum">Maximum</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>∧</span></code></td>
-<td>Sort Up</td>
-<td><a href="doc/logic.html">And</a>*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>∨</span></code></td>
-<td>Sort Down</td>
-<td><a href="doc/logic.html">Or</a>*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>¬</span></code></td>
-<td><a href="doc/logic.html">Not</a>*</td>
-<td><a href="doc/logic.html">Span</a>*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>|</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Magnitude">Absolute Value</a></td>
-<td><a href="https://aplwiki.com/wiki/Residue">Modulus</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>≤</span></code></td>
-<td></td>
-<td><a href="https://aplwiki.com/wiki/Less_than_or_Equal_to">Less Than or Equal to</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>&lt;</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Enclose">Enclose</a></td>
-<td><a href="https://aplwiki.com/wiki/Less_than">Less Than</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>&gt;</span></code></td>
-<td><a href="doc/couple.html">Merge</a>*</td>
-<td><a href="https://aplwiki.com/wiki/Greater_than">Greater Than</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>≥</span></code></td>
-<td></td>
-<td><a href="https://aplwiki.com/wiki/Greater_than_or_Equal_to">Greater Than or Equal to</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>=</span></code></td>
-<td>Rank</td>
-<td><a href="https://aplwiki.com/wiki/Equal_to">Equals</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>≠</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Tally">Length</a></td>
-<td><a href="https://aplwiki.com/wiki/Not_Equal_to">Not Equals</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>≡</span></code></td>
-<td><a href="doc/depth.html">Depth</a>*</td>
-<td><a href="https://aplwiki.com/wiki/Match">Match</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>≢</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Shape">Shape</a></td>
-<td><a href="https://aplwiki.com/wiki/Not_Match">Not Match</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⊣</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Identity">Identity</a></td>
-<td><a href="https://aplwiki.com/wiki/Identity">Left</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⊢</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Identity">Identity</a></td>
-<td><a href="https://aplwiki.com/wiki/Identity">Right</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⥊</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Ravel">Deshape</a></td>
-<td><a href="https://aplwiki.com/wiki/Reshape">Reshape</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>∾</span></code></td>
-<td><a href="doc/join.html">Join</a>*</td>
-<td><a href="https://aplwiki.com/wiki/Catenate">Join to</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>≍</span></code></td>
-<td><a href="doc/couple.html">Solo</a>*</td>
-<td><a href="doc/couple.html">Couple</a>*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>↑</span></code></td>
-<td><a href="doc/prefixes.html">Prefixes</a>*</td>
-<td><a href="https://aplwiki.com/wiki/Take">Take</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>↓</span></code></td>
-<td><a href="doc/prefixes.html">Suffixes</a>*</td>
-<td><a href="https://aplwiki.com/wiki/Drop">Drop</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>↕</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Index_Generator">Range</a></td>
-<td><a href="doc/windows.html">Windows</a>*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>⌽</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Reverse">Reverse</a></td>
-<td><a href="https://aplwiki.com/wiki/Rotate">Rotate</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⍉</span></code></td>
-<td><a href="doc/transpose.html">Transpose</a>*</td>
-<td><a href="doc/transpose.html">Reorder axes</a>*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>/</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Indices">Indices</a></td>
-<td><a href="https://aplwiki.com/wiki/Replicate">Replicate</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⍋</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Grade">Grade Up</a></td>
-<td><a href="https://aplwiki.com/wiki/Interval_Index">Bins Up</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⍒</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Grade">Grade Down</a></td>
-<td><a href="https://aplwiki.com/wiki/Interval_Index">Bins Down</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⊏</span></code></td>
-<td>First Cell*</td>
-<td>Select*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>⊑</span></code></td>
-<td><a href="https://aplwiki.com/wiki/First">First</a></td>
-<td>Pick*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>⊐</span></code></td>
-<td></td>
-<td><a href="https://aplwiki.com/wiki/Index_Of">Index of</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⊒</span></code></td>
-<td>Occurrence Count*</td>
-<td>Progressive Index of*</td>
-</tr>
-<tr>
-<td><code><span class='Function'>∊</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Nub_Sieve">Unique Mask</a></td>
-<td><a href="https://aplwiki.com/wiki/Membership">Member of</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⍷</span></code></td>
-<td><a href="https://aplwiki.com/wiki/Unique">Deduplicate</a></td>
-<td><a href="https://aplwiki.com/wiki/Find">Find</a></td>
-</tr>
-<tr>
-<td><code><span class='Function'>⊔</span></code></td>
-<td><a href="doc/group.html">Group Indices</a>*</td>
-<td><a href="doc/group.html">Group</a>*</td>
-</tr>
-</tbody>
-</table>
-<h3 id="modifiers">Modifiers</h3>
-<p><em>Combinators</em> only control the application of functions. Because a non-function operand applies as a constant function, some combinators have extra meanings when passed a constant. For example, <code><span class='Number'>0</span><span class='Modifier'>˜</span></code> is the constant function that always returns 0 and <code><span class='Number'>0</span><span class='Modifier2'>⊸</span><span class='Function'>&lt;</span></code> is the function that tests whether its right argument is greater than 0.</p>
-<table>
-<thead>
-<tr>
-<th>Glyph</th>
-<th>Name(s)</th>
-<th>Definition</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code><span class='Modifier'>˜</span></code></td>
-<td>Self/Swap</td>
-<td><code><span class='Brace'>{</span><span class='Value'>𝕩</span><span class='Function'>𝔽</span><span class='Value'>𝕨</span><span class='Function'>⊣</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
-<td>Duplicate one argument or exchange two</td>
-</tr>
-<tr>
-<td><code><span class='Modifier2'>∘</span></code></td>
-<td>Atop</td>
-<td><code><span class='Brace'>{</span><span class='Function'>𝔽</span><span class='Value'>𝕨</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
-<td>Apply <code><span class='Function'>𝔾</span></code> to both arguments and <code><span class='Function'>𝔽</span></code> to the result</td>
-</tr>
-<tr>
-<td><code><span class='Modifier2'>○</span></code></td>
-<td>Over</td>
-<td><code><span class='Brace'>{</span><span class='Paren'>(</span><span class='Function'>𝔾</span><span class='Value'>𝕨</span><span class='Paren'>)</span><span class='Function'>𝔽𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
-<td>Apply <code><span class='Function'>𝔾</span></code> to each argument and <code><span class='Function'>𝔽</span></code> to the results</td>
-</tr>
-<tr>
-<td><code><span class='Modifier2'>⊸</span></code></td>
-<td>Before/Bind</td>
-<td><code><span class='Brace'>{</span><span class='Paren'>(</span><span class='Function'>𝔽</span><span class='Value'>𝕨</span><span class='Function'>⊣</span><span class='Value'>𝕩</span><span class='Paren'>)</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
-<td><code><span class='Function'>𝔾</span></code>'s left argument comes from <code><span class='Function'>𝔽</span></code></td>
-</tr>
-<tr>
-<td><code><span class='Modifier2'>⟜</span></code></td>
-<td>After/Bind</td>
-<td><code><span class='Brace'>{</span><span class='Paren'>(</span><span class='Value'>𝕨</span><span class='Function'>⊣</span><span class='Value'>𝕩</span><span class='Paren'>)</span><span class='Function'>𝔽𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
-<td><code><span class='Function'>𝔽</span></code>'s right argument comes from <code><span class='Function'>𝔾</span></code></td>
-</tr>
-<tr>
-<td><code><span class='Modifier2'>⌾</span></code></td>
-<td>Under</td>
-<td><code><span class='Brace'>{</span><span class='Function'>𝔾</span><span class='Modifier'>⁼</span><span class='Modifier2'>∘</span><span class='Function'>𝔽</span><span class='Modifier2'>○</span><span class='Function'>𝔾</span><span class='Brace'>}</span></code> OR <code><span class='Brace'>{</span><span class='Paren'>(</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Paren'>)</span><span class='Gets'>↩</span><span class='Value'>𝕨</span><span class='Function'>𝔽</span><span class='Modifier2'>○</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Separator'>⋄</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
-<td>Apply <code><span class='Function'>𝔽</span></code> over <code><span class='Function'>𝔾</span></code>, then undo <code><span class='Function'>𝔾</span></code></td>
-</tr>
-<tr>
-<td><code><span class='Modifier2'>⊘</span></code></td>
-<td>Valences</td>
-<td><code><span class='Brace'>{</span><span class='Function'>𝔽</span><span class='Value'>𝕩;𝕨</span><span class='Function'>𝔾</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
-<td>Apply <code><span class='Function'>𝔽</span></code> if there's one argument but <code><span class='Function'>𝔾</span></code> if there are two</td>
-</tr>
-<tr>
-<td><code><span class='Modifier2'>◶</span></code></td>
-<td>Choose</td>
-<td><code><span class='Brace'>{</span><span class='Value'>f</span><span class='Gets'>←</span><span class='Paren'>(</span><span class='Value'>𝕨</span><span class='Function'>𝔽</span><span class='Value'>𝕩</span><span class='Paren'>)</span><span class='Function'>⊑</span><span class='Value'>𝕘</span> <span class='Separator'>⋄</span> <span class='Value'>𝕨</span><span class='Function'>F</span><span class='Value'>𝕩</span><span class='Brace'>}</span></code></td>
-<td>Select one of the functions in list <code><span class='Value'>𝕘</span></code> based on <code><span class='Function'>𝔽</span></code></td>
-</tr>
-</tbody>
-</table>
-<p>Choose isn't really a combinator since it calls the function <code><span class='Function'>⊑</span></code>, and Under is not a true combinator since it has an &quot;undo&quot; step at the end. This step might be implemented using the left operand's inverse (<em>computational</em> Under) or its structural properties (<em>structural</em> Under).</p>
-<p>Other modifiers control array traversal and iteration. In three cases a simpler 1-modifier is paired with a generalized 2-modifier: in each case the 1-modifier happens to be the same as the 2-modifier with a right operand of <code><span class='Number'>¯1</span></code>.</p>
-<table>
-<thead>
-<tr>
-<th>1-Modifier</th>
-<th>Name</th>
-<th>2-Modifier</th>
-<th>Name</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code><span class='Modifier'>˘</span></code></td>
-<td>Cells</td>
-<td><code><span class='Modifier2'>⎉</span></code></td>
-<td>Rank</td>
-</tr>
-<tr>
-<td><code><span class='Modifier'>¨</span></code></td>
-<td>Each</td>
-<td><code><span class='Modifier2'>⚇</span></code></td>
-<td>Depth</td>
-</tr>
-<tr>
-<td><code><span class='Modifier'>⌜</span></code></td>
-<td>Table</td>
-<td></td>
-<td></td>
-</tr>
-<tr>
-<td><code><span class='Modifier'>⁼</span></code></td>
-<td>Undo</td>
-<td><code><span class='Modifier2'>⍟</span></code></td>
-<td>Repeat</td>
-</tr>
-<tr>
-<td><code><span class='Modifier'>´</span></code></td>
-<td>Fold</td>
-<td></td>
-<td></td>
-</tr>
-<tr>
-<td><code><span class='Modifier'>˝</span></code></td>
-<td>Insert</td>
-<td></td>
-<td></td>
-</tr>
-<tr>
-<td><code><span class='Modifier'>`</span></code></td>
-<td>Scan</td>
-<td></td>
-<td></td>
-</tr>
-</tbody>
-</table>
-<h2 id="types">Types</h2>
-<p>BQN will initially support the following fundamental types:</p>
-<ul>
-<li>Number (complex with 64-bit float precision)</li>
-<li>Character (Unicode code point)</li>
-<li>Array</li>
-<li>Function</li>
-<li>1-Modifier</li>
-<li>2-Modifier</li>
-</ul>
-<p>All of these types are immutable, and immutable types should be the default for BQN. The only mutable type likely to be added is the namespace or scope.</p>
+<h2 id="how-do-i-get-started">How do I get started?</h2>
+<p>Read the <a href="doc/index.html">documentation</a>!</p>
+<p>BQN documentation is currently written primarily for array programmers and is not comprehensive, with aspects of the language that are shared with APL poorly documented. If you're not an array programmer, it would probably be better to start with another language, or wait a few weeks. But if you're a serious language enthusiast, the <a href="spec/index.html">specification</a> is fairly complete and might be enough to fill the gaps in the documentation.</p>
+<p>If you're an array programmer, then you're in much better shape. However, you should be aware of two key differences between BQN and existing array languages beyond just the changes of <a href="doc/primitive.html">primitives</a>—if these differences don't seem important to you then you don't understand them! BQN's based array model is different from both a flat array model like J and a nested one like APL2, Dyalog, or GNU APL in that it has true non-array values (plain numbers and characters) that are different from depth-0 scalars. BQN also uses <a href="context.html">syntactic roles</a> rather than dynamic type to determine how values interact, that is, what's an argument or operand and so on. This system, along with lexical closures, means BQN fully supports Lisp-style <a href="functional.html">functional programming</a>.</p>
 
diff --git a/docs/try.html b/docs/try.html
index 764a18a4..a054e8c6 100644
--- a/docs/try.html
+++ b/docs/try.html
@@ -35,7 +35,7 @@
   <p>
     Notes:
     <ul>
-      <li>You can type special characters with a back<em>slash</em> prefix, as shown by hovering over the character bar above. Documentation links for primitives are found <a href="https://mlochbaum.github.io/BQN/index.html#built-in-operations">here</a>.</li>
+      <li>You can type special characters with a back<em>slash</em> prefix, as shown by hovering over the character bar above. Documentation links for primitives are found <a href="doc/primitive.html">here</a>.</li>
       <li>Any modifier with enter will execute (not just shift).</li>
       <li>BQN uses <code class="Ligature">‿</code> (backslash-space) for stranding, and not juxtaposition. If you don't know what went wrong, check for this first!</li>
       <li>This implementation is still WIP, and in particular I am improving error checking and messages now. Support for function headers and multiple bodies is missing, and Under (<code class="Modifier2">⌾</code>) only works for a small class of structural functions. Performance is bad.</li>
author	Marshall Lochbaum <mwlochbaum@gmail.com>	2020-08-19 22:52:18 -0400
committer	Marshall Lochbaum <mwlochbaum@gmail.com>	2020-08-19 22:54:23 -0400
commit	4739618a7f14a224274c40e43471a7fd0bba6c9f (patch)
tree	890147ca6367251feaa435b10dd873c5a2e2627c /docs
parent	0135f65e0baec4d7913c9619b0fae6d1eb867a17 (diff)