--- gforth/blocks.fs	1996/07/16 20:57:06	1.9
+++ gforth/blocks.fs	1997/05/29 19:42:12	1.15
@@ -55,28 +55,30 @@ User block-fid
 
 block-cold
 
-Defer flush-file
+Defer flush-blocks
 
-: use-file ( addr u -- )
-    2dup ['] open-path-file catch 0<>
+: open-blocks ( addr u -- ) \ gforth
+    \g use the file, whose name is given by @var{addr u}, as blocks file 
+    2dup ['] open-fpath-file catch 0<>
     if
 	2drop r/w bin create-file throw
     else
 	rot close-file throw  2dup file-status throw bin open-file throw
 	>r 2drop r>
     then
-    block-fid @ IF  flush-file block-fid @ close-file throw  THEN
+    block-fid @ IF  flush-blocks block-fid @ close-file throw  THEN
     block-fid ! ;
 
-: use ( "file" -- )
-    name use-file ;
+: use ( "file" -- ) \ gforth
+    \g use @var{file} as blocks file
+    name open-blocks ;
 
 \ the file is opened as binary file, since it either will contain text
 \ without newlines or binary data
 : get-block-fid ( -- fid )
     block-fid @ 0=
     if
-	s" blocks.fb" use-file
+	s" blocks.fb" open-blocks
     then
     block-fid @ ;
 
@@ -109,7 +111,7 @@ Defer flush-file
     save-buffers
     empty-buffers ;
 
-' flush IS flush-file
+' flush IS flush-blocks
 
 : get-buffer ( n -- a-addr )
     buffers mod buffer-struct drop * block-buffers @ + ;
@@ -166,23 +168,24 @@ User scr 0 scr !
   pop-file ( throw ) ;
 
 : thru ( i*x n1 n2 -- j*x )
-  1+ swap 0 ?DO  I load  LOOP ;
+  1+ swap ?DO  I load  LOOP ;
 
 : +load ( i*x n -- j*x )  blk @ + load ;
 
 : +thru ( i*x n1 n2 -- j*x )
-  1+ swap 0 ?DO  I +load  LOOP ;
+  1+ swap ?DO  I +load  LOOP ;
 
 : --> ( -- )  refill drop ; immediate
 
 : block-included ( addr u -- )
-    block-fid @ >r block-fid off use-file
+    block-fid @ >r block-fid off open-blocks
     1 load block-fid @ close-file throw flush
     r> block-fid ! ;
 
-: include ( "name" -- )
-    name 2dup dup 3 - /string s" .fb" compare
-    0= IF  block-included  ELSE  included  THEN ;
+\ thrown out because it may provide unpleasant surprises - anton
+\ : include ( "name" -- )
+\     name 2dup dup 3 - /string s" .fb" compare
+\     0= IF  block-included  ELSE  included  THEN ;
 
 get-current environment-wordlist set-current
 true constant block