--- gforth/assert.fs	1994/07/08 15:00:28	1.1
+++ gforth/assert.fs	1995/01/12 18:37:48	1.2
@@ -6,20 +6,27 @@ variable assert-level \ all assertions a
 1 assert-level !
 
 : assertn ( n -- )
+    \ this is internal (it is not immediate)
     assert-level @ >
     if
 	POSTPONE (
     then ;
 
 : assert0( ( -- )
+    \ important assertions that should always be turned on
     0 assertn ; immediate
 : assert1( ( -- )
+    \ normal assertions; turned on by default
     1 assertn ; immediate
 : assert2( ( -- )
+    \ debugging assertions
     2 assertn ; immediate
 : assert3( ( -- )
+    \ slow assertions that you may not want to turn on in normal debugging;
+    \ you would turn them on mainly for thorough checking
     3 assertn ; immediate
 : assert( ( -- )
+    \ equivalent to assert1(
     POSTPONE assert1( ; immediate
 
 : (endassert) ( flag -- )