diff options
| author | Marshall Lochbaum <mwlochbaum@gmail.com> | 2021-04-06 11:21:08 -0400 |
|---|---|---|
| committer | Marshall Lochbaum <mwlochbaum@gmail.com> | 2021-04-06 11:21:51 -0400 |
| commit | aaa0de82d6d1b71c950438aa695dc02fb210b140 (patch) | |
| tree | d7a1e8df3daef40d752eb682fbfb0fa6760b5088 /running.md | |
| parent | a93ebb94f939c1c6ab3dcd78ee17a1d882355289 (diff) | |
Fix docs regarding dzaima+reference and deemphasize it
Diffstat (limited to 'running.md')
| -rw-r--r-- | running.md | 16 |
1 files changed, 8 insertions, 8 deletions
@@ -14,19 +14,19 @@ Because self-hosted BQN requires only a simple virtual machine to run, it is [fa ### dzaima/BQN -[dzaima/BQN](https://github.com/dzaima/BQN/) is an implementation in Java created by modifying the existing dzaima/APL. It should be easy to run on desktop Linux and Android. It is still in development and has almost complete syntax support but incomplete primitive support. +[dzaima/BQN](https://github.com/dzaima/BQN/) is an implementation in Java created by modifying the existing dzaima/APL. It should be easy to run on desktop Linux and Android. It is still in development and has almost complete syntax support but incomplete primitive support: major missing functionality is dyadic Depth (`⚇`), Windows (`↕`), and many cases of set functions (`⊐⊒∊⍷`, mostly with rank >1). -### dzaima+reference BQN - -This repository contains a dzaima/BQN script `dzref` that fills in the gaps in primitive support using BQN implementations of primitives that are not yet up to spec ([reference implementations](spec/reference.bqn) of all primitives starting from a small set of pre-existing functions are part of BQN's specification). - -You can run `dzref` from ordinary dzaima/BQN using the `•Import` command; see for example [wcshim.bqn](wcshim.bqn). For testing, it is run as a Unix script, in which case it depends on an executable `dbqn` that runs dzaima/BQN on a file argument. I use the following script, using the path to a clone of dzaima/BQN for the jar file. +In this repository and elsewhere, dzaima/BQN scripts are called with `#! /usr/bin/env dbqn`. This requires an executable file `dbqn` somewhere in your path with the following contents: #! /bin/bash - + java -jar /path/to/dzaima/BQN/BQN.jar "$@" -The left argument for `•Import` or the shell arguments can contain up to two arguments for the script. The first is a file to run, and the second is BQN code to be run after it. +If compiled with Native Image, `nBQN` can be used directly instead. + +#### dzaima+reference BQN + +This repository contains a dzaima/BQN script `dzref` that fills in gaps in primitive support with BQN implementations. dzaima/BQN has good enough primitive support that I now almost never use this, but it's still needed for the website generator md.bqn. The command-line arguments are a script to run and followed by the `•args` to supply to it. ### BQN2NGN |
