diff options
| -rw-r--r-- | README.md | 4 | ||||
| -rw-r--r-- | docs/index.html | 4 | ||||
| -rw-r--r-- | docs/running.html | 2 | ||||
| -rw-r--r-- | docs/try.html | 1 | ||||
| -rw-r--r-- | running.md | 2 |
5 files changed, 7 insertions, 6 deletions
@@ -27,7 +27,7 @@ Looking for a modern, powerful language centered on Ken Iverson's array programm - A simple, consistent, and [stable](commentary/stability.md) array programming language - A low-dependency C implementation using bytecode compilation: [installation](running.md) -- Basic [system functions](spec/system.md) for common math, file, and IO operations +- [System functions](spec/system.md) for common math, file, and IO operations - Documentation with examples, visuals, explanations, and rationale for features - Replace or extend primitives to make a [BQN-like language](doc/rebqn.md) suited for specialized domains @@ -37,7 +37,7 @@ BQN **will provide**: - Interfaces to connect with other languages, like a C FFI and JSON and CSV tools - A standard system to install and use libraries and packages, and support for package managers -At present, I think BQN is a good choice for learning array programming, scripting, medium-scale number crunching, and recreational programming. For some examples of BQN in action, this repository holds the dreaded [self-hosted compiler](src/c.bqn) and the friendlier [markdown processor](md.bqn) used to generate the site. See also my scripts at [bqn-libs](https://github.com/mlochbaum/bqn-libs), this [gnuplot interface](https://github.com/frasiyav/BQN-Gnuplot/blob/main/Gnuplot.bqn), some nicely commented Advent of Code 2021 [solutions](https://gitlab.com/icen/aoc21), or something else from the [community](community/README.md) page. +At present, I think BQN is a good choice for learning array programming, scripting, medium-scale (fits in RAM) number crunching, and recreational programming. For some examples of BQN in action, this repository holds the dreaded [self-hosted compiler](src/c.bqn) and the friendlier [markdown processor](md.bqn) used to generate the site. See also my scripts at [bqn-libs](https://github.com/mlochbaum/bqn-libs), this [gnuplot interface](https://github.com/frasiyav/BQN-Gnuplot/blob/main/Gnuplot.bqn), examples on [RosettaCode](https://rosettacode.org/wiki/Category:BQN), or something else from the [community](community/README.md) page. ## What kind of name is "BQN"? diff --git a/docs/index.html b/docs/index.html index eda3046b..4e441a8f 100644 --- a/docs/index.html +++ b/docs/index.html @@ -26,7 +26,7 @@ <ul> <li>A simple, consistent, and <a href="commentary/stability.html">stable</a> array programming language</li> <li>A low-dependency C implementation using bytecode compilation: <a href="running.html">installation</a></li> -<li>Basic <a href="spec/system.html">system functions</a> for common math, file, and IO operations</li> +<li><a href="spec/system.html">System functions</a> for common math, file, and IO operations</li> <li>Documentation with examples, visuals, explanations, and rationale for features</li> <li>Replace or extend primitives to make a <a href="doc/rebqn.html">BQN-like language</a> suited for specialized domains</li> </ul> @@ -36,7 +36,7 @@ <li>Interfaces to connect with other languages, like a C FFI and JSON and CSV tools</li> <li>A standard system to install and use libraries and packages, and support for package managers</li> </ul> -<p>At present, I think BQN is a good choice for learning array programming, scripting, medium-scale number crunching, and recreational programming. For some examples of BQN in action, this repository holds the dreaded <a href="https://github.com/mlochbaum/BQN/blob/master/src/c.bqn">self-hosted compiler</a> and the friendlier <a href="https://github.com/mlochbaum/BQN/blob/master/md.bqn">markdown processor</a> used to generate the site. See also my scripts at <a href="https://github.com/mlochbaum/bqn-libs">bqn-libs</a>, this <a href="https://github.com/frasiyav/BQN-Gnuplot/blob/main/Gnuplot.bqn">gnuplot interface</a>, some nicely commented Advent of Code 2021 <a href="https://gitlab.com/icen/aoc21">solutions</a>, or something else from the <a href="community/index.html">community</a> page.</p> +<p>At present, I think BQN is a good choice for learning array programming, scripting, medium-scale (fits in RAM) number crunching, and recreational programming. For some examples of BQN in action, this repository holds the dreaded <a href="https://github.com/mlochbaum/BQN/blob/master/src/c.bqn">self-hosted compiler</a> and the friendlier <a href="https://github.com/mlochbaum/BQN/blob/master/md.bqn">markdown processor</a> used to generate the site. See also my scripts at <a href="https://github.com/mlochbaum/bqn-libs">bqn-libs</a>, this <a href="https://github.com/frasiyav/BQN-Gnuplot/blob/main/Gnuplot.bqn">gnuplot interface</a>, examples on <a href="https://rosettacode.org/wiki/Category:BQN">RosettaCode</a>, or something else from the <a href="community/index.html">community</a> page.</p> <h2 id="what-kind-of-name-is-bqn"><a class="header" href="#what-kind-of-name-is-bqn">What kind of name is "BQN"?</a></h2> <p>It's three letters, that happen to match the capitals in "Big Questions Notation". You can pronounce it "bacon", but are advised to avoid this unless there's puns.</p> <h2 id="whats-the-language-like"><a class="header" href="#whats-the-language-like">What's the language like?</a></h2> diff --git a/docs/running.html b/docs/running.html index b7cbe3f6..7fea2682 100644 --- a/docs/running.html +++ b/docs/running.html @@ -35,7 +35,7 @@ <p><code><span class='Value'>genRuntime</span></code> can also be run with another BQN implementation (the Node.js one works but takes up to a minute), and plain <code><span class='Value'>.</span><span class='Function'>/</span><span class='Value'>genRuntime</span></code> uses your system's <code><span class='Value'>bqn</span></code> executable. I symlink <code><span class='Value'>…</span><span class='Function'>/CBQN/BQN</span></code> to <code><span class='Value'>~</span><span class='Function'>/</span><span class='Value'>bin</span><span class='Function'>/</span><span class='Value'>bqn</span></code> so I can easily use CBQN for scripting.</p> <p>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.</p> <h3 id="dzaimabqn"><a class="header" href="#dzaimabqn">dzaima/BQN</a></h3> -<p><a href="https://github.com/dzaima/BQN/">dzaima/BQN</a> is an implementation in Java created by modifying the existing dzaima/APL, and should be easy to run on desktop Linux and Android. It was historically the main implementation, but is now updated only to stay up to date with language changes. Major missing functionality is dyadic Depth (<code><span class='Modifier2'>⚇</span></code>) and set functions <code><span class='Function'>⊐⊒∊⍷</span></code> with rank >1, and there are various small differences from the BQN spec, mostly to do with rank, handling of atoms, fills, and headers.</p> +<p><a href="https://github.com/dzaima/BQN/">dzaima/BQN</a> is an implementation in Java created by modifying the existing dzaima/APL, and should be easy to run on desktop Linux and Android. It was historically the main implementation, but is now updated only to stay up to date with language changes. Major missing functionality is dyadic Depth (<code><span class='Modifier2'>⚇</span></code>) and set functions <code><span class='Function'>⊐⊒∊⍷</span></code> with rank >1, and there are various small differences from the BQN spec, mostly to do with rank, handling of atoms, fills, and headers. It uses UTF-16 instead of UTF-32, so that characters like <code><span class='Value'>𝕩</span></code> don't behave correctly.</p> <p>To get an executable that works like CBQN, make a script with the following contents. Scripts may use <code><span class='Comment'>#! /usr/bin/env dbqn</span></code> to run with dzaima/BQN specifically, but this is rare now (in this repository, only <code><span class='Value'>test</span><span class='Function'>/</span><span class='Value'>dzaima</span></code> does it).</p> <pre><span class='Comment'>#! /bin/bash </span> diff --git a/docs/try.html b/docs/try.html index 3fc040d4..c8b73770 100644 --- a/docs/try.html +++ b/docs/try.html @@ -31,6 +31,7 @@ <p> Notes: <ul> + <li>Also try <a href="https://bqnpad.mechanize.systems/">BQNPAD</a>, a third-party REPL with an interactive session format.</li> <li>The top bar has everything you need to know about BQN's special characters. Click to enter it, hover to see its name and the backslash combination you can type instead, and middle- or modified click to go to a help page.</li> <li>The code window is vertically resizeable.</li> </ul> @@ -42,7 +42,7 @@ CBQN uses the self-hosted runtime to achieve full primitive coverage, and implem ### dzaima/BQN -[dzaima/BQN](https://github.com/dzaima/BQN/) is an implementation in Java created by modifying the existing dzaima/APL, and should be easy to run on desktop Linux and Android. It was historically the main implementation, but is now updated only to stay up to date with language changes. Major missing functionality is dyadic Depth (`⚇`) and set functions `⊐⊒∊⍷` with rank >1, and there are various small differences from the BQN spec, mostly to do with rank, handling of atoms, fills, and headers. +[dzaima/BQN](https://github.com/dzaima/BQN/) is an implementation in Java created by modifying the existing dzaima/APL, and should be easy to run on desktop Linux and Android. It was historically the main implementation, but is now updated only to stay up to date with language changes. Major missing functionality is dyadic Depth (`⚇`) and set functions `⊐⊒∊⍷` with rank >1, and there are various small differences from the BQN spec, mostly to do with rank, handling of atoms, fills, and headers. It uses UTF-16 instead of UTF-32, so that characters like `𝕩` don't behave correctly. To get an executable that works like CBQN, make a script with the following contents. Scripts may use `#! /usr/bin/env dbqn` to run with dzaima/BQN specifically, but this is rare now (in this repository, only `test/dzaima` does it). |