From 3e68a09ae1617551ca1cbf3b5b72621170b4aa0c Mon Sep 17 00:00:00 2001
From: Přemysl Janouch
Date: Fri, 26 May 2017 19:44:03 +0200
Subject: Remove suck
struct context::arguments stank, the "arg" special form stank.
The amount of lines this adds can be counted on one hand.
---
README.adoc | 18 +++++++++---------
1 file changed, 9 insertions(+), 9 deletions(-)
(limited to 'README.adoc')
diff --git a/README.adoc b/README.adoc
index c31b576..12a397c 100644
--- a/README.adoc
+++ b/README.adoc
@@ -52,8 +52,8 @@ For a slightly more realistic example have a look at 'greet.ell'.
Runtime
-------
Variables use per-block dynamic scoping. Arguments to a block (which is a list
-of lists) must be assigned to variables first using the `arg` special form, and
-that must happen before they get overriden by execution of a different block.
+of lists) are assigned to local variables named `1`, `2`, etc., and the full
+list of them is stored in `*`.
When evaluating a command, the first argument is typically a string with its
name and it is resolved as if `set` was called on it.
@@ -64,19 +64,18 @@ Special Forms
-------------
`quote []...`
-Returns the arguments without any evaluation.
-
-`arg []...`
-
-Assigns arguments to the current block in order to given names. Names for which
-there are no values left default to `[]`. This form can effectively be used to
-declare local variables.
+Like `values` but returns the arguments without any evaluation.
Standard library
----------------
The standard library interprets the empty list and the empty string as false
values, everything else is taken as true.
+`local []...`
+
+Create local variables in the current block. Names for which there are no
+values left default to `()`.
+
`set []`
Retrieve or set a named variable. The syntax sugar for retrieval is `@`.
@@ -167,6 +166,7 @@ Install development packages for GNU Readline to get a REPL for toying around:
Possible Ways of Complicating
-----------------------------
+ * `local [_a _b _rest] @*` would elegantly solve the problem of varargs
* reference counting: currently all values are always copied as needed, which
is good enough for all imaginable use cases, simpler and less error-prone
--
cgit v1.2.3-54-g00ecf