From 627237af1b07cc8102b286e0557771c6a777416b Mon Sep 17 00:00:00 2001 From: "Alex A. Naanou" Date: Fri, 25 Aug 2017 17:38:18 +0300 Subject: [PATCH] updating docs... Signed-off-by: Alex A. Naanou --- Slang/slang.appcache | 2 +- Slang/slang.js | 16 ++++++++++++---- 2 files changed, 13 insertions(+), 5 deletions(-) diff --git a/Slang/slang.appcache b/Slang/slang.appcache index e764582..69886fd 100755 --- a/Slang/slang.appcache +++ b/Slang/slang.appcache @@ -1,5 +1,5 @@ CACHE MANIFEST -# Timestamp: 20170825132449 +# Timestamp: 20170825173434 CACHE: slang.html diff --git a/Slang/slang.js b/Slang/slang.js index 8d7f268..dcb598c 100755 --- a/Slang/slang.js +++ b/Slang/slang.js @@ -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...