v0.7 notes and docs

vito · Jul 4, 2022 · 8bc8572 · 8bc8572
1 parent f4aee8f
commit 8bc8572
Show file tree

Hide file tree

Showing 7 changed files with 2,807 additions and 2,588 deletions.
diff --git a/docs/bassics.html b/docs/bassics.html
diff --git a/docs/guide.html b/docs/guide.html
diff --git a/docs/index.html b/docs/index.html
diff --git a/docs/stdlib.html b/docs/stdlib.html
diff --git a/notes/v0.7.0.md b/notes/v0.7.0.md
@@ -0,0 +1 @@
+More tweaks and polish on the path towards stability.
diff --git a/pkg/bass/ground.go b/pkg/bass/ground.go
@@ -777,7 +777,10 @@ func init() {
 
 	Ground.Set("binds?",
 		Func("binds?", "[scope sym]", (*Scope).Binds),
-		`returns true if the scope has a value bound to the given symbol`)
+		`returns true if the scope has a value bound to the given symbol`,
+		`=> (binds? {:x 1} :x)`,
+		`=> (binds? {} :x)`,
+		`=> (binds? (current-scope) :binds?)`)
 }
 
 type primPred struct {

diff --git a/std/root.bass b/std/root.bass
@@ -535,8 +535,16 @@
 (defn run [thunk]
   ((start thunk (fn [err] (and err (err))))))
 
-; runs the body if test returns true
+; evaluates the body if test returns true
 ;
 ; Returns the body's result, or null if the test is false.
+;
+; => (when true (def x :a) (log "hello") (log "world") x)
+;
+; => x
+;
+; => (when false (def x :b))
+;
+; => x
 (defop when [test & body] scope
   (eval [if test [do & body] null] scope))