aboutsummaryrefslogtreecommitdiff
path: root/running.md
diff options
context:
space:
mode:
authorMarshall Lochbaum <mwlochbaum@gmail.com>2022-05-10 21:15:28 -0400
committerMarshall Lochbaum <mwlochbaum@gmail.com>2022-05-10 21:15:28 -0400
commitf13a4160801d23877c755717057fb35ee76dc120 (patch)
tree8941cd51cf21d2429b5db7c20e531304ceb4edbe /running.md
parent4d3e30eb0b84544b20183924c17b19758964fa8d (diff)
Running in Windows
Diffstat (limited to 'running.md')
-rw-r--r--running.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/running.md b/running.md
index d78ee91d..73830efa 100644
--- a/running.md
+++ b/running.md
@@ -4,7 +4,7 @@
[CBQN](https://github.com/dzaima/CBQN) is the primary offline implementation. Scripts in this repository start with `#! /usr/bin/env bqn` in order to look up the user's `bqn` executable, which is expected to be CBQN.
-Third-party packages to build some BQN implementations are available for both Nix and Arch Linux. For general use I recommend `cbqn` from nixpkgs (Nix) and `cbqn-git` from the AUR (Arch).
+Third-party packages to build some BQN implementations are available for both Nix and Arch Linux. For general use I recommend `cbqn` from nixpkgs (Nix) and `cbqn-git` from the AUR (Arch). There are also third party [Windows builds](https://github.com/actalley/WinBQN) hosted on Github.
For tools related to running BQN, see the [editor plugins](editors/README.md) and [fonts page](https://mlochbaum.github.io/BQN/fonts.html).
@@ -42,6 +42,8 @@ The file [docs/bqn.js](docs/bqn.js) is zero-dependency Javascript, and can be lo
C sources are kept in the [CBQN](https://github.com/dzaima/CBQN) repository, but it also depends on bytecode from the BQN sources here. Running `make` gets a working copy right away with saved bytecode. Then to use the latest bytecode, call `$ ./BQN genRuntime …/BQN`, where `…/BQN` points to this repository, and run `make` again.
+CBQN is developed on Linux, and as-is will only run on Unix-like systems (including macOS). To run on Windows, [WSL](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux) has the best support but there are also native builds based on each of Cygwin and Mingw [here](https://github.com/actalley/WinBQN).
+
`genRuntime` can also be run with another BQN implementation (the Node.js one works but takes up to a minute), and plain `./genRuntime` uses your system's `bqn` executable. I symlink `…/CBQN/BQN` to `~/bin/bqn` so I can easily use CBQN for scripting.
CBQN uses the self-hosted runtime to achieve full primitive coverage, and implements specific primitives or parts of primitives natively to speed them up. This means primitives with native support—including everything used by the compiler—are fairly fast while others are much slower.