--- gforth/blocks.fs	1999/04/16 22:19:50	1.24
+++ gforth/blocks.fs	2000/02/28 21:27:07	1.29
@@ -45,6 +45,7 @@ Variable last-block
 $20 Value buffers
 
 User block-fid
+User offset   0 offset !  \ store 1 here fore 0.4.0 compatibility
 
 : block-cold ( -- )
     block-fid off  last-block off
@@ -87,10 +88,10 @@ Defer flush-blocks ( -- ) \ gforth
 
 : block-position ( u -- ) \ block
     \G Position the block file to the start of block @i{u}.
-    1- chars/block chars um* get-block-fid reposition-file throw ;
+    offset @ - chars/block chars um* get-block-fid reposition-file throw ;
 
 : update ( -- ) \ block
-    \G Mark the current block buffer as dirty.
+    \G Mark the state of the current block buffer as assigned-dirty.
     last-block @ ?dup IF  buffer-dirty on  THEN ;
 
 : save-buffer ( buffer -- ) \ gforth
@@ -127,17 +128,17 @@ Defer flush-blocks ( -- ) \ gforth
 
 ' flush IS flush-blocks
 
-: get-buffer ( n -- a-addr ) \ gforth
-    buffers mod buffer-struct %size * block-buffers @ + ;
+: get-buffer ( u -- a-addr ) \ gforth
+    0 buffers um/mod drop buffer-struct %size * block-buffers @ + ;
 
-: block ( u -- a-addr ) \ block- block
+: block ( u -- a-addr ) \ gforthman- block
     \G If a block buffer is assigned for block @i{u}, return its
     \G start address, @i{a-addr}. Otherwise, assign a block buffer
     \G for block @i{u} (if the assigned block buffer has been
     \G @code{update}d, transfer the contents to mass storage), read
     \G the block into the block buffer and return its start address,
     \G @i{a-addr}.
-    dup 0= -35 and throw
+    dup offset @ u< -35 and throw
     dup get-buffer >r
     dup r@ buffer-block @ <>
     r@ buffer-fid @ block-fid @ <> or
@@ -167,15 +168,16 @@ Defer flush-blocks ( -- ) \ gforth
     \ reading in the block is unnecessary, but simpler
     block ;
 
-User scr ( -- a-addr ) \ block-ext
-    \G USER VARIABLE: @i{a-addr} is the address of a cell containing
+User scr ( -- a-addr ) \ block-ext s-c-r
+    \G @code{User} variable -- @i{a-addr} is the address of a cell containing
     \G the block number of the block most recently processed by
     \G @code{list}.
 0 scr !
 
 \ nac31Mar1999 moved "scr @" to list to make the stack comment correct
 : updated?  ( n -- f ) \ gforth
-    \G Return true if block @i{n} has been marked as dirty.
+    \G Return true if @code{updated} has been used to mark block @i{n}
+    \G as assigned-dirty.
     buffer
     [ 0 buffer-dirty 0 block-buffer - ] Literal + @ ;
 
@@ -224,10 +226,13 @@ User scr ( -- a-addr ) \ block-ext
     \G current block + @i{n1} thru the current block + @i{n2}.
     1+ swap ?DO  I +load  LOOP ;
 
-: --> ( -- ) \ block- block chain
+: --> ( -- ) \ gforthman- gforth chain
     \G If this symbol is encountered whilst loading block @i{n},
     \G discard the remainder of the block and load block @i{n+1}. Used
-    \G for chaining multiple blocks together as a single loadable unit.
+    \G for chaining multiple blocks together as a single loadable
+    \G unit.  Not recommended, because it destroys the independence of
+    \G loading.  Use @code{thru} (which is standard) or @code{+thru}
+    \G instead.
     refill drop ; immediate
 
 : block-included ( a-addr u -- ) \ gforth