Diff for /gforth/Attic/kernal.fs between versions 1.24 and 1.61

version 1.24, 1994/11/15 15:55:39 version 1.61, 1996/08/21 14:58:42
Line 1 Line 1
 \ KERNAL.FS    GNU FORTH kernal                        17dec92py  \ KERNAL.FS    GForth kernal                        17dec92py
 \ $ID:  
   \ Copyright (C) 1995 Free Software Foundation, Inc.
   
   \ This file is part of Gforth.
   
   \ Gforth is free software; you can redistribute it and/or
   \ modify it under the terms of the GNU General Public License
   \ as published by the Free Software Foundation; either version 2
   \ of the License, or (at your option) any later version.
   
   \ This program is distributed in the hope that it will be useful,
   \ but WITHOUT ANY WARRANTY; without even the implied warranty of
   \ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   \ GNU General Public License for more details.
   
   \ You should have received a copy of the GNU General Public License
   \ along with this program; if not, write to the Free Software
   \ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
   
 \ Idea and implementation: Bernd Paysan (py)  \ Idea and implementation: Bernd Paysan (py)
 \ Copyright 1992 by the ANSI figForth Development Group  
   
 \ Log:  ', '- usw. durch [char] ... ersetzt  \ Log:  ', '- usw. durch [char] ... ersetzt
 \       man sollte die unterschiedlichen zahlensysteme  \       man sollte die unterschiedlichen zahlensysteme
Line 31 Line 48
   
 HEX  HEX
   
   \ labels for some code addresses
   
   : docon: ( -- addr )    \ gforth
       \ the code address of a @code{CONSTANT}
       ['] bl >code-address ;
   
   : docol: ( -- addr )    \ gforth
       \ the code address of a colon definition
       ['] docon: >code-address ;
   
   : dovar: ( -- addr )    \ gforth
       \ the code address of a @code{CREATE}d word
       ['] udp >code-address ;
   
   : douser: ( -- addr )   \ gforth
       \ the code address of a @code{USER} variable
       ['] s0 >code-address ;
   
   : dodefer: ( -- addr )  \ gforth
       \ the code address of a @code{defer}ed word
       ['] source >code-address ;
   
   : dofield: ( -- addr )  \ gforth
       \ the code address of a @code{field}
       ['] reveal-method >code-address ;
   
   NIL AConstant NIL \ gforth
   
 \ Bit string manipulation                              06oct92py  \ Bit string manipulation                              06oct92py
   
 Create bits  80 c, 40 c, 20 c, 10 c, 8 c, 4 c, 2 c, 1 c,  \ Create bits  80 c, 40 c, 20 c, 10 c, 8 c, 4 c, 2 c, 1 c,
 DOES> ( n -- )  + c@ ;  \ DOES> ( n -- )  + c@ ;
   
 : >bit  ( addr n -- c-addr mask )  8 /mod rot + swap bits ;  \ : >bit  ( addr n -- c-addr mask )  8 /mod rot + swap bits ;
 : +bit  ( addr n -- )  >bit over c@ or swap c! ;  \ : +bit  ( addr n -- )  >bit over c@ or swap c! ;
   
 : relinfo ( -- addr )  forthstart dup @ + ;  \ : relinfo ( -- addr )  forthstart dup @ + !!bug!! ;
 : >rel  ( addr -- n )  forthstart - ;  \ : >rel  ( addr -- n )  forthstart - ;
 : relon ( addr -- )  relinfo swap >rel cell / +bit ;  \ : relon ( addr -- )  relinfo swap >rel cell / +bit ;
   
 \ here allot , c, A,                                   17dec92py  \ here allot , c, A,                                   17dec92py
   
 : dp    ( -- addr )  dpp @ ;  : dp    ( -- addr ) \ gforth
 : here  ( -- here )  dp @ ;      dpp @ ;
 : allot ( n -- )     dp +! ;  : here  ( -- here ) \ core
 : c,    ( c -- )     here 1 chars allot c! ;      dp @ ;
 : ,     ( x -- )     here cell allot  ! ;  : allot ( n -- ) \ core
 : 2,    ( w1 w2 -- ) \ general      dp +! ;
   : c,    ( c -- ) \ core
       here 1 chars allot c! ;
   : ,     ( x -- ) \ core
       here cell allot  ! ;
   : 2,    ( w1 w2 -- ) \ gforth
     here 2 cells allot 2! ;      here 2 cells allot 2! ;
   
 : aligned ( addr -- addr' )  \ : aligned ( addr -- addr' ) \ core
   [ cell 1- ] Literal + [ -1 cells ] Literal and ;  \     [ cell 1- ] Literal + [ -1 cells ] Literal and ;
 : align ( -- )          here dup aligned swap ?DO  bl c,  LOOP ;  : align ( -- ) \ core
       here dup aligned swap ?DO  bl c,  LOOP ;
 : faligned ( addr -- f-addr )  
   [ 1 floats 1- ] Literal + [ -1 floats ] Literal and ;  \ : faligned ( addr -- f-addr ) \ float
   \     [ 1 floats 1- ] Literal + [ -1 floats ] Literal and ;
 : falign ( -- )  
   here dup faligned swap  
   ?DO  
       bl c,  
   LOOP ;  
   
 : chars ; immediate  : falign ( -- ) \ float
       here dup faligned swap
       ?DO
           bl c,
       LOOP ;
   
   \ !! this is machine-dependent, but works on all but the strangest machines
   ' faligned Alias maxaligned ( addr1 -- addr2 ) \ gforth
   ' falign Alias maxalign ( -- ) \ gforth
   
   \ !! machine-dependent and won't work if "0 >body" <> "0 >body maxaligned"
   ' maxaligned Alias cfaligned ( addr1 -- addr2 ) \ gforth
   \ the code field is aligned if its body is maxaligned
   ' maxalign Alias cfalign ( -- ) \ gforth
   
   : chars ( n1 -- n2 ) \ core
   ; immediate
   
   
   \ : A!    ( addr1 addr2 -- ) \ gforth
   \    dup relon ! ;
   \ : A,    ( addr -- ) \ gforth
   \    here cell allot A! ;
   ' ! alias A! ( addr1 addr2 -- ) \ gforth
   ' , alias A, ( addr -- ) \ gforth 
   
 : A!    ( addr1 addr2 -- )  dup relon ! ;  
 : A,    ( addr -- )     here cell allot A! ;  
   
 \ on off                                               23feb93py  \ on off                                               23feb93py
   
 : on  ( addr -- )  true  swap ! ;  : on  ( addr -- ) \ gforth
 : off ( addr -- )  false swap ! ;      true  swap ! ;
   : off ( addr -- ) \ gforth
       false swap ! ;
   
   \ dabs roll                                           17may93jaw
   
   : dabs ( d1 -- d2 ) \ double
       dup 0< IF dnegate THEN ;
   
   : roll  ( x0 x1 .. xn n -- x1 .. xn x0 ) \ core-ext
     dup 1+ pick >r
     cells sp@ cell+ dup cell+ rot move drop r> ;
   
 \ name> found                                          17dec92py  \ name> found                                          17dec92py
   
 : (name>)  ( nfa -- cfa )    count  $1F and  +  aligned ;  $80 constant alias-mask \ set when the word is not an alias!
 : name>    ( nfa -- cfa )    cell+  $40 constant immediate-mask
   dup  (name>) swap  c@ $80 and 0= IF  @ THEN ;  $20 constant restrict-mask
   
 : found ( nfa -- cfa n )  cell+  : ((name>))  ( nfa -- cfa )
   dup c@ >r  (name>) r@ $80 and  0= IF  @       THEN      name>string +  cfaligned ;
                   -1 r@ $40 and     IF  1-      THEN  
                      r> $20 and     IF  negate  THEN  ;  : (name>x) ( nfa -- cfa b )
       \ cfa is an intermediate cfa and b is the flags byte of nfa
 \ (find)                                               17dec92py      dup ((name>))
       swap cell+ c@ dup alias-mask and 0=
 \ : (find) ( addr count nfa1 -- nfa2 / false )      IF
 \   BEGIN  dup  WHILE  dup >r          swap @ swap
 \          cell+ count $1F and dup >r 2over r> =      THEN ;
 \          IF  -text  0= IF  2drop r> EXIT  THEN  
 \          ELSE  2drop drop  THEN  r> @  
 \   REPEAT nip nip ;  
   
 \ place bounds                                         13feb93py  \ place bounds                                         13feb93py
   
 : place  ( addr len to -- ) over >r  rot over 1+  r> move c! ;  : place  ( addr len to -- ) \ gforth
 : bounds ( beg count -- end beg )  over + swap ;      over >r  rot over 1+  r> move c! ;
   : bounds ( beg count -- end beg ) \ gforth
       over + swap ;
   
   : save-mem      ( addr1 u -- addr2 u ) \ gforth
       \ copy a memory block into a newly allocated region in the heap
       swap >r
       dup allocate throw
       swap 2dup r> -rot move ;
   
   : extend-mem    ( addr1 u1 u -- addr addr2 u2 )
       \ extend memory block allocated from the heap by u aus
       \ the (possibly reallocated piece is addr2 u2, the extension is at addr
       over >r + dup >r resize throw
       r> over r> + -rot ;
   
 \ input stream primitives                              23feb93py  \ input stream primitives                              23feb93py
   
 : tib   >tib @ ;  : tib ( -- c-addr ) \ core-ext
 Defer source      \ obsolescent
 : (source) ( -- addr count ) tib #tib @ ;      >tib @ ;
   Defer source ( -- addr count ) \ core
   \ used by dodefer:, must be defer
   : (source) ( -- addr count )
       tib #tib @ ;
 ' (source) IS source  ' (source) IS source
   
 \ (word)                                               22feb93py  \ (word)                                               22feb93py
   
 : scan   ( addr1 n1 char -- addr2 n2 )  : scan   ( addr1 n1 char -- addr2 n2 ) \ gforth
     \ skip all characters not equal to char      \ skip all characters not equal to char
     >r      >r
     BEGIN      BEGIN
Line 121  Defer source Line 214  Defer source
         1 /string          1 /string
     REPEAT  THEN      REPEAT  THEN
     rdrop ;      rdrop ;
 : skip   ( addr1 n1 char -- addr2 n2 )  : skip   ( addr1 n1 char -- addr2 n2 ) \ gforth
     \ skip all characters equal to char      \ skip all characters equal to char
     >r      >r
     BEGIN      BEGIN
Line 141  Defer source Line 234  Defer source
   
 \ word parse                                           23feb93py  \ word parse                                           23feb93py
   
 : parse-word  ( char -- addr len )  : parse-word  ( char -- addr len ) \ gforth
   source 2dup >r >r >in @ /string    source 2dup >r >r >in @ over min /string
   rot dup bl = IF  drop (parse-white)  ELSE  (word)  THEN    rot dup bl = IF  drop (parse-white)  ELSE  (word)  THEN
   2dup + r> - 1+ r> min >in ! ;    2dup + r> - 1+ r> min >in ! ;
 : word   ( char -- addr )  : word   ( char -- addr ) \ core
   parse-word here place  bl here count + c!  here ;    parse-word here place  bl here count + c!  here ;
   
 : parse    ( char -- addr len )  : parse    ( char -- addr len ) \ core-ext
   >r  source  >in @ /string  over  swap r>  scan >r    >r  source  >in @ over min /string  over  swap r>  scan >r
   over - dup r> IF 1+ THEN  >in +! ;    over - dup r> IF 1+ THEN  >in +! ;
   
 \ name                                                 13feb93py  \ name                                                 13feb93py
   
 : capitalize ( addr len -- addr len )  : capitalize ( addr len -- addr len ) \ gforth
   2dup chars chars bounds    2dup chars chars bounds
   ?DO  I c@ toupper I c! 1 chars +LOOP ;    ?DO  I c@ toupper I c! 1 chars +LOOP ;
 : (name) ( -- c-addr count )  : (name) ( -- c-addr count )
Line 162  Defer source Line 255  Defer source
     2dup + r> - 1+ r> min >in ! ;      2dup + r> - 1+ r> min >in ! ;
 \    name count ;  \    name count ;
   
   : name-too-short? ( c-addr u -- c-addr u )
       dup 0= -&16 and throw ;
   
   : name-too-long? ( c-addr u -- c-addr u )
       dup $1F u> -&19 and throw ;
   
 \ Literal                                              17dec92py  \ Literal                                              17dec92py
   
 : Literal  ( n -- )  state @ IF postpone lit  , THEN ;  : Literal  ( compilation n -- ; run-time -- n ) \ core
                                                       immediate      postpone lit  , ; immediate restrict
 : ALiteral ( n -- )  state @ IF postpone lit A, THEN ;  : ALiteral ( compilation addr -- ; run-time -- addr ) \ gforth
                                                       immediate      postpone lit A, ; immediate restrict
   
 : char   ( 'char' -- n )  bl word char+ c@ ;  : char   ( 'char' -- n ) \ core
 : [char] ( 'char' -- n )  char postpone Literal ; immediate      bl word char+ c@ ;
 ' [char] Alias Ascii immediate  : [char] ( compilation 'char' -- ; run-time -- n )
       char postpone Literal ; immediate restrict
 : (compile) ( -- )  r> dup cell+ >r @ compile, ;  
 : postpone ( "name" -- )  : (compile) ( -- ) \ gforth
   name sfind dup 0= abort" Can't compile "      r> dup cell+ >r @ compile, ;
   0> IF  compile,  ELSE  postpone (compile) A,  THEN ;  
                                              immediate restrict  \ not the most efficient implementation of POSTPONE, but simple
   : POSTPONE ( -- ) \ core
       COMP' swap POSTPONE aliteral compile, ; immediate restrict
   
   : interpret/compile: ( interp-xt comp-xt "name" -- )
       Create immediate swap A, A,
   DOES>
       abort" executed primary cfa of an interpret/compile: word" ;
   \    state @ IF  cell+  THEN  perform ;
   
 \ Use (compile) for the old behavior of compile!  \ Use (compile) for the old behavior of compile!
   
 \ digit?                                               17dec92py  \ digit?                                               17dec92py
   
 : digit?   ( char -- digit true/ false )  : digit?   ( char -- digit true/ false ) \ gforth
   base @ $100 =    base @ $100 =
   IF    IF
     true EXIT      true EXIT
Line 201  Defer source Line 308  Defer source
   
 : accumulate ( +d0 addr digit - +d1 addr )  : accumulate ( +d0 addr digit - +d1 addr )
   swap >r swap  base @  um* drop rot  base @  um* d+ r> ;    swap >r swap  base @  um* drop rot  base @  um* d+ r> ;
 : >number ( d addr count -- d addr count )  
   0 ?DO  count digit? WHILE  accumulate  LOOP 0  : >number ( d addr count -- d addr count ) \ core
   ELSE  1- I' I - UNLOOP  THEN ;      0
       ?DO
           count digit?
       WHILE
           accumulate
       LOOP
           0
       ELSE
           1- I' I -
           UNLOOP
       THEN ;
   
 \ number? number                                       23feb93py  \ number? number                                       23feb93py
   
 Create bases   10 ,   2 ,   A , 100 ,  Create bases   10 ,   2 ,   A , 100 ,
 \              16     2    10   Zeichen  \              16     2    10   Zeichen
 \ !! this saving and restoring base is an abomination! - anton  \ !! this saving and restoring base is an abomination! - anton
 : getbase ( addr u -- addr' u' )  over c@ [char] $ - dup 4 u<  : getbase ( addr u -- addr' u' )
   IF  cells bases + @ base ! 1 /string  ELSE  drop  THEN ;      over c@ [char] $ - dup 4 u<
 : s>number ( addr len -- d )  base @ >r  dpl on      IF
   over c@ '- =  dup >r  IF  1 /string  THEN          cells bases + @ base ! 1 /string
   getbase  dpl on  0 0 2swap      ELSE
   BEGIN  dup >r >number dup  WHILE  dup r> -  WHILE          drop
          dup dpl ! over c@ [char] . =  WHILE      THEN ;
          1 /string  : s>number ( addr len -- d )
   REPEAT  THEN  2drop rdrop dpl off  ELSE      base @ >r  dpl on
   2drop rdrop r> IF  dnegate  THEN      over c@ '- =  dup >r
   THEN r> base ! ;      IF
           1 /string
       THEN
       getbase  dpl on  0 0 2swap
       BEGIN
           dup >r >number dup
       WHILE
           dup r> -
       WHILE
           dup dpl ! over c@ [char] . =
       WHILE
           1 /string
       REPEAT  THEN
           2drop rdrop dpl off
       ELSE
           2drop rdrop r>
           IF
               dnegate
           THEN
       THEN
       r> base ! ;
   
 : snumber? ( c-addr u -- 0 / n -1 / d 0> )  : snumber? ( c-addr u -- 0 / n -1 / d 0> )
     s>number dpl @ 0=      s>number dpl @ 0=
     IF      IF
Line 235  Create bases   10 ,   2 ,   A , 100 , Line 373  Create bases   10 ,   2 ,   A , 100 ,
     else      else
         r> swap          r> swap
     then ;      then ;
 : s>d ( n -- d ) dup 0< ;  : s>d ( n -- d ) \ core         s-to-d
       dup 0< ;
 : number ( string -- d )  : number ( string -- d )
   number? ?dup 0= abort" ?"  0< IF s>d THEN ;      number? ?dup 0= abort" ?"  0<
       IF
           s>d
       THEN ;
   
 \ space spaces ud/mod                                  21mar93py  \ space spaces ud/mod                                  21mar93py
 decimal  decimal
 Create spaces  bl 80 times \ times from target compiler! 11may93jaw  Create spaces ( u -- ) \ core
 DOES>   ( u -- )  swap  bl 80 times \ times from target compiler! 11may93jaw
         0 max 0 ?DO  I' I - &80 min 2dup type  +LOOP  drop ;  DOES>   ( u -- )
 Create backspaces  08 80 times \ times from target compiler! 11may93jaw      swap
 DOES>   ( u -- )  swap      0 max 0 ?DO  I' I - &80 min 2dup type  +LOOP  drop ;
         0 max 0 ?DO  I' I - &80 min 2dup type  +LOOP  drop ;  Create backspaces
   08 80 times \ times from target compiler! 11may93jaw
   DOES>   ( u -- )
       swap
       0 max 0 ?DO  I' I - &80 min 2dup type  +LOOP  drop ;
 hex  hex
 : space   1 spaces ;  : space ( -- ) \ core
       1 spaces ;
   
 : ud/mod ( ud1 u2 -- urem udquot )  >r 0 r@ um/mod r> swap >r  : ud/mod ( ud1 u2 -- urem udquot ) \ gforth
                                     um/mod r> ;      >r 0 r@ um/mod r> swap >r
       um/mod r> ;
   
 : pad    ( -- addr )  : pad    ( -- addr ) \ core-ext
   here [ $20 8 2* cells + 2 + cell+ ] Literal + aligned ;    here [ $20 8 2* cells + 2 + cell+ ] Literal + aligned ;
   
 \ hold <# #> sign # #s                                 25jan92py  \ hold <# #> sign # #s                                 25jan92py
   
 : hold    ( char -- )         pad cell - -1 chars over +! @ c! ;  : hold    ( char -- ) \ core
       pad cell - -1 chars over +! @ c! ;
   
 : <#                          pad cell - dup ! ;  : <# ( -- ) \ core      less-number-sign
       pad cell - dup ! ;
   
 : #>      ( 64b -- addr +n )  2drop pad cell - dup @ tuck - ;  : #>      ( xd -- addr u ) \ core       number-sign-greater
       2drop pad cell - dup @ tuck - ;
   
 : sign    ( n -- )            0< IF  [char] - hold  THEN ;  : sign    ( n -- ) \ core
       0< IF  [char] - hold  THEN ;
   
 : #       ( +d1 -- +d2 )    base @ 2 max ud/mod rot 9 over <  : #       ( ud1 -- ud2 ) \ core         number-sign
   IF [ char A char 9 - 1- ] Literal +  THEN  [char] 0 + hold ;      base @ 2 max ud/mod rot 9 over <
       IF
           [ char A char 9 - 1- ] Literal +
       THEN
       [char] 0 + hold ;
   
 : #s      ( +d -- 0 0 )         BEGIN  # 2dup d0=  UNTIL ;  : #s      ( +d -- 0 0 ) \ core  number-sign-s
       BEGIN
           # 2dup d0=
       UNTIL ;
   
 \ print numbers                                        07jun92py  \ print numbers                                        07jun92py
   
 : d.r      >r tuck  dabs  <# #s  rot sign #>  : d.r ( d n -- ) \ double       d-dot-r
            r> over - spaces  type ;      >r tuck  dabs  <# #s  rot sign #>
       r> over - spaces  type ;
 : ud.r     >r <# #s #> r> over - spaces type ;  
   : ud.r ( ud n -- ) \ gforth     u-d-dot-r
 : .r       >r s>d r> d.r ;      >r <# #s #> r> over - spaces type ;
 : u.r      0 swap ud.r ;  
   : .r ( n1 n2 -- ) \ core-ext    dot-r
 : d.       0 d.r space ;      >r s>d r> d.r ;
 : ud.      0 ud.r space ;  : u.r ( u n -- )  \ core-ext    u-dot-r
       0 swap ud.r ;
 : .        s>d d. ;  
 : u.       0 ud. ;  : d. ( d -- ) \ double  d-dot
       0 d.r space ;
   : ud. ( ud -- ) \ gforth        u-d-dot
       0 ud.r space ;
   
   : . ( n -- ) \ core     dot
       s>d d. ;
   : u. ( u -- ) \ core    u-dot
       0 ud. ;
   
 \ catch throw                                          23feb93py  \ catch throw                                          23feb93py
 \ bounce                                                08jun93jaw  \ bounce                                                08jun93jaw
Line 293  hex Line 460  hex
 \ !! allow the user to add rollback actions    anton  \ !! allow the user to add rollback actions    anton
 \ !! use a separate exception stack?           anton  \ !! use a separate exception stack?           anton
   
 : lp@ ( -- addr )  : lp@ ( -- addr ) \ gforth      l-p-fetch
  laddr# [ 0 , ] ;   laddr# [ 0 , ] ;
   
 : catch ( x1 .. xn xt -- y1 .. ym 0 / z1 .. zn error )  : catch ( x1 .. xn xt -- y1 .. ym 0 / z1 .. zn error ) \ exception
   >r sp@ r> swap >r       \ don't count xt! jaw    >r sp@ r> swap >r       \ don't count xt! jaw
   fp@ >r    fp@ >r
   lp@ >r    lp@ >r
Line 305  hex Line 472  hex
   execute    execute
   r> handler ! rdrop rdrop rdrop 0 ;    r> handler ! rdrop rdrop rdrop 0 ;
   
 : throw ( y1 .. ym error/0 -- y1 .. ym / z1 .. zn error )  : throw ( y1 .. ym error/0 -- y1 .. ym / z1 .. zn error ) \ exception
     ?DUP IF      ?DUP IF
         [ here 4 cells ! ]          [ here 9 cells ! ]
         handler @ rp!          handler @ rp!
         r> handler !          r> handler !
         r> lp!          r> lp!
Line 317  hex Line 484  hex
   
 \ Bouncing is very fine,  \ Bouncing is very fine,
 \ programming without wasting time...   jaw  \ programming without wasting time...   jaw
 : bounce ( y1 .. ym error/0 -- y1 .. ym error / y1 .. ym )  : bounce ( y1 .. ym error/0 -- y1 .. ym error / y1 .. ym ) \ gforth
 \ a throw without data or fp stack restauration  \ a throw without data or fp stack restauration
   ?DUP IF    ?DUP IF
     handler @ rp!      handler @ rp!
Line 329  hex Line 496  hex
   
 \ ?stack                                               23feb93py  \ ?stack                                               23feb93py
   
 : ?stack ( ?? -- ?? )  sp@ s0 @ > IF  -4 throw  THEN ;  : ?stack ( ?? -- ?? ) \ gforth
       sp@ s0 @ > IF    -4 throw  THEN
       fp@ f0 @ > IF  -&45 throw  THEN  ;
 \ ?stack should be code -- it touches an empty stack!  \ ?stack should be code -- it touches an empty stack!
   
 \ interpret                                            10mar92py  \ interpret                                            10mar92py
   
 Defer parser  Defer parser
 Defer name      ' (name) IS name  Defer name ( -- c-addr count ) \ gforth
 Defer notfound ( c-addr count -- )  \ get the next word from the input buffer
   ' (name) IS name
 : no.extensions  ( addr u -- )  2drop -&13 bounce ;  Defer compiler-notfound ( c-addr count -- )
   Defer interpreter-notfound ( c-addr count -- )
   
   : no.extensions  ( addr u -- )
       2drop -&13 bounce ;
   ' no.extensions IS compiler-notfound
   ' no.extensions IS interpreter-notfound
   
   : compile-only-error ( ... -- )
       -&14 throw ;
   Defer interpret-special ( c-addr u xt -- ) \ !! use nfa instead of xt?
   ' compile-only-error IS interpret-special
   
 ' no.extensions IS notfound  : interpret ( ?? -- ?? ) \ gforth
       \ interpret/compile the (rest of the) input buffer
 : interpret  
     BEGIN      BEGIN
         ?stack name dup          ?stack name dup
     WHILE      WHILE
Line 352  Defer notfound ( c-addr count -- ) Line 531  Defer notfound ( c-addr count -- )
   
 \ interpreter compiler                                 30apr92py  \ interpreter compiler                                 30apr92py
   
 : interpreter  ( c-addr u -- )   \ not the most efficient implementations of interpreter and compiler
     \ interpretation semantics for the name/number c-addr u  : interpreter ( c-addr u -- ) 
     2dup sfind dup      2dup find-name dup
     IF      if
         1 and          nip nip name>int execute
         IF \ not restricted to compile state?      else
             nip nip execute  EXIT          drop
         THEN          2dup 2>r snumber?
         -&14 throw  
     THEN  
     drop  
     2dup 2>r snumber?  
     IF  
         2rdrop  
     ELSE  
         2r> notfound  
     THEN ;  
   
 ' interpreter  IS  parser  
   
 : compiler     ( c-addr u -- )  
     \ compilation semantics for the name/number c-addr u  
     2dup sfind dup  
     IF  
         0>  
         IF          IF
             nip nip execute EXIT              2rdrop
           ELSE
               2r> interpreter-notfound
         THEN          THEN
         compile, 2drop EXIT      then ;
     THEN  
     drop  : compiler ( c-addr u -- )
     2dup snumber? dup      2dup find-name dup
     IF      if ( c-addr u nfa )
         0>          nip nip name>comp execute
       else
           drop
           2dup snumber? dup
         IF          IF
             swap postpone Literal              0>
               IF
                   swap postpone Literal
               THEN
               postpone Literal
               2drop
           ELSE
               drop compiler-notfound
         THEN          THEN
         postpone Literal      then ;
         2drop  
     ELSE  ' interpreter  IS  parser
         drop notfound  
     THEN ;  
   
 : [     ['] interpreter  IS parser state off ; immediate  : [ ( -- ) \ core       left-bracket
 : ]     ['] compiler     IS parser state on  ;      ['] interpreter  IS parser state off ; immediate
   : ] ( -- ) \ core       right-bracket
       ['] compiler     IS parser state on  ;
   
 \ locals stuff needed for control structures  \ locals stuff needed for control structures
   
 : compile-lp+! ( n -- )  : compile-lp+! ( n -- ) \ gforth        compile-l-p-plus-store
     dup negate locals-size +!      dup negate locals-size +!
     0 over = if      0 over = if
     else -1 cells  over = if postpone lp-      else -1 cells  over = if postpone lp-
Line 409  Defer notfound ( c-addr count -- ) Line 583  Defer notfound ( c-addr count -- )
     else postpone lp+!# dup ,      else postpone lp+!# dup ,
     then then then then drop ;      then then then then drop ;
   
 : adjust-locals-size ( n -- )  : adjust-locals-size ( n -- ) \ gforth
     \ sets locals-size to n and generates an appropriate lp+!      \ sets locals-size to n and generates an appropriate lp+!
     locals-size @ swap - compile-lp+! ;      locals-size @ swap - compile-lp+! ;
   
Line 425  variable backedge-locals Line 599  variable backedge-locals
     \ the back edge if the BEGIN is unreachable from above. Set by      \ the back edge if the BEGIN is unreachable from above. Set by
     \ ASSUME-LIVE, reset by UNREACHABLE.      \ ASSUME-LIVE, reset by UNREACHABLE.
   
 : UNREACHABLE ( -- )  : UNREACHABLE ( -- ) \ gforth
     \ declares the current point of execution as unreachable      \ declares the current point of execution as unreachable
     dead-code on      dead-code on
     0 backedge-locals ! ; immediate      0 backedge-locals ! ; immediate
   
 : ASSUME-LIVE ( orig -- orig )  : ASSUME-LIVE ( orig -- orig ) \ gforth
     \ used immediateliy before a BEGIN that is not reachable from      \ used immediateliy before a BEGIN that is not reachable from
     \ above.  causes the BEGIN to assume that the same locals are live      \ above.  causes the BEGIN to assume that the same locals are live
     \ as at the orig point      \ as at the orig point
Line 439  variable backedge-locals Line 613  variable backedge-locals
           
 \ locals list operations  \ locals list operations
   
 : common-list ( list1 list2 -- list3 )  : common-list ( list1 list2 -- list3 ) \ gforth-internal
 \ list1 and list2 are lists, where the heads are at higher addresses than  \ list1 and list2 are lists, where the heads are at higher addresses than
 \ the tail. list3 is the largest sublist of both lists.  \ the tail. list3 is the largest sublist of both lists.
  begin   begin
Line 453  variable backedge-locals Line 627  variable backedge-locals
  repeat   repeat
  drop ;   drop ;
   
 : sub-list? ( list1 list2 -- f )  : sub-list? ( list1 list2 -- f ) \ gforth-internal
 \ true iff list1 is a sublist of list2  \ true iff list1 is a sublist of list2
  begin   begin
    2dup u<     2dup u<
Line 462  variable backedge-locals Line 636  variable backedge-locals
  repeat   repeat
  = ;   = ;
   
 : list-size ( list -- u )  : list-size ( list -- u ) \ gforth-internal
 \ size of the locals frame represented by list  \ size of the locals frame represented by list
  0 ( list n )   0 ( list n )
  begin   begin
    over 0<>     over 0<>
  while   while
    over     over
    name> >body @ max     ((name>)) >body @ max
    swap @ swap ( get next )     swap @ swap ( get next )
  repeat   repeat
  faligned nip ;   faligned nip ;
Line 523  variable backedge-locals Line 697  variable backedge-locals
   
 3 constant cs-item-size  3 constant cs-item-size
   
 : CS-PICK ( ... u -- ... destu )  : CS-PICK ( ... u -- ... destu ) \ tools-ext
  1+ cs-item-size * 1- >r   1+ cs-item-size * 1- >r
  r@ pick  r@ pick  r@ pick   r@ pick  r@ pick  r@ pick
  rdrop   rdrop
  dup non-orig? ;   dup non-orig? ;
   
 : CS-ROLL ( destu/origu .. dest0/orig0 u -- .. dest0/orig0 destu/origu )  : CS-ROLL ( destu/origu .. dest0/orig0 u -- .. dest0/orig0 destu/origu ) \ tools-ext
  1+ cs-item-size * 1- >r   1+ cs-item-size * 1- >r
  r@ roll r@ roll r@ roll   r@ roll r@ roll r@ roll
  rdrop   rdrop
Line 555  variable backedge-locals Line 729  variable backedge-locals
 : >resolve    ( addr -- )        here over - swap ! ;  : >resolve    ( addr -- )        here over - swap ! ;
 : <resolve    ( addr -- )        here - , ;  : <resolve    ( addr -- )        here - , ;
   
 : BUT       1 cs-roll ;                      immediate restrict  : BUT
 : YET       0 cs-pick ;                       immediate restrict      1 cs-roll ;                      immediate restrict
   : YET
       0 cs-pick ;                       immediate restrict
   
 \ Structural Conditionals                              12dec92py  \ Structural Conditionals                              12dec92py
   
 : AHEAD ( -- orig )  : AHEAD ( compilation -- orig ; run-time -- ) \ tools-ext
  POSTPONE branch >mark POSTPONE unreachable ; immediate restrict      POSTPONE branch  >mark  POSTPONE unreachable ; immediate restrict
   
 : IF ( -- orig )  : IF ( compilation -- orig ; run-time f -- ) \ core
  POSTPONE ?branch >mark ; immediate restrict   POSTPONE ?branch >mark ; immediate restrict
   
 : ?DUP-IF \ general  : ?DUP-IF ( compilation -- orig ; run-time n -- n| ) \ gforth   question-dupe-if
 \ This is the preferred alternative to the idiom "?DUP IF", since it can be  \ This is the preferred alternative to the idiom "?DUP IF", since it can be
 \ better handled by tools like stack checkers  \ better handled by tools like stack checkers. Besides, it's faster.
     POSTPONE ?dup POSTPONE if ;       immediate restrict      POSTPONE ?dup-?branch >mark ;       immediate restrict
 : ?DUP-0=-IF \ general  
     POSTPONE ?dup POSTPONE 0= POSTPONE if ; immediate restrict  
   
 : THEN ( orig -- )  : ?DUP-0=-IF ( compilation -- orig ; run-time n -- n| ) \ gforth        question-dupe-zero-equals-if
     dup orig?      POSTPONE ?dup-0=-?branch >mark ;       immediate restrict
     dead-orig =  
   : then-like ( orig -- addr )
       swap -rot dead-orig =
     if      if
         >resolve drop          drop
     else      else
         dead-code @          dead-code @
         if          if
             >resolve set-locals-size-list dead-code off              set-locals-size-list dead-code off
         else \ both live          else \ both live
             over list-size adjust-locals-size              dup list-size adjust-locals-size
             >resolve  
             locals-list @ common-list dup list-size adjust-locals-size              locals-list @ common-list dup list-size adjust-locals-size
             locals-list !              locals-list !
         then          then
     then ; immediate restrict      then ;
   
   : THEN ( compilation orig -- ; run-time -- ) \ core
       dup orig?  then-like  >resolve ; immediate restrict
   
 ' THEN alias ENDIF immediate restrict \ general  ' THEN alias ENDIF ( compilation orig -- ; run-time -- ) \ gforth
   immediate restrict
 \ Same as "THEN". This is what you use if your program will be seen by  \ Same as "THEN". This is what you use if your program will be seen by
 \ people who have not been brought up with Forth (or who have been  \ people who have not been brought up with Forth (or who have been
 \ brought up with fig-Forth).  \ brought up with fig-Forth).
   
 : ELSE ( orig1 -- orig2 )  : ELSE ( compilation orig1 -- orig2 ; run-time f -- ) \ core
     POSTPONE ahead      POSTPONE ahead
     1 cs-roll      1 cs-roll
     POSTPONE then ; immediate restrict      POSTPONE then ; immediate restrict
   
   
 : BEGIN ( -- dest )  : BEGIN ( compilation -- dest ; run-time -- ) \ core
     dead-code @ if      dead-code @ if
         \ set up an assumption of the locals visible here.  if the          \ set up an assumption of the locals visible here.  if the
         \ users want something to be visible, they have to declare          \ users want something to be visible, they have to declare
Line 616  variable backedge-locals Line 795  variable backedge-locals
 \ issue a warning (see below). The following code is generated:  \ issue a warning (see below). The following code is generated:
 \ lp+!# (current-local-size - dest-locals-size)  \ lp+!# (current-local-size - dest-locals-size)
 \ branch <begin>  \ branch <begin>
 : AGAIN ( dest -- )  
     dest?  : again-like ( dest -- addr )
     over list-size adjust-locals-size      over list-size adjust-locals-size
     POSTPONE branch      swap check-begin  POSTPONE unreachable ;
     <resolve  
     check-begin  : AGAIN ( compilation dest -- ; run-time -- ) \ core-ext
     POSTPONE unreachable ; immediate restrict      dest? again-like  POSTPONE branch  <resolve ; immediate restrict
   
 \ UNTIL (the current control flow may join an earlier one or continue):  \ UNTIL (the current control flow may join an earlier one or continue):
 \ Similar to AGAIN. The new locals-list and locals-size are the current  \ Similar to AGAIN. The new locals-list and locals-size are the current
Line 642  variable backedge-locals Line 821  variable backedge-locals
     then ( list )      then ( list )
     check-begin ;      check-begin ;
   
 : UNTIL ( dest -- )  : UNTIL ( compilation dest -- ; run-time f -- ) \ core
     dest? ['] ?branch ['] ?branch-lp+!# until-like ; immediate restrict      dest? ['] ?branch ['] ?branch-lp+!# until-like ; immediate restrict
   
 : WHILE ( dest -- orig dest )  : WHILE ( compilation dest -- orig dest ; run-time f -- ) \ core
     POSTPONE if      POSTPONE if
     1 cs-roll ; immediate restrict      1 cs-roll ; immediate restrict
   
 : REPEAT ( orig dest -- )  : REPEAT ( compilation orig dest -- ; run-time -- ) \ core
     POSTPONE again      POSTPONE again
     POSTPONE then ; immediate restrict      POSTPONE then ; immediate restrict
   
Line 693  Avariable leave-sp  leave-stack 3 cells Line 872  Avariable leave-sp  leave-stack 3 cells
     cell - dup @ swap      cell - dup @ swap
     leave-sp ! ;      leave-sp ! ;
   
 : DONE ( orig -- )  drop >r drop  : DONE ( compilation orig -- ; run-time -- ) \ gforth
     \ !! the original done had ( addr -- )      \ !! the original done had ( addr -- )
       drop >r drop
     begin      begin
         leave>          leave>
         over r@ u>=          over r@ u>=
Line 703  Avariable leave-sp  leave-stack 3 cells Line 883  Avariable leave-sp  leave-stack 3 cells
     repeat      repeat
     >leave rdrop ; immediate restrict      >leave rdrop ; immediate restrict
   
 : LEAVE ( -- )  : LEAVE ( compilation -- ; run-time loop-sys -- ) \ core
     POSTPONE ahead      POSTPONE ahead
     >leave ; immediate restrict      >leave ; immediate restrict
   
 : ?LEAVE ( -- )  : ?LEAVE ( compilation -- ; run-time f | f loop-sys -- ) \ gforth       question-leave
     POSTPONE 0= POSTPONE if      POSTPONE 0= POSTPONE if
     >leave ; immediate restrict      >leave ; immediate restrict
   
 : DO ( -- do-sys )  : DO ( compilation -- do-sys ; run-time w1 w2 -- loop-sys ) \ core
     POSTPONE (do)      POSTPONE (do)
     POSTPONE begin drop do-dest      POSTPONE begin drop do-dest
     ( 0 0 0 >leave ) ; immediate restrict      ( 0 0 0 >leave ) ; immediate restrict
   
 : ?DO ( -- do-sys )  : ?do-like ( -- do-sys )
     ( 0 0 0 >leave )      ( 0 0 0 >leave )
     POSTPONE (?do)  
     >mark >leave      >mark >leave
     POSTPONE begin drop do-dest ; immediate restrict      POSTPONE begin drop do-dest ;
   
 : FOR ( -- do-sys )  : ?DO ( compilation -- do-sys ; run-time w1 w2 -- | loop-sys )  \ core-ext      question-do
       POSTPONE (?do) ?do-like ; immediate restrict
   
   : +DO ( compilation -- do-sys ; run-time n1 n2 -- | loop-sys )  \ gforth        plus-do
       POSTPONE (+do) ?do-like ; immediate restrict
   
   : U+DO ( compilation -- do-sys ; run-time u1 u2 -- | loop-sys ) \ gforth        u-plus-do
       POSTPONE (u+do) ?do-like ; immediate restrict
   
   : -DO ( compilation -- do-sys ; run-time n1 n2 -- | loop-sys )  \ gforth        minus-do
       POSTPONE (-do) ?do-like ; immediate restrict
   
   : U-DO ( compilation -- do-sys ; run-time u1 u2 -- | loop-sys ) \ gforth        u-minus-do
       POSTPONE (u-do) ?do-like ; immediate restrict
   
   : FOR ( compilation -- do-sys ; run-time u -- loop-sys )        \ gforth
     POSTPONE (for)      POSTPONE (for)
     POSTPONE begin drop do-dest      POSTPONE begin drop do-dest
     ( 0 0 0 >leave ) ; immediate restrict      ( 0 0 0 >leave ) ; immediate restrict
Line 733  Avariable leave-sp  leave-stack 3 cells Line 927  Avariable leave-sp  leave-stack 3 cells
     >r >r 0 cs-pick swap cell - swap 1 cs-roll r> r> rot do-dest?      >r >r 0 cs-pick swap cell - swap 1 cs-roll r> r> rot do-dest?
     until-like  POSTPONE done  POSTPONE unloop ;      until-like  POSTPONE done  POSTPONE unloop ;
   
 : LOOP ( do-sys -- )  : LOOP ( compilation do-sys -- ; run-time loop-sys1 -- | loop-sys2 )    \ core
  ['] (loop) ['] (loop)-lp+!# loop-like ; immediate restrict   ['] (loop) ['] (loop)-lp+!# loop-like ; immediate restrict
   
 : +LOOP ( do-sys -- )  : +LOOP ( compilation do-sys -- ; run-time loop-sys1 n -- | loop-sys2 ) \ core  plus-loop
  ['] (+loop) ['] (+loop)-lp+!# loop-like ; immediate restrict   ['] (+loop) ['] (+loop)-lp+!# loop-like ; immediate restrict
   
   \ !! should the compiler warn about +DO..-LOOP?
   : -LOOP ( compilation do-sys -- ; run-time loop-sys1 u -- | loop-sys2 ) \ gforth        minus-loop
    ['] (-loop) ['] (-loop)-lp+!# loop-like ; immediate restrict
   
 \ A symmetric version of "+LOOP". I.e., "-high -low ?DO -inc S+LOOP"  \ A symmetric version of "+LOOP". I.e., "-high -low ?DO -inc S+LOOP"
 \ will iterate as often as "high low ?DO inc S+LOOP". For positive  \ will iterate as often as "high low ?DO inc S+LOOP". For positive
 \ increments it behaves like "+LOOP". Use S+LOOP instead of +LOOP for  \ increments it behaves like "+LOOP". Use S+LOOP instead of +LOOP for
 \ negative increments.  \ negative increments.
 : S+LOOP ( do-sys -- )  : S+LOOP ( compilation do-sys -- ; run-time loop-sys1 n -- | loop-sys2 )        \ gforth        s-plus-loop
  ['] (s+loop) ['] (s+loop)-lp+!# loop-like ; immediate restrict   ['] (s+loop) ['] (s+loop)-lp+!# loop-like ; immediate restrict
   
 : NEXT ( do-sys -- )  : NEXT ( compilation do-sys -- ; run-time loop-sys1 -- | loop-sys2 ) \ gforth
  ['] (next) ['] (next)-lp+!# loop-like ; immediate restrict   ['] (next) ['] (next)-lp+!# loop-like ; immediate restrict
   
 \ Structural Conditionals                              12dec92py  \ Structural Conditionals                              12dec92py
   
 : EXIT ( -- )  : EXIT ( compilation -- ; run-time nest-sys -- ) \ core
     0 adjust-locals-size      0 adjust-locals-size
     POSTPONE ;s      POSTPONE ;s
     POSTPONE unreachable ; immediate restrict      POSTPONE unreachable ; immediate restrict
   
 : ?EXIT ( -- )  : ?EXIT ( -- ) ( compilation -- ; run-time nest-sys f -- | nest-sys ) \ gforth
      POSTPONE if POSTPONE exit POSTPONE then ; immediate restrict       POSTPONE if POSTPONE exit POSTPONE then ; immediate restrict
   
 \ Strings                                              22feb93py  \ Strings                                              22feb93py
Line 767  Avariable leave-sp  leave-stack 3 cells Line 965  Avariable leave-sp  leave-stack 3 cells
   r> r> dup count + aligned >r swap >r ;               restrict    r> r> dup count + aligned >r swap >r ;               restrict
 : (.")     "lit count type ;                           restrict  : (.")     "lit count type ;                           restrict
 : (S")     "lit count ;                                restrict  : (S")     "lit count ;                                restrict
 : SLiteral postpone (S") here over char+ allot  place align ;  : SLiteral ( Compilation c-addr1 u ; run-time -- c-addr2 u ) \ string
       postpone (S") here over char+ allot  place align ;
                                              immediate restrict                                               immediate restrict
 : S"       [char] " parse  state @ IF  postpone SLiteral  THEN ;  : ( ( compilation 'ccc<close-paren>' -- ; run-time -- ) \ core,file     paren
                                              immediate      BEGIN
 : ."       state @  IF    postpone (.") ,"  align          >in @ [char] ) parse nip >in @ rot - =
                     ELSE  [char] " parse type  THEN  ;  immediate      WHILE
 : (        [char] ) parse 2drop ;                       immediate          loadfile @ IF
 : \        blk @ IF  >in @ c/l / 1+ c/l * >in !  EXIT  THEN              refill 0= abort" missing ')' in paren comment"
            source >in ! drop ;                          immediate          THEN
       REPEAT ;                       immediate
   : \ ( -- ) \ core-ext backslash
       blk @
       IF
           >in @ c/l / 1+ c/l * >in !
           EXIT
       THEN
       source >in ! drop ; immediate
   
   : \G ( -- ) \ gforth backslash
       POSTPONE \ ; immediate
   
 \ error handling                                       22feb93py  \ error handling                                       22feb93py
 \ 'abort thrown out!                                   11may93jaw  \ 'abort thrown out!                                   11may93jaw
   
 : (abort")      "lit >r IF  r> "error ! -2 throw  THEN  : (abort")
                 rdrop ;      "lit >r
 : abort"        postpone (abort") ," ;        immediate restrict      IF
           r> "error ! -2 throw
       THEN
       rdrop ;
   : abort" ( compilation 'ccc"' -- ; run-time f -- ) \ core,exception-ext abort-quote
       postpone (abort") ," ;        immediate restrict
   
 \ Header states                                        23feb93py  \ Header states                                        23feb93py
   
 : flag! ( 8b -- )  : cset ( bmask c-addr -- )
     last @ dup 0= abort" last word was headerless"      tuck c@ or swap c! ; 
     cell+ tuck c@ xor swap c! ;  : creset ( bmask c-addr -- )
 : immediate     $20 flag! ;      tuck c@ swap invert and swap c! ; 
 : restrict      $40 flag! ;  : ctoggle ( bmask c-addr -- )
 \ ' noop alias restrict      tuck c@ xor swap c! ; 
   
   : lastflags ( -- c-addr )
       \ the address of the flags byte in the last header
       \ aborts if the last defined word was headerless
       last @ dup 0= abort" last word was headerless" cell+ ;
   
   : immediate     immediate-mask lastflags cset ;
   : restrict      restrict-mask lastflags cset ;
   
 \ Header                                               23feb93py  \ Header                                               23feb93py
   
Line 800  Avariable leave-sp  leave-stack 3 cells Line 1023  Avariable leave-sp  leave-stack 3 cells
 \ with existing/independent defining words  \ with existing/independent defining words
   
 defer (header)  defer (header)
 defer header     ' (header) IS header  defer header ( -- ) \ gforth
   ' (header) IS header
   
 : name,  ( "name" -- )  : string, ( c-addr u -- ) \ gforth
     name      \ puts down string as cstring
     dup $1F u> -&19 and throw ( is name too long? )      dup c, here swap chars dup allot move ;
     dup c,  here swap chars  dup allot  move  align ;  
 : input-stream-header ( "name" -- )  : header, ( c-addr u -- ) \ gforth
     \ !! this is f83-implementation-dependent      name-too-long?
     align here last !  -1 A,      align here last !
     name, $80 flag! ;      current @ 1 or A,   \ link field; before revealing, it contains the
                           \ tagged reveal-into wordlist
       string, cfalign
       alias-mask lastflags cset ;
   
   : input-stream-header ( "name" -- )
       name name-too-short? header, ;
 : input-stream ( -- )  \ general  : input-stream ( -- )  \ general
 \ switches back to getting the name from the input stream ;  \ switches back to getting the name from the input stream ;
     ['] input-stream-header IS (header) ;      ['] input-stream-header IS (header) ;
Line 821  defer header     ' (header) IS header Line 1050  defer header     ' (header) IS header
 create nextname-buffer 32 chars allot  create nextname-buffer 32 chars allot
   
 : nextname-header ( -- )  : nextname-header ( -- )
     \ !! f83-implementation-dependent      nextname-buffer count header,
     nextname-buffer count  
     align here last ! -1 A,  
     dup c,  here swap chars  dup allot  move  align  
     $80 flag!  
     input-stream ;      input-stream ;
   
 \ the next name is given in the string  \ the next name is given in the string
 : nextname ( c-addr u -- ) \ general  : nextname ( c-addr u -- ) \ gforth
     dup $1F u> -&19 and throw ( is name too long? )      name-too-long?
     nextname-buffer c! ( c-addr )      nextname-buffer c! ( c-addr )
     nextname-buffer count move      nextname-buffer count move
     ['] nextname-header IS (header) ;      ['] nextname-header IS (header) ;
   
 : noname-header ( -- )  : noname-header ( -- )
     0 last !      0 last ! cfalign
     input-stream ;      input-stream ;
   
 : noname ( -- ) \ general  : noname ( -- ) \ gforth
 \ the next defined word remains anonymous. The xt of that word is given by lastxt  \ the next defined word remains anonymous. The xt of that word is given by lastxt
     ['] noname-header IS (header) ;      ['] noname-header IS (header) ;
   
 : lastxt ( -- xt ) \ general  : lastxt ( -- xt ) \ gforth
 \ xt is the execution token of the last word defined. The main purpose of this word is to get the xt of words defined using noname  \ xt is the execution token of the last word defined. The main purpose of this word is to get the xt of words defined using noname
     lastcfa @ ;      lastcfa @ ;
   
 : Alias    ( cfa "name" -- )  : Alias    ( cfa "name" -- ) \ gforth
   Header reveal , $80 flag! ;      Header reveal
       alias-mask lastflags creset
       dup A, lastcfa ! ;
   
 : name>string ( nfa -- addr count )  : name>string ( nfa -- addr count ) \ gforth    name-to-string
  cell+ count $1F and ;   cell+ count $1F and ;
   
 Create ???  0 , 3 c, char ? c, char ? c, char ? c,  Create ???  0 , 3 c, char ? c, char ? c, char ? c,
 : >name ( cfa -- nfa )  : >name ( cfa -- nfa ) \ gforth to-name
  $21 cell do   $21 cell do
    dup i - count $9F and + aligned over $80 + = if     dup i - count $9F and + cfaligned over alias-mask + = if
      i - cell - unloop exit       i - cell - unloop exit
    then     then
  cell +loop   cell +loop
  drop ??? ( wouldn't 0 be better? ) ;   drop ??? ( wouldn't 0 be better? ) ;
   
 \ indirect threading                                   17mar93py  \ threading                                   17mar93py
   
 : cfa,     ( code-address -- )  : cfa,     ( code-address -- )  \ gforth        cfa-comma
     here lastcfa !      here
     here  0 A, 0 ,  code-address! ;      dup lastcfa !
 : compile, ( xt -- )            A, ;      0 A, 0 ,  code-address! ;
 : !does    ( addr -- )          lastcfa @ does-code! ;  : compile, ( xt -- )    \ core-ext      compile-comma
 : (;code)  ( R: addr -- )       r> /does-handler + !does ;      A, ;
   : !does    ( addr -- ) \ gforth store-does
       lastxt does-code! ;
   : (does>)  ( R: addr -- )
       r> /does-handler + !does ;
 : dodoes,  ( -- )  : dodoes,  ( -- )
   here /does-handler allot does-handler! ;    here /does-handler allot does-handler! ;
   
 \ direct threading is implementation dependent  : Create ( -- ) \ core
       Header reveal dovar: cfa, ;
 : Create    Header reveal [ :dovar ] Literal cfa, ;  
   
 \ DOES>                                                17mar93py  
   
 : DOES>  ( compilation: -- )  
     state @  
     IF  
         ;-hook postpone (;code) dodoes,  
     ELSE  
         dodoes, here !does 0 ]  
     THEN   
     :-hook ; immediate  
   
 \ Create Variable User Constant                        17mar93py  \ Create Variable User Constant                        17mar93py
   
 : Variable  Create 0 , ;  : Variable ( -- ) \ core
 : AVariable Create 0 A, ;      Create 0 , ;
   : AVariable ( -- ) \ gforth
       Create 0 A, ;
 : 2VARIABLE ( "name" -- ) \ double  : 2VARIABLE ( "name" -- ) \ double
     create 0 , 0 , ;      create 0 , 0 , ;
           
 : User      Variable ;  : User
 : AUser     AVariable ;      Variable ;
   : AUser
 : (Constant)  Header reveal [ :docon ] Literal cfa, ;      AVariable ;
 : Constant  (Constant) , ;  
 : AConstant (Constant) A, ;  : (Constant)  Header reveal docon: cfa, ;
   : Constant ( w -- ) \ core
       (Constant) , ;
   : AConstant ( addr -- ) \ gforth
       (Constant) A, ;
   
 : 2CONSTANT  : 2Constant ( d -- ) \ double
     create ( w1 w2 "name" -- )      Create ( w1 w2 "name" -- )
         2,          2,
     does> ( -- w1 w2 )      DOES> ( -- w1 w2 )
         2@ ;          2@ ;
           
 \ IS Defer What's Defers TO                            24feb93py  \ IS Defer What's Defers TO                            24feb93py
   
 : Defer ( -- )  : Defer ( -- ) \ gforth
     \ !! shouldn't it be initialized with abort or something similar?      \ !! shouldn't it be initialized with abort or something similar?
     Header Reveal [ :dodefer ] Literal cfa,      Header Reveal dodefer: cfa,
     ['] noop A, ;      ['] noop A, ;
 \     Create ( -- )   \     Create ( -- ) 
 \       ['] noop A,  \       ['] noop A,
 \     DOES> ( ??? )  \     DOES> ( ??? )
 \       @ execute ;  \       perform ;
   
 : IS ( addr "name" -- )  : Defers ( "name" -- ) \ gforth
     ' >body      ' >body @ compile, ; immediate
     state @  
     IF    postpone ALiteral postpone !    
     ELSE  !  
     THEN ;  immediate  
 ' IS Alias TO immediate  
   
 : What's ( "name" -- addr )  ' >body  
   state @ IF  postpone ALiteral postpone @  ELSE  @  THEN ;  
                                              immediate  
 : Defers ( "name" -- )  ' >body @ compile, ;  
                                              immediate  
   
 \ : ;                                                  24feb93py  \ : ;                                                  24feb93py
   
 defer :-hook ( sys1 -- sys2 )  defer :-hook ( sys1 -- sys2 )
 defer ;-hook ( sys2 -- sys1 )  defer ;-hook ( sys2 -- sys1 )
   
 : : ( -- colon-sys )  Header [ :docol ] Literal cfa, defstart ] :-hook ;  : : ( -- colon-sys ) \ core     colon
 : ; ( colon-sys -- )  ;-hook ?struc postpone exit reveal postpone [ ;      Header docol: cfa, defstart ] :-hook ;
   immediate restrict  : ; ( compilation colon-sys -- ; run-time nest-sys ) \ core     semicolon
       ;-hook ?struc postpone exit reveal postpone [ ; immediate restrict
   
 : :noname ( -- xt colon-sys )  : :noname ( -- xt colon-sys ) \ core-ext        colon-no-name
     0 last !      0 last !
     here [ :docol ] Literal cfa, 0 ] :-hook ;      here docol: cfa, 0 ] :-hook ;
   
 \ Search list handling                                 23feb93py  \ Search list handling                                 23feb93py
   
 AVariable current  AVariable current ( -- addr ) \ gforth
   
 : last?   ( -- false / nfa nfa )    last @ ?dup ;  : last?   ( -- false / nfa nfa )
 : (reveal) ( -- )      last @ ?dup ;
   last?  : (reveal) ( nfa wid -- )
   IF      ( wid>wordlist-id ) dup >r
       dup @ 0<      @ over ( name>link ) ! 
       IF      r> ! ;
         current @ @ over ! current @ !  
       ELSE  
         drop  
       THEN  
   THEN ;  
   
 \ object oriented search list                          17mar93py  \ object oriented search list                          17mar93py
   
 \ word list structure:  \ word list structure:
 \ struct  
 \   1 cells: field find-method   \ xt: ( c_addr u wid -- name-id )  struct
 \   1 cells: field reveal-method \ xt: ( -- )    1 cells: field find-method   \ xt: ( c_addr u wid -- name-id )
 \   1 cells: field rehash-method \ xt: ( wid -- )    1 cells: field reveal-method \ xt: ( nfa wid -- ) \ used by dofield:, must be field
     1 cells: field rehash-method \ xt: ( wid -- )
 \   \ !! what else  \   \ !! what else
 \ end-struct wordlist-map-struct  end-struct wordlist-map-struct
   
 \ struct  struct
 \   1 cells: field wordlist-id \ not the same as wid; representation depends on implementation    1 cells: field wordlist-id \ not the same as wid; representation depends on implementation
 \   1 cells: field wordlist-map \ pointer to a wordlist-map-struct    1 cells: field wordlist-map \ pointer to a wordlist-map-struct
 \   1 cells: field wordlist-link \ link field to other wordlists    1 cells: field wordlist-link \ link field to other wordlists
 \   1 cells: field wordlist-extend \ points to wordlist extensions (eg hash)    1 cells: field wordlist-extend \ points to wordlist extensions (eg hash)
 \ end-struct wordlist-struct  end-struct wordlist-struct
   
 : f83find      ( addr len wordlist -- nfa / false )  @ (f83find) ;  : f83find      ( addr len wordlist -- nfa / false )
       ( wid>wordlist-id ) @ (f83find) ;
   
 \ Search list table: find reveal  \ Search list table: find reveal
 Create f83search       ' f83find A,  ' (reveal) A,  ' drop A,  Create f83search ( -- wordlist-map )
       ' f83find A,  ' (reveal) A,  ' drop A,
   
 Create forth-wordlist  NIL A, G f83search T A, NIL A, NIL A,  Create forth-wordlist  NIL A, G f83search T A, NIL A, NIL A,
 AVariable lookup       G forth-wordlist lookup T !  AVariable lookup       G forth-wordlist lookup T !
 G forth-wordlist current T !  G forth-wordlist current T !
   
   \ higher level parts of find
   
   ( struct )
   0 >body cell
     1 cells: field special-interpretation
     1 cells: field special-compilation
   end-struct special-struct
   
   : interpret/compile? ( xt -- flag )
       >does-code ['] S" >does-code = ;
   
   : (x>int) ( cfa b -- xt )
       \ get interpretation semantics of name
       restrict-mask and
       if
           drop ['] compile-only-error
       else
           dup interpret/compile?
           if
               special-interpretation @
           then
       then ;
   
   : name>int ( nfa -- xt ) \ gforth
       (name>x) (x>int) ;
   
   : name>comp ( nfa -- w xt ) \ gforth
       \ get compilation semantics of name
       (name>x) >r dup interpret/compile?
       if
           special-compilation @
       then
       r> immediate-mask and if
           ['] execute
       else
           ['] compile,
       then ;
   
 : (search-wordlist)  ( addr count wid -- nfa / false )  : (search-wordlist)  ( addr count wid -- nfa / false )
   dup cell+ @ @ execute ;      dup wordlist-map @ find-method perform ;
   
   : flag-sign ( f -- 1|-1 )
       \ true becomes 1, false -1
       0= 2* 1+ ;
   
   : search-wordlist ( addr count wid -- 0 / xt +-1 ) \ search
      \ xt is the interpretation semantics
       (search-wordlist) dup if
           (name>x) tuck (x>int) ( b xt )
           swap immediate-mask and flag-sign
       then ;
   
   : find-name ( c-addr u -- nfa/0 )
       lookup @ (search-wordlist) ;
   
   : sfind ( c-addr u -- 0 / xt +-1  ) \ gforth-obsolete
       find-name dup
       if ( nfa )
           state @
           if
               name>comp ['] execute =
           else
               (name>x) tuck (x>int)
               swap immediate-mask and
           then
           flag-sign
       then ;
   
   : find ( c-addr -- xt +-1 / c-addr 0 ) \ core
       dup count sfind dup
       if
           rot drop
       then ;
   
 : search-wordlist  ( addr count wid -- 0 / xt +-1 )  : (') ( "name" -- nfa ) \ gforth
   (search-wordlist) dup  IF  found  THEN ;      name find-name dup 0=
       IF
           drop -&13 bounce
       THEN  ;
   
   : [(')]  ( compilation "name" -- ; run-time -- nfa ) \ gforth   bracket-paren-tick
       (') postpone ALiteral ; immediate restrict
   
   : '    ( "name" -- xt ) \ core  tick
       (') name>int ;
   : [']  ( compilation "name" -- ; run-time -- xt ) \ core        bracket-tick
       ' postpone ALiteral ; immediate restrict
   
   : COMP'    ( "name" -- w xt ) \ gforth  c-tick
       (') name>comp ;
   : [COMP']  ( compilation "name" -- ; run-time -- w xt ) \ gforth        bracket-comp-tick
       COMP' swap POSTPONE Aliteral POSTPONE ALiteral ; immediate restrict
   
 Variable warnings  G -1 warnings T !  \ reveal words
   
   Variable warnings ( -- addr ) \ gforth
   G -1 warnings T !
   
 : check-shadow  ( addr count wid -- )  : check-shadow  ( addr count wid -- )
 \ prints a warning if the string is already present in the wordlist  \ prints a warning if the string is already present in the wordlist
 \ !! should be refined so the user can suppress the warnings  
  >r 2dup 2dup r> (search-wordlist) warnings @ and ?dup if   >r 2dup 2dup r> (search-wordlist) warnings @ and ?dup if
    ." redefined " name>string 2dup type     ." redefined " name>string 2dup type
    compare 0<> if     compare 0<> if
Line 1010  Variable warnings  G -1 warnings T ! Line 1312  Variable warnings  G -1 warnings T !
  then   then
  2drop 2drop ;   2drop 2drop ;
   
 : sfind ( c-addr u -- xt n / 0 )  : reveal ( -- ) \ gforth
     lookup @ search-wordlist ;      last?
       if \ the last word has a header
 : find   ( addr -- cfa +-1 / string false )          dup ( name>link ) @ 1 and
     \ !! not ANS conformant: returns +-2 for restricted words          if \ it is still hidden
     dup count sfind dup if              dup ( name>link ) @ 1 xor           ( nfa wid )
         rot drop              2dup >r name>string r> check-shadow ( nfa wid )
               dup wordlist-map @ reveal-method perform
           then
     then ;      then ;
   
 : reveal ( -- )  : rehash  ( wid -- )
  last? if      dup wordlist-map @ rehash-method perform ;
    name>string current @ check-shadow  
  then  
  current @ cell+ @ cell+ @ execute ;  
   
 : rehash  ( wid -- )  dup cell+ @ cell+ cell+ @ execute ;  
   
 : '    ( "name" -- addr )  name sfind 0= if -&13 bounce then ;  
 : [']  ( "name" -- addr )  ' postpone ALiteral ; immediate  
 \ Input                                                13feb93py  \ Input                                                13feb93py
   
 07 constant #bell  07 constant #bell ( -- c ) \ gforth
 08 constant #bs  08 constant #bs ( -- c ) \ gforth
 09 constant #tab  09 constant #tab ( -- c ) \ gforth
 7F constant #del  7F constant #del ( -- c ) \ gforth
 0D constant #cr                \ the newline key code  0D constant #cr   ( -- c ) \ gforth
 0C constant #ff  \ the newline key code
 0A constant #lf  0C constant #ff ( -- c ) \ gforth
   0A constant #lf ( -- c ) \ gforth
   
 : bell  #bell emit ;  : bell  #bell emit ;
   : cr ( -- ) \ core
       \ emit a newline
       #lf ( sic! ) emit ;
   
 \ : backspaces  0 ?DO  #bs emit  LOOP ;  \ : backspaces  0 ?DO  #bs emit  LOOP ;
 : >string  ( span addr pos1 -- span addr pos1 addr2 len )  
   over 3 pick 2 pick chars /string ;  : (ins) ( max span addr pos1 key -- max span addr pos2 )
 : type-rest ( span addr pos1 -- span addr pos1 back )      >r 2dup + r@ swap c! r> emit 1+ rot 1+ -rot ;
   >string tuck type ;  : (bs) ( max span addr pos1 -- max span addr pos2 flag )
 : (del)  ( max span addr pos1 -- max span addr pos2 )      dup IF
   1- >string over 1+ -rot move          #bs emit bl emit #bs emit 1- rot 1- -rot
   rot 1- -rot  #bs emit  type-rest bl emit 1+ backspaces ;      THEN false ;
 : (ins)  ( max span addr pos1 char -- max span addr pos2 )  : (ret)  true space ;
   >r >string over 1+ swap move 2dup chars + r> swap c!  
   rot 1+ -rot type-rest 1- backspaces 1+ ;  
 : ?del ( max span addr pos1 -- max span addr pos2 0 )  
   dup  IF  (del)  THEN  0 ;  
 : (ret)  type-rest drop true space ;  
 : back  dup  IF  1- #bs emit  ELSE  #bell emit  THEN 0 ;  
 : forw 2 pick over <> IF  2dup + c@ emit 1+  ELSE  #bell emit  THEN 0 ;  
   
 Create ctrlkeys  Create ctrlkeys
   ] false false back  false  false false forw  false    ] false false false false  false false false false
     ?del  false (ret) false  false (ret) false false      (bs)  false (ret) false  false (ret) false false
     false false false false  false false false false      false false false false  false false false false
     false false false false  false false false false [      false false false false  false false false false [
   
   defer insert-char
   ' (ins) IS insert-char
 defer everychar  defer everychar
 ' noop IS everychar  ' noop IS everychar
   
 : decode ( max span addr pos1 key -- max span addr pos2 flag )  : decode ( max span addr pos1 key -- max span addr pos2 flag )
   everychar    everychar
   dup #del = IF  drop #bs  THEN  \ del is rubout    dup #del = IF  drop #bs  THEN  \ del is rubout
   dup bl <   IF  cells ctrlkeys + @ execute  EXIT  THEN    dup bl <   IF  cells ctrlkeys + perform  EXIT  THEN
   >r 2over = IF  rdrop bell 0 EXIT  THEN    >r 2over = IF  rdrop bell 0 EXIT  THEN
   r> (ins) 0 ;    r> insert-char 0 ;
   
 \ decode should better use a table for control key actions  
 \ to define keyboard bindings later  
   
 : accept   ( addr len -- len )  : accept   ( addr len -- len ) \ core
   dup 0< IF    abs over dup 1 chars - c@ tuck type     dup 0< IF    abs over dup 1 chars - c@ tuck type 
 \ this allows to edit given strings  \ this allows to edit given strings
          ELSE  0  THEN rot over           ELSE  0  THEN rot over
Line 1086  defer everychar Line 1379  defer everychar
   
 \ Output                                               13feb93py  \ Output                                               13feb93py
   
 Defer type      \ defer type for a output buffer or fast  : (type) ( c-addr u -- ) \ gforth
                 \ screen write      outfile-id write-file drop \ !! use ?DUP-IF THROW ENDIF instead of DROP ?
   ;
   
 \ : (type) ( addr len -- )  Defer type ( c-addr u -- ) \ core
 \   bounds ?DO  I c@ emit  LOOP ;  \ defer type for a output buffer or fast
   \ screen write
   
 ' (type) IS Type  ' (type) IS Type
   
 Defer emit  : (emit) ( c -- ) \ gforth
       outfile-id emit-file drop \ !! use ?DUP-IF THROW ENDIF instead of DROP ?
   ;
   
   Defer emit ( c -- ) \ core
 ' (Emit) IS Emit  ' (Emit) IS Emit
   
 Defer key  Defer key ( -- c ) \ core
 ' (key) IS key  ' (key) IS key
   
 \ : form  ( -- rows cols )  &24 &80 ;  
 \ form should be implemented using TERMCAPS or CURSES  
 \ : rows  form drop ;  
 \ : cols  form nip  ;  
   
 \ Query                                                07apr93py  \ Query                                                07apr93py
   
 : refill ( -- flag )  : refill ( -- flag ) \ core-ext,block-ext,file-ext
   blk @  IF  1 blk +!  true  EXIT  THEN    blk @  IF  1 blk +!  true  0 >in !  EXIT  THEN
   tib /line    tib /line
   loadfile @ ?dup    loadfile @ ?dup
   IF    read-line throw    IF    read-line throw
   ELSE  loadline @ 0< IF 2drop false EXIT THEN    ELSE  sourceline# 0< IF 2drop false EXIT THEN
         accept true          accept true
   THEN    THEN
   1 loadline +!    1 loadline +!
   swap #tib ! 0 >in ! ;    swap #tib ! 0 >in ! ;
   
 : Query  ( -- )  loadfile off  blk off  refill drop ;  : Query  ( -- ) \ core-ext
       \ obsolescent
       loadfile off  blk off  refill drop ;
   
 \ File specifiers                                       11jun93jaw  \ File specifiers                                       11jun93jaw
   
Line 1127  Defer key Line 1422  Defer key
 \ 1 c, here char r c, 0 c,                0 c, 0 c, char b c, 0 c,  \ 1 c, here char r c, 0 c,                0 c, 0 c, char b c, 0 c,
 \ 2 c, here char r c, char + c, 0 c,  \ 2 c, here char r c, char + c, 0 c,
 \ 2 c, here char w c, char + c, 0 c, align  \ 2 c, here char w c, char + c, 0 c, align
 4 Constant w/o  4 Constant w/o ( -- fam ) \ file        w-o
 2 Constant r/w  2 Constant r/w ( -- fam ) \ file        r-w
 0 Constant r/o  0 Constant r/o ( -- fam ) \ file        r-o
   
 \ BIN WRITE-LINE                                        11jun93jaw  \ BIN WRITE-LINE                                        11jun93jaw
   
 \ : bin           dup 1 chars - c@  \ : bin           dup 1 chars - c@
 \                 r/o 4 chars + over - dup >r swap move r> ;  \                 r/o 4 chars + over - dup >r swap move r> ;
   
 : bin  1+ ;  : bin ( fam1 -- fam2 ) \ file
       1 or ;
   
 create nl$ 1 c, A c, 0 c, \ gnu includes usually a cr in dos  create nl$ 1 c, A c, 0 c, \ gnu includes usually a cr in dos
                            \ or not unix environments if                             \ or not unix environments if
                            \ bin is not selected                             \ bin is not selected
   
 : write-line    dup >r write-file ?dup IF r> drop EXIT THEN  : write-line ( c-addr u fileid -- ior ) \ file
                 nl$ count r> write-file ;      dup >r write-file
       ?dup IF
           r> drop EXIT
       THEN
       nl$ count r> write-file ;
   
 \ include-file                                         07apr93py  \ include-file                                         07apr93py
   
 : push-file  ( -- )  r>  : push-file  ( -- )  r>
   loadline @ >r loadfile @ >r    sourceline# >r  loadfile @ >r
   blk @ >r >tib @ >r  #tib @ dup >r  >tib +!  >in @ >r  >r ;    blk @ >r  tibstack @ >r  >tib @ >r  #tib @ >r
     >tib @ tibstack @ = IF  r@ tibstack +!  THEN
     tibstack @ >tib ! >in @ >r  >r ;
   
 : pop-file   ( throw-code -- throw-code )  : pop-file   ( throw-code -- throw-code )
   dup IF    dup IF
          source >in @ loadline @ loadfilename 2@           source >in @ sourceline# sourcefilename
          error-stack dup @ dup 1+           error-stack dup @ dup 1+
          max-errors 1- min error-stack !           max-errors 1- min error-stack !
          6 * cells + cell+           6 * cells + cell+
Line 1162  create nl$ 1 c, A c, 0 c, \ gnu includes Line 1464  create nl$ 1 c, A c, 0 c, \ gnu includes
          -1 cells +LOOP           -1 cells +LOOP
   THEN    THEN
   r>    r>
   r> >in !  r> #tib !  r> >tib !  r> blk !    r> >in !  r> #tib !  r> >tib !  r> tibstack !  r> blk !
   r> loadfile ! r> loadline !  >r ;    r> loadfile ! r> loadline !  >r ;
   
 : read-loop ( i*x -- j*x )  : read-loop ( i*x -- j*x )
   BEGIN  refill  WHILE  interpret  REPEAT ;    BEGIN  refill  WHILE  interpret  REPEAT ;
   
 : include-file ( i*x fid -- j*x )  : include-file ( i*x fid -- j*x ) \ file
   push-file  loadfile !    push-file  loadfile !
   0 loadline ! blk off  ['] read-loop catch    0 loadline ! blk off  ['] read-loop catch
   loadfile @ close-file swap 2dup or    loadfile @ close-file swap 2dup or
Line 1176  create nl$ 1 c, A c, 0 c, \ gnu includes Line 1478  create nl$ 1 c, A c, 0 c, \ gnu includes
   
 create pathfilenamebuf 256 chars allot \ !! make this grow on demand  create pathfilenamebuf 256 chars allot \ !! make this grow on demand
   
 : open-path-file ( c-addr1 u1 -- file-id c-addr2 u2 )  \ : check-file-prefix  ( addr len -- addr' len' flag )
     \ opens a file for reading, searching in the path for it; c-addr2  \   dup 0=                    IF  true EXIT  THEN 
     \ u2 is the full filename (valid until the next call); if the file  \   over c@ '/ =              IF  true EXIT  THEN 
     \ is not found (or in case of other errors for each try), -38  \   over 2 S" ./" compare 0=  IF  true EXIT  THEN 
     \ (non-existant file) is thrown. Opening for other access modes  \   over 3 S" ../" compare 0= IF  true EXIT  THEN
     \ makes little sense, as the path will usually contain dirs that  \   over 2 S" ~/" compare 0=
     \ are only readable for the user  \   IF     1 /string
     \ !! check for "/", "./", "../" in original filename; check for "~/"?  \          S" HOME" getenv tuck pathfilenamebuf swap move
   \          2dup + >r pathfilenamebuf + swap move
   \          pathfilenamebuf r> true
   \   ELSE   false
   \   THEN ;
   
   : absolut-path? ( addr u -- flag ) \ gforth
       \ a path is absolute, if it starts with a / or a ~ (~ expansion),
       \ or if it is in the form ./* or ../*, extended regexp: [/~]|./|../
       \ Pathes simply containing a / are not absolute!
       over c@ '/ = >r
       over c@ '~ = >r
       2dup 2 min S" ./" compare 0= >r
            3 min S" ../" compare 0=
       r> r> r> or or or ;
   \   [char] / scan nip 0<> ;    
   
   : open-path-file ( c-addr1 u1 -- file-id c-addr2 u2 ) \ gforth
       \ opens a file for reading, searching in the path for it (unless
       \ the filename contains a slash); c-addr2 u2 is the full filename
       \ (valid until the next call); if the file is not found (or in
       \ case of other errors for each try), -38 (non-existant file) is
       \ thrown. Opening for other access modes makes little sense, as
       \ the path will usually contain dirs that are only readable for
       \ the user
       \ !! use file-status to determine access mode?
       2dup absolut-path?
       if \ the filename contains a slash
           2dup r/o open-file throw ( c-addr1 u1 file-id )
           -rot >r pathfilenamebuf r@ cmove ( file-id R: u1 )
           pathfilenamebuf r> EXIT
       then
     pathdirs 2@ 0      pathdirs 2@ 0
   \    check-file-prefix 0= 
   \    IF  pathdirs 2@ 0
     ?DO ( c-addr1 u1 dirnamep )      ?DO ( c-addr1 u1 dirnamep )
         dup >r 2@ dup >r pathfilenamebuf swap cmove ( addr u )          dup >r 2@ dup >r pathfilenamebuf swap cmove ( addr u )
         2dup pathfilenamebuf r@ chars + swap cmove ( addr u )          2dup pathfilenamebuf r@ chars + swap cmove ( addr u )
         pathfilenamebuf over r> + dup >r r/o open-file 0=          pathfilenamebuf over r> + dup >r r/o open-file 0=
         if ( addr u file-id )          IF ( addr u file-id )
             nip nip r> rdrop 0 leave              nip nip r> rdrop 0 LEAVE
         then          THEN
         rdrop drop r> cell+ cell+          rdrop drop r> cell+ cell+
     LOOP      LOOP
   \    ELSE   2dup open-file throw -rot  THEN 
     0<> -&38 and throw ( file-id u2 )      0<> -&38 and throw ( file-id u2 )
     pathfilenamebuf swap ;      pathfilenamebuf swap ;
   
 : included ( i*x addr u -- j*x )  create included-files 0 , 0 , ( pointer to and count of included files )
     loadfilename 2@ >r >r  here ," the terminal" dup c@ swap 1 + swap , A, here 2 cells -
     open-path-file ( file-id c-addr2 u2 )  create image-included-files  1 , A, ( pointer to and count of included files )
     dup allocate throw over loadfilename 2! ( file-id c-addr2 u2 )  \ included-files points to ALLOCATEd space, while image-included-files
     drop loadfilename 2@ move  \ points to ALLOTed objects, so it survives a save-system
   
   : loadfilename ( -- a-addr )
       \ a-addr 2@ produces the current file name ( c-addr u )
       included-files 2@ drop loadfilename# @ 2* cells + ;
   
   : sourcefilename ( -- c-addr u ) \ gforth
       \ the name of the source file which is currently the input
       \ source.  The result is valid only while the file is being
       \ loaded.  If the current input source is no (stream) file, the
       \ result is undefined.
       loadfilename 2@ ;
   
   : sourceline# ( -- u ) \ gforth         sourceline-number
       \ the line number of the line that is currently being interpreted
       \ from a (stream) file. The first line has the number 1. If the
       \ current input source is no (stream) file, the result is
       \ undefined.
       loadline @ ;
   
   : init-included-files ( -- )
       image-included-files 2@ 2* cells save-mem drop ( addr )
       image-included-files 2@ nip included-files 2! ;
   
   : included? ( c-addr u -- f ) \ gforth
       \ true, iff filename c-addr u is in included-files
       included-files 2@ 0
       ?do ( c-addr u addr )
           dup >r 2@ 2over compare 0=
           if
               2drop rdrop unloop
               true EXIT
           then
           r> cell+ cell+
       loop
       2drop drop false ;
   
   : add-included-file ( c-addr u -- ) \ gforth
       \ add name c-addr u to included-files
       included-files 2@ 2* cells 2 cells extend-mem
       2/ cell / included-files 2!
       2! ;
   \    included-files 2@ tuck 1+ 2* cells resize throw
   \    swap 2dup 1+ included-files 2!
   \    2* cells + 2! ;
   
   : included1 ( i*x file-id c-addr u -- j*x ) \ gforth
       \ include the file file-id with the name given by c-addr u
       loadfilename# @ >r
       save-mem add-included-file ( file-id )
       included-files 2@ nip 1- loadfilename# !
     ['] include-file catch      ['] include-file catch
     \ don't free filenames; they don't take much space      r> loadfilename# !
     \ and are used for debugging      throw ;
     r> r> loadfilename 2!  throw ;      
   : included ( i*x addr u -- j*x ) \ file
       open-path-file included1 ;
   
   : required ( i*x addr u -- j*x ) \ gforth
       \ include the file with the name given by addr u, if it is not
       \ included already. Currently this works by comparing the name of
       \ the file (with path) against the names of earlier included
       \ files; however, it would probably be better to fstat the file,
       \ and compare the device and inode. The advantages would be: no
       \ problems with several paths to the same file (e.g., due to
       \ links) and we would catch files included with include-file and
       \ write a require-file.
       open-path-file 2dup included?
       if
           2drop close-file throw
       else
           included1
       then ;
   
 \ HEX DECIMAL                                           2may93jaw  \ HEX DECIMAL                                           2may93jaw
   
 : decimal a base ! ;  : decimal ( -- ) \ core
 : hex     10 base ! ;      a base ! ;
   : hex ( -- ) \ core-ext
       10 base ! ;
   
 \ DEPTH                                                 9may93jaw  \ DEPTH                                                 9may93jaw
   
 : depth ( -- +n )  sp@ s0 @ swap - cell / ;  : depth ( -- +n ) \ core
 : clearstack ( ... -- )  s0 @ sp! ;      sp@ s0 @ swap - cell / ;
   : clearstack ( ... -- )
       s0 @ sp! ;
   
 \ INCLUDE                                               9may93jaw  \ INCLUDE                                               9may93jaw
   
 : include  ( "file" -- )  : include  ( "file" -- ) \ gforth
   name included ;    name included ;
   
   : require  ( "file" -- ) \ gforth
     name required ;
   
 \ RECURSE                                               17may93jaw  \ RECURSE                                               17may93jaw
   
 : recurse ( -- )  : recurse ( compilation -- ; run-time ?? -- ?? ) \ core
     lastxt compile, ; immediate restrict      lastxt compile, ; immediate restrict
 : recursive ( -- )  ' reveal alias recursive ( -- ) \ gforth
     reveal ; immediate          immediate
   
 \ */MOD */                                              17may93jaw  \ */MOD */                                              17may93jaw
   
 \ !! I think */mod should have the same rounding behaviour as / - anton  \ !! I think */mod should have the same rounding behaviour as / - anton
 : */mod >r m* r> sm/rem ;  : */mod ( n1 n2 n3 -- n4 n5 ) \ core    star-slash-mod
       >r m* r> sm/rem ;
   
 : */ */mod nip ;  : */ ( n1 n2 n3 -- n4 ) \ core  star-slash
       */mod nip ;
   
 \ EVALUATE                                              17may93jaw  \ EVALUATE                                              17may93jaw
   
 : evaluate ( c-addr len -- )  : evaluate ( c-addr len -- ) \ core,block
   push-file  dup #tib ! >tib @ swap move    push-file  #tib ! >tib !
   >in off blk off loadfile off -1 loadline !    >in off blk off loadfile off -1 loadline !
   
 \  BEGIN  interpret  >in @ #tib @ u>= UNTIL  
   ['] interpret catch    ['] interpret catch
   pop-file throw ;    pop-file throw ;
   
   : abort ( ?? -- ?? ) \ core,exception-ext
 : abort -1 throw ;      -1 throw ;
   
 \+ environment? true ENV" CORE"  \+ environment? true ENV" CORE"
 \ core wordset is now complete!  \ core wordset is now complete!
Line 1271  max-errors 6 * cells allot Line 1682  max-errors 6 * cells allot
 \ line-number  \ line-number
 \ Loadfilename ( addr u )  \ Loadfilename ( addr u )
   
 : dec. ( n -- )  : dec. ( n -- ) \ gforth
     \ print value in decimal representation      \ print value in decimal representation
     base @ decimal swap . base ! ;      base @ decimal swap . base ! ;
   
 : typewhite ( addr u -- )  : hex. ( u -- ) \ gforth
       \ print value as unsigned hex number
       '$ emit base @ swap hex u. base ! ;
   
   : typewhite ( addr u -- ) \ gforth
     \ like type, but white space is printed instead of the characters      \ like type, but white space is printed instead of the characters
     bounds ?do      bounds ?do
         i c@ 9 = if \ check for tab          i c@ 9 = if \ check for tab
Line 1284  max-errors 6 * cells allot Line 1699  max-errors 6 * cells allot
             bl              bl
         then          then
         emit          emit
     loop      loop ;
 ;  
   
 DEFER DOERROR  DEFER DOERROR
   
Line 1310  DEFER DOERROR Line 1724  DEFER DOERROR
 ;  ;
   
 : (DoError) ( throw-code -- )  : (DoError) ( throw-code -- )
   loadline @ IF    sourceline# IF
                source >in @ loadline @ 0 0 .error-frame                 source >in @ sourceline# 0 0 .error-frame
   THEN    THEN
   error-stack @ 0 ?DO    error-stack @ 0 ?DO
     -1 error-stack +!      -1 error-stack +!
Line 1335  DEFER DOERROR Line 1749  DEFER DOERROR
   
 ' (DoError) IS DoError  ' (DoError) IS DoError
   
 : quit   r0 @ rp! handler off >tib @ >r  : quit ( ?? -- ?? ) \ core
   BEGIN      r0 @ rp! handler off >tib @ >r
     postpone [      BEGIN
     ['] 'quit CATCH dup          postpone [
   WHILE          ['] 'quit CATCH dup
     DoError r@ >tib !      WHILE
   REPEAT          DoError r@ >tib ! r@ tibstack !
   drop r> >tib ! ;      REPEAT
       drop r> >tib ! ;
   
 \ Cold                                                 13feb93py  \ Cold                                                 13feb93py
   
 \ : .name ( name -- ) cell+ count $1F and type space ;  \ : .name ( name -- ) name>string type space ;
 \ : words  listwords @  \ : words  listwords @
 \          BEGIN  @ dup  WHILE  dup .name  REPEAT drop ;  \          BEGIN  @ dup  WHILE  dup .name  REPEAT drop ;
   
 : cstring>sstring  ( cstring -- addr n )  -1 0 scan 0 swap 1+ /string ;  : cstring>sstring  ( cstring -- addr n ) \ gforth       cstring-to-sstring
 : arg ( n -- addr count )  cells argv @ + @ cstring>sstring ;      -1 0 scan 0 swap 1+ /string ;
   : arg ( n -- addr count ) \ gforth
       cells argv @ + @ cstring>sstring ;
 : #!       postpone \ ;  immediate  : #!       postpone \ ;  immediate
   
 Create pathstring 2 cells allot \ string  Create pathstring 2 cells allot \ string
Line 1363  Variable argc Line 1780  Variable argc
   
 : process-path ( addr1 u1 -- addr2 u2 )  : process-path ( addr1 u1 -- addr2 u2 )
     \ addr1 u1 is a path string, addr2 u2 is an array of dir strings      \ addr1 u1 is a path string, addr2 u2 is an array of dir strings
     here >r      align here >r
     BEGIN      BEGIN
         over >r [char] : scan          over >r [char] : scan
         over r> tuck - ( rest-str this-str )          over r> tuck - ( rest-str this-str )
Line 1385  Variable argc Line 1802  Variable argc
     2drop      2drop
     here r> tuck - 2 cells / ;      here r> tuck - 2 cells / ;
   
 : ">tib  ( addr len -- )  dup #tib ! >in off tib swap move ;  : do-option ( addr1 len1 addr2 len2 -- n )
       2swap
 : do-option ( addr1 len1 addr2 len2 -- n )  2swap      2dup s" -e"         compare  0= >r
   2dup s" -e"        compare  0= >r      2dup s" --evaluate" compare  0= r> or
   2dup s" -evaluate" compare  0= r> or      IF  2drop dup >r ['] evaluate catch
   IF  2drop ">tib interpret  2 EXIT  THEN          ?dup IF  dup >r DoError r> negate (bye)  THEN
   ." Unknown option: " type cr 2drop 1 ;          r> >tib +!  2 EXIT  THEN
       ." Unknown option: " type cr 2drop 1 ;
   
 : process-args ( -- )  : process-args ( -- )
       >tib @ >r
     argc @ 1      argc @ 1
     ?DO      ?DO
         I arg over c@ [char] - <>          I arg over c@ [char] - <>
         IF          IF
             true to script? included  false to script? 1              required 1
         ELSE          ELSE
             I 1+ arg  do-option              I 1+ argc @ =  IF  s" "  ELSE  I 1+ arg  THEN
               do-option
         THEN          THEN
     +LOOP ;      +LOOP
       r> >tib ! ;
   
 Defer 'cold ' noop IS 'cold  Defer 'cold ' noop IS 'cold
   
 : cold ( -- )  : cold ( -- ) \ gforth
     'cold      stdout TO outfile-id
     pathstring 2@ process-path pathdirs 2!      pathstring 2@ process-path pathdirs 2!
       init-included-files
       'cold
     argc @ 1 >      argc @ 1 >
     IF      IF
           true to script?
         ['] process-args catch ?dup          ['] process-args catch ?dup
         IF          IF
             dup >r DoError cr r> negate (bye)              dup >r DoError cr r> negate (bye)
         THEN          THEN
           cr
     THEN      THEN
     cr      false to script?
     ." GNU Forth 0.0alpha, Copyright (C) 1994 Free Software Foundation, Inc." cr      ." GForth " version-string type ." , Copyright (C) 1994-1996 Free Software Foundation, Inc." cr
     ." GNU Forth comes with ABSOLUTELY NO WARRANTY; for details type `license'" cr      ." GForth comes with ABSOLUTELY NO WARRANTY; for details type `license'" cr
     ." Type `bye' to exit"      ." Type `bye' to exit"
     quit ;      loadline off quit ;
   
 : license ( -- ) cr  : license ( -- ) \ gforth
    cr
  ." This program is free software; you can redistribute it and/or modify" cr   ." This program is free software; you can redistribute it and/or modify" cr
  ." it under the terms of the GNU General Public License as published by" cr   ." it under the terms of the GNU General Public License as published by" cr
  ." the Free Software Foundation; either version 2 of the License, or" cr   ." the Free Software Foundation; either version 2 of the License, or" cr
Line 1439  Defer 'cold ' noop IS 'cold Line 1865  Defer 'cold ' noop IS 'cold
   
 : boot ( path **argv argc -- )  : boot ( path **argv argc -- )
   argc ! argv ! cstring>sstring pathstring 2!  main-task up!    argc ! argv ! cstring>sstring pathstring 2!  main-task up!
   sp@ dup s0 ! $10 + >tib ! rp@ r0 !  fp@ f0 !  cold ;    sp@ dup s0 ! $10 + dup >tib ! tibstack ! #tib off >in off
     rp@ r0 !  fp@ f0 !  ['] cold catch DoError bye ;
   
 : bye  script? 0= IF  cr  THEN  0 (bye) ;  : bye ( -- ) \ tools-ext
       script? 0= IF  cr  THEN  0 (bye) ;
   
 \ **argv may be scanned by the C starter to get some important  \ **argv may be scanned by the C starter to get some important
 \ information, as -display and -geometry for an X client FORTH  \ information, as -display and -geometry for an X client FORTH
 \ or space and stackspace overrides  \ or space and stackspace overrides
   
 \ 0 arg contains, however, the name of the program.  \ 0 arg contains, however, the name of the program.
   
   

Removed from v.1.24  
changed lines
  Added in v.1.61


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>