diff options
| author | Marshall Lochbaum <mwlochbaum@gmail.com> | 2021-07-19 14:23:42 -0400 |
|---|---|---|
| committer | Marshall Lochbaum <mwlochbaum@gmail.com> | 2021-07-19 14:23:42 -0400 |
| commit | 4c397e48db4ee4b0a53d58aa4d1c8288341ab161 (patch) | |
| tree | 139f6f3bbbd3bd3e99aa660a643fd52884235dba /docs | |
| parent | 7c191728085439b8507f067f146809607054b5c8 (diff) | |
Link to primitive and compiler directories in the implementation README
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/implementation/index.html | 2 |
1 files changed, 2 insertions, 0 deletions
diff --git a/docs/implementation/index.html b/docs/implementation/index.html index c9d79a2c..ccfaa132 100644 --- a/docs/implementation/index.html +++ b/docs/implementation/index.html @@ -9,6 +9,8 @@ <ul> <li><a href="codfns.html">Comparison to Co-dfns</a> discusses the general compilation strategy and how it compares to the only other array-based compiler.</li> <li><a href="vm.html">The BQN virtual machine and runtime</a> describes the non-self-hosted parts of the BQN implementation, that is, everything you need to port it to a new platform.</li> +<li><a href="primitive/index.html">Notes on implementing primitives</a></li> +<li><a href="compile/index.html">Notes on compilation</a></li> </ul> <p>This repository's BQN implementation is written mainly in BQN: the bytecode <a href="https://github.com/mlochbaum/BQN/blob/master/implementation/../src/c.bqn">compiler</a> is completely self-hosted, and the majority of the runtime (<a href="https://github.com/mlochbaum/BQN/blob/master/implementation/../src/r0.bqn">r0</a>, <a href="https://github.com/mlochbaum/BQN/blob/master/implementation/../src/r1.bqn">r1</a>) is written in BQN except that it is allowed to define primitives; some preprocessing turns the primitives into identifiers. The remaining part, a VM, can be implemented in any language to obtain a version of BQN running in that language.</p> <p>The VM used for the online REPL is the <a href="https://github.com/mlochbaum/BQN/blob/master/implementation/../docs/bqn.js">Javascript implementation</a>. The bytecode matches dzaima/BQN's format, and <a href="https://github.com/mlochbaum/BQN/blob/master/implementation/../dc.bqn">an extension</a> to the compiler adjusts the slightly different block declarations to target dzaima+reference BQN. <a href="https://github.com/mlochbaum/BQN/blob/master/implementation/../wc.bqn">An earlier experiment</a> targetting <a href="https://en.wikipedia.org/wiki/WebAssembly">WebAssembly</a> works only on a very small subset of BQN. All versions have automated tests in the <a href="https://github.com/mlochbaum/BQN/blob/master/implementation/../test/">test</a> directory.</p> |