updating docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
This commit is contained in:
Alex A. Naanou 2017-08-25 17:38:18 +03:00
parent 2e173f9786
commit 627237af1b
2 changed files with 13 additions and 5 deletions

View File

@ -1,5 +1,5 @@
CACHE MANIFEST
# Timestamp: 20170825132449
# Timestamp: 20170825173434
CACHE:
slang.html

View File

@ -539,6 +539,9 @@ var BOOTSTRAP =
-------------------------------------------------------------------------------
Slang Basics
------------
The system consists of:
- Stack
- Code
@ -574,21 +577,22 @@ var BOOTSTRAP =
Words may read and affect any of the three system parts:
- Stack
- Code
- Namespace (not yet fully implemented)
- Namespace
Traditioannly, in stack languages words affect only the stack, this is
one of the motivations to implement Slang, that is, to experiment with
different ways to go with stack languages.
TODO: add a complete word-set for work with lists/blocks
TODO: add a complete word-set for work with dicts/namespaces
TODO: add topological comparison/diff
-----------------------------------------------------------------------------
Stack effect notation
---------------------
Traditionally, stack languages use a "stack effect" notation to document how
words affect the stack state, a kind of before-after transformation. here is
a basic example showing how the word "add" works:
@ -636,6 +640,9 @@ var BOOTSTRAP =
-------------------------------------------------------------------------------
Blocks / Lists
--------------
Basic words for block manipulation:
Get block length
@ -719,7 +726,8 @@ var BOOTSTRAP =
-------------------------------------------------------------------------------
Objects and namespaces:
Objects and namespaces
----------------------
Get the namespace object...