Annotation of gforth/cross.fs, revision 1.43

1.1       anton       1: \ CROSS.FS     The Cross-Compiler                      06oct92py
                      2: \ Idea and implementation: Bernd Paysan (py)
1.30      anton       3: 
                      4: \ Copyright (C) 1995 Free Software Foundation, Inc.
                      5: 
                      6: \ This file is part of Gforth.
                      7: 
                      8: \ Gforth is free software; you can redistribute it and/or
                      9: \ modify it under the terms of the GNU General Public License
                     10: \ as published by the Free Software Foundation; either version 2
                     11: \ of the License, or (at your option) any later version.
                     12: 
                     13: \ This program is distributed in the hope that it will be useful,
                     14: \ but WITHOUT ANY WARRANTY; without even the implied warranty of
                     15: \ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     16: \ GNU General Public License for more details.
                     17: 
                     18: \ You should have received a copy of the GNU General Public License
                     19: \ along with this program; if not, write to the Free Software
                     20: \ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
1.1       anton      21: 
                     22: \ Log:
                     23: \       changed in ; [ to state off           12may93jaw
                     24: \       included place +place                 12may93jaw
                     25: \       for a created word (variable, constant...)
                     26: \       is now an alias in the target voabulary.
                     27: \       this means it is no longer necessary to
                     28: \       switch between vocabularies for variable
                     29: \       initialization                        12may93jaw
                     30: \       discovered error in DOES>
                     31: \       replaced !does with (;code)           16may93jaw
                     32: \       made complete redesign and
                     33: \       introduced two vocs method
                     34: \       to be asure that the right words
                     35: \       are found                             08jun93jaw
                     36: \       btw:  ! works not with 16 bit
                     37: \             targets                         09jun93jaw
                     38: \       added: 2user and value                11jun93jaw
                     39: 
1.9       pazsan     40: \ include other.fs       \ ansforth extentions for cross
1.1       anton      41: 
1.23      pazsan     42: : string, ( c-addr u -- )
                     43:     \ puts down string as cstring
                     44:     dup c, here swap chars dup allot move ;
                     45: ' falign Alias cfalign
1.5       pazsan     46: : comment? ( c-addr u -- c-addr u )
                     47:         2dup s" (" compare 0=
                     48:         IF    postpone (
                     49:         ELSE  2dup s" \" compare 0= IF postpone \ THEN
                     50:         THEN ;
                     51: 
1.1       anton      52: decimal
                     53: 
                     54: \ Begin CROSS COMPILER:
                     55: 
                     56: \ GhostNames                                            9may93jaw
                     57: \ second name source to search trough list
                     58: 
                     59: VARIABLE GhostNames
                     60: 0 GhostNames !
                     61: : GhostName ( -- addr )
1.22      anton      62:     here GhostNames @ , GhostNames ! here 0 ,
                     63:     bl word count
                     64:     \ 2dup type space
                     65:     string, cfalign ;
1.1       anton      66: 
                     67: hex
                     68: 
                     69: 
                     70: Vocabulary Cross
                     71: Vocabulary Target
                     72: Vocabulary Ghosts
                     73: VOCABULARY Minimal
                     74: only Forth also Target also also
                     75: definitions Forth
                     76: 
                     77: : T  previous Cross also Target ; immediate
                     78: : G  Ghosts ; immediate
                     79: : H  previous Forth also Cross ; immediate
                     80: 
                     81: forth definitions
                     82: 
                     83: : T  previous Cross also Target ; immediate
                     84: : G  Ghosts ; immediate
                     85: 
                     86: : >cross  also Cross definitions previous ;
                     87: : >target also Target definitions previous ;
                     88: : >minimal also Minimal definitions previous ;
                     89: 
                     90: H
                     91: 
                     92: >CROSS
                     93: 
1.43    ! pazsan     94: \ Parameter for target systems                         06oct92py
        !            95: 
        !            96: mach-file count included
        !            97: 
        !            98: also Forth definitions
        !            99: 
        !           100: [IFDEF] asm-include asm-include [THEN]
        !           101: 
        !           102: previous
        !           103: 
        !           104: >CROSS
        !           105: 
1.1       anton     106: \ Variables                                            06oct92py
                    107: 
                    108: Variable image
                    109: Variable tlast    NIL tlast !  \ Last name field
                    110: Variable tlastcfa \ Last code field
                    111: Variable tdoes    \ Resolve does> calls
                    112: Variable bit$
                    113: Variable tdp
                    114: : there  tdp @ ;
                    115: 
1.19      pazsan    116: \ Create additional parameters                         19jan95py
                    117: 
                    118: T
                    119: cell               Constant tcell
                    120: cell<<             Constant tcell<<
                    121: cell>bit           Constant tcell>bit
                    122: bits/byte          Constant tbits/byte
                    123: float              Constant tfloat
                    124: 1 bits/byte lshift Constant maxbyte
                    125: H
                    126: 
1.1       anton     127: >TARGET
                    128: 
                    129: \ Byte ordering and cell size                          06oct92py
                    130: 
1.19      pazsan    131: : cell+         tcell + ;
                    132: : cells         tcell<< lshift ;
1.1       anton     133: : chars         ;
1.19      pazsan    134: : floats       tfloat * ;
1.6       anton     135:     
1.1       anton     136: >CROSS
1.19      pazsan    137: : cell/         tcell<< rshift ;
1.1       anton     138: >TARGET
                    139: 20 CONSTANT bl
                    140: -1 Constant NIL
                    141: 
                    142: >CROSS
                    143: 
1.20      pazsan    144: bigendian
                    145: [IF]
                    146:    : T!  ( n addr -- )  >r s>d r> tcell bounds swap 1-
                    147:      DO  maxbyte ud/mod rot I c!  -1 +LOOP  2drop ;
                    148:    : T@  ( addr -- n )  >r 0 0 r> tcell bounds
                    149:      DO  maxbyte * swap maxbyte um* rot + swap I c@ + swap  LOOP d>s ;
1.19      pazsan    150: [ELSE]
1.20      pazsan    151:    : T!  ( n addr -- )  >r s>d r> tcell bounds
                    152:      DO  maxbyte ud/mod rot I c!  LOOP  2drop ;
                    153:    : T@  ( addr -- n )  >r 0 0 r> tcell bounds swap 1-
                    154:      DO  maxbyte * swap maxbyte um* rot + swap I c@ + swap  -1 +LOOP d>s ;
1.1       anton     155: [THEN]
                    156: 
                    157: \ Memory initialisation                                05dec92py
                    158: \ Fixed bug in else part                               11may93jaw
                    159: 
                    160: [IFDEF] Memory \ Memory is a bigFORTH feature
1.5       pazsan    161:    also Memory
1.1       anton     162:    : initmem ( var len -- )
                    163:      2dup swap handle! >r @ r> erase ;
1.5       pazsan    164:    toss
1.1       anton     165: [ELSE]
                    166:    : initmem ( var len -- )
                    167:      tuck allocate abort" CROSS: No memory for target"
                    168:      ( len var adr ) dup rot !
                    169:      ( len adr ) swap erase ;
                    170: [THEN]
                    171: 
                    172: \ MakeKernal                                           12dec92py
                    173: 
                    174: >MINIMAL
1.39      pazsan    175: : makekernel ( targetsize -- targetsize )
1.1       anton     176:   bit$  over 1- cell>bit rshift 1+ initmem
                    177:   image over initmem tdp off ;
                    178: 
                    179: >CROSS
                    180: \ Bit string manipulation                               06oct92py
                    181: \                                                       9may93jaw
                    182: CREATE Bittable 80 c, 40 c, 20 c, 10 c, 8 c, 4 c, 2 c, 1 c,
                    183: : bits ( n -- n ) chars Bittable + c@ ;
                    184: 
                    185: : >bit ( addr n -- c-addr mask ) 8 /mod rot + swap bits ;
                    186: : +bit ( addr n -- )  >bit over c@ or swap c! ;
1.4       pazsan    187: : -bit ( addr n -- )  >bit invert over c@ and swap c! ;
1.1       anton     188: : relon ( taddr -- )  bit$ @ swap cell/ +bit ;
1.4       pazsan    189: : reloff ( taddr -- )  bit$ @ swap cell/ -bit ;
1.1       anton     190: 
                    191: \ Target memory access                                 06oct92py
                    192: 
                    193: : align+  ( taddr -- rest )
                    194:     cell tuck 1- and - [ cell 1- ] Literal and ;
1.22      anton     195: : cfalign+  ( taddr -- rest )
1.39      pazsan    196:     \ see kernel.fs:cfaligned
1.43    ! pazsan    197:     /maxalign tuck 1- and - [ /maxalign 1- ] Literal and ;
1.1       anton     198: 
                    199: >TARGET
                    200: : aligned ( taddr -- ta-addr )  dup align+ + ;
                    201: \ assumes cell alignment granularity (as GNU C)
                    202: 
1.22      anton     203: : cfaligned ( taddr1 -- taddr2 )
1.39      pazsan    204:     \ see kernel.fs
1.22      anton     205:     dup cfalign+ + ;
                    206: 
1.1       anton     207: >CROSS
                    208: : >image ( taddr -- absaddr )  image @ + ;
                    209: >TARGET
1.19      pazsan    210: : @  ( taddr -- w )     >image t@ ;
                    211: : !  ( w taddr -- )     >image t! ;
1.1       anton     212: : c@ ( taddr -- char )  >image c@ ;
                    213: : c! ( char taddr -- )  >image c! ;
1.7       anton     214: : 2@ ( taddr -- x1 x2 ) T dup cell+ @ swap @ H ;
                    215: : 2! ( x1 x2 taddr -- ) T swap over ! cell+ ! H ;
1.1       anton     216: 
                    217: \ Target compilation primitives                        06oct92py
                    218: \ included A!                                          16may93jaw
                    219: 
                    220: : here  ( -- there )    there ;
                    221: : allot ( n -- )        tdp +! ;
                    222: : ,     ( w -- )        T here H cell T allot  ! H ;
                    223: : c,    ( char -- )     T here    1 allot c! H ;
                    224: : align ( -- )          T here H align+ 0 ?DO  bl T c, H LOOP ;
1.22      anton     225: : cfalign ( -- )
                    226:     T here H cfalign+ 0 ?DO  bl T c, H LOOP ;
1.1       anton     227: 
                    228: : A!                    dup relon T ! H ;
                    229: : A,    ( w -- )        T here H relon T , H ;
                    230: 
                    231: >CROSS
                    232: 
                    233: \ threading modell                                     13dec92py
                    234: 
                    235: >TARGET
                    236: : >body   ( cfa -- pfa ) T cell+ cell+ H ;
                    237: >CROSS
                    238: 
                    239: \ Ghost Builder                                        06oct92py
                    240: 
                    241: \ <T T> new version with temp variable                 10may93jaw
                    242: 
                    243: VARIABLE VocTemp
                    244: 
                    245: : <T  get-current VocTemp ! also Ghosts definitions ;
                    246: : T>  previous VocTemp @ set-current ;
                    247: 
                    248: 4711 Constant <fwd>             4712 Constant <res>
1.42      pazsan    249: 4713 Constant <imm>             4714 Constant <do:>
1.1       anton     250: 
                    251: \ iForth makes only immediate directly after create
                    252: \ make atonce trick! ?
                    253: 
                    254: Variable atonce atonce off
                    255: 
                    256: : NoExec true ABORT" CROSS: Don't execute ghost" ;
                    257: 
                    258: : GhostHeader <fwd> , 0 , ['] NoExec , ;
                    259: 
1.43    ! pazsan    260: : >magic ;
        !           261: : >link cell+ ;
        !           262: : >exec cell+ cell+ ;
1.1       anton     263: : >end 3 cells + ;
                    264: 
1.11      pazsan    265: Variable last-ghost
1.1       anton     266: : Make-Ghost ( "name" -- ghost )
                    267:   >in @ GhostName swap >in !
                    268:   <T Create atonce @ IF immediate atonce off THEN
                    269:   here tuck swap ! ghostheader T>
1.11      pazsan    270:   DOES> dup last-ghost ! >exec @ execute ;
1.1       anton     271: 
                    272: \ ghost words                                          14oct92py
                    273: \                                          changed:    10may93py/jaw
                    274: 
                    275: : gfind   ( string -- ghost true/1 / string false )
                    276: \ searches for string in word-list ghosts
1.5       pazsan    277:   dup count [ ' ghosts >body ] ALiteral search-wordlist
1.38      anton     278:   dup IF >r >body nip r>  THEN ;
1.1       anton     279: 
                    280: VARIABLE Already
                    281: 
                    282: : ghost   ( "name" -- ghost )
                    283:   Already off
1.13      pazsan    284:   >in @  bl word gfind   IF  Already on nip EXIT  THEN
1.1       anton     285:   drop  >in !  Make-Ghost ;
                    286: 
                    287: \ resolve                                              14oct92py
                    288: 
                    289: : resolve-loop ( ghost tcfa -- ghost tcfa )
                    290:   >r dup >link @
                    291:   BEGIN  dup  WHILE  dup T @ H r@ rot T ! H REPEAT  drop r> ;
                    292: 
                    293: \ exists                                                9may93jaw
                    294: 
                    295: : exists ( ghost tcfa -- )
                    296:   over GhostNames
                    297:   BEGIN @ dup
                    298:   WHILE 2dup cell+ @ =
                    299:   UNTIL
1.18      pazsan    300:         2 cells + count cr ." CROSS: Exists: " type 4 spaces drop
1.1       anton     301:         swap cell+ !
1.24      pazsan    302:   ELSE  true abort" CROSS: Ghostnames inconsistent "
1.1       anton     303:   THEN ;
                    304: 
                    305: : resolve  ( ghost tcfa -- )
                    306:   over >magic @ <fwd> <>  IF  exists EXIT THEN
                    307:   resolve-loop  over >link ! <res> swap >magic ! ;
                    308: 
                    309: \ gexecute ghost,                                      01nov92py
                    310: 
                    311: : do-forward   ( ghost -- )
                    312:   >link dup @  there rot !  T  A,  H ;
                    313: : do-resolve   ( ghost -- )
                    314:   >link @                   T  A,  H ;
                    315: 
                    316: : gexecute   ( ghost -- )   dup @
                    317:              <fwd> = IF  do-forward  ELSE  do-resolve  THEN ;
                    318: : ghost,     ghost  gexecute ;
                    319: 
                    320: \ .unresolved                                          11may93jaw
                    321: 
                    322: variable ResolveFlag
                    323: 
                    324: \ ?touched                                             11may93jaw
                    325: 
                    326: : ?touched ( ghost -- flag ) dup >magic @ <fwd> = swap >link @
                    327:                                0 <> and ;
                    328: 
                    329: : ?resolved  ( ghostname -- )
                    330:   dup cell+ @ ?touched
                    331:   IF  cell+ cell+ count cr type ResolveFlag on ELSE drop THEN ;
                    332: 
                    333: >MINIMAL
                    334: : .unresolved  ( -- )
                    335:   ResolveFlag off cr ." Unresolved: "
                    336:   Ghostnames
                    337:   BEGIN @ dup
                    338:   WHILE dup ?resolved
1.10      anton     339:   REPEAT drop ResolveFlag @
                    340:   IF
1.11      pazsan    341:       abort" Unresolved words!"
1.10      anton     342:   ELSE
                    343:       ." Nothing!"
                    344:   THEN
                    345:   cr ;
1.1       anton     346: 
                    347: >CROSS
                    348: \ Header states                                        12dec92py
                    349: 
                    350: : flag! ( 8b -- )   tlast @ dup >r T c@ xor r> c! H ;
                    351: 
                    352: VARIABLE ^imm
                    353: 
                    354: >TARGET
1.36      anton     355: : immediate     40 flag!
1.18      pazsan    356:                 ^imm @ @ dup <imm> = IF  drop  EXIT  THEN
1.1       anton     357:                 <res> <> ABORT" CROSS: Cannot immediate a unresolved word"
                    358:                 <imm> ^imm @ ! ;
1.36      anton     359: : restrict      20 flag! ;
1.1       anton     360: >CROSS
                    361: 
                    362: \ ALIAS2 ansforth conform alias                          9may93jaw
                    363: 
                    364: : ALIAS2 create here 0 , DOES> @ execute ;
                    365: \ usage:
1.18      pazsan    366: \ ' <name> alias2 bla !
1.1       anton     367: 
                    368: \ Target Header Creation                               01nov92py
                    369: 
                    370: : string,  ( addr count -- )
1.28      pazsan    371:   dup T c, H bounds  ?DO  I c@ T c, H  LOOP ; 
1.22      anton     372: : name,  ( "name" -- )  bl word count string, T cfalign H ;
1.1       anton     373: : view,   ( -- ) ( dummy ) ;
                    374: 
1.25      pazsan    375: \ Target Document Creation (goes to crossdoc.fd)       05jul95py
                    376: 
                    377: s" crossdoc.fd" r/w create-file throw value doc-file-id
                    378: \ contains the file-id of the documentation file
                    379: 
1.40      pazsan    380: : T-\G ( -- )
1.25      pazsan    381:     source >in @ /string doc-file-id write-line throw
1.40      pazsan    382:     postpone \ ;
1.25      pazsan    383: 
1.39      pazsan    384: Variable to-doc  to-doc on
1.25      pazsan    385: 
                    386: : cross-doc-entry  ( -- )
                    387:     to-doc @ tlast @ 0<> and   \ not an anonymous (i.e. noname) header
                    388:     IF
                    389:        s" " doc-file-id write-line throw
                    390:        s" make-doc " doc-file-id write-file throw
                    391:        tlast @ >image count $1F and doc-file-id write-file throw
                    392:        >in @
                    393:        [char] ( parse 2drop
                    394:        [char] ) parse doc-file-id write-file throw
                    395:        s"  )" doc-file-id write-file throw
                    396:        [char] \ parse 2drop                                    
1.40      pazsan    397:        T-\G
1.25      pazsan    398:        >in !
1.39      pazsan    399:     THEN ;
1.25      pazsan    400: 
1.28      pazsan    401: \ Target TAGS creation
                    402: 
1.39      pazsan    403: s" kernel.TAGS" r/w create-file throw value tag-file-id
1.28      pazsan    404: \ contains the file-id of the tags file
                    405: 
                    406: Create tag-beg 2 c,  7F c, bl c,
                    407: Create tag-end 2 c,  bl c, 01 c,
                    408: Create tag-bof 1 c,  0C c,
                    409: 
                    410: 2variable last-loadfilename 0 0 last-loadfilename 2!
                    411:            
                    412: : put-load-file-name ( -- )
                    413:     loadfilename 2@ last-loadfilename 2@ d<>
                    414:     IF
                    415:        tag-bof count tag-file-id write-line throw
1.31      anton     416:        sourcefilename 2dup
1.28      pazsan    417:        tag-file-id write-file throw
                    418:        last-loadfilename 2!
                    419:        s" ,0" tag-file-id write-line throw
                    420:     THEN ;
                    421: 
                    422: : cross-tag-entry  ( -- )
                    423:     tlast @ 0<>        \ not an anonymous (i.e. noname) header
                    424:     IF
                    425:        put-load-file-name
                    426:        source >in @ min tag-file-id write-file throw
                    427:        tag-beg count tag-file-id write-file throw
                    428:        tlast @ >image count $1F and tag-file-id write-file throw
                    429:        tag-end count tag-file-id write-file throw
1.31      anton     430:        base @ decimal sourceline# 0 <# #s #> tag-file-id write-file throw
1.28      pazsan    431: \      >in @ 0 <# #s [char] , hold #> tag-file-id write-line throw
                    432:        s" ,0" tag-file-id write-line throw
                    433:        base !
                    434:     THEN ;
                    435: 
1.43    ! pazsan    436: \ Check for words
        !           437: 
        !           438: Defer skip? ' false IS skip?
        !           439: 
        !           440: : defined? ( -- flag ) \ name
        !           441:     ghost >magic @ <fwd> <> ;
        !           442: 
        !           443: : needed? ( -- flag ) \ name
        !           444:     ghost dup >magic @ <fwd> =
        !           445:     IF  >link @ 0<>  ELSE  drop false  THEN ;
        !           446: 
        !           447: : skip-defs ( -- )
        !           448:     BEGIN  refill  WHILE  source -trailing nip 0= UNTIL  THEN ;
        !           449: 
1.28      pazsan    450: \ Target header creation
                    451: 
1.1       anton     452: VARIABLE CreateFlag CreateFlag off
                    453: 
1.43    ! pazsan    454: : (Theader ( "name" -- ghost )
        !           455: \  >in @ bl word count type 2 spaces >in !
        !           456:   T align H view,
1.1       anton     457:   tlast @ dup 0> IF  T 1 cells - THEN  A, H  there tlast !
                    458:   >in @ name, >in ! T here H tlastcfa !
                    459:   CreateFlag @ IF
1.18      pazsan    460:        >in @ alias2 swap >in !         \ create alias in target
                    461:        >in @ ghost swap >in !
                    462:        swap also ghosts ' previous swap !     \ tick ghost and store in alias
                    463:        CreateFlag off
1.1       anton     464:   ELSE ghost THEN
                    465:   dup >magic ^imm !     \ a pointer for immediate
                    466:   Already @ IF  dup >end tdoes !
                    467:   ELSE 0 tdoes ! THEN
1.25      pazsan    468:   80 flag!
1.28      pazsan    469:   cross-doc-entry cross-tag-entry ;
1.1       anton     470: 
                    471: VARIABLE ;Resolve 1 cells allot
                    472: 
1.11      pazsan    473: : Theader  ( "name" -- ghost )
                    474:   (THeader dup there resolve 0 ;Resolve ! ;
1.1       anton     475: 
                    476: >TARGET
                    477: : Alias    ( cfa -- ) \ name
1.43    ! pazsan    478:     >in @ skip? IF  2drop  EXIT  THEN  >in !
        !           479:     dup 0< has-prims 0= and
        !           480:     IF
        !           481:        ." needs prim: " >in @ bl word count type >in ! cr
        !           482:     THEN
        !           483:     (THeader over resolve T A, H 80 flag! ;
1.42      pazsan    484: : Alias:   ( cfa -- ) \ name
1.43    ! pazsan    485:     >in @ skip? IF  2drop  EXIT  THEN  >in !
        !           486:     dup 0< has-prims 0= and
        !           487:     IF
        !           488:        ." needs doer: " >in @ bl word count type >in ! cr
        !           489:     THEN
        !           490:     ghost tuck swap resolve <do:> swap >magic ! ;
1.1       anton     491: >CROSS
                    492: 
                    493: \ Conditionals and Comments                            11may93jaw
                    494: 
                    495: : ;Cond
                    496:   postpone ;
                    497:   swap ! ;  immediate
                    498: 
                    499: : Cond: ( -- ) \ name {code } ;
                    500:   atonce on
                    501:   ghost
                    502:   >exec
                    503:   :NONAME ;
                    504: 
                    505: : restrict? ( -- )
                    506: \ aborts on interprete state - ae
                    507:   state @ 0= ABORT" CROSS: Restricted" ;
                    508: 
                    509: : Comment ( -- )
                    510:   >in @ atonce on ghost swap >in ! ' swap >exec ! ;
                    511: 
                    512: Comment (       Comment \
                    513: 
                    514: \ Predefined ghosts                                    12dec92py
                    515: 
                    516: ghost 0=                                        drop
                    517: ghost branch    ghost ?branch                   2drop
                    518: ghost (do)      ghost (?do)                     2drop
                    519: ghost (for)                                     drop
                    520: ghost (loop)    ghost (+loop)                   2drop
                    521: ghost (next)                                    drop
1.2       pazsan    522: ghost unloop    ghost ;S                        2drop
1.1       anton     523: ghost lit       ghost (compile) ghost !         2drop drop
1.29      anton     524: ghost (does>)   ghost noop                      2drop
1.1       anton     525: ghost (.")      ghost (S")      ghost (ABORT")  2drop drop
1.41      pazsan    526: ghost '                                         drop
1.42      pazsan    527: ghost :docol    ghost :doesjump ghost :dodoes   2drop drop
1.1       anton     528: 
                    529: \ compile                                              10may93jaw
                    530: 
                    531: : compile  ( -- ) \ name
                    532:   restrict?
1.13      pazsan    533:   bl word gfind dup 0= ABORT" CROSS: Can't compile "
1.1       anton     534:   0> ( immediate? )
                    535:   IF    >exec @ compile,
                    536:   ELSE  postpone literal postpone gexecute  THEN ;
                    537:                                         immediate
                    538: 
1.42      pazsan    539: \ generic threading modell
                    540: : docol,  ( -- ) compile :docol T 0 , H ;
                    541: 
                    542: : dodoes, ( -- ) compile :doesjump T 0 , H ;
                    543: 
1.43    ! pazsan    544: [IFUNDEF] (code) 
        !           545: Defer (code)
        !           546: Defer (end-code)
        !           547: [THEN]
        !           548: 
1.1       anton     549: >TARGET
1.43    ! pazsan    550: : Code
        !           551:     (THeader there resolve
        !           552:     there 2 T cells H + T a, 0 , H
        !           553:     depth (code) ;
        !           554: 
        !           555: : Code:
        !           556:     ghost dup there resolve  <do:> swap >magic !
        !           557:     depth (code) ;
        !           558: 
        !           559: : end-code
        !           560:     depth ?dup IF   1- <> ABORT" CROSS: Stack changed"
        !           561:     ELSE true ABORT" CROSS: Stack empty" THEN
        !           562:     (end-code) ;
        !           563:                
1.13      pazsan    564: : '  ( -- cfa ) bl word gfind 0= ABORT" CROSS: undefined "
1.1       anton     565:   dup >magic @ <fwd> = ABORT" CROSS: forward " >link @ ;
                    566: 
                    567: Cond: [']  compile lit ghost gexecute ;Cond
1.14      anton     568: 
                    569: Cond: chars ;Cond
1.1       anton     570: 
                    571: >CROSS
                    572: \ tLiteral                                             12dec92py
                    573: 
                    574: : lit, ( n -- )   compile lit T  ,  H ;
                    575: : alit, ( n -- )  compile lit T A,  H ;
                    576: 
                    577: >TARGET
1.40      pazsan    578: Cond: \G  T-\G ;Cond
                    579: 
1.1       anton     580: Cond:  Literal ( n -- )   restrict? lit, ;Cond
                    581: Cond: ALiteral ( n -- )   restrict? alit, ;Cond
                    582: 
                    583: : Char ( "<char>" -- )  bl word char+ c@ ;
                    584: Cond: [Char]   ( "<char>" -- )  restrict? Char  lit, ;Cond
                    585: 
1.43    ! pazsan    586: \ some special literals                                        27jan97jaw
        !           587: 
        !           588: Cond: MAXU
        !           589:  restrict? compile lit 
        !           590:  tcell 0 ?DO FF T c, H LOOP ;Cond
        !           591: 
        !           592: Cond: MINI
        !           593:  restrict? compile lit
        !           594:  bigendian IF
        !           595:  80 T c, H tcell 1 ?DO 0 T c, H LOOP 
        !           596:  ELSE
        !           597:  tcell 1 ?DO 0 T c, H LOOP 80 T c, H
        !           598:  THEN
        !           599:  ;Cond
        !           600:  
        !           601: Cond: MAXI
        !           602:  restrict? compile lit
        !           603:  bigendian IF
        !           604:  7F T c, H tcell 1 ?DO FF T c, H LOOP 
        !           605:  ELSE
        !           606:  tcell 1 ?DO FF T c, H LOOP 7F T c, H
        !           607:  THEN
        !           608:  ;Cond
        !           609: 
1.1       anton     610: >CROSS
                    611: \ Target compiling loop                                12dec92py
                    612: \ ">tib trick thrown out                               10may93jaw
                    613: \ number? defined at the top                           11may93jaw
                    614: 
                    615: \ compiled word might leave items on stack!
                    616: : tcom ( in name -- )
                    617:   gfind  ?dup  IF    0> IF    nip >exec @ execute
                    618:                         ELSE  nip gexecute  THEN EXIT THEN
                    619:   number? dup  IF    0> IF swap lit,  THEN  lit,  drop
                    620:                ELSE  2drop >in !
                    621:                ghost gexecute THEN  ;
                    622: 
                    623: >TARGET
                    624: \ : ; DOES>                                            13dec92py
                    625: \ ]                                                     9may93py/jaw
                    626: 
                    627: : ] state on
                    628:     BEGIN
1.13      pazsan    629:         BEGIN >in @ bl word
1.1       anton     630:               dup c@ 0= WHILE 2drop refill 0=
                    631:               ABORT" CROSS: End of file while target compiling"
                    632:         REPEAT
                    633:         tcom
                    634:         state @
                    635:         0=
                    636:     UNTIL ;
                    637: 
                    638: \ by the way: defining a second interpreter (a compiler-)loop
                    639: \             is not allowed if a system should be ans conform
                    640: 
                    641: : : ( -- colon-sys ) \ Name
1.43    ! pazsan    642:   >in @ skip? IF  drop skip-defs  EXIT  THEN  >in !
1.1       anton     643:   (THeader ;Resolve ! there ;Resolve cell+ !
                    644:   docol, depth T ] H ;
                    645: 
1.37      pazsan    646: : :noname ( -- colon-sys )
                    647:   T align H there docol, depth T ] H ;
                    648: 
1.2       pazsan    649: Cond: EXIT ( -- )  restrict?  compile ;S  ;Cond
1.6       anton     650: 
                    651: Cond: ?EXIT ( -- ) 1 abort" CROSS: using ?exit" ;Cond
1.2       pazsan    652: 
1.1       anton     653: Cond: ; ( -- ) restrict?
                    654:                depth ?dup IF   1- <> ABORT" CROSS: Stack changed"
                    655:                           ELSE true ABORT" CROSS: Stack empty" THEN
1.2       pazsan    656:                compile ;S state off
1.1       anton     657:                ;Resolve @
                    658:                IF ;Resolve @ ;Resolve cell+ @ resolve THEN
                    659:                ;Cond
                    660: Cond: [  restrict? state off ;Cond
                    661: 
                    662: >CROSS
1.42      pazsan    663: : !does
                    664:     tlastcfa @ dup there >r tdp ! compile :dodoes r> tdp ! T cell+ ! H ;
1.1       anton     665: 
                    666: >TARGET
                    667: Cond: DOES> restrict?
1.29      anton     668:         compile (does>) dodoes, tdoes @ ?dup IF  @ T here H resolve THEN
1.1       anton     669:         ;Cond
                    670: : DOES> dodoes, T here H !does depth T ] H ;
                    671: 
                    672: >CROSS
                    673: \ Creation                                             01nov92py
                    674: 
                    675: \ Builder                                               11may93jaw
                    676: 
                    677: : Builder    ( Create do: "name" -- )
                    678:   >in @ alias2 swap dup >in ! >r >r
                    679:   Make-Ghost rot swap >exec ! ,
                    680:   r> r> >in !
1.11      pazsan    681:   also ghosts ' previous swap ! ;
                    682: \  DOES>  dup >exec @ execute ;
1.1       anton     683: 
                    684: : gdoes,  ( ghost -- )  >end @ dup >magic @ <fwd> <>
1.42      pazsan    685:     IF
                    686:        dup >magic @ <do:> =
                    687:        IF  gexecute T 0 , H  EXIT THEN
                    688:     THEN
                    689:     compile :dodoes gexecute T here H cell - reloff ;
1.1       anton     690: 
1.11      pazsan    691: : TCreate ( -- )
                    692:   last-ghost @
1.1       anton     693:   CreateFlag on
1.11      pazsan    694:   Theader >r dup gdoes,
                    695:   >end @ >exec @ r> >exec ! ;
1.1       anton     696: 
                    697: : Build:  ( -- [xt] [colon-sys] )
                    698:   :noname  postpone TCreate ;
                    699: 
                    700: : gdoes>  ( ghost -- addr flag )
1.11      pazsan    701:   last-ghost @
1.1       anton     702:   state @ IF  gexecute true EXIT  THEN
                    703:   cell+ @ T >body H false ;
                    704: 
                    705: \ DO: ;DO                                               11may93jaw
                    706: \ changed to ?EXIT                                      10may93jaw
                    707: 
                    708: : DO:     ( -- addr [xt] [colon-sys] )
                    709:   here ghostheader
1.11      pazsan    710:   :noname postpone gdoes> postpone ?EXIT ;
1.1       anton     711: 
1.42      pazsan    712: : by:     ( -- addr [xt] [colon-sys] ) \ name
                    713:   ghost
                    714:   :noname postpone gdoes> postpone ?EXIT ;
                    715: 
1.1       anton     716: : ;DO ( addr [xt] [colon-sys] -- )
                    717:   postpone ;    ( S addr xt )
                    718:   over >exec ! ; immediate
                    719: 
                    720: : by      ( -- addr ) \ Name
                    721:   ghost >end @ ;
                    722: 
                    723: >TARGET
                    724: \ Variables and Constants                              05dec92py
                    725: 
                    726: Build:  ;
1.42      pazsan    727: by: :dovar ( ghost -- addr ) ;DO
1.1       anton     728: Builder Create
                    729: 
                    730: Build: T 0 , H ;
                    731: by Create
                    732: Builder Variable
                    733: 
                    734: Build: T 0 A, H ;
                    735: by Create
                    736: Builder AVariable
                    737: 
1.3       pazsan    738: \ User variables                                       04may94py
                    739: 
                    740: >CROSS
                    741: Variable tup  0 tup !
                    742: Variable tudp 0 tudp !
                    743: : u,  ( n -- udp )
                    744:   tup @ tudp @ + T  ! H
1.19      pazsan    745:   tudp @ dup T cell+ H tudp ! ;
1.3       pazsan    746: : au, ( n -- udp )
                    747:   tup @ tudp @ + T A! H
1.19      pazsan    748:   tudp @ dup T cell+ H tudp ! ;
1.3       pazsan    749: >TARGET
                    750: 
                    751: Build: T 0 u, , H ;
1.42      pazsan    752: by: :douser ( ghost -- up-addr )  T @ H tup @ + ;DO
1.1       anton     753: Builder User
                    754: 
1.3       pazsan    755: Build: T 0 u, , 0 u, drop H ;
                    756: by User
1.1       anton     757: Builder 2User
                    758: 
1.3       pazsan    759: Build: T 0 au, , H ;
                    760: by User
1.1       anton     761: Builder AUser
                    762: 
                    763: Build:  ( n -- ) T , H ;
1.42      pazsan    764: by: :docon ( ghost -- n ) T @ H ;DO
1.1       anton     765: Builder Constant
                    766: 
                    767: Build:  ( n -- ) T A, H ;
                    768: by Constant
                    769: Builder AConstant
                    770: 
1.24      pazsan    771: Build:  ( d -- ) T , , H ;
                    772: DO: ( ghost -- d ) T dup cell+ @ swap @ H ;DO
                    773: Builder 2Constant
                    774: 
1.1       anton     775: Build: T 0 , H ;
                    776: by Constant
                    777: Builder Value
                    778: 
1.32      pazsan    779: Build: T 0 A, H ;
                    780: by Constant
                    781: Builder AValue
                    782: 
1.1       anton     783: Build:  ( -- ) compile noop ;
1.42      pazsan    784: by: :dodefer ( ghost -- ) ABORT" CROSS: Don't execute" ;DO
1.1       anton     785: Builder Defer
1.37      pazsan    786: 
                    787: Build:  ( inter comp -- ) swap T immediate A, A, H ;
                    788: DO: ( ghost -- ) ABORT" CROSS: Don't execute" ;DO
1.38      anton     789: Builder interpret/compile:
1.24      pazsan    790: 
                    791: \ Sturctures                                           23feb95py
                    792: 
                    793: >CROSS
                    794: : nalign ( addr1 n -- addr2 )
                    795: \ addr2 is the aligned version of addr1 wrt the alignment size n
                    796:  1- tuck +  swap invert and ;
                    797: >TARGET
                    798: 
                    799: Build:         >r rot r@ nalign  dup T , H  ( align1 size offset )
                    800:        + swap r> nalign ;
1.42      pazsan    801: by: :dofield T @ H + ;DO
1.24      pazsan    802: Builder Field
                    803: 
                    804: : struct  T 0 1 chars H ;
                    805: : end-struct  T 2Constant H ;
                    806: 
                    807: : cells: ( n -- size align )
                    808:     T cells 1 cells H ;
                    809: 
                    810: \ ' 2Constant Alias2 end-struct
                    811: \ 0 1 T Chars H 2Constant struct
1.1       anton     812: 
                    813: \ structural conditionals                              17dec92py
                    814: 
                    815: >CROSS
                    816: : ?struc      ( flag -- )       ABORT" CROSS: unstructured " ;
                    817: : sys?        ( sys -- sys )    dup 0= ?struc ;
                    818: : >mark       ( -- sys )        T here  0 , H ;
                    819: : >resolve    ( sys -- )        T here over - swap ! H ;
                    820: : <resolve    ( sys -- )        T here - , H ;
                    821: >TARGET
                    822: 
                    823: \ Structural Conditionals                              12dec92py
                    824: 
                    825: Cond: BUT       restrict? sys? swap ;Cond
                    826: Cond: YET       restrict? sys? dup ;Cond
                    827: 
                    828: >CROSS
                    829: Variable tleavings
                    830: >TARGET
                    831: 
                    832: Cond: DONE   ( addr -- )  restrict? tleavings @
                    833:       BEGIN  2dup u> 0=  WHILE  dup T @ H swap >resolve REPEAT
                    834:       tleavings ! drop ;Cond
                    835: 
                    836: >CROSS
                    837: : (leave  T here H tleavings @ T , H  tleavings ! ;
                    838: >TARGET
                    839: 
                    840: Cond: LEAVE     restrict? compile branch (leave ;Cond
                    841: Cond: ?LEAVE    restrict? compile 0=  compile ?branch (leave  ;Cond
                    842: 
                    843: \ Structural Conditionals                              12dec92py
                    844: 
                    845: Cond: AHEAD     restrict? compile branch >mark ;Cond
                    846: Cond: IF        restrict? compile ?branch >mark ;Cond
                    847: Cond: THEN      restrict? sys? dup T @ H ?struc >resolve ;Cond
                    848: Cond: ELSE      restrict? sys? compile AHEAD swap compile THEN ;Cond
                    849: 
                    850: Cond: BEGIN     restrict? T here H ;Cond
                    851: Cond: WHILE     restrict? sys? compile IF swap ;Cond
                    852: Cond: AGAIN     restrict? sys? compile branch <resolve ;Cond
                    853: Cond: UNTIL     restrict? sys? compile ?branch <resolve ;Cond
                    854: Cond: REPEAT    restrict? over 0= ?struc compile AGAIN compile THEN ;Cond
                    855: 
                    856: \ Structural Conditionals                              12dec92py
                    857: 
                    858: Cond: DO        restrict? compile (do)   T here H ;Cond
                    859: Cond: ?DO       restrict? compile (?do)  (leave T here H ;Cond
                    860: Cond: FOR       restrict? compile (for)  T here H ;Cond
                    861: 
                    862: >CROSS
                    863: : loop]   dup <resolve cell - compile DONE compile unloop ;
                    864: >TARGET
                    865: 
                    866: Cond: LOOP      restrict? sys? compile (loop)  loop] ;Cond
                    867: Cond: +LOOP     restrict? sys? compile (+loop) loop] ;Cond
                    868: Cond: NEXT      restrict? sys? compile (next)  loop] ;Cond
                    869: 
                    870: \ String words                                         23feb93py
                    871: 
                    872: : ,"            [char] " parse string, T align H ;
                    873: 
                    874: Cond: ."        restrict? compile (.")     T ," H ;Cond
                    875: Cond: S"        restrict? compile (S")     T ," H ;Cond
                    876: Cond: ABORT"    restrict? compile (ABORT") T ," H ;Cond
                    877: 
                    878: Cond: IS        T ' >body H compile ALiteral compile ! ;Cond
                    879: : IS            T ' >body ! H ;
1.9       pazsan    880: Cond: TO        T ' >body H compile ALiteral compile ! ;Cond
                    881: : TO            T ' >body ! H ;
1.1       anton     882: 
                    883: \ LINKED ERR" ENV" 2ENV"                                18may93jaw
                    884: 
                    885: \ linked list primitive
                    886: : linked        T here over @ A, swap ! H ;
                    887: 
                    888: : err"   s" ErrLink linked" evaluate T , H
                    889:          [char] " parse string, T align H ;
                    890: 
                    891: : env"  [char] " parse s" EnvLink linked" evaluate
                    892:         string, T align , H ;
                    893: 
                    894: : 2env" [char] " parse s" EnvLink linked" evaluate
                    895:         here >r string, T align , , H
                    896:         r> dup T c@ H 80 and swap T c! H ;
                    897: 
                    898: \ compile must be last                                 22feb93py
                    899: 
                    900: Cond: compile ( -- ) restrict? \ name
1.13      pazsan    901:       bl word gfind dup 0= ABORT" CROSS: Can't compile"
1.1       anton     902:       0> IF    gexecute
                    903:          ELSE  dup >magic @ <imm> =
                    904:                IF   gexecute
                    905:                ELSE compile (compile) gexecute THEN THEN ;Cond
                    906: 
                    907: Cond: postpone ( -- ) restrict? \ name
1.13      pazsan    908:       bl word gfind dup 0= ABORT" CROSS: Can't compile"
1.1       anton     909:       0> IF    gexecute
                    910:          ELSE  dup >magic @ <imm> =
                    911:                IF   gexecute
                    912:                ELSE compile (compile) gexecute THEN THEN ;Cond
                    913: 
                    914: >MINIMAL
                    915: also minimal
                    916: \ Usefull words                                        13feb93py
                    917: 
                    918: : KB  400 * ;
                    919: 
                    920: \ define new [IFDEF] and [IFUNDEF]                      20may93jaw
                    921: 
1.43    ! pazsan    922: : defined? defined? ;
1.1       anton     923: 
1.43    ! pazsan    924: : [IFDEF] defined? postpone [IF] ;
        !           925: : [IFUNDEF] defined? 0= postpone [IF] ;
1.1       anton     926: 
                    927: \ C: \- \+ Conditional Compiling                         09jun93jaw
                    928: 
1.43    ! pazsan    929: : C: >in @ defined? 0=
1.1       anton     930:      IF    >in ! T : H
                    931:      ELSE drop
                    932:         BEGIN bl word dup c@
                    933:               IF   count comment? s" ;" compare 0= ?EXIT
                    934:               ELSE refill 0= ABORT" CROSS: Out of Input while C:"
                    935:               THEN
                    936:         AGAIN
                    937:      THEN ;
                    938: 
                    939: also minimal
                    940: 
1.43    ! pazsan    941: : \- defined? IF postpone \ THEN ;
        !           942: : \+ defined? 0= IF postpone \ THEN ;
1.1       anton     943: 
                    944: : [IF]   postpone [IF] ;
                    945: : [THEN] postpone [THEN] ;
                    946: : [ELSE] postpone [ELSE] ;
                    947: 
                    948: Cond: [IF]      [IF] ;Cond
                    949: Cond: [IFDEF]   [IFDEF] ;Cond
                    950: Cond: [IFUNDEF] [IFUNDEF] ;Cond
                    951: Cond: [THEN]    [THEN] ;Cond
                    952: Cond: [ELSE]    [ELSE] ;Cond
                    953: 
                    954: \ save-cross                                           17mar93py
                    955: 
                    956: \ i'm not interested in bigforth features this time    10may93jaw
                    957: \ [IFDEF] file
                    958: \ also file
                    959: \ [THEN]
                    960: \ included throw after create-file                     11may93jaw
                    961: 
1.12      anton     962: bigendian Constant bigendian
1.1       anton     963: 
1.34      anton     964: Create magic  s" Gforth10" here over allot swap move
1.26      pazsan    965: 
1.35      anton     966: char 1 bigendian + cell + magic 7 + c!
1.26      pazsan    967: 
1.34      anton     968: : save-cross ( "image-name" "binary-name" -- )
                    969:   bl parse ." Saving to " 2dup type cr
1.1       anton     970:   w/o bin create-file throw >r
1.43    ! pazsan    971:   NIL IF
        !           972:       s" #! "   r@ write-file throw
        !           973:       bl parse  r@ write-file throw
        !           974:       s"  -i"   r@ write-file throw
        !           975:       #lf       r@ emit-file throw
        !           976:       r@ dup file-position throw drop 8 mod 8 swap ( file-id limit index )
        !           977:       ?do
        !           978:          bl over emit-file throw
        !           979:       loop
        !           980:       drop
        !           981:       magic 8       r@ write-file throw \ write magic
        !           982:   ELSE
        !           983:       bl parse 2drop
        !           984:   THEN
1.16      pazsan    985:   image @ there r@ write-file throw \ write image
1.43    ! pazsan    986:   NIL IF
        !           987:       bit$  @ there 1- cell>bit rshift 1+
1.16      pazsan    988:                 r@ write-file throw \ write tags
1.43    ! pazsan    989:   THEN
1.1       anton     990:   r> close-file throw ;
                    991: 
                    992: \ words that should be in minimal
                    993: 
1.43    ! pazsan    994: : here there ;
        !           995: also forth [IFDEF] Label : Label Label ; [THEN] previous
        !           996: : + + ;
        !           997: : or or ;
        !           998: : 1- 1- ;
        !           999: : - - ;
        !          1000: : 2* 2* ;
        !          1001: : * * ;
        !          1002: : / / ;
        !          1003: : dup dup ;
        !          1004: : over over ;
        !          1005: : swap swap ;
        !          1006: : rot rot ;
        !          1007: : drop drop ;
        !          1008: : =   = ;
        !          1009: : 0=   0= ;
        !          1010: : lshift lshift ;
        !          1011: : 2/ 2/ ;
1.19      pazsan   1012: : . . ;
1.42      pazsan   1013: 
                   1014: mach-file count included
1.1       anton    1015: 
1.43    ! pazsan   1016: : all-words    ['] false    IS skip? ;
        !          1017: : needed-words ['] needed?  IS skip? ;
        !          1018: : undef-words  ['] defined? IS skip? ;
1.1       anton    1019: 
1.40      pazsan   1020: : \  postpone \ ;  immediate
                   1021: : (  postpone ( ;  immediate
1.1       anton    1022: : include bl word count included ;
                   1023: : .( [char] ) parse type ;
                   1024: : cr cr ;
                   1025: 
                   1026: : times 0 ?DO dup T c, H LOOP drop ; \ used for space table creation
                   1027: only forth also minimal definitions
                   1028: 
                   1029: \ cross-compiler words
                   1030: 
                   1031: : decimal       decimal ;
                   1032: : hex           hex ;
                   1033: 
1.3       pazsan   1034: : tudp          T tudp H ;
1.39      pazsan   1035: : tup           T tup H ;
                   1036: 
                   1037: : doc-off       false T to-doc H ! ;
                   1038: : doc-on        true  T to-doc H ! ;
                   1039: 
                   1040: minimal
1.1       anton    1041: 
                   1042: \ for debugging...
                   1043: : order         order ;
                   1044: : words         words ;
                   1045: : .s            .s ;
                   1046: 
                   1047: : bye           bye ;
                   1048: 
                   1049: \ turnkey direction
                   1050: : H forth ; immediate
                   1051: : T minimal ; immediate
                   1052: : G ghosts ; immediate
                   1053: 
                   1054: : turnkey  0 set-order also Target definitions
                   1055:            also Minimal also ;
                   1056: 
                   1057: \ these ones are pefered:
                   1058: 
                   1059: : lock   turnkey ;
                   1060: : unlock forth also cross ;
                   1061: 
                   1062: unlock definitions also minimal
                   1063: : lock   lock ;
                   1064: lock

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