From 202568257c0efda6aa2509f4f3eb9f815e87e018 Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Thu, 13 May 2021 18:19:25 -0400 Subject: Remove references to namespaces not being implemented --- docs/doc/namespace.html | 1 - docs/running.html | 2 +- docs/try.html | 2 +- 3 files changed, 2 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/doc/namespace.html b/docs/doc/namespace.html index c6f19582..935effca 100644 --- a/docs/doc/namespace.html +++ b/docs/doc/namespace.html @@ -6,7 +6,6 @@

Namespaces

A namespace is a type of value that groups together several values (fields) from the same scope. A block or file returns a namespace if it contains any export arrows at the top level, and fields from namespaces can be accessed with either dot syntax or destructuring assignment. A namespace that contains is mutable, so that its fields might change in value.

-

The self-hosting BQN used for the online REPL doesn't support namespaces yet, but will eventually. dzaima/BQN does.

The following quick example shows a few ways to use a namespace returned by •Import:

ns  •Import "file.bqn"
 something, abbrabbreviation  ns  # Destructure
diff --git a/docs/running.html b/docs/running.html
index 10e72c01..53d262d1 100644
--- a/docs/running.html
+++ b/docs/running.html
@@ -8,7 +8,7 @@
 

There are currently two active BQN implementations: the self-hosted one in this repository, and the independent dzaima/BQN. Neither is entirely complete but they are quite capable for pure programming tasks (say, implementing a compiler). dzaima/BQN has good performance while self-hosted is a few hundred times slower. I tend to develop parts of applications in the online REPL and move to dzaima/BQN scripts in order to run them.

Self-hosted BQN

The online REPL is here. The file docs/bqn.js is zero-dependency Javascript, and can be loaded from HTML or Node.js. For command line use, call the Node.js script bqn.js, passing a file and •args, or -e to execute all remaining arguments directly and print the results. This notebook shows how to run it in an Observable notebook.

-

Fully supports all primitives except a few cases of structural Under (), but still missing some advanced features: namespaces, block headers and multiple body syntax, derived 1-modifiers, and block returns.

+

Fully supports all primitives except a few cases of structural Under (), but still missing some advanced features: block headers and multiple body syntax, derived 1-modifiers, and block returns.

This version of BQN is implemented mainly in BQN itself, but a host language supplies basic functionality and can also replace primitives for better performance. This also allows embedding, where programs in the host language can include BQN code. Support in the following languages has been implemented:

  • Javascript; see above. Slow (compiles at ~5kB/s) but usable.
  • diff --git a/docs/try.html b/docs/try.html index 8fa61889..d5871c0d 100644 --- a/docs/try.html +++ b/docs/try.html @@ -32,7 +32,7 @@
    • You can type special characters with a backslash prefix, as shown by hovering over the character bar above. Documentation links for primitives are here.
    • Any modifier with enter will execute, not just shift. The code window is vertically resizeable.
    • -
    • Support for function headers and multiple bodies, and namespaces, is missing.
    • +
    • Support for function headers and multiple bodies is missing.

    -- cgit v1.2.3