Annotation of gforth/cross.fs, revision 1.139

1.1       anton       1: \ CROSS.FS     The Cross-Compiler                      06oct92py
                      2: \ Idea and implementation: Bernd Paysan (py)
1.30      anton       3: 
1.138     anton       4: \ Copyright (C) 1995,1996,1997,1998,1999,2000,2003 Free Software Foundation, Inc.
1.30      anton       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
1.87      anton      20: \ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
1.1       anton      21: 
1.67      jwilke     22: 0 
                     23: [IF]
                     24: 
                     25: ToDo:
1.107     jwilke     26: - Crossdoc destination ./doc/crossdoc.fd makes no sense when
                     27:   cross.fs is used seperately. jaw
                     28: - Do we need this char translation with >address and in branchoffset? 
                     29:   (>body also affected) jaw
1.67      jwilke     30: 
                     31: [THEN]
1.48      anton      32: 
1.128     anton      33: s" compat/strcomp.fs" included
                     34: 
1.77      jwilke     35: hex
                     36: 
                     37: \ debugging for compiling
                     38: 
                     39: \ print stack at each colon definition
                     40: \ : : save-input cr bl word count type restore-input throw .s : ;
                     41: 
                     42: \ print stack at each created word
                     43: \ : create save-input cr bl word count type restore-input throw .s create ;
                     44: 
                     45: 
                     46: \ \ -------------  Setup Vocabularies
                     47: 
                     48: \ Remark: Vocabulary is not ANS, but it should work...
                     49: 
                     50: Vocabulary Cross
                     51: Vocabulary Target
                     52: Vocabulary Ghosts
                     53: Vocabulary Minimal
                     54: only Forth also Target also also
                     55: definitions Forth
                     56: 
1.78      jwilke     57: : T  previous Ghosts also Target ; immediate
1.77      jwilke     58: : G  Ghosts ; immediate
                     59: : H  previous Forth also Cross ; immediate
                     60: 
                     61: forth definitions
                     62: 
1.78      jwilke     63: : T  previous Ghosts also Target ; immediate
1.77      jwilke     64: : G  Ghosts ; immediate
                     65: 
1.105     jwilke     66: 
1.77      jwilke     67: : >cross  also Cross definitions previous ;
                     68: : >target also Target definitions previous ;
                     69: : >minimal also Minimal definitions previous ;
                     70: 
                     71: H
                     72: 
                     73: >CROSS
                     74: 
1.123     jwilke     75: \ Test against this definitions to find out whether we are cross-compiling
                     76: \ may be usefull for assemblers
                     77: 0 Constant gforth-cross-indicator
                     78: 
1.77      jwilke     79: \ find out whether we are compiling with gforth
                     80: 
                     81: : defined? bl word find nip ;
                     82: defined? emit-file defined? toupper and \ drop 0
                     83: [IF]
                     84: \ use this in a gforth system
                     85: : \GFORTH ; immediate
                     86: : \ANSI postpone \ ; immediate
                     87: [ELSE]
                     88: : \GFORTH postpone \ ; immediate
                     89: : \ANSI ; immediate
                     90: [THEN]
                     91: 
                     92: \ANSI : [IFUNDEF] defined? 0= postpone [IF] ; immediate
                     93: \ANSI : [IFDEF] defined? postpone [IF] ; immediate
                     94: 0 \ANSI drop 1
                     95: [IF]
                     96: : \G postpone \ ; immediate
                     97: : rdrop postpone r> postpone drop ; immediate
                     98: : name bl word count ;
                     99: : bounds over + swap ;
                    100: : scan >r BEGIN dup WHILE over c@ r@ <> WHILE 1 /string REPEAT THEN rdrop ;
                    101: : linked here over @ , swap ! ;
                    102: : alias create , DOES> @ EXECUTE ;
                    103: : defer ['] noop alias ;
                    104: : is state @ 
                    105:   IF ' >body postpone literal postpone ! 
                    106:   ELSE ' >body ! THEN ; immediate
                    107: : 0>= 0< 0= ;
                    108: : d<> rot <> -rot <> or ;
                    109: : toupper dup [char] a [char] z 1+ within IF [char] A [char] a - + THEN ;
                    110: Variable ebuf
                    111: : emit-file ( c fd -- ior ) swap ebuf c! ebuf 1 chars rot write-file ;
                    112: 0a Constant #lf
                    113: 0d Constant #cr
                    114: 
                    115: [IFUNDEF] Warnings Variable Warnings [THEN]
                    116: 
                    117: \ \ Number parsing                                     23feb93py
                    118: 
                    119: \ number? number                                       23feb93py
                    120: 
                    121: Variable dpl
                    122: 
                    123: hex
                    124: Create bases   10 ,   2 ,   A , 100 ,
                    125: \              16     2    10   character
                    126: 
                    127: \ !! protect BASE saving wrapper against exceptions
                    128: : getbase ( addr u -- addr' u' )
                    129:     over c@ [char] $ - dup 4 u<
                    130:     IF
                    131:        cells bases + @ base ! 1 /string
                    132:     ELSE
                    133:        drop
                    134:     THEN ;
                    135: 
                    136: : sign? ( addr u -- addr u flag )
                    137:     over c@ [char] - =  dup >r
                    138:     IF
                    139:        1 /string
                    140:     THEN
                    141:     r> ;
                    142: 
                    143: : s>unumber? ( addr u -- ud flag )
1.78      jwilke    144:     over [char] ' =
                    145:     IF         \ a ' alone is rather unusual :-)
                    146:        drop char+ c@ 0 true EXIT 
                    147:     THEN
1.77      jwilke    148:     base @ >r  dpl on  getbase
                    149:     0. 2swap
                    150:     BEGIN ( d addr len )
                    151:        dup >r >number dup
                    152:     WHILE \ there are characters left
                    153:        dup r> -
                    154:     WHILE \ the last >number parsed something
                    155:        dup 1- dpl ! over c@ [char] . =
                    156:     WHILE \ the current char is '.'
                    157:        1 /string
                    158:     REPEAT  THEN \ there are unparseable characters left
                    159:        2drop false
                    160:     ELSE
                    161:        rdrop 2drop true
                    162:     THEN
                    163:     r> base ! ;
                    164: 
                    165: \ ouch, this is complicated; there must be a simpler way - anton
                    166: : s>number? ( addr len -- d f )
                    167:     \ converts string addr len into d, flag indicates success
                    168:     sign? >r
                    169:     s>unumber?
                    170:     0= IF
                    171:         rdrop false
                    172:     ELSE \ no characters left, all ok
                    173:        r>
                    174:        IF
                    175:            dnegate
                    176:        THEN
                    177:        true
                    178:     THEN ;
                    179: 
                    180: : s>number ( addr len -- d )
                    181:     \ don't use this, there is no way to tell success
                    182:     s>number? drop ;
                    183: 
                    184: : snumber? ( c-addr u -- 0 / n -1 / d 0> )
                    185:     s>number? 0=
                    186:     IF
                    187:        2drop false  EXIT
                    188:     THEN
                    189:     dpl @ dup 0< IF
                    190:        nip
                    191:     ELSE
                    192:        1+
                    193:     THEN ;
                    194: 
                    195: : number? ( string -- string 0 / n -1 / d 0> )
                    196:     dup >r count snumber? dup if
                    197:        rdrop
                    198:     else
                    199:        r> swap
                    200:     then ;
                    201: 
                    202: : number ( string -- d )
                    203:     number? ?dup 0= abort" ?"  0<
                    204:     IF
                    205:        s>d
                    206:     THEN ;
                    207: 
                    208: [THEN]
1.48      anton     209: 
1.115     jwilke    210: \ this provides assert( and struct stuff
                    211: \GFORTH [IFUNDEF] assert1(
                    212: \GFORTH also forth definitions require assert.fs previous
                    213: \GFORTH [THEN]
                    214: 
                    215: >CROSS
                    216: 
1.52      jwilke    217: hex     \ the defualt base for the cross-compiler is hex !!
1.78      jwilke    218: \ Warnings off
1.52      jwilke    219: 
                    220: \ words that are generaly useful
                    221: 
1.59      pazsan    222: : KB  400 * ;
1.52      jwilke    223: : >wordlist ( vocabulary-xt -- wordlist-struct )
                    224:   also execute get-order swap >r 1- set-order r> ;
                    225: 
                    226: : umax 2dup u< IF swap THEN drop ;
                    227: : umin 2dup u> IF swap THEN drop ;
1.1       anton     228: 
1.23      pazsan    229: : string, ( c-addr u -- )
                    230:     \ puts down string as cstring
                    231:     dup c, here swap chars dup allot move ;
1.5       pazsan    232: 
1.77      jwilke    233: : ," [char] " parse string, ;
                    234: 
1.52      jwilke    235: : SetValue ( n -- <name> )
1.54      pazsan    236: \G Same behaviour as "Value" if the <name> is not defined
                    237: \G Same behaviour as "to" if <name> is defined
1.52      jwilke    238: \G SetValue searches in the current vocabulary
1.68      jwilke    239:   save-input bl word >r restore-input throw r> count
                    240:   get-current search-wordlist
                    241:   IF   drop >r
                    242:        \ we have to set current to be topmost context wordlist
                    243:        get-order get-order get-current swap 1+ set-order
                    244:        r> ['] to execute
1.74      jwilke    245:        set-order
1.68      jwilke    246:   ELSE Value THEN ;
1.52      jwilke    247: 
                    248: : DefaultValue ( n -- <name> )
1.54      pazsan    249: \G Same behaviour as "Value" if the <name> is not defined
                    250: \G DefaultValue searches in the current vocabulary
1.52      jwilke    251:  save-input bl word >r restore-input throw r> count
                    252:  get-current search-wordlist
1.56      pazsan    253:  IF bl word drop 2drop ELSE Value THEN ;
1.1       anton     254: 
                    255: hex
                    256: 
1.120     jwilke    257: \ FIXME delete`
1.52      jwilke    258: \ 1 Constant Cross-Flag        \ to check whether assembler compiler plug-ins are
                    259:                        \ for cross-compiling
                    260: \ No! we use "[IFUNDEF]" there to find out whether we are target compiling!!!
                    261: 
1.120     jwilke    262: \ FIXME move down
1.52      jwilke    263: : comment? ( c-addr u -- c-addr u )
1.128     anton     264:         2dup s" (" str=
1.52      jwilke    265:         IF    postpone (
1.128     anton     266:         ELSE  2dup s" \" str= IF postpone \ THEN
1.52      jwilke    267:         THEN ;
                    268: 
1.120     jwilke    269: : X ( -- <name> )
                    270: \G The next word in the input is a target word.
                    271: \G Equivalent to T <name> but without permanent
                    272: \G switch to target dictionary. Used as prefix e.g. for @, !, here etc.
                    273:   bl word count [ ' target >wordlist ] Literal search-wordlist
                    274:   IF state @ IF compile, ELSE execute THEN
                    275:   ELSE -1 ABORT" Cross: access method not supported!"
                    276:   THEN ; immediate
1.105     jwilke    277: 
1.52      jwilke    278: \ Begin CROSS COMPILER:
                    279: 
1.74      jwilke    280: \ debugging
1.52      jwilke    281: 
1.74      jwilke    282: 0 [IF]
                    283: 
                    284: This implements debugflags for the cross compiler and the compiled
                    285: images. It works identical to the has-flags in the environment.
                    286: The debugflags are defined in a vocabluary. If the word exists and
                    287: its value is true, the flag is switched on.
                    288: 
                    289: [THEN]
                    290: 
1.77      jwilke    291: >CROSS
                    292: 
1.74      jwilke    293: Vocabulary debugflags  \ debug flags for cross
                    294: also debugflags get-order over
                    295: Constant debugflags-wl
                    296: set-order previous
                    297: 
                    298: : DebugFlag
                    299:   get-current >r debugflags-wl set-current
                    300:   SetValue
                    301:   r> set-current ;
                    302: 
                    303: : Debug? ( adr u -- flag )
                    304: \G return true if debug flag is defined or switched on
                    305:   debugflags-wl search-wordlist
                    306:   IF EXECUTE
                    307:   ELSE false THEN ;
                    308: 
                    309: : D? ( <name> -- flag )
                    310: \G return true if debug flag is defined or switched on
                    311: \G while compiling we do not return the current value but
                    312:   bl word count debug? ;
                    313: 
                    314: : [d?]
                    315: \G compile the value-xt so the debug flag can be switched
                    316: \G the flag must exist!
                    317:   bl word count debugflags-wl search-wordlist
                    318:   IF   compile,
                    319:   ELSE  -1 ABORT" unknown debug flag"
                    320:        \ POSTPONE false 
                    321:   THEN ; immediate
1.54      pazsan    322: 
1.123     jwilke    323: : symentry ( adr len taddr -- )
                    324: \G Produce a symbol table (an optional symbol address
                    325: \G map) if wanted
                    326:     [ [IFDEF] fd-symbol-table ]
                    327:       base @ swap hex s>d <# 8 0 DO # LOOP #> fd-symbol-table write-file throw base !
                    328:       s" :" fd-symbol-table write-file throw
                    329:       fd-symbol-table write-line throw
                    330:     [ [ELSE] ]
                    331:       2drop drop
                    332:     [ [THEN] ] ;
                    333: 
                    334: 
1.77      jwilke    335: \ \ --------------------       source file
                    336: 
                    337: decimal
                    338: 
                    339: Variable cross-file-list
                    340: 0 cross-file-list !
                    341: Variable target-file-list
                    342: 0 target-file-list !
                    343: Variable host-file-list
                    344: 0 host-file-list !
                    345: 
                    346: cross-file-list Value file-list
                    347: 0 Value source-desc
                    348: 
                    349: \ file loading
                    350: 
                    351: : >fl-id   1 cells + ;
                    352: : >fl-name 2 cells + ;
                    353: 
                    354: Variable filelist 0 filelist !
                    355: Create NoFile ," #load-file#"
                    356: 
                    357: : loadfile ( -- adr )
                    358:   source-desc ?dup IF >fl-name ELSE NoFile THEN ;
                    359: 
                    360: : sourcefilename ( -- adr len ) 
                    361:   loadfile count ;
                    362: 
                    363: \ANSI : sourceline# 0 ;
                    364: 
                    365: \ \ --------------------       path handling from kernel/paths.fs
                    366: 
                    367: \ paths.fs path file handling                                    03may97jaw
                    368: 
                    369: \ -Changing the search-path:
                    370: \ fpath+ <path>        adds a directory to the searchpath
                    371: \ fpath= <path>|<path> makes complete now searchpath
                    372: \                      seperator is |
                    373: \ .fpath               displays the search path
                    374: \ remark I: 
                    375: \ a ./ in the beginning of filename is expanded to the directory the
                    376: \ current file comes from. ./ can also be included in the search-path!
                    377: \ ~+/ loads from the current working directory
                    378: 
                    379: \ remark II:
                    380: \ if there is no sufficient space for the search path increase it!
                    381: 
                    382: 
                    383: \ -Creating custom paths:
                    384: 
                    385: \ It is possible to use the search mechanism on yourself.
                    386: 
                    387: \ Make a buffer for the path:
                    388: \ create mypath        100 chars ,     \ maximum length (is checked)
                    389: \              0 ,             \ real len
                    390: \              100 chars allot \ space for path
                    391: \ use the same functions as above with:
                    392: \ mypath path+ 
                    393: \ mypath path=
                    394: \ mypath .path
                    395: 
                    396: \ do a open with the search path:
                    397: \ open-path-file ( adr len path -- fd adr len ior )
                    398: \ the file is opened read-only; if the file is not found an error is generated
                    399: 
                    400: \ questions to: wilke@jwdt.com
                    401: 
                    402: [IFUNDEF] +place
                    403: : +place ( adr len adr )
                    404:         2dup >r >r
                    405:         dup c@ char+ + swap move
                    406:         r> r> dup c@ rot + swap c! ;
                    407: [THEN]
                    408: 
                    409: [IFUNDEF] place
                    410: : place ( c-addr1 u c-addr2 )
                    411:         2dup c! char+ swap move ;
                    412: [THEN]
                    413: 
                    414: \ if we have path handling, use this and the setup of it
                    415: [IFUNDEF] open-fpath-file
                    416: 
                    417: create sourcepath 1024 chars , 0 , 1024 chars allot \ !! make this dynamic
                    418: sourcepath value fpath
                    419: 
                    420: : also-path ( adr len path^ -- )
                    421:   >r
                    422:   \ len check
                    423:   r@ cell+ @ over + r@ @ u> ABORT" path buffer too small!"
                    424:   \ copy into
                    425:   tuck r@ cell+ dup @ cell+ + swap cmove
                    426:   \ make delimiter
                    427:   0 r@ cell+ dup @ cell+ + 2 pick + c! 1 + r> cell+ +!
                    428:   ;
                    429: 
                    430: : only-path ( adr len path^ -- )
                    431:   dup 0 swap cell+ ! also-path ;
                    432: 
                    433: : path+ ( path-addr  "dir" -- ) \ gforth
                    434:     \G Add the directory @var{dir} to the search path @var{path-addr}.
                    435:     name rot also-path ;
                    436: 
                    437: : fpath+ ( "dir" ) \ gforth
                    438:     \G Add directory @var{dir} to the Forth search path.
                    439:     fpath path+ ;
                    440: 
                    441: : path= ( path-addr "dir1|dir2|dir3" ) \ gforth
                    442:     \G Make a complete new search path; the path separator is |.
                    443:     name 2dup bounds ?DO i c@ [char] | = IF 0 i c! THEN LOOP
                    444:     rot only-path ;
                    445: 
                    446: : fpath= ( "dir1|dir2|dir3" ) \ gforth
                    447:     \G Make a complete new Forth search path; the path separator is |.
                    448:     fpath path= ;
                    449: 
                    450: : path>counted  cell+ dup cell+ swap @ ;
                    451: 
                    452: : next-path ( adr len -- adr2 len2 )
                    453:   2dup 0 scan
                    454:   dup 0= IF     2drop 0 -rot 0 -rot EXIT THEN
                    455:   >r 1+ -rot r@ 1- -rot
                    456:   r> - ;
                    457: 
                    458: : previous-path ( path^ -- )
                    459:   dup path>counted
                    460:   BEGIN tuck dup WHILE repeat ;
                    461: 
                    462: : .path ( path-addr -- ) \ gforth
                    463:     \G Display the contents of the search path @var{path-addr}.
                    464:     path>counted
                    465:     BEGIN next-path dup WHILE type space REPEAT 2drop 2drop ;
                    466: 
                    467: : .fpath ( -- ) \ gforth
                    468:     \G Display the contents of the Forth search path.
                    469:     fpath .path ;
                    470: 
                    471: : absolut-path? ( addr u -- flag ) \ gforth
                    472:     \G A path is absolute if it starts with a / or a ~ (~ expansion),
                    473:     \G or if it is in the form ./*, extended regexp: ^[/~]|./, or if
                    474:     \G it has a colon as second character ("C:...").  Paths simply
                    475:     \G containing a / are not absolute!
                    476:     2dup 2 u> swap 1+ c@ [char] : = and >r \ dos absoulte: c:/....
                    477:     over c@ [char] / = >r
                    478:     over c@ [char] ~ = >r
1.128     anton     479:     \ 2dup S" ../" string-prefix? r> or >r \ not catered for in expandtopic
                    480:     S" ./" string-prefix?
1.77      jwilke    481:     r> r> r> or or or ;
                    482: 
                    483: Create ofile 0 c, 255 chars allot
                    484: Create tfile 0 c, 255 chars allot
                    485: 
                    486: : pathsep? dup [char] / = swap [char] \ = or ;
                    487: 
                    488: : need/   ofile dup c@ + c@ pathsep? 0= IF s" /" ofile +place THEN ;
                    489: 
                    490: : extractpath ( adr len -- adr len2 )
                    491:   BEGIN dup WHILE 1-
                    492:         2dup + c@ pathsep? IF EXIT THEN
                    493:   REPEAT ;
                    494: 
                    495: : remove~+ ( -- )
1.128     anton     496:     ofile count s" ~+/" string-prefix?
1.77      jwilke    497:     IF
                    498:        ofile count 3 /string ofile place
                    499:     THEN ;
                    500: 
                    501: : expandtopic ( -- ) \ stack effect correct? - anton
                    502:     \ expands "./" into an absolute name
1.128     anton     503:     ofile count s" ./" string-prefix?
1.77      jwilke    504:     IF
                    505:        ofile count 1 /string tfile place
                    506:        0 ofile c! sourcefilename extractpath ofile place
                    507:        ofile c@ IF need/ THEN
                    508:        tfile count over c@ pathsep? IF 1 /string THEN
                    509:        ofile +place
                    510:     THEN ;
                    511: 
                    512: : compact.. ( adr len -- adr2 len2 )
1.85      pazsan    513:     \ deletes phrases like "xy/.." out of our directory name 2dec97jaw
                    514:     over swap
                    515:     BEGIN  dup  WHILE
1.128     anton     516:         dup >r '/ scan 2dup s" /../" string-prefix?
1.85      pazsan    517:         IF
                    518:             dup r> - >r 4 /string over r> + 4 -
                    519:             swap 2dup + >r move dup r> over -
                    520:         ELSE
                    521:             rdrop dup 1 min /string
                    522:         THEN
                    523:     REPEAT  drop over - ;
1.77      jwilke    524: 
                    525: : reworkdir ( -- )
                    526:   remove~+
                    527:   ofile count compact..
                    528:   nip ofile c! ;
                    529: 
                    530: : open-ofile ( -- fid ior )
                    531:     \G opens the file whose name is in ofile
                    532:     expandtopic reworkdir
                    533:     ofile count r/o open-file ;
                    534: 
                    535: : check-path ( adr1 len1 adr2 len2 -- fd 0 | 0 <>0 )
                    536:   0 ofile ! >r >r ofile place need/
                    537:   r> r> ofile +place
                    538:   open-ofile ;
                    539: 
                    540: : open-path-file ( addr1 u1 path-addr -- wfileid addr2 u2 0 | ior ) \ gforth
                    541:     \G Look in path @var{path-addr} for the file specified by @var{addr1 u1}.
                    542:     \G If found, the resulting path and an open file descriptor
                    543:     \G are returned. If the file is not found, @var{ior} is non-zero.
                    544:   >r
                    545:   2dup absolut-path?
                    546:   IF    rdrop
                    547:         ofile place open-ofile
                    548:        dup 0= IF >r ofile count r> THEN EXIT
                    549:   ELSE  r> path>counted
                    550:         BEGIN  next-path dup
                    551:         WHILE  5 pick 5 pick check-path
                    552:         0= IF >r 2drop 2drop r> ofile count 0 EXIT ELSE drop THEN
                    553:   REPEAT
                    554:         2drop 2drop 2drop -38
                    555:   THEN ;
                    556: 
                    557: : open-fpath-file ( addr1 u1 -- wfileid addr2 u2 0 | ior ) \ gforth
                    558:     \G Look in the Forth search path for the file specified by @var{addr1 u1}.
                    559:     \G If found, the resulting path and an open file descriptor
                    560:     \G are returned. If the file is not found, @var{ior} is non-zero.
                    561:     fpath open-path-file ;
                    562: 
                    563: fpath= ~+
                    564: 
                    565: [THEN]
                    566: 
                    567: \ \ --------------------       include require                 13may99jaw
                    568: 
                    569: >CROSS
                    570: 
                    571: : add-included-file ( adr len -- adr )
                    572:   dup >fl-name char+ allocate throw >r
                    573:   file-list @ r@ ! r@ file-list !
                    574:   r@ >fl-name place r> ;
                    575: 
                    576: : included? ( c-addr u -- f )
                    577:   file-list
                    578:   BEGIN        @ dup
1.128     anton     579:   WHILE        >r 2dup r@ >fl-name count str=
1.77      jwilke    580:        IF rdrop 2drop true EXIT THEN
                    581:        r>
                    582:   REPEAT
                    583:   2drop drop false ;   
                    584: 
                    585: false DebugFlag showincludedfiles
                    586: 
                    587: : included1 ( fd adr u -- )
                    588: \ include file adr u / fd
                    589: \ we don't use fd with include-file, because the forth system
                    590: \ doesn't know the name of the file to get a nice error report
                    591:   [d?] showincludedfiles
                    592:   IF   cr ." Including: " 2dup type ." ..." THEN
                    593:   rot close-file throw
                    594:   source-desc >r
                    595:   add-included-file to source-desc 
                    596:   sourcefilename
                    597:   ['] included catch
                    598:   r> to source-desc 
                    599:   throw ;
                    600: 
                    601: : included ( adr len -- )
                    602:        cross-file-list to file-list
                    603:        open-fpath-file throw 
                    604:         included1 ;
                    605: 
                    606: : required ( adr len -- )
                    607:        cross-file-list to file-list
                    608:        open-fpath-file throw \ 2dup cr ." R:" type
                    609:        2dup included?
                    610:        IF      2drop close-file throw
                    611:        ELSE    included1
                    612:        THEN ;
                    613: 
                    614: : include bl word count included ;
                    615: 
                    616: : require bl word count required ;
                    617: 
1.78      jwilke    618: 0 [IF]
                    619: 
1.77      jwilke    620: also forth definitions previous
                    621: 
                    622: : included ( adr len -- ) included ;
                    623: 
                    624: : required ( adr len -- ) required ;
                    625: 
                    626: : include include ;
                    627: 
                    628: : require require ;
                    629: 
1.78      jwilke    630: [THEN]
                    631: 
1.77      jwilke    632: >CROSS
                    633: hex
                    634: 
                    635: \ \ --------------------        Error Handling                  05aug97jaw
                    636: 
                    637: \ Flags
                    638: 
                    639: also forth definitions  \ these values may be predefined before
                    640:                         \ the cross-compiler is loaded
                    641: 
                    642: false DefaultValue stack-warn           \ check on empty stack at any definition
                    643: false DefaultValue create-forward-warn   \ warn on forward declaration of created words
                    644: 
                    645: previous >CROSS
                    646: 
                    647: : .dec
                    648:   base @ decimal swap . base ! ;
                    649: 
                    650: : .sourcepos
                    651:   cr sourcefilename type ." :"
                    652:   sourceline# .dec ;
                    653: 
                    654: : warnhead
                    655: \G display error-message head
                    656: \G perhaps with linenumber and filename
                    657:   .sourcepos ." Warning: " ;
                    658: 
                    659: : empty? depth IF .sourcepos ." Stack not empty!"  THEN ;
                    660: 
                    661: stack-warn [IF]
                    662: : defempty? empty? ;
                    663: [ELSE]
                    664: : defempty? ; immediate
1.139   ! jwilke    665: \ : defempty? .sourcepos ; 
1.77      jwilke    666: [THEN]
                    667: 
1.105     jwilke    668: \ \ --------------------        Compiler Plug Ins               01aug97jaw
                    669: 
                    670: >CROSS
                    671: 
                    672: \ Compiler States
                    673: 
                    674: Variable comp-state
                    675: 0 Constant interpreting
                    676: 1 Constant compiling
                    677: 2 Constant resolving
                    678: 3 Constant assembling
                    679: 
                    680: : compiling? comp-state @ compiling = ;
                    681: 
                    682: : pi-undefined -1 ABORT" Plugin undefined" ;
                    683: 
                    684: : Plugin ( -- : pluginname )
                    685:   Create 
                    686:   \ for normal cross-compiling only one action
                    687:   \ exists, this fields are identical. For the instant
                    688:   \ simulation environment we need, two actions for each plugin
                    689:   \ the target one and the one that generates the simulation code
                    690:   ['] pi-undefined , \ action
                    691:   ['] pi-undefined , \ target plugin action
                    692:   8765 ,     \ plugin magic
                    693:   DOES> perform ;
                    694: 
                    695: Plugin DummyPlugin
                    696: 
                    697: : 'PI ( -- addr : pluginname )
                    698:   ' >body dup 2 cells + @ 8765 <> ABORT" not a plugin" ;
                    699: 
                    700: : plugin-of ( xt -- : pluginname )
                    701:   dup 'PI 2! ;
                    702: 
                    703: : action-of ( xt -- : plunginname )
                    704:   'PI cell+ ! ;
                    705: 
                    706: : TPA ( -- : plugin )
                    707: \ target plugin action
                    708: \ executes current target action of plugin
                    709:   'PI cell+ POSTPONE literal POSTPONE perform ; immediate
                    710: 
                    711: Variable ppi-temp 0 ppi-temp !
                    712: 
                    713: : pa:
                    714: \g define plugin action
                    715:   ppi-temp @ ABORT" pa: definition not closed"
                    716:   'PI ppi-temp ! :noname ;
                    717: 
                    718: : ;pa
                    719: \g end a definition for plugin action
                    720:   POSTPONE ; ppi-temp @ ! 0 ppi-temp ! ; immediate
                    721: 
                    722: 
1.107     jwilke    723: Plugin dlit, ( d -- )                  \ compile numerical value the target
1.105     jwilke    724: Plugin lit, ( n -- )
                    725: Plugin alit, ( n -- )
                    726: 
                    727: Plugin branch, ( target-addr -- )      \ compiles a branch
                    728: Plugin ?branch, ( target-addr -- )     \ compiles a ?branch
                    729: Plugin branchmark, ( -- branch-addr )  \ reserves room for a branch
                    730: Plugin ?branchmark, ( -- branch-addr ) \ reserves room for a ?branch
                    731: Plugin ?domark, ( -- branch-addr )     \ reserves room for a ?do branch
                    732: Plugin branchto, ( -- )                        \ actual program position is target of a branch (do e.g. alignment)
                    733: ' NOOP plugin-of branchto, 
                    734: Plugin branchtoresolve, ( branch-addr -- ) \ resolves a forward reference from branchmark
                    735: Plugin branchtomark, ( -- target-addr )        \ marks a branch destination
                    736: 
                    737: Plugin colon, ( tcfa -- )              \ compiles call to tcfa at current position
                    738: Plugin prim, ( tcfa -- )               \ compiles primitive invocation
                    739: Plugin colonmark, ( -- addr )          \ marks a colon call
                    740: Plugin colon-resolve ( tcfa addr -- )
                    741: 
                    742: Plugin addr-resolve ( target-addr addr -- )
                    743: Plugin doer-resolve ( ghost res-pnt target-addr addr -- ghost res-pnt )
                    744: 
                    745: Plugin ncontrols? ( [ xn ... x1 ] n -- ) \ checks wheter n control structures are open
                    746: Plugin if,     ( -- if-token )
                    747: Plugin else,   ( if-token -- if-token )
                    748: Plugin then,   ( if-token -- )
                    749: Plugin ahead,
                    750: Plugin begin,
                    751: Plugin while,
                    752: Plugin until,
                    753: Plugin again,
                    754: Plugin repeat,
                    755: Plugin cs-swap ( x1 x2 -- x2 x1 )
                    756: 
                    757: Plugin case,   ( -- n )
                    758: Plugin of,     ( n -- x1 n )
                    759: Plugin endof,  ( x1 n -- x2 n )
                    760: Plugin endcase,        ( x1 .. xn n -- )
                    761: 
                    762: Plugin do,     ( -- do-token )
                    763: Plugin ?do,    ( -- ?do-token )
                    764: Plugin for,    ( -- for-token )
                    765: Plugin loop,   ( do-token / ?do-token -- )
                    766: Plugin +loop,  ( do-token / ?do-token -- )
                    767: Plugin next,   ( for-token )
                    768: Plugin leave,  ( -- )
                    769: Plugin ?leave,         ( -- )
                    770: 
1.121     jwilke    771: Plugin ca>native  \ Convert a code address to the processors
                    772:                   \ native address. This is used in doprim, and
                    773:                   \ code/code: primitive definitions word to
                    774:                   \ convert the addresses.
                    775:                   \ The only target where we need this is the misc
                    776:                   \ which is a 16 Bit processor with word addresses
                    777:                   \ but the forth system we build has a normal byte
                    778:                   \ addressed memory model    
1.105     jwilke    779: 
                    780: Plugin doprim, \ compiles start of a primitive
                    781: Plugin docol,          \ compiles start of a colon definition
                    782: Plugin doer,           
                    783: Plugin fini,      \ compiles end of definition ;s
                    784: Plugin doeshandler,
                    785: Plugin dodoes,
                    786: 
                    787: Plugin colon-start
                    788: ' noop plugin-of colon-start
                    789: Plugin colon-end
                    790: ' noop plugin-of colon-end
                    791: 
                    792: Plugin ]comp     \ starts compilation
                    793: ' noop plugin-of ]comp
                    794: Plugin comp[     \ ends compilation
                    795: ' noop plugin-of comp[
                    796: 
                    797: Plugin t>body             \ we need the system >body
                    798:                        \ and the target >body
                    799: 
                    800: >TARGET
                    801: : >body t>body ;
                    802: 
                    803: 
1.103     jwilke    804: \ Ghost Builder                                        06oct92py
                    805: 
1.105     jwilke    806: >CROSS
1.103     jwilke    807: hex
1.105     jwilke    808: \ Values for ghost magic
1.103     jwilke    809: 4711 Constant <fwd>             4712 Constant <res>
                    810: 4713 Constant <imm>             4714 Constant <do:>
                    811: 4715 Constant <skip>
                    812: 
1.105     jwilke    813: \ Bitmask for ghost flags
1.103     jwilke    814: 1 Constant <unique>
1.105     jwilke    815: 2 Constant <primitive>
                    816: 
                    817: \ FXIME: move this to general stuff?
                    818: : set-flag ( addr flag -- )
                    819:   over @ or swap ! ;
                    820: 
                    821: : reset-flag ( addr flag -- )
                    822:   invert over @ and swap ! ;
                    823: 
                    824: : get-flag ( addr flag -- f )
                    825:   swap @ and 0<> ;
                    826:   
1.103     jwilke    827: 
                    828: Struct
1.52      jwilke    829: 
1.103     jwilke    830:   \ link to next ghost (always the first element)
                    831:   cell% field >next-ghost
1.52      jwilke    832: 
1.103     jwilke    833:   \ type of ghost
                    834:   cell% field >magic
                    835:                
                    836:   \ pointer where ghost is in target, or if unresolved
                    837:   \ points to the where we have to resolve (linked-list)
                    838:   cell% field >link
1.52      jwilke    839: 
1.106     jwilke    840:   \ execution semantics (while target compiling) of ghost
1.103     jwilke    841:   cell% field >exec
1.52      jwilke    842: 
1.106     jwilke    843:   \ compilation action of this ghost; this is what is
                    844:   \ done to compile a call (or whatever) to this definition.
                    845:   \ E.g. >comp contains the semantic of postpone s"
                    846:   \ whereas >exec-compile contains the semantic of s"
1.105     jwilke    847:   cell% field >comp
                    848: 
1.106     jwilke    849:   \ Compilation sematics (while parsing) of this ghost. E.g. 
                    850:   \ "\" will skip the rest of line.
                    851:   \ These semantics are defined by Cond: and
                    852:   \ if a word is made immediate in instant, then the >exec2 field
                    853:   \ gets copied to here
1.103     jwilke    854:   cell% field >exec-compile
1.52      jwilke    855: 
1.106     jwilke    856:   \ Additional execution semantics of this ghost. This is used
                    857:   \ for code generated by instant and for the doer-xt of created
                    858:   \ words
1.103     jwilke    859:   cell% field >exec2
1.52      jwilke    860: 
1.103     jwilke    861:   cell% field >created
1.52      jwilke    862: 
1.103     jwilke    863:   \ the xt of the created ghost word itself
                    864:   cell% field >ghost-xt
1.52      jwilke    865: 
1.103     jwilke    866:   \ pointer to the counted string of the assiciated
                    867:   \ assembler label
                    868:   cell% field >asm-name
1.52      jwilke    869: 
1.103     jwilke    870:   \ mapped primitives have a special address, so
                    871:   \ we are able to detect them
                    872:   cell% field >asm-dummyaddr
                    873:                        
                    874:   \ for builder (create, variable...) words
                    875:   \ the execution symantics of words built are placed here
                    876:   \ this is a doer ghost or a dummy ghost
                    877:   cell% field >do:ghost
1.93      pazsan    878: 
1.103     jwilke    879:   cell% field >ghost-flags
1.93      pazsan    880: 
1.103     jwilke    881:   cell% field >ghost-name
1.52      jwilke    882: 
1.103     jwilke    883: End-Struct ghost-struct
1.52      jwilke    884: 
1.103     jwilke    885: Variable ghost-list
                    886: 0 ghost-list !
1.52      jwilke    887: 
                    888: Variable executed-ghost \ last executed ghost, needed in tcreate and gdoes>
1.103     jwilke    889: \ Variable last-ghost  \ last ghost that is created
1.52      jwilke    890: Variable last-header-ghost \ last ghost definitions with header
                    891: 
1.103     jwilke    892: \ space for ghosts resolve structure
                    893: \ we create ghosts in a sepearte space
                    894: \ and not to the current host dp, because this
                    895: \ gives trouble with instant while compiling and creating
                    896: \ a ghost for a forward reference
                    897: \ BTW: we cannot allocate another memory region
                    898: \ because allot will check the overflow!!
                    899: Variable cross-space-dp
                    900: Create cross-space 250000 allot here 100 allot align 
                    901: Constant cross-space-end
                    902: cross-space cross-space-dp !
                    903: Variable cross-space-dp-orig
                    904: 
                    905: : cross-space-used cross-space-dp @ cross-space - ;
                    906: 
                    907: : >space ( -- )
                    908:   dp @ cross-space-dp-orig !
                    909:   cross-space-dp @ dp ! ;
                    910: 
                    911: : space> ( -- )
                    912:   dp @ dup cross-space-dp !
                    913:   cross-space-end u> ABORT" CROSS: cross-space overflow"
                    914:   cross-space-dp-orig @ dp ! ;
                    915: 
1.106     jwilke    916: \ this is just for debugging, to see this in the backtrace
1.103     jwilke    917: : execute-exec execute ;
                    918: : execute-exec2 execute ;
                    919: : execute-exec-compile execute ;
                    920: 
                    921: : NoExec
                    922:   executed-ghost @ >exec2 @
                    923:   ?dup 
                    924:   IF   execute-exec2
                    925:   ELSE true ABORT" CROSS: Don't execute ghost, or immediate target word"
                    926:   THEN ;
                    927: 
1.105     jwilke    928: Defer is-forward
                    929: 
1.103     jwilke    930: : (ghostheader) ( -- )
1.121     jwilke    931:     ghost-list linked <fwd> , 0 , ['] NoExec , ['] is-forward ,
1.118     pazsan    932:     0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , ;
1.103     jwilke    933: 
                    934: : ghostheader ( -- ) (ghostheader) 0 , ;
                    935: 
                    936: ' Ghosts >wordlist Constant ghosts-wordlist
                    937: 
                    938: \ the current wordlist for ghost definitions in the host
                    939: ghosts-wordlist Value current-ghosts
                    940: 
1.52      jwilke    941: : Make-Ghost ( "name" -- ghost )
1.103     jwilke    942:   >space
                    943:   \ save current and create in ghost vocabulary
                    944:   get-current >r current-ghosts set-current
                    945:   >in @ Create >in !
                    946:   \ some forth systems like iForth need the immediate directly
                    947:   \ after the word is created
                    948:   \ restore current
                    949:   r> set-current
                    950:   here (ghostheader)
                    951:   bl word count string, align
                    952:   space>
                    953:   \ set ghost-xt field by doing a search
                    954:   dup >ghost-name count 
                    955:   current-ghosts search-wordlist
                    956:   0= ABORT" CROSS: Just created, must be there!"
                    957:   over >ghost-xt !
                    958:   DOES> 
                    959:       dup executed-ghost !
                    960:       >exec @ execute-exec ;
1.52      jwilke    961: 
                    962: \ ghost words                                          14oct92py
                    963: \                                          changed:    10may93py/jaw
                    964: 
1.103     jwilke    965: Defer search-ghosts
                    966: 
                    967: : (search-ghosts) ( adr len -- cfa true | 0 )
                    968:   current-ghosts search-wordlist ; 
                    969: 
                    970:   ' (search-ghosts) IS search-ghosts
                    971: 
                    972: : gsearch ( addr len -- ghost true | 0 )
                    973:   search-ghosts
                    974:   dup IF swap >body swap THEN ;
                    975: 
                    976: : gfind   ( string -- ghost true / string false )
1.52      jwilke    977: \ searches for string in word-list ghosts
1.103     jwilke    978:   \ dup count type space
                    979:   dup >r count gsearch
                    980:   dup IF rdrop ELSE r> swap THEN ;
1.52      jwilke    981: 
                    982: : gdiscover ( xt -- ghost true | xt false )
1.103     jwilke    983:   >r ghost-list
1.52      jwilke    984:   BEGIN @ dup
1.103     jwilke    985:   WHILE dup >magic @ <fwd> <>
                    986:         IF dup >link @ r@ =
                    987:            IF rdrop true EXIT THEN
                    988:         THEN
1.52      jwilke    989:   REPEAT
1.103     jwilke    990:   drop r> false ;
1.52      jwilke    991: 
1.105     jwilke    992: : xt>ghost ( xt -- ghost )
                    993:   gdiscover 0= ABORT" CROSS: ghost not found for this xt" ;
                    994: 
1.103     jwilke    995: : Ghost   ( "name" -- ghost )
                    996:   >in @ bl word gfind IF  nip EXIT  THEN
1.52      jwilke    997:   drop  >in !  Make-Ghost ;
                    998: 
                    999: : >ghostname ( ghost -- adr len )
1.103     jwilke   1000:   >ghost-name count ;
                   1001: 
                   1002: : forward? ( ghost -- flag )
                   1003:   >magic @ <fwd> = ;
                   1004: 
                   1005: : undefined? ( ghost -- flag )
                   1006:   >magic @ dup <fwd> = swap <skip> = or ;
                   1007: 
                   1008: : immediate? ( ghost -- flag )
                   1009:   >magic @ <imm> = ;
                   1010: 
                   1011: Variable TWarnings
                   1012: TWarnings on
                   1013: Variable Exists-Warnings
                   1014: Exists-Warnings on
                   1015: 
                   1016: : exists-warning ( ghost -- ghost )
                   1017:   TWarnings @ Exists-Warnings @ and
                   1018:   IF dup >ghostname warnhead type ."  exists " THEN ;
                   1019: 
                   1020: \ : HeaderGhost Ghost ;
                   1021: 
                   1022: Variable reuse-ghosts reuse-ghosts off
                   1023: 
                   1024: : HeaderGhost ( "name" -- ghost )
                   1025:   >in @ 
                   1026:   bl word count 
                   1027: \  2dup type space
                   1028:   current-ghosts search-wordlist
                   1029:   IF  >body dup undefined? reuse-ghosts @ or
                   1030:       IF   nip EXIT
                   1031:       ELSE exists-warning 
                   1032:       THEN
                   1033:       drop >in ! 
                   1034:   ELSE >in ! 
                   1035:   THEN 
                   1036:   \ we keep the execution semantics of the prviously
                   1037:   \ defined words, this is a workaround
                   1038:   \ for the redefined \ until vocs work
                   1039:   Make-Ghost ;
                   1040:  
1.78      jwilke   1041: : .ghost ( ghost -- ) >ghostname type ;
                   1042: 
1.77      jwilke   1043: \ ' >ghostname ALIAS @name
1.52      jwilke   1044: 
1.115     jwilke   1045: : findghost ( "ghostname" -- ghost ) 
                   1046:   bl word gfind 0= ABORT" CROSS: Ghost don't exists" ;
                   1047: 
1.103     jwilke   1048: : [G'] ( -- ghost : name )
                   1049: \G ticks a ghost and returns its address
1.115     jwilke   1050:   findghost
                   1051:   state @ IF postpone literal THEN ; immediate
1.103     jwilke   1052: 
1.105     jwilke   1053: : g>xt ( ghost -- xt )
                   1054: \G Returns the xt (cfa) of a ghost. Issues a warning if undefined.
1.103     jwilke   1055:   dup undefined? ABORT" CROSS: forward " >link @ ;
                   1056:    
1.105     jwilke   1057: : g>body ( ghost -- body )
                   1058: \G Returns the body-address (pfa) of a ghost. 
                   1059: \G Issues a warning if undefined (a forward-reference).
                   1060:   g>xt X >body ;
                   1061: 
1.103     jwilke   1062: 1 Constant <label>
1.52      jwilke   1063: 
1.103     jwilke   1064: Struct
                   1065:   \ bitmask of address type (not used for now)
                   1066:   cell% field addr-type
                   1067:   \ if this address is an xt, this field points to the ghost
                   1068:   cell% field addr-xt-ghost
                   1069:   \ a bit mask that tells as what part of the cell
                   1070:   \ is refenced from an address pointer, used for assembler generation
                   1071:   cell% field addr-refs
                   1072: End-Struct addr-struct
                   1073: 
                   1074: : %allocerase ( align size -- addr )
                   1075:   dup >r %alloc dup r> erase ;
                   1076: 
                   1077: \ returns the addr struct, define it if 0 reference
                   1078: : define-addr-struct ( addr -- struct-addr )
                   1079:   dup @ ?dup IF nip EXIT THEN
                   1080:   addr-struct %allocerase tuck swap ! ;
1.75      jwilke   1081: 
1.118     pazsan   1082: >cross
                   1083: 
1.52      jwilke   1084: \ Predefined ghosts                                    12dec92py
                   1085: 
1.114     jwilke   1086: Ghost - drop \ need a ghost otherwise "-" would be treated as a number
                   1087: 
1.103     jwilke   1088: Ghost 0=                                        drop
                   1089: Ghost branch    Ghost ?branch                   2drop
                   1090: Ghost unloop    Ghost ;S                        2drop
1.118     pazsan   1091: Ghost lit       Ghost !                         2drop
                   1092: Ghost noop                                      drop
1.103     jwilke   1093: Ghost over      Ghost =         Ghost drop      2drop drop
                   1094: Ghost 2drop drop
                   1095: Ghost 2dup drop
1.115     jwilke   1096: Ghost call drop
                   1097: Ghost @ drop
                   1098: Ghost useraddr drop
                   1099: Ghost execute drop
                   1100: Ghost + drop
                   1101: Ghost decimal drop
                   1102: Ghost hex drop
1.118     pazsan   1103: Ghost lit@ drop
                   1104: Ghost lit-perform drop
                   1105: Ghost lit+ drop
                   1106: Ghost does-exec drop
1.52      jwilke   1107: 
1.119     pazsan   1108: Ghost :docol    Ghost :doesjump Ghost :dodoes   2drop drop
                   1109: Ghost :dovar                                   drop
                   1110: 
1.52      jwilke   1111: \ \ Parameter for target systems                         06oct92py
                   1112: 
1.103     jwilke   1113: 
1.52      jwilke   1114: \ we define it ans like...
                   1115: wordlist Constant target-environment
                   1116: 
1.103     jwilke   1117: \ save information of current dictionary to restore with environ>
                   1118: Variable env-current 
1.52      jwilke   1119: 
                   1120: : >ENVIRON get-current env-current ! target-environment set-current ;
                   1121: : ENVIRON> env-current @ set-current ; 
1.43      pazsan   1122: 
1.48      anton    1123: >TARGET
1.43      pazsan   1124: 
1.103     jwilke   1125: : environment? ( addr len -- [ x ] true | false )
                   1126: \G returns the content of environment variable and true or
                   1127: \G false if not present
                   1128:    target-environment search-wordlist 
                   1129:    IF EXECUTE true ELSE false THEN ;
                   1130: 
                   1131: : $has? ( addr len -- x | false )
                   1132: \G returns the content of environment variable 
                   1133: \G or false if not present
                   1134:    T environment? H dup IF drop THEN ;
                   1135: 
                   1136: : e? ( "name" -- x )
                   1137: \G returns the content of environment variable. 
                   1138: \G The variable is expected to exist. If not, issue an error.
                   1139:    bl word count T environment? H 
                   1140:    0= ABORT" environment variable not defined!" ;
                   1141: 
                   1142: : has? ( "name" --- x | false )
                   1143: \G returns the content of environment variable 
                   1144: \G or false if not present
                   1145:    bl word count T $has? H ;
1.52      jwilke   1146: 
1.48      anton    1147: 
1.54      pazsan   1148: >ENVIRON get-order get-current swap 1+ set-order
                   1149: true SetValue compiler
1.83      pazsan   1150: true SetValue cross
1.54      pazsan   1151: true SetValue standard-threading
                   1152: >TARGET previous
1.52      jwilke   1153: 
1.77      jwilke   1154: 0
1.103     jwilke   1155: [IFDEF] mach-file drop mach-file count 1 [THEN]
                   1156: [IFDEF] machine-file drop machine-file 1 [THEN]
                   1157: [IF]   included hex
1.77      jwilke   1158: [ELSE]  cr ." No machine description!" ABORT 
                   1159: [THEN]
1.43      pazsan   1160: 
1.53      jwilke   1161: >ENVIRON
                   1162: 
1.54      pazsan   1163: T has? ec H
                   1164: [IF]
                   1165: false DefaultValue relocate
                   1166: false DefaultValue file
                   1167: false DefaultValue OS
                   1168: false DefaultValue prims
                   1169: false DefaultValue floating
                   1170: false DefaultValue glocals
                   1171: false DefaultValue dcomps
                   1172: false DefaultValue hash
                   1173: false DefaultValue xconds
                   1174: false DefaultValue header
1.105     jwilke   1175: false DefaultValue backtrace
                   1176: false DefaultValue new-input
                   1177: false DefaultValue peephole
1.129     jwilke   1178: false DefaultValue abranch
1.139   ! jwilke   1179: true DefaultValue f83headerstring
1.130     pazsan   1180: true  DefaultValue control-rack
1.54      pazsan   1181: [THEN]
                   1182: 
1.139   ! jwilke   1183: true DefaultValue gforthcross
1.54      pazsan   1184: true DefaultValue interpreter
                   1185: true DefaultValue ITC
                   1186: false DefaultValue rom
1.73      jwilke   1187: true DefaultValue standardthreading
1.53      jwilke   1188: 
1.139   ! jwilke   1189: \ ANSForth environment  stuff
        !          1190: 8 DefaultValue ADDRESS-UNIT-BITS
        !          1191: 255 DefaultValue MAX-CHAR
        !          1192: 255 DefaultValue /COUNTED-STRING
        !          1193: 
1.52      jwilke   1194: >TARGET
1.53      jwilke   1195: s" relocate" T environment? H 
1.103     jwilke   1196: \ JAW why set NIL to this?!
                   1197: [IF]   drop \ SetValue NIL
1.113     jwilke   1198: [ELSE] >ENVIRON X NIL SetValue relocate
1.53      jwilke   1199: [THEN]
1.113     jwilke   1200: >TARGET
                   1201: 
                   1202: 0 Constant NIL
1.43      pazsan   1203: 
                   1204: >CROSS
                   1205: 
1.52      jwilke   1206: \ \ Create additional parameters                         19jan95py
1.19      pazsan   1207: 
1.71      jwilke   1208: \ currently cross only works for host machines with address-unit-bits
                   1209: \ eual to 8 because of s! and sc!
                   1210: \ but I start to query the environment just to modularize a little bit
                   1211: 
                   1212: : check-address-unit-bits ( -- )       
                   1213: \      s" ADDRESS-UNIT-BITS" environment?
                   1214: \      IF 8 <> ELSE true THEN
                   1215: \      ABORT" ADDRESS-UNIT-BITS unknown or not equal to 8!"
                   1216: 
                   1217: \      shit, this doesn't work because environment? is only defined for 
                   1218: \      gforth.fi and not kernl???.fi
                   1219:        ;
                   1220: 
                   1221: check-address-unit-bits
                   1222: 8 Constant bits/byte   \ we define: byte is address-unit
                   1223: 
                   1224: 1 bits/byte lshift Constant maxbyte 
1.77      jwilke   1225: \ this sets byte size for the target machine, (probably right guess) jaw
1.67      jwilke   1226: 
1.19      pazsan   1227: T
1.71      jwilke   1228: NIL                    Constant TNIL
                   1229: cell                   Constant tcell
                   1230: cell<<                 Constant tcell<<
                   1231: cell>bit               Constant tcell>bit
                   1232: bits/char              Constant tbits/char
                   1233: bits/char H bits/byte T /      
                   1234:                        Constant tchar
                   1235: float                  Constant tfloat
                   1236: 1 bits/char lshift     Constant tmaxchar
                   1237: [IFUNDEF] bits/byte
                   1238: 8                      Constant tbits/byte
                   1239: [ELSE]
                   1240: bits/byte              Constant tbits/byte
                   1241: [THEN]
1.19      pazsan   1242: H
1.81      pazsan   1243: tbits/char bits/byte / Constant tbyte
1.71      jwilke   1244: 
1.19      pazsan   1245: 
1.48      anton    1246: \ Variables                                            06oct92py
                   1247: 
1.124     jwilke   1248: Variable (tlast)    
                   1249: (tlast) Value tlast TNIL tlast !  \ Last name field
1.48      anton    1250: Variable tlastcfa \ Last code field
1.52      jwilke   1251: 
                   1252: \ statistics                                           10jun97jaw
                   1253: 
                   1254: Variable headers-named 0 headers-named !
                   1255: Variable user-vars 0 user-vars !
                   1256: 
1.67      jwilke   1257: : target>bitmask-size ( u1 -- u2 )
                   1258:   1- tcell>bit rshift 1+ ;
                   1259: 
1.105     jwilke   1260: : allocatetarget ( size -- adr )
1.67      jwilke   1261:   dup allocate ABORT" CROSS: No memory for target"
                   1262:   swap over swap erase ;
1.52      jwilke   1263: 
1.54      pazsan   1264: \ \ memregion.fs
1.52      jwilke   1265: 
                   1266: 
                   1267: Variable last-defined-region    \ pointer to last defined region
                   1268: Variable region-link            \ linked list with all regions
                   1269: Variable mirrored-link          \ linked list for mirrored regions
                   1270: 0 dup mirrored-link ! region-link !
                   1271: 
1.139   ! jwilke   1272: : >rname 9 cells + ;
        !          1273: : >rtouch 8 cells + ; \ executed when region is accessed
1.124     jwilke   1274: : >rbm   4 cells + ; \ bitfield per cell witch indicates relocation
1.103     jwilke   1275: : >rmem  5 cells + ;
1.124     jwilke   1276: : >rtype 6 cells + ; \ field per cell witch points to a type struct
                   1277: : >rrom 7 cells + ;  \ a -1 indicates that this region is rom
1.67      jwilke   1278: : >rlink 3 cells + ;
1.52      jwilke   1279: : >rdp 2 cells + ;
                   1280: : >rlen cell+ ;
                   1281: : >rstart ;
                   1282: 
1.113     jwilke   1283: : (region) ( addr len region -- )
                   1284: \G change startaddress and length of an existing region
                   1285:   >r r@ last-defined-region !
                   1286:   r@ >rlen ! dup r@ >rstart ! r> >rdp ! ;
1.52      jwilke   1287: 
1.139   ! jwilke   1288: : uninitialized -1 ABORT" CROSS: Region is uninitialized" ;
        !          1289: 
1.123     jwilke   1290: : region ( addr len -- "name" )                
1.103     jwilke   1291: \G create a new region
1.52      jwilke   1292:   \ check whether predefined region exists 
                   1293:   save-input bl word find >r >r restore-input throw r> r> 0= 
                   1294:   IF   \ make region
                   1295:        drop
                   1296:        save-input create restore-input throw
                   1297:        here last-defined-region !
                   1298:        over ( startaddr ) , ( length ) , ( dp ) ,
1.139   ! jwilke   1299:        region-link linked 0 , 0 , 0 , 0 , 
        !          1300:         ['] uninitialized ,
        !          1301:         bl word count string,
1.52      jwilke   1302:   ELSE \ store new parameters in region
                   1303:         bl word drop
1.113     jwilke   1304:        >body (region)
1.52      jwilke   1305:   THEN ;
                   1306: 
1.103     jwilke   1307: : borders ( region -- startaddr endaddr ) 
                   1308: \G returns lower and upper region border
1.67      jwilke   1309:   dup >rstart @ swap >rlen @ over + ;
1.52      jwilke   1310: 
1.103     jwilke   1311: : extent  ( region -- startaddr len )   
                   1312: \G returns the really used area
1.67      jwilke   1313:   dup >rstart @ swap >rdp @ over - ;
1.52      jwilke   1314: 
1.103     jwilke   1315: : area ( region -- startaddr totallen ) 
                   1316: \G returns the total area
1.79      jwilke   1317:   dup >rstart @ swap >rlen @ ;
1.52      jwilke   1318: 
1.139   ! jwilke   1319: : dp@ ( region -- dp )
        !          1320:   >rdp @ ;
        !          1321: 
1.124     jwilke   1322: : mirrored ( -- )                              
                   1323: \G mark last defined region as mirrored
1.52      jwilke   1324:   mirrored-link
1.68      jwilke   1325:   align linked last-defined-region @ , ;
1.52      jwilke   1326: 
1.124     jwilke   1327: : writeprotected
                   1328: \G mark a region as write protected
                   1329:   -1 last-defined-region @ >rrom ! ;
                   1330: 
1.67      jwilke   1331: : .addr ( u -- )
                   1332: \G prints a 16 or 32 Bit nice hex value
1.52      jwilke   1333:   base @ >r hex
                   1334:   tcell 2 u>
1.77      jwilke   1335:   IF s>d <# # # # # [char] . hold # # # # #> type
1.52      jwilke   1336:   ELSE s>d <# # # # # # #> type
1.103     jwilke   1337:   THEN r> base ! space ;
1.52      jwilke   1338: 
                   1339: : .regions                      \G display region statistic
                   1340: 
                   1341:   \ we want to list the regions in the right order
                   1342:   \ so first collect all regions on stack
                   1343:   0 region-link @
                   1344:   BEGIN dup WHILE dup @ REPEAT drop
                   1345:   BEGIN dup
1.67      jwilke   1346:   WHILE cr
                   1347:         0 >rlink - >r
                   1348:         r@ >rname count tuck type
1.52      jwilke   1349:         12 swap - 0 max spaces space
1.67      jwilke   1350:         ." Start: " r@ >rstart @ dup .addr space
                   1351:         ." End: " r@ >rlen @ + .addr space
                   1352:         ." DP: " r> >rdp @ .addr
1.52      jwilke   1353:   REPEAT drop
1.53      jwilke   1354:   s" rom" T $has? H 0= ?EXIT
1.52      jwilke   1355:   cr ." Mirrored:"
                   1356:   mirrored-link @
                   1357:   BEGIN dup
1.67      jwilke   1358:   WHILE space dup cell+ @ >rname count type @
1.52      jwilke   1359:   REPEAT drop cr
                   1360:   ;
                   1361: 
                   1362: \ -------- predefined regions
                   1363: 
                   1364: 0 0 region address-space
                   1365: \ total memory addressed and used by the target system
                   1366: 
1.139   ! jwilke   1367: 0 0 region user-region
        !          1368: \ data for user variables goes here
        !          1369: \ this has to be defined before dictionary or ram-dictionary
        !          1370: 
1.52      jwilke   1371: 0 0 region dictionary
                   1372: \ rom area for the compiler
                   1373: 
1.53      jwilke   1374: T has? rom H
1.52      jwilke   1375: [IF]
                   1376: 0 0 region ram-dictionary mirrored
                   1377: \ ram area for the compiler
                   1378: [ELSE]
                   1379: ' dictionary ALIAS ram-dictionary
                   1380: [THEN]
                   1381: 
                   1382: 0 0 region return-stack
                   1383: 
                   1384: 0 0 region data-stack
                   1385: 
                   1386: 0 0 region tib-region
                   1387: 
                   1388: ' dictionary ALIAS rom-dictionary
                   1389: 
1.139   ! jwilke   1390: : setup-region ( region -- )
        !          1391:   >r
        !          1392:   \ allocate mem
        !          1393:   r@ >rlen @ allocatetarget
        !          1394:   r@ >rmem !
        !          1395: 
        !          1396:   r@ >rlen @
        !          1397:   target>bitmask-size allocatetarget
        !          1398:   r@ >rbm !
        !          1399: 
        !          1400:   r@ >rlen @
        !          1401:   tcell / 1+ cells allocatetarget r@ >rtype !
        !          1402: 
        !          1403:   ['] noop r@ >rtouch !
        !          1404:   rdrop ;
1.52      jwilke   1405: 
1.105     jwilke   1406: : setup-target ( -- )   \G initialize target's memory space
1.53      jwilke   1407:   s" rom" T $has? H
1.52      jwilke   1408:   IF  \ check for ram and rom...
1.72      jwilke   1409:       \ address-space area nip 0<>
1.67      jwilke   1410:       ram-dictionary area nip 0<>
                   1411:       rom-dictionary area nip 0<>
1.72      jwilke   1412:       and 0=
1.52      jwilke   1413:       ABORT" CROSS: define address-space, rom- , ram-dictionary, with rom-support!"
                   1414:   THEN
                   1415:   address-space area nip
                   1416:   IF
                   1417:       address-space area
                   1418:   ELSE
                   1419:       dictionary area
                   1420:   THEN
1.67      jwilke   1421:   nip 0=
1.52      jwilke   1422:   ABORT" CROSS: define at least address-space or dictionary!!"
1.67      jwilke   1423: 
                   1424:   \ allocate target for each region
                   1425:   region-link
                   1426:   BEGIN @ dup
                   1427:   WHILE dup
                   1428:         0 >rlink - >r
                   1429:         r@ >rlen @
1.139   ! jwilke   1430:         IF      r@ setup-region
        !          1431:         THEN    rdrop
1.72      jwilke   1432:    REPEAT drop ;
                   1433: 
1.105     jwilke   1434: \ MakeKernel                                                           22feb99jaw
1.72      jwilke   1435: 
1.134     pazsan   1436: : makekernel ( start targetsize -- )
1.113     jwilke   1437: \G convenience word to setup the memory of the target
                   1438: \G used by main.fs of the c-engine based systems
1.134     pazsan   1439:   dictionary (region) setup-target ;
1.72      jwilke   1440: 
                   1441: >MINIMAL
                   1442: : makekernel makekernel ;
                   1443: >CROSS
1.52      jwilke   1444: 
1.54      pazsan   1445: \ \ switched tdp for rom support                               03jun97jaw
1.52      jwilke   1446: 
                   1447: \ second value is here to store some maximal value for statistics
                   1448: \ tempdp is also embedded here but has nothing to do with rom support
                   1449: \ (needs switched dp)
                   1450: 
                   1451: variable tempdp        0 ,     \ temporary dp for resolving
                   1452: variable tempdp-save
                   1453: 
                   1454: 0 [IF]
                   1455: variable romdp 0 ,      \ Dictionary-Pointer for ramarea
                   1456: variable ramdp 0 ,      \ Dictionary-Pointer for romarea
                   1457: 
                   1458: \
                   1459: variable sramdp                \ start of ram-area for forth
                   1460: variable sromdp                \ start of rom-area for forth
                   1461: 
                   1462: [THEN]
                   1463: 
1.123     jwilke   1464: 0 Value current-region
                   1465: 0 Value tdp
                   1466: Variable fixed         \ flag: true: no automatic switching
1.52      jwilke   1467:                        \       false: switching is done automatically
                   1468: 
                   1469: \ Switch-Policy:
                   1470: \
                   1471: \ a header is always compiled into rom
                   1472: \ after a created word (create and variable) compilation goes to ram
                   1473: \
                   1474: \ Be careful: If you want to make the data behind create into rom
                   1475: \ you have to put >rom before create!
                   1476: 
                   1477: variable constflag constflag off
                   1478: 
1.67      jwilke   1479: : activate ( region -- )
                   1480: \G next code goes to this region
1.123     jwilke   1481:   dup to current-region >rdp to tdp ;
1.67      jwilke   1482: 
1.52      jwilke   1483: : (switchram)
1.53      jwilke   1484:   fixed @ ?EXIT s" rom" T $has? H 0= ?EXIT
1.67      jwilke   1485:   ram-dictionary activate ;
1.52      jwilke   1486: 
                   1487: : switchram
                   1488:   constflag @
                   1489:   IF constflag off ELSE (switchram) THEN ;
                   1490: 
                   1491: : switchrom
1.67      jwilke   1492:   fixed @ ?EXIT rom-dictionary activate ;
1.52      jwilke   1493: 
                   1494: : >tempdp ( addr -- ) 
                   1495:   tdp tempdp-save ! tempdp to tdp tdp ! ;
                   1496: : tempdp> ( -- )
                   1497:   tempdp-save @ to tdp ;
                   1498: 
                   1499: : >ram  fixed off (switchram) fixed on ;
                   1500: : >rom  fixed off switchrom fixed on ;
                   1501: : >auto fixed off switchrom ;
                   1502: 
                   1503: 
                   1504: 
                   1505: \ : romstart dup sromdp ! romdp ! ;
                   1506: \ : ramstart dup sramdp ! ramdp ! ;
                   1507: 
1.67      jwilke   1508: \ default compilation goes to rom
1.52      jwilke   1509: \ when romable support is off, only the rom switch is used (!!)
                   1510: >auto
                   1511: 
1.48      anton    1512: : there  tdp @ ;
                   1513: 
1.52      jwilke   1514: >TARGET
1.48      anton    1515: 
1.52      jwilke   1516: \ \ Target Memory Handling
1.1       anton    1517: 
                   1518: \ Byte ordering and cell size                          06oct92py
                   1519: 
1.19      pazsan   1520: : cell+         tcell + ;
                   1521: : cells         tcell<< lshift ;
1.71      jwilke   1522: : chars         tchar * ;
                   1523: : char+                tchar + ;
1.19      pazsan   1524: : floats       tfloat * ;
1.6       anton    1525:     
1.1       anton    1526: >CROSS
1.19      pazsan   1527: : cell/         tcell<< rshift ;
1.1       anton    1528: >TARGET
                   1529: 20 CONSTANT bl
1.52      jwilke   1530: \ TNIL Constant NIL
1.1       anton    1531: 
                   1532: >CROSS
                   1533: 
1.20      pazsan   1534: bigendian
                   1535: [IF]
1.106     jwilke   1536:    : DS!  ( d addr -- )  tcell bounds swap 1-
1.20      pazsan   1537:      DO  maxbyte ud/mod rot I c!  -1 +LOOP  2drop ;
1.106     jwilke   1538:    : DS@  ( addr -- d )  >r 0 0 r> tcell bounds
                   1539:      DO  maxbyte * swap maxbyte um* rot + swap I c@ + swap  LOOP ;
1.57      pazsan   1540:    : Sc!  ( n addr -- )  >r s>d r> tchar bounds swap 1-
                   1541:      DO  maxbyte ud/mod rot I c!  -1 +LOOP  2drop ;
                   1542:    : Sc@  ( addr -- n )  >r 0 0 r> tchar bounds
                   1543:      DO  maxbyte * swap maxbyte um* rot + swap I c@ + swap  LOOP d>s ;
1.19      pazsan   1544: [ELSE]
1.106     jwilke   1545:    : DS!  ( d addr -- )  tcell bounds
1.20      pazsan   1546:      DO  maxbyte ud/mod rot I c!  LOOP  2drop ;
1.106     jwilke   1547:    : DS@  ( addr -- n )  >r 0 0 r> tcell bounds swap 1-
                   1548:      DO  maxbyte * swap maxbyte um* rot + swap I c@ + swap  -1 +LOOP ;
1.57      pazsan   1549:    : Sc!  ( n addr -- )  >r s>d r> tchar bounds
                   1550:      DO  maxbyte ud/mod rot I c!  LOOP  2drop ;
                   1551:    : Sc@  ( addr -- n )  >r 0 0 r> tchar bounds swap 1-
                   1552:      DO  maxbyte * swap maxbyte um* rot + swap I c@ + swap  -1 +LOOP d>s ;
1.1       anton    1553: [THEN]
                   1554: 
1.106     jwilke   1555: : S! ( n addr -- ) >r s>d r> DS! ;
                   1556: : S@ ( addr -- n ) DS@ d>s ;
                   1557: 
1.67      jwilke   1558: : taddr>region ( taddr -- region | 0 )
                   1559: \G finds for a target-address the correct region
                   1560: \G returns 0 if taddr is not in range of a target memory region
                   1561:   region-link
                   1562:   BEGIN @ dup
                   1563:   WHILE dup >r
                   1564:         0 >rlink - >r
                   1565:         r@ >rlen @
                   1566:         IF      dup r@ borders within
1.139   ! jwilke   1567:                 IF r> r> drop nip 
        !          1568:                    dup >rtouch @ EXECUTE EXIT 
        !          1569:                 THEN
1.67      jwilke   1570:         THEN
                   1571:         r> drop
                   1572:         r>
                   1573:   REPEAT
                   1574:   2drop 0 ;
                   1575: 
1.103     jwilke   1576: : taddr>region-abort ( taddr -- region | 0 )
1.122     jwilke   1577: \G Same as taddr>region but aborts if taddr is not
                   1578: \G a valid address in the target address space
1.103     jwilke   1579:   dup taddr>region dup 0= 
                   1580:   IF    drop cr ." Wrong address: " .addr
                   1581:         -1 ABORT" Address out of range!"
                   1582:   THEN nip ;
                   1583: 
1.67      jwilke   1584: : (>regionimage) ( taddr -- 'taddr )
                   1585:   dup
                   1586:   \ find region we want to address
1.103     jwilke   1587:   taddr>region-abort
1.67      jwilke   1588:   >r
                   1589:   \ calculate offset in region
                   1590:   r@ >rstart @ -
                   1591:   \ add regions real address in our memory
                   1592:   r> >rmem @ + ;
                   1593: 
1.124     jwilke   1594: : (>regionramimage) ( taddr -- 'taddr )
                   1595: \G same as (>regionimage) but aborts if the region is rom
                   1596:   dup
                   1597:   \ find region we want to address
                   1598:   taddr>region-abort
                   1599:   >r
                   1600:   r@ >rrom @ ABORT" CROSS: region is write-protected!"
                   1601:   \ calculate offset in region
                   1602:   r@ >rstart @ -
                   1603:   \ add regions real address in our memory
                   1604:   r> >rmem @ + ;
                   1605: 
1.103     jwilke   1606: : (>regionbm) ( taddr -- 'taddr bitmaskbaseaddr )
                   1607:   dup
                   1608:   \ find region we want to address
                   1609:   taddr>region-abort
                   1610:   >r
                   1611:   \ calculate offset in region
                   1612:   r@ >rstart @ -
                   1613:   \ add regions real address in our memory
                   1614:   r> >rbm @ ;
                   1615: 
                   1616: : (>regiontype) ( taddr -- 'taddr )
                   1617:   dup
                   1618:   \ find region we want to address
                   1619:   taddr>region-abort
                   1620:   >r
                   1621:   \ calculate offset in region
                   1622:   r@ >rstart @ - tcell / cells
                   1623:   \ add regions real address in our memory
                   1624:   r> >rtype @ + ;
                   1625:   
1.1       anton    1626: \ Bit string manipulation                               06oct92py
                   1627: \                                                       9may93jaw
                   1628: CREATE Bittable 80 c, 40 c, 20 c, 10 c, 8 c, 4 c, 2 c, 1 c,
                   1629: : bits ( n -- n ) chars Bittable + c@ ;
                   1630: 
                   1631: : >bit ( addr n -- c-addr mask ) 8 /mod rot + swap bits ;
                   1632: : +bit ( addr n -- )  >bit over c@ or swap c! ;
1.4       pazsan   1633: : -bit ( addr n -- )  >bit invert over c@ and swap c! ;
1.67      jwilke   1634: 
1.103     jwilke   1635: : @relbit ( taddr -- f ) (>regionbm) swap cell/ >bit swap c@ and ;
                   1636: 
1.84      jwilke   1637: : (relon) ( taddr -- )  
                   1638:   [ [IFDEF] fd-relocation-table ]
                   1639:   s" +" fd-relocation-table write-file throw
                   1640:   dup s>d <# #s #> fd-relocation-table write-line throw
                   1641:   [ [THEN] ]
1.103     jwilke   1642:   (>regionbm) swap cell/ +bit ;
1.84      jwilke   1643: 
                   1644: : (reloff) ( taddr -- ) 
                   1645:   [ [IFDEF] fd-relocation-table ]
                   1646:   s" -" fd-relocation-table write-file throw
                   1647:   dup s>d <# #s #> fd-relocation-table write-line throw
                   1648:   [ [THEN] ]
1.103     jwilke   1649:   (>regionbm) swap cell/ -bit ;
1.67      jwilke   1650: 
                   1651: DEFER >image
1.124     jwilke   1652: DEFER >ramimage
1.67      jwilke   1653: DEFER relon
                   1654: DEFER reloff
                   1655: DEFER correcter
                   1656: 
                   1657: T has? relocate H
                   1658: [IF]
                   1659: ' (relon) IS relon
                   1660: ' (reloff) IS reloff
1.103     jwilke   1661: ' (>regionimage) IS >image
1.124     jwilke   1662: ' (>regionimage) IS >ramimage
1.67      jwilke   1663: [ELSE]
                   1664: ' drop IS relon
                   1665: ' drop IS reloff
1.68      jwilke   1666: ' (>regionimage) IS >image
1.124     jwilke   1667: ' (>regionimage) IS >ramimage
1.67      jwilke   1668: [THEN]
1.1       anton    1669: 
1.124     jwilke   1670: : enforce-writeprotection ( -- )
                   1671:   ['] (>regionramimage) IS >ramimage ;
                   1672: 
                   1673: : relax-writeprotection ( -- )
                   1674:   ['] (>regionimage) IS >ramimage ;
                   1675: 
                   1676: : writeprotection-relaxed? ( -- )
                   1677:   ['] >ramimage >body @ ['] (>regionimage) = ;
                   1678: 
1.1       anton    1679: \ Target memory access                                 06oct92py
                   1680: 
                   1681: : align+  ( taddr -- rest )
1.48      anton    1682:     tcell tuck 1- and - [ tcell 1- ] Literal and ;
1.22      anton    1683: : cfalign+  ( taddr -- rest )
1.39      pazsan   1684:     \ see kernel.fs:cfaligned
1.43      pazsan   1685:     /maxalign tuck 1- and - [ /maxalign 1- ] Literal and ;
1.1       anton    1686: 
                   1687: >TARGET
                   1688: : aligned ( taddr -- ta-addr )  dup align+ + ;
                   1689: \ assumes cell alignment granularity (as GNU C)
                   1690: 
1.22      anton    1691: : cfaligned ( taddr1 -- taddr2 )
1.39      pazsan   1692:     \ see kernel.fs
1.22      anton    1693:     dup cfalign+ + ;
                   1694: 
1.52      jwilke   1695: : @  ( taddr -- w )     >image S@ ;
1.124     jwilke   1696: : !  ( w taddr -- )     >ramimage S! ;
1.57      pazsan   1697: : c@ ( taddr -- char )  >image Sc@ ;
1.124     jwilke   1698: : c! ( char taddr -- )  >ramimage Sc! ;
1.7       anton    1699: : 2@ ( taddr -- x1 x2 ) T dup cell+ @ swap @ H ;
1.82      pazsan   1700: : 2! ( x1 x2 taddr -- ) T tuck ! cell+ ! H ;
1.1       anton    1701: 
                   1702: \ Target compilation primitives                        06oct92py
                   1703: \ included A!                                          16may93jaw
                   1704: 
                   1705: : here  ( -- there )    there ;
                   1706: : allot ( n -- )        tdp +! ;
1.78      jwilke   1707: : ,     ( w -- )        T here H tcell T allot  ! H ;
                   1708: : c,    ( char -- )     T here H tchar T allot c! H ;
                   1709: : align ( -- )          T here H align+ 0 ?DO  bl T c, H tchar +LOOP ;
1.22      anton    1710: : cfalign ( -- )
1.78      jwilke   1711:     T here H cfalign+ 0 ?DO  bl T c, H tchar +LOOP ;
1.1       anton    1712: 
1.71      jwilke   1713: : >address             dup 0>= IF tbyte / THEN ; \ ?? jaw 
1.59      pazsan   1714: : A!                    swap >address swap dup relon T ! H ;
                   1715: : A,    ( w -- )        >address T here H relon T , H ;
1.1       anton    1716: 
1.118     pazsan   1717: \ high-level ghosts
                   1718: 
                   1719: >CROSS
                   1720: 
                   1721: Ghost (do)      Ghost (?do)                     2drop
                   1722: Ghost (for)                                     drop
                   1723: Ghost (loop)    Ghost (+loop)                   2drop
                   1724: Ghost (next)                                    drop
                   1725: Ghost (does>)   Ghost (compile)                 2drop
                   1726: Ghost (.")      Ghost (S")      Ghost (ABORT")  2drop drop
1.130     pazsan   1727: Ghost (C")      Ghost c(abort") Ghost type      2drop drop
1.118     pazsan   1728: Ghost '                                         drop
                   1729: 
                   1730: \ user ghosts
                   1731: 
                   1732: Ghost state drop
1.103     jwilke   1733: 
                   1734: \ \ --------------------        Host/Target copy etc.          29aug01jaw
                   1735: 
                   1736: 
                   1737: >CROSS
                   1738: 
1.107     jwilke   1739: : TD! >image DS! ;
                   1740: : TD@ >image DS@ ;
                   1741: 
1.103     jwilke   1742: : th-count ( taddr -- host-addr len )
                   1743: \G returns host address of target string
                   1744:   assert1( tbyte 1 = )
                   1745:   dup X c@ swap X char+ >image swap ;
                   1746: 
                   1747: : ht-move ( haddr taddr len -- )
                   1748: \G moves data from host-addr to destination in target-addr
                   1749: \G character by character
                   1750:   swap -rot bounds ?DO I c@ over X c! X char+ LOOP drop ;
                   1751: 
                   1752: 2Variable last-string
                   1753: 
                   1754: : ht-string,  ( addr count -- )
                   1755:   dup there swap last-string 2!
1.130     pazsan   1756:     dup T c, H bounds  ?DO  I c@ T c, H  LOOP ;
                   1757: : ht-mem, ( addr count )
                   1758:     bounds ?DO  I c@  T c, H  LOOP ;
1.103     jwilke   1759: 
                   1760: >TARGET
                   1761: 
                   1762: : count dup X c@ swap X char+ swap ;
1.110     jwilke   1763: 
                   1764: : on           -1 -1 rot TD!  ; 
1.103     jwilke   1765: : off          T 0 swap ! H ;
1.1       anton    1766: 
1.107     jwilke   1767: : tcmove ( source dest len -- )
                   1768: \G cmove in target memory
                   1769:   tchar * bounds
                   1770:   ?DO  dup T c@ H I T c! H 1+
                   1771:   tchar +LOOP  drop ;
                   1772: 
                   1773: : td, ( d -- )
                   1774: \G Store a host value as one cell into the target
                   1775:   there tcell X allot TD! ;
                   1776: 
                   1777: \ \ Load Assembler
                   1778: 
                   1779: >TARGET
                   1780: H also Forth definitions
                   1781: 
                   1782: \ FIXME: should we include the assembler really in the forth 
                   1783: \ dictionary?!?!?!? This conflicts with the existing assembler 
                   1784: \ of the host forth system!!
                   1785: [IFDEF] asm-include asm-include [THEN] hex
                   1786: 
                   1787: previous
                   1788: 
                   1789: 
1.52      jwilke   1790: >CROSS
                   1791: 
1.103     jwilke   1792: : (cc) T a, H ;                                        ' (cc) plugin-of colon,
1.105     jwilke   1793: : (prim) T a, H ;                              ' (prim) plugin-of prim,
1.52      jwilke   1794: 
1.118     pazsan   1795: : (cr) >tempdp colon, tempdp> ;                 ' (cr) plugin-of colon-resolve
1.103     jwilke   1796: : (ar) T ! H ;                                 ' (ar) plugin-of addr-resolve
1.54      pazsan   1797: : (dr)  ( ghost res-pnt target-addr addr )
                   1798:        >tempdp drop over 
                   1799:        dup >magic @ <do:> =
                   1800:        IF      doer,
                   1801:        ELSE    dodoes,
                   1802:        THEN 
1.103     jwilke   1803:        tempdp> ;                               ' (dr) plugin-of doer-resolve
1.54      pazsan   1804: 
                   1805: : (cm) ( -- addr )
1.121     jwilke   1806:     there -1 colon, ;                          ' (cm) plugin-of colonmark,
1.1       anton    1807: 
1.52      jwilke   1808: >TARGET
1.105     jwilke   1809: : compile, ( xt -- )
1.107     jwilke   1810:   dup xt>ghost >comp @ EXECUTE ;
1.52      jwilke   1811: >CROSS
1.1       anton    1812: 
1.102     jwilke   1813: \ resolve structure
                   1814: 
                   1815: : >next ;              \ link to next field
                   1816: : >tag cell+ ;         \ indecates type of reference: 0: call, 1: address, 2: doer
                   1817: : >taddr cell+ cell+ ; 
                   1818: : >ghost 3 cells + ;
                   1819: : >file 4 cells + ;
                   1820: : >line 5 cells + ;
                   1821: 
                   1822: : (refered) ( ghost addr tag -- )
                   1823: \G creates a reference to ghost at address taddr
1.103     jwilke   1824:     >space
                   1825:     rot >link linked
1.102     jwilke   1826:     ( taddr tag ) ,
                   1827:     ( taddr ) , 
                   1828:     last-header-ghost @ , 
                   1829:     loadfile , 
                   1830:     sourceline# , 
1.103     jwilke   1831:     space>
1.118     pazsan   1832: ;
                   1833: 
1.52      jwilke   1834: : refered ( ghost tag -- )
1.53      jwilke   1835: \G creates a resolve structure
1.54      pazsan   1836:     T here aligned H swap (refered)
                   1837:   ;
                   1838: 
                   1839: : killref ( addr ghost -- )
                   1840: \G kills a forward reference to ghost at position addr
                   1841: \G this is used to eleminate a :dovar refence after making a DOES>
                   1842:     dup >magic @ <fwd> <> IF 2drop EXIT THEN
                   1843:     swap >r >link
                   1844:     BEGIN dup @ dup  ( addr last this )
                   1845:     WHILE dup >taddr @ r@ =
                   1846:         IF   @ over !
                   1847:         ELSE nip THEN
                   1848:     REPEAT rdrop 2drop 
1.53      jwilke   1849:   ;
1.48      anton    1850: 
1.52      jwilke   1851: Defer resolve-warning
1.1       anton    1852: 
1.52      jwilke   1853: : reswarn-test ( ghost res-struct -- ghost res-struct )
1.78      jwilke   1854:   over cr ." Resolving " .ghost dup ."  in " >ghost @ .ghost ;
1.1       anton    1855: 
1.52      jwilke   1856: : reswarn-forward ( ghost res-struct -- ghost res-struct )
1.78      jwilke   1857:   over warnhead .ghost dup ."  is referenced in " 
                   1858:   >ghost @ .ghost ;
1.1       anton    1859: 
1.52      jwilke   1860: \ ' reswarn-test IS resolve-warning
                   1861:  
1.1       anton    1862: \ resolve                                              14oct92py
                   1863: 
1.54      pazsan   1864:  : resolve-loop ( ghost resolve-list tcfa -- )
                   1865:     >r
                   1866:     BEGIN dup WHILE 
                   1867: \        dup >tag @ 2 = IF reswarn-forward THEN
                   1868:          resolve-warning 
                   1869:          r@ over >taddr @ 
                   1870:          2 pick >tag @
                   1871:          CASE  0 OF colon-resolve ENDOF
                   1872:                1 OF addr-resolve ENDOF
                   1873:                2 OF doer-resolve ENDOF
                   1874:          ENDCASE
                   1875:          @ \ next list element
                   1876:     REPEAT 2drop rdrop 
                   1877:   ;
1.52      jwilke   1878: 
                   1879: \ : resolve-loop ( ghost tcfa -- ghost tcfa )
                   1880: \  >r dup >link @
                   1881: \  BEGIN  dup  WHILE  dup T @ H r@ rot T ! H REPEAT  drop r> ;
1.1       anton    1882: 
                   1883: \ exists                                                9may93jaw
                   1884: 
1.103     jwilke   1885: : exists ( ghost tcfa -- )
                   1886: \G print warning and set new target link in ghost
                   1887:   swap exists-warning
                   1888:   >link ! ;
1.52      jwilke   1889: 
1.105     jwilke   1890: : colon-resolved   ( ghost -- )
1.121     jwilke   1891: \ compiles a call to a colon definition,
                   1892: \ compile action for >comp field
                   1893:     >link @ colon, ; 
1.105     jwilke   1894: 
                   1895: : prim-resolved  ( ghost -- )
1.121     jwilke   1896: \ compiles a call to a primitive
1.105     jwilke   1897:     >link @ prim, ;
                   1898: 
1.121     jwilke   1899: : (is-forward)   ( ghost -- )
                   1900:     colonmark, 0 (refered) ; \ compile space for call
                   1901: ' (is-forward) IS is-forward
                   1902: 
1.118     pazsan   1903: 0 Value resolved
1.1       anton    1904: 
1.122     jwilke   1905: : resolve-forward-references ( ghost resolve-list -- )
                   1906:     \ loop through forward referencies
                   1907:     comp-state @ >r Resolving comp-state !
                   1908:     over >link @ resolve-loop 
                   1909:     r> comp-state !
                   1910: 
                   1911:     ['] noop IS resolve-warning ;
                   1912: 
                   1913: 
                   1914: : (resolve) ( ghost tcfa -- ghost resolve-list )
                   1915:     \ check for a valid address, it is a primitive reference
                   1916:     \ otherwise
1.103     jwilke   1917:     dup taddr>region 0<> IF
1.122     jwilke   1918:       \ define this address in the region address type table
1.103     jwilke   1919:       2dup (>regiontype) define-addr-struct addr-xt-ghost 
                   1920:       \ we define new address only if empty
1.105     jwilke   1921:       \ this is for not to take over the alias ghost
                   1922:       \ (different ghost, but identical xt)
1.103     jwilke   1923:       \ but the very first that really defines it
                   1924:       dup @ 0= IF ! ELSE 2drop THEN
                   1925:     THEN
1.122     jwilke   1926:     swap >r
1.118     pazsan   1927:     r@ to resolved
1.121     jwilke   1928: 
                   1929: \    r@ >comp @ ['] is-forward =
                   1930: \    ABORT" >comp action not set on a resolved ghost"
                   1931: 
                   1932:     \ copmile action defaults to colon-resolved
                   1933:     \ if this is not right something must be set before
                   1934:     \ calling resolve
                   1935:     r@ >comp @ ['] is-forward = IF
1.122     jwilke   1936:        ['] colon-resolved r@ >comp !
                   1937:    THEN
                   1938:     r@ >link @ swap \ ( list tcfa R: ghost )
                   1939:     \ mark ghost as resolved
                   1940:     r@ >link ! <res> r@ >magic !
                   1941:     r> swap ;
1.54      pazsan   1942: 
1.122     jwilke   1943: : resolve  ( ghost tcfa -- )
                   1944: \G resolve referencies to ghost with tcfa
                   1945:     \ is ghost resolved?, second resolve means another 
                   1946:     \ definition with the same name
                   1947:     over undefined? 0= IF  exists EXIT THEN
                   1948:     (resolve)
                   1949:     ( ghost resolve-list )
                   1950:     resolve-forward-references ;
                   1951: 
                   1952: : resolve-noforwards ( ghost tcfa -- )
                   1953: \G Same as resolve but complain if there are any
                   1954: \G forward references on this ghost
                   1955:    \ is ghost resolved?, second resolve means another 
                   1956:    \ definition with the same name
                   1957:    over undefined? 0= IF  exists EXIT THEN
                   1958:    (resolve)
                   1959:    IF cr ." No forward references allowed on: " .ghost cr
                   1960:       -1 ABORT" Illegal forward reference"
                   1961:    THEN
                   1962:    drop ;
1.1       anton    1963: 
                   1964: \ gexecute ghost,                                      01nov92py
                   1965: 
1.103     jwilke   1966: : (gexecute)   ( ghost -- )
1.105     jwilke   1967:   dup >comp @ EXECUTE ;
1.103     jwilke   1968: 
                   1969: : gexecute ( ghost -- )
1.120     jwilke   1970:   dup >magic @ <imm> = ABORT" CROSS: gexecute on immediate word"
1.103     jwilke   1971:   (gexecute) ;
1.52      jwilke   1972: 
                   1973: : addr,  ( ghost -- )
1.105     jwilke   1974:   dup forward? IF  1 refered 0 T a, H ELSE >link @ T a, H THEN ;
1.52      jwilke   1975: 
1.1       anton    1976: \ .unresolved                                          11may93jaw
                   1977: 
                   1978: variable ResolveFlag
                   1979: 
                   1980: \ ?touched                                             11may93jaw
                   1981: 
1.52      jwilke   1982: : ?touched ( ghost -- flag ) dup forward? swap >link @
1.1       anton    1983:                                0 <> and ;
                   1984: 
1.53      jwilke   1985: : .forwarddefs ( ghost -- )
1.103     jwilke   1986:   ."  appeared in:"
                   1987:   >link
                   1988:   BEGIN        @ dup
                   1989:   WHILE        cr 5 spaces
                   1990:        dup >ghost @ .ghost
                   1991:        ."  file " dup >file @ ?dup IF count type ELSE ." CON" THEN
                   1992:        ."  line " dup >line @ .dec
                   1993:   REPEAT 
                   1994:   drop ;
                   1995: 
                   1996: : ?resolved  ( ghost -- )
                   1997:   dup ?touched
                   1998:   IF   ResolveFlag on 
                   1999:        dup cr .ghost .forwarddefs
1.53      jwilke   2000:   ELSE         drop 
                   2001:   THEN ;
1.1       anton    2002: 
                   2003: : .unresolved  ( -- )
                   2004:   ResolveFlag off cr ." Unresolved: "
1.103     jwilke   2005:   ghost-list
1.1       anton    2006:   BEGIN @ dup
                   2007:   WHILE dup ?resolved
1.10      anton    2008:   REPEAT drop ResolveFlag @
                   2009:   IF
1.48      anton    2010:       -1 abort" Unresolved words!"
1.10      anton    2011:   ELSE
                   2012:       ." Nothing!"
                   2013:   THEN
                   2014:   cr ;
1.1       anton    2015: 
1.52      jwilke   2016: : .stats
                   2017:   base @ >r decimal
                   2018:   cr ." named Headers: " headers-named @ . 
                   2019:   r> base ! ;
                   2020: 
1.79      jwilke   2021: >MINIMAL
                   2022: 
                   2023: : .unresolved .unresolved ;
                   2024: 
1.1       anton    2025: >CROSS
                   2026: \ Header states                                        12dec92py
                   2027: 
1.102     jwilke   2028: \ : flag! ( 8b -- )   tlast @ dup >r T c@ xor r> c! H ;
1.90      pazsan   2029: bigendian [IF] 0 [ELSE] tcell 1- [THEN] Constant flag+
                   2030: : flag! ( w -- )   tlast @ flag+ + dup >r T c@ xor r> c! H ;
1.1       anton    2031: 
                   2032: VARIABLE ^imm
                   2033: 
1.105     jwilke   2034: \ !! should be target wordsize specific
                   2035: $80 constant alias-mask
                   2036: $40 constant immediate-mask
                   2037: $20 constant restrict-mask
                   2038: 
1.1       anton    2039: >TARGET
1.105     jwilke   2040: : immediate     immediate-mask flag!
1.18      pazsan   2041:                 ^imm @ @ dup <imm> = IF  drop  EXIT  THEN
1.1       anton    2042:                 <res> <> ABORT" CROSS: Cannot immediate a unresolved word"
                   2043:                 <imm> ^imm @ ! ;
1.105     jwilke   2044: : restrict      restrict-mask flag! ;
1.52      jwilke   2045: 
1.54      pazsan   2046: : isdoer       
                   2047: \G define a forth word as doer, this makes obviously only sence on
                   2048: \G forth processors such as the PSC1000
                   2049:                <do:> last-header-ghost @ >magic ! ;
1.1       anton    2050: >CROSS
                   2051: 
                   2052: \ Target Header Creation                               01nov92py
                   2053: 
1.103     jwilke   2054: : ht-lstring, ( addr count -- )
1.102     jwilke   2055:   dup T , H bounds  ?DO  I c@ T c, H  LOOP ;
                   2056: 
1.103     jwilke   2057: >TARGET
1.139   ! jwilke   2058: X has? f83headerstring [IF]
        !          2059: : name,  ( "name" -- )  bl word count ht-string, X cfalign ;
        !          2060: [ELSE]
1.103     jwilke   2061: : name,  ( "name" -- )  bl word count ht-lstring, X cfalign ;
1.139   ! jwilke   2062: [THEN]
1.1       anton    2063: : view,   ( -- ) ( dummy ) ;
1.52      jwilke   2064: >CROSS
1.1       anton    2065: 
1.25      pazsan   2066: \ Target Document Creation (goes to crossdoc.fd)       05jul95py
                   2067: 
1.55      pazsan   2068: s" ./doc/crossdoc.fd" r/w create-file throw value doc-file-id
1.25      pazsan   2069: \ contains the file-id of the documentation file
                   2070: 
1.40      pazsan   2071: : T-\G ( -- )
1.25      pazsan   2072:     source >in @ /string doc-file-id write-line throw
1.40      pazsan   2073:     postpone \ ;
1.25      pazsan   2074: 
1.39      pazsan   2075: Variable to-doc  to-doc on
1.25      pazsan   2076: 
                   2077: : cross-doc-entry  ( -- )
                   2078:     to-doc @ tlast @ 0<> and   \ not an anonymous (i.e. noname) header
                   2079:     IF
                   2080:        s" " doc-file-id write-line throw
                   2081:        s" make-doc " doc-file-id write-file throw
1.102     jwilke   2082: 
1.105     jwilke   2083:        Last-Header-Ghost @ >ghostname doc-file-id write-file throw
1.25      pazsan   2084:        >in @
                   2085:        [char] ( parse 2drop
                   2086:        [char] ) parse doc-file-id write-file throw
                   2087:        s"  )" doc-file-id write-file throw
                   2088:        [char] \ parse 2drop                                    
1.40      pazsan   2089:        T-\G
1.25      pazsan   2090:        >in !
1.39      pazsan   2091:     THEN ;
1.25      pazsan   2092: 
1.28      pazsan   2093: \ Target TAGS creation
                   2094: 
1.39      pazsan   2095: s" kernel.TAGS" r/w create-file throw value tag-file-id
1.116     pazsan   2096: s" kernel.tags" r/w create-file throw value vi-tag-file-id
1.28      pazsan   2097: \ contains the file-id of the tags file
                   2098: 
1.137     anton    2099: Create tag-beg 1 c,  7F c,
                   2100: Create tag-end 1 c,  01 c,
1.28      pazsan   2101: Create tag-bof 1 c,  0C c,
1.116     pazsan   2102: Create tag-tab 1 c,  09 c,
1.28      pazsan   2103: 
                   2104: 2variable last-loadfilename 0 0 last-loadfilename 2!
                   2105:            
                   2106: : put-load-file-name ( -- )
1.77      jwilke   2107:     sourcefilename last-loadfilename 2@ d<>
1.28      pazsan   2108:     IF
                   2109:        tag-bof count tag-file-id write-line throw
1.31      anton    2110:        sourcefilename 2dup
1.28      pazsan   2111:        tag-file-id write-file throw
                   2112:        last-loadfilename 2!
                   2113:        s" ,0" tag-file-id write-line throw
                   2114:     THEN ;
                   2115: 
1.116     pazsan   2116: : cross-gnu-tag-entry  ( -- )
1.28      pazsan   2117:     tlast @ 0<>        \ not an anonymous (i.e. noname) header
                   2118:     IF
                   2119:        put-load-file-name
                   2120:        source >in @ min tag-file-id write-file throw
                   2121:        tag-beg count tag-file-id write-file throw
1.116     pazsan   2122:        Last-Header-Ghost @ >ghostname tag-file-id write-file throw
1.28      pazsan   2123:        tag-end count tag-file-id write-file throw
1.31      anton    2124:        base @ decimal sourceline# 0 <# #s #> tag-file-id write-file throw
1.28      pazsan   2125: \      >in @ 0 <# #s [char] , hold #> tag-file-id write-line throw
                   2126:        s" ,0" tag-file-id write-line throw
                   2127:        base !
                   2128:     THEN ;
1.116     pazsan   2129: 
                   2130: : cross-vi-tag-entry ( -- )
                   2131:     tlast @ 0<>        \ not an anonymous (i.e. noname) header
                   2132:     IF
                   2133:        sourcefilename vi-tag-file-id write-file throw
                   2134:        tag-tab count vi-tag-file-id write-file throw
                   2135:        Last-Header-Ghost @ >ghostname vi-tag-file-id write-file throw
                   2136:        tag-tab count vi-tag-file-id write-file throw
                   2137:        s" /^" vi-tag-file-id write-file throw
                   2138:        source vi-tag-file-id write-file throw
                   2139:        s" $/" vi-tag-file-id write-line throw
                   2140:     THEN ;
                   2141: 
                   2142: : cross-tag-entry ( -- )
                   2143:     cross-gnu-tag-entry
                   2144:     cross-vi-tag-entry ;
1.28      pazsan   2145: 
1.43      pazsan   2146: \ Check for words
                   2147: 
                   2148: Defer skip? ' false IS skip?
                   2149: 
1.103     jwilke   2150: : skipdef ( "name" -- )
1.79      jwilke   2151: \G skip definition of an undefined word in undef-words and
                   2152: \G all-words mode
1.103     jwilke   2153:     Ghost dup forward?
1.75      jwilke   2154:     IF  >magic <skip> swap !
                   2155:     ELSE drop THEN ;
                   2156: 
1.103     jwilke   2157: : tdefined? ( "name" -- flag ) 
                   2158:     Ghost undefined? 0= ;
1.75      jwilke   2159: 
1.103     jwilke   2160: : defined2? ( "name" -- flag ) 
1.75      jwilke   2161: \G return true for anything else than forward, even for <skip>
                   2162: \G that's what we want
1.103     jwilke   2163:     Ghost forward? 0= ;
1.43      pazsan   2164: 
1.103     jwilke   2165: : forced? ( "name" -- flag )
1.79      jwilke   2166: \G return ture if it is a foreced skip with defskip
1.103     jwilke   2167:     Ghost >magic @ <skip> = ;
1.79      jwilke   2168: 
1.43      pazsan   2169: : needed? ( -- flag ) \ name
1.48      anton    2170: \G returns a false flag when
                   2171: \G a word is not defined
                   2172: \G a forward reference exists
                   2173: \G so the definition is not skipped!
                   2174:     bl word gfind
1.75      jwilke   2175:     IF dup undefined?
1.48      anton    2176:        nip
                   2177:        0=
                   2178:     ELSE  drop true  THEN ;
1.43      pazsan   2179: 
1.139   ! jwilke   2180: : doer? ( "name" -- 0 | addr ) \ name
        !          2181:     Ghost dup >magic @ <do:> = 
        !          2182:     IF >link @ ELSE drop 0 THEN ;
1.44      pazsan   2183: 
1.43      pazsan   2184: : skip-defs ( -- )
                   2185:     BEGIN  refill  WHILE  source -trailing nip 0= UNTIL  THEN ;
                   2186: 
1.28      pazsan   2187: \ Target header creation
                   2188: 
1.54      pazsan   2189: Variable NoHeaderFlag
                   2190: NoHeaderFlag off
1.1       anton    2191: 
1.54      pazsan   2192: : 0.r ( n1 n2 -- ) 
                   2193:     base @ >r hex 
                   2194:     0 swap <# 0 ?DO # LOOP #> type 
                   2195:     r> base ! ;
1.84      jwilke   2196: 
                   2197: : .sym ( adr len -- )
                   2198: \G escapes / and \ to produce sed output
1.52      jwilke   2199:   bounds 
                   2200:   DO I c@ dup
1.77      jwilke   2201:        CASE    [char] / OF drop ." \/" ENDOF
                   2202:                [char] \ OF drop ." \\" ENDOF
1.52      jwilke   2203:                dup OF emit ENDOF
                   2204:        ENDCASE
1.54      pazsan   2205:     LOOP ;
1.52      jwilke   2206: 
1.103     jwilke   2207: Defer setup-execution-semantics
                   2208: 0 Value lastghost
                   2209: 
                   2210: : (THeader ( "name" -- ghost )
1.54      pazsan   2211:     \  >in @ bl word count type 2 spaces >in !
                   2212:     \ wordheaders will always be compiled to rom
                   2213:     switchrom
                   2214:     \ build header in target
                   2215:     NoHeaderFlag @
                   2216:     IF  NoHeaderFlag off
                   2217:     ELSE
                   2218:        T align H view,
1.78      jwilke   2219:        tlast @ dup 0> IF tcell - THEN T A, H  there tlast !
1.54      pazsan   2220:        1 headers-named +!      \ Statistic
                   2221:        >in @ T name, H >in !
                   2222:     THEN
                   2223:     T cfalign here H tlastcfa !
1.84      jwilke   2224:     \ Old Symbol table sed-script
1.54      pazsan   2225: \    >in @ cr ." sym:s/CFA=" there 4 0.r ." /"  bl word count .sym ." /g" cr >in !
1.103     jwilke   2226:     HeaderGhost
1.84      jwilke   2227:     \ output symbol table to extra file
1.123     jwilke   2228:     dup >ghostname there symentry
1.103     jwilke   2229:     dup Last-Header-Ghost ! dup to lastghost
1.54      pazsan   2230:     dup >magic ^imm !     \ a pointer for immediate
1.105     jwilke   2231:     alias-mask flag!
1.103     jwilke   2232:     cross-doc-entry cross-tag-entry 
                   2233:     setup-execution-semantics
                   2234:     ;
1.1       anton    2235: 
1.52      jwilke   2236: \ this is the resolver information from ":"
                   2237: \ resolving is done by ";"
1.103     jwilke   2238: Variable ;Resolve 1 cells allot
                   2239: 
                   2240: : hereresolve ( ghost -- )
                   2241:   there resolve 0 ;Resolve ! ;
1.1       anton    2242: 
1.11      pazsan   2243: : Theader  ( "name" -- ghost )
1.103     jwilke   2244:   (THeader dup hereresolve ;
                   2245: 
                   2246: Variable aprim-nr -20 aprim-nr !
                   2247: 
                   2248: : copy-execution-semantics ( ghost-from ghost-dest -- )
                   2249:   >r
                   2250:   dup >exec @ r@ >exec !
1.117     pazsan   2251:   dup >comp @ r@ >comp !
1.103     jwilke   2252:   dup >exec2 @ r@ >exec2 !
                   2253:   dup >exec-compile @ r@ >exec-compile !
                   2254:   dup >ghost-xt @ r@ >ghost-xt !
                   2255:   dup >created @ r@ >created !
                   2256:   rdrop drop ;
1.1       anton    2257: 
                   2258: >TARGET
1.103     jwilke   2259: 
1.1       anton    2260: : Alias    ( cfa -- ) \ name
1.103     jwilke   2261:   >in @ skip? IF  2drop  EXIT  THEN  >in !
                   2262:   (THeader ( S xt ghost )
1.105     jwilke   2263:   2dup swap xt>ghost swap copy-execution-semantics
                   2264:   over resolve T A, H alias-mask flag! ;
1.103     jwilke   2265: 
                   2266: Variable last-prim-ghost
                   2267: 0 last-prim-ghost !
                   2268: 
                   2269: : asmprimname, ( ghost -- : name ) 
                   2270:   dup last-prim-ghost !
                   2271:   >r
                   2272:   here bl word count string, r@ >asm-name !
                   2273:   aprim-nr @ r> >asm-dummyaddr ! ;
                   2274: 
                   2275: Defer setup-prim-semantics
                   2276: 
1.112     jwilke   2277: : mapprim   ( "forthname" "asmlabel" -- ) 
1.103     jwilke   2278:   THeader -1 aprim-nr +! aprim-nr @ T A, H
                   2279:   asmprimname, 
                   2280:   setup-prim-semantics ;
                   2281: 
1.112     jwilke   2282: : mapprim:   ( "forthname" "asmlabel" -- ) 
1.103     jwilke   2283:   -1 aprim-nr +! aprim-nr @
1.122     jwilke   2284:   Ghost tuck swap resolve-noforwards <do:> swap tuck >magic !
1.103     jwilke   2285:   asmprimname, ;
                   2286: 
1.119     pazsan   2287: : Doer:   ( cfa -- ) \ name
1.103     jwilke   2288:   >in @ skip? IF  2drop  EXIT  THEN  >in !
                   2289:   dup 0< s" prims" T $has? H 0= and
                   2290:   IF
                   2291:       .sourcepos ." needs doer: " >in @ bl word count type >in ! cr
                   2292:   THEN
1.119     pazsan   2293:   Ghost
1.122     jwilke   2294:   tuck swap resolve-noforwards <do:> swap >magic ! ;
1.64      pazsan   2295: 
                   2296: Variable prim#
                   2297: : first-primitive ( n -- )  prim# ! ;
1.132     pazsan   2298: : group 0 word drop prim# @ 1- -$200 and prim# ! ;
1.64      pazsan   2299: : Primitive  ( -- ) \ name
1.117     pazsan   2300:   >in @ skip? IF  drop  EXIT  THEN  >in !
                   2301:   s" prims" T $has? H 0=
1.103     jwilke   2302:   IF
                   2303:      .sourcepos ." needs prim: " >in @ bl word count type >in ! cr
                   2304:   THEN
                   2305:   prim# @ (THeader ( S xt ghost )
1.121     jwilke   2306:   ['] prim-resolved over >comp !
1.105     jwilke   2307:   dup >ghost-flags <primitive> set-flag
1.122     jwilke   2308:   over resolve-noforwards T A, H alias-mask flag!
1.103     jwilke   2309:   -1 prim# +! ;
1.1       anton    2310: >CROSS
                   2311: 
                   2312: \ Conditionals and Comments                            11may93jaw
                   2313: 
1.103     jwilke   2314: \G saves the existing cond action, this is used for redefining in
                   2315: \G instant
                   2316: Variable cond-xt-old
                   2317: 
                   2318: : cond-target ( -- )
                   2319: \G Compiles semantic of redefined cond into new one
                   2320:   cond-xt-old @ compile, ; immediate restrict
                   2321: 
1.1       anton    2322: : ;Cond
                   2323:   postpone ;
                   2324:   swap ! ;  immediate
                   2325: 
1.103     jwilke   2326: : Cond: ( "name" -- ) 
                   2327: \g defines a conditional or another word that must
                   2328: \g be executed directly while compiling
                   2329: \g these words have no interpretative semantics by default
                   2330:   Ghost
                   2331:   >exec-compile
                   2332:   dup @ cond-xt-old !
1.1       anton    2333:   :NONAME ;
                   2334: 
                   2335: 
                   2336: : Comment ( -- )
1.103     jwilke   2337:   >in @ Ghost swap >in ! ' swap 
                   2338:   2dup >exec-compile ! >exec ! ;
1.1       anton    2339: 
                   2340: Comment (       Comment \
                   2341: 
                   2342: \ compile                                              10may93jaw
                   2343: 
1.103     jwilke   2344: : compile  ( "name" -- ) \ name
1.115     jwilke   2345:   findghost
1.103     jwilke   2346:   dup >exec-compile @ ?dup
                   2347:   IF    nip compile,
                   2348:   ELSE  postpone literal postpone gexecute  THEN ;  immediate restrict
                   2349:             
1.52      jwilke   2350: >TARGET
                   2351: 
1.105     jwilke   2352: : '  ( -- xt ) 
                   2353: \G returns the target-cfa of a ghost
1.52      jwilke   2354:   bl word gfind 0= ABORT" CROSS: Ghost don't exists"
1.105     jwilke   2355:   g>xt ;
1.52      jwilke   2356: 
1.103     jwilke   2357: \ FIXME: this works for the current use cases, but is not
                   2358: \ in all cases correct ;-) 
                   2359: : comp' X ' 0 ;
                   2360: 
1.52      jwilke   2361: Cond: [']  T ' H alit, ;Cond
                   2362: 
                   2363: >CROSS
                   2364: 
                   2365: : [T']
                   2366: \ returns the target-cfa of a ghost, or compiles it as literal
1.115     jwilke   2367:   postpone [G'] 
                   2368:   state @ IF postpone g>xt ELSE g>xt THEN ; immediate
1.42      pazsan   2369: 
1.52      jwilke   2370: \ \ threading modell                                   13dec92py
                   2371: \ modularized                                          14jun97jaw
                   2372: 
1.106     jwilke   2373: T 2 cells H Value xt>body
1.52      jwilke   2374: 
1.103     jwilke   2375: : (>body)   ( cfa -- pfa ) 
1.105     jwilke   2376:   xt>body + ;                                          ' (>body) plugin-of t>body
                   2377: 
                   2378: : fillcfa   ( usedcells -- )
1.106     jwilke   2379:   T cells H xt>body swap -
1.105     jwilke   2380:   assert1( dup 0 >= )
                   2381:   0 ?DO 0 X c, tchar +LOOP ;
1.52      jwilke   2382: 
1.103     jwilke   2383: : (doer,)   ( ghost -- ) 
1.105     jwilke   2384:   addr, 1 fillcfa ;                                    ' (doer,) plugin-of doer,
1.52      jwilke   2385: 
1.105     jwilke   2386: : (docol,)  ( -- ) [G'] :docol (doer,) ;               ' (docol,) plugin-of docol,
1.52      jwilke   2387: 
1.121     jwilke   2388:                                                         ' NOOP plugin-of ca>native
                   2389: 
1.52      jwilke   2390: : (doprim,) ( -- )
1.105     jwilke   2391:   there xt>body + ca>native T a, H 1 fillcfa ;         ' (doprim,) plugin-of doprim,
1.52      jwilke   2392: 
                   2393: : (doeshandler,) ( -- ) 
1.119     pazsan   2394:   T cfalign H [G'] :doesjump addr, T 0 , H ;           ' (doeshandler,) plugin-of doeshandler,
1.52      jwilke   2395: 
                   2396: : (dodoes,) ( does-action-ghost -- )
1.119     pazsan   2397:   ]comp [G'] :dodoes addr, comp[
1.52      jwilke   2398:   addr,
1.103     jwilke   2399:   \ the relocator in the c engine, does not like the
                   2400:   \ does-address to marked for relocation
                   2401:   [ T e? ec H 0= [IF] ] T here H tcell - reloff [ [THEN] ]
1.105     jwilke   2402:   2 fillcfa ;                                          ' (dodoes,) plugin-of dodoes,
1.52      jwilke   2403: 
1.107     jwilke   2404: : (dlit,) ( n -- ) compile lit td, ;                   ' (dlit,) plugin-of dlit,
                   2405: 
                   2406: : (lit,) ( n -- )  s>d dlit, ;                         ' (lit,) plugin-of lit,
1.52      jwilke   2407: 
1.67      jwilke   2408: \ if we dont produce relocatable code alit, defaults to lit, jaw
1.84      jwilke   2409: \ this is just for convenience, so we don't have to define alit,
                   2410: \ seperately for embedded systems....
                   2411: T has? relocate H
1.67      jwilke   2412: [IF]
1.105     jwilke   2413: : (alit,) ( n -- )  compile lit T  a, H ;              ' (alit,) plugin-of alit,
1.67      jwilke   2414: [ELSE]
1.105     jwilke   2415: : (alit,) ( n -- )  lit, ;                             ' (alit,) plugin-of alit,
1.67      jwilke   2416: [THEN]
1.52      jwilke   2417: 
1.105     jwilke   2418: : (fini,)         compile ;s ;                         ' (fini,) plugin-of fini,
1.42      pazsan   2419: 
1.43      pazsan   2420: [IFUNDEF] (code) 
                   2421: Defer (code)
                   2422: Defer (end-code)
                   2423: [THEN]
                   2424: 
1.1       anton    2425: >TARGET
1.43      pazsan   2426: : Code
1.52      jwilke   2427:   defempty?
1.121     jwilke   2428:   (THeader ( ghost )
                   2429:   ['] prim-resolved over >comp !
1.122     jwilke   2430:   there resolve-noforwards
1.121     jwilke   2431:   
1.53      jwilke   2432:   [ T e? prims H 0= [IF] T e? ITC H [ELSE] true [THEN] ] [IF]
1.52      jwilke   2433:   doprim, 
1.48      anton    2434:   [THEN]
                   2435:   depth (code) ;
1.43      pazsan   2436: 
1.121     jwilke   2437: \ FIXME : no-compile -1 ABORT" this ghost is not for compilation" ;
                   2438: 
1.43      pazsan   2439: : Code:
1.52      jwilke   2440:   defempty?
1.121     jwilke   2441:     Ghost >r 
1.123     jwilke   2442:     r@ >ghostname there symentry
1.122     jwilke   2443:     r@ there ca>native resolve-noforwards
1.121     jwilke   2444:     <do:> r@ >magic !
                   2445:     r> drop
1.43      pazsan   2446:     depth (code) ;
                   2447: 
                   2448: : end-code
1.52      jwilke   2449:     (end-code)
1.43      pazsan   2450:     depth ?dup IF   1- <> ABORT" CROSS: Stack changed"
                   2451:     ELSE true ABORT" CROSS: Stack empty" THEN
1.52      jwilke   2452:     ;
1.14      anton    2453: 
1.1       anton    2454: >CROSS
1.52      jwilke   2455: 
1.1       anton    2456: \ tLiteral                                             12dec92py
                   2457: 
                   2458: >TARGET
1.40      pazsan   2459: Cond: \G  T-\G ;Cond
                   2460: 
1.105     jwilke   2461: Cond: Literal  ( n -- )   lit, ;Cond
1.103     jwilke   2462: Cond: ALiteral ( n -- )   alit, ;Cond
1.1       anton    2463: 
                   2464: : Char ( "<char>" -- )  bl word char+ c@ ;
1.103     jwilke   2465: Cond: [Char]   ( "<char>" -- )  Char  lit, ;Cond
                   2466: 
1.139   ! jwilke   2467: : (x#) ( adr len base -- )
        !          2468:   base @ >r base ! 0 0 name >number 2drop drop r> base ! ;
        !          2469: 
        !          2470: : d# $0a (x#) ;
        !          2471: : h# $010 (x#) ;
        !          2472: 
        !          2473: Cond: d# $0a (x#) lit, ;Cond
        !          2474: Cond: h# $010 (x#) lit, ;Cond
        !          2475: 
1.104     jwilke   2476: tchar 1 = [IF]
1.110     jwilke   2477: Cond: chars ;Cond 
1.104     jwilke   2478: [THEN]
1.1       anton    2479: 
1.43      pazsan   2480: \ some special literals                                        27jan97jaw
                   2481: 
                   2482: Cond: MAXU
1.125     jwilke   2483:   -1 s>d dlit,
1.52      jwilke   2484:   ;Cond
1.43      pazsan   2485: 
1.125     jwilke   2486: tcell 2 = tcell 4 = or tcell 8 = or 0=
                   2487: [IF]
                   2488: .( Warning: MINI and MAXI may not work with this host) cr
                   2489: [THEN]
                   2490: 
1.43      pazsan   2491: Cond: MINI
1.125     jwilke   2492:   tcell 2 = IF $8000 ELSE $80000000 THEN 0
                   2493:   tcell 8 = IF swap THEN dlit,
1.52      jwilke   2494:   ;Cond
1.43      pazsan   2495:  
                   2496: Cond: MAXI
1.125     jwilke   2497:   tcell 2 = IF $7fff ELSE $7fffffff THEN 0
                   2498:   tcell 8 = IF drop -1 swap THEN dlit,
                   2499:   ;Cond
1.43      pazsan   2500: 
1.1       anton    2501: >CROSS
1.115     jwilke   2502: 
1.1       anton    2503: \ Target compiling loop                                12dec92py
                   2504: \ ">tib trick thrown out                               10may93jaw
                   2505: \ number? defined at the top                           11may93jaw
1.77      jwilke   2506: \ replaced >in by save-input                           
                   2507: 
                   2508: : discard 0 ?DO drop LOOP ;
1.1       anton    2509: 
                   2510: \ compiled word might leave items on stack!
1.77      jwilke   2511: : tcom ( x1 .. xn n name -- )
                   2512: \  dup count type space
1.103     jwilke   2513:   gfind 
                   2514:   IF    >r ( discard saved input state ) discard r>
                   2515:        dup >exec-compile @ ?dup
                   2516:         IF   nip execute-exec-compile ELSE gexecute  THEN 
1.77      jwilke   2517:        EXIT 
                   2518:   THEN
                   2519:   number? dup  
                   2520:   IF   0> IF swap lit,  THEN  lit, discard
1.103     jwilke   2521:   ELSE 2drop restore-input throw Ghost gexecute THEN  ;
1.1       anton    2522: 
                   2523: \ : ; DOES>                                            13dec92py
                   2524: \ ]                                                     9may93py/jaw
                   2525: 
1.115     jwilke   2526: >CROSS
                   2527: 
1.105     jwilke   2528: : compiling-state ( -- )
                   2529: \G set states to compililng
1.54      pazsan   2530:     Compiling comp-state !
1.103     jwilke   2531:     \ if we have a state in target, change it with the compile state
1.105     jwilke   2532:     [G'] state dup undefined? 0= 
                   2533:     IF >ghost-xt @ execute X on ELSE drop THEN ;
                   2534: 
                   2535: : interpreting-state ( -- )
                   2536: \G set states to interpreting
                   2537:    \ if target has a state variable, change it according to our state
                   2538:    [G'] state dup undefined? 0= 
                   2539:    IF >ghost-xt @ execute X off ELSE drop THEN
                   2540:    Interpreting comp-state ! ;
1.115     jwilke   2541: 
                   2542: >TARGET
1.105     jwilke   2543: 
                   2544: : ] 
                   2545:     compiling-state
1.1       anton    2546:     BEGIN
1.77      jwilke   2547:         BEGIN save-input bl word
                   2548:               dup c@ 0= WHILE drop discard refill 0=
1.1       anton    2549:               ABORT" CROSS: End of file while target compiling"
                   2550:         REPEAT
                   2551:         tcom
1.103     jwilke   2552:         compiling? 0=
1.1       anton    2553:     UNTIL ;
                   2554: 
                   2555: \ by the way: defining a second interpreter (a compiler-)loop
                   2556: \             is not allowed if a system should be ans conform
                   2557: 
1.110     jwilke   2558: : (:) ( ghost -- ) 
                   2559: \ common factor of : and :noname. Prepare ;Resolve and start definition
                   2560:    ;Resolve ! there ;Resolve cell+ !
                   2561:    docol, ]comp  colon-start depth T ] H ;
                   2562: 
1.1       anton    2563: : : ( -- colon-sys ) \ Name
1.52      jwilke   2564:   defempty?
                   2565:   constflag off \ don't let this flag work over colon defs
                   2566:                \ just to go sure nothing unwanted happens
1.43      pazsan   2567:   >in @ skip? IF  drop skip-defs  EXIT  THEN  >in !
1.110     jwilke   2568:   (THeader (:) ;
1.1       anton    2569: 
1.37      pazsan   2570: : :noname ( -- colon-sys )
1.110     jwilke   2571:   X cfalign there 
                   2572:   \ define a nameless ghost
                   2573:   here ghostheader dup last-header-ghost ! dup to lastghost
                   2574:   (:) ;  
1.37      pazsan   2575: 
1.103     jwilke   2576: Cond: EXIT ( -- )   compile ;S  ;Cond
1.6       anton    2577: 
                   2578: Cond: ?EXIT ( -- ) 1 abort" CROSS: using ?exit" ;Cond
1.2       pazsan   2579: 
1.52      jwilke   2580: >CROSS
                   2581: : LastXT ;Resolve @ 0= abort" CROSS: no definition for LastXT"
                   2582:          ;Resolve cell+ @ ;
                   2583: 
                   2584: >TARGET
                   2585: 
1.103     jwilke   2586: Cond: recurse ( -- ) Last-Header-Ghost @ gexecute ;Cond
1.52      jwilke   2587: 
1.103     jwilke   2588: Cond: ; ( -- ) 
1.105     jwilke   2589:        depth ?dup 
                   2590:        IF   1- <> ABORT" CROSS: Stack changed"
                   2591:        ELSE true ABORT" CROSS: Stack empty" 
                   2592:        THEN
                   2593:        colon-end
                   2594:        fini,
                   2595:        comp[
                   2596:        ;Resolve @ 
1.118     pazsan   2597:        IF  ['] colon-resolved ;Resolve @ >comp !
                   2598:            ;Resolve @ ;Resolve cell+ @ resolve 
1.105     jwilke   2599:        THEN
                   2600:        interpreting-state
                   2601:        ;Cond
                   2602: 
                   2603: Cond: [ ( -- ) interpreting-state ;Cond
1.1       anton    2604: 
                   2605: >CROSS
1.54      pazsan   2606: 
1.117     pazsan   2607: 0 Value created
1.54      pazsan   2608: 
1.52      jwilke   2609: : !does ( does-action -- )
1.54      pazsan   2610:     tlastcfa @ [G'] :dovar killref
1.117     pazsan   2611:     >space here >r ghostheader space>
1.121     jwilke   2612:     ['] colon-resolved r@ >comp !
1.117     pazsan   2613:     r@ created >do:ghost ! r@ swap resolve
                   2614:     r> tlastcfa @ >tempdp dodoes, tempdp> ;
1.103     jwilke   2615: 
                   2616: Defer instant-interpret-does>-hook
                   2617: 
1.134     pazsan   2618: T has? peephole H [IF]
1.118     pazsan   2619: : does-resolved ( ghost -- )
                   2620:     compile does-exec g>xt T a, H ;
1.134     pazsan   2621: [ELSE]
                   2622: : does-resolved ( ghost -- )
                   2623:     g>xt T a, H ;
                   2624: [THEN]
1.118     pazsan   2625: 
1.103     jwilke   2626: : resolve-does>-part ( -- )
                   2627: \ resolve words made by builders
1.105     jwilke   2628:   Last-Header-Ghost @ >do:ghost @ ?dup 
1.117     pazsan   2629:   IF  there resolve  THEN ;
1.103     jwilke   2630: 
1.1       anton    2631: >TARGET
1.103     jwilke   2632: Cond: DOES>
                   2633:         compile (does>) doeshandler,
                   2634:         resolve-does>-part
1.1       anton    2635:         ;Cond
1.103     jwilke   2636: 
1.118     pazsan   2637: : DOES>
                   2638:     ['] does-resolved created >comp !
                   2639:     switchrom doeshandler, T here H !does 
                   2640:     instant-interpret-does>-hook
                   2641:     depth T ] H ;
1.1       anton    2642: 
                   2643: >CROSS
1.108     jwilke   2644: \ Creation                                              01nov92py
1.1       anton    2645: 
                   2646: \ Builder                                               11may93jaw
                   2647: 
1.108     jwilke   2648: 0 Value built
                   2649: 
1.105     jwilke   2650: : Builder    ( Create-xt do-ghost "name" -- )
1.52      jwilke   2651: \ builds up a builder in current vocabulary
                   2652: \ create-xt is executed when word is interpreted
1.106     jwilke   2653: \ do:-xt is executed when the created word from builder is executed
1.105     jwilke   2654: \ for do:-xt an additional entry after the normal ghost-entrys is used
1.52      jwilke   2655: 
1.109     jwilke   2656:   ghost to built 
1.108     jwilke   2657:   built >created @ 0= IF
                   2658:     built >created on
                   2659:   THEN ;
1.1       anton    2660: 
1.52      jwilke   2661: : gdoes,  ( ghost -- )
                   2662: \ makes the codefield for a word that is built
1.103     jwilke   2663:   >do:ghost @ dup undefined? 0=
1.52      jwilke   2664:   IF
1.42      pazsan   2665:        dup >magic @ <do:> =
1.54      pazsan   2666:        IF       doer, 
                   2667:        ELSE    dodoes,
                   2668:        THEN
                   2669:        EXIT
1.52      jwilke   2670:   THEN
                   2671: \  compile :dodoes gexecute
                   2672: \  T here H tcell - reloff 
1.54      pazsan   2673:   2 refered 
                   2674:   0 fillcfa
                   2675:   ;
1.1       anton    2676: 
1.103     jwilke   2677: : takeover-x-semantics ( S constructor-ghost new-ghost -- )
1.117     pazsan   2678:    \g stores execution semantic and compilation semantic in the built word
                   2679:    swap >do:ghost @ 2dup swap >do:ghost !
1.110     jwilke   2680:    \ we use the >exec2 field for the semantic of a created word,
                   2681:    \ using exec or exec2 makes no difference for normal cross-compilation
                   2682:    \ but is usefull for instant where the exec field is already
                   2683:    \ defined (e.g. Vocabularies)
1.105     jwilke   2684:    2dup >exec @ swap >exec2 ! 
                   2685:    >comp @ swap >comp ! ;
1.103     jwilke   2686: 
1.118     pazsan   2687: 0 Value createhere
                   2688: 
                   2689: : create-resolve ( -- )
                   2690:     created createhere resolve 0 ;Resolve ! ;
                   2691: : create-resolve-immediate ( -- )
                   2692:     create-resolve T immediate H ;
                   2693: 
1.52      jwilke   2694: : TCreate ( <name> -- )
                   2695:   create-forward-warn
                   2696:   IF ['] reswarn-forward IS resolve-warning THEN
1.103     jwilke   2697:   executed-ghost @ (Theader
1.117     pazsan   2698:   dup >created on  dup to created
1.118     pazsan   2699:   2dup takeover-x-semantics
                   2700:   there to createhere drop gdoes, ;
1.52      jwilke   2701: 
                   2702: : RTCreate ( <name> -- )
                   2703: \ creates a new word with code-field in ram
                   2704:   create-forward-warn
                   2705:   IF ['] reswarn-forward IS resolve-warning THEN
                   2706:   \ make Alias
1.103     jwilke   2707:   executed-ghost @ (THeader 
1.118     pazsan   2708:   dup >created on  dup to created
1.103     jwilke   2709:   2dup takeover-x-semantics
1.105     jwilke   2710:   there 0 T a, H alias-mask flag!
1.103     jwilke   2711:   \ store poiter to code-field
1.52      jwilke   2712:   switchram T cfalign H
                   2713:   there swap T ! H
                   2714:   there tlastcfa ! 
1.118     pazsan   2715:   there to createhere drop gdoes, ;
1.1       anton    2716: 
                   2717: : Build:  ( -- [xt] [colon-sys] )
1.52      jwilke   2718:   :noname postpone TCreate ;
                   2719: 
                   2720: : BuildSmart:  ( -- [xt] [colon-sys] )
                   2721:   :noname
1.53      jwilke   2722:   [ T has? rom H [IF] ]
1.52      jwilke   2723:   postpone RTCreate
                   2724:   [ [ELSE] ]
                   2725:   postpone TCreate 
                   2726:   [ [THEN] ] ;
1.1       anton    2727: 
1.108     jwilke   2728: : ;Build
1.118     pazsan   2729:   postpone create-resolve postpone ; built >exec ! ; immediate
                   2730: 
                   2731: : ;Build-immediate
                   2732:     postpone create-resolve-immediate
                   2733:     postpone ; built >exec ! ; immediate
1.108     jwilke   2734: 
1.1       anton    2735: : gdoes>  ( ghost -- addr flag )
1.110     jwilke   2736:   executed-ghost @ g>body ;
1.1       anton    2737: 
                   2738: \ DO: ;DO                                               11may93jaw
                   2739: 
1.108     jwilke   2740: : do:ghost! ( ghost -- ) built >do:ghost ! ;
                   2741: : doexec! ( xt -- ) built >do:ghost @ >exec ! ;
                   2742: 
                   2743: : DO:     ( -- [xt] [colon-sys] )
                   2744:   here ghostheader do:ghost!
1.110     jwilke   2745:   :noname postpone gdoes> ;
1.1       anton    2746: 
1.108     jwilke   2747: : by:     ( -- [xt] [colon-sys] ) \ name
                   2748:   Ghost do:ghost!
1.110     jwilke   2749:   :noname postpone gdoes> ;
1.42      pazsan   2750: 
1.108     jwilke   2751: : ;DO ( [xt] [colon-sys] -- )
                   2752:   postpone ; doexec! ; immediate
1.1       anton    2753: 
1.109     jwilke   2754: : by      ( -- ) \ Name
1.108     jwilke   2755:   Ghost >do:ghost @ do:ghost! ;
1.107     jwilke   2756: 
1.109     jwilke   2757: : compile: ( --[xt] [colon-sys] )
1.107     jwilke   2758: \G defines a compile time action for created words
                   2759: \G by this builder
                   2760:   :noname ;
                   2761: 
1.109     jwilke   2762: : ;compile ( [xt] [colon-sys] -- )
                   2763:   postpone ; built >do:ghost @ >comp ! ; immediate
1.107     jwilke   2764: 
1.1       anton    2765: \ Variables and Constants                              05dec92py
                   2766: 
1.108     jwilke   2767: Builder (Constant)
                   2768: Build:  ( n -- ) ;Build
1.103     jwilke   2769: by: :docon ( target-body-addr -- n ) T @ H ;DO
1.52      jwilke   2770: 
1.108     jwilke   2771: Builder Constant
                   2772: Build:  ( n -- ) T , H ;Build
1.52      jwilke   2773: by (Constant)
                   2774: 
1.108     jwilke   2775: Builder AConstant
                   2776: Build:  ( n -- ) T A, H ;Build
1.52      jwilke   2777: by (Constant)
                   2778: 
1.108     jwilke   2779: Builder 2Constant
                   2780: Build:  ( d -- ) T , , H ;Build
1.52      jwilke   2781: DO: ( ghost -- d ) T dup cell+ @ swap @ H ;DO
                   2782: 
1.108     jwilke   2783: Builder Create
                   2784: BuildSmart: ;Build
1.103     jwilke   2785: by: :dovar ( target-body-addr -- addr ) ;DO
1.1       anton    2786: 
1.108     jwilke   2787: Builder Variable
1.53      jwilke   2788: T has? rom H [IF]
1.108     jwilke   2789: Build: ( -- ) T here 0 A, H switchram T align here swap ! 0 , H ( switchrom ) ;Build
1.52      jwilke   2790: by (Constant)
                   2791: [ELSE]
1.108     jwilke   2792: Build: T 0 , H ;Build
1.1       anton    2793: by Create
1.52      jwilke   2794: [THEN]
1.1       anton    2795: 
1.108     jwilke   2796: Builder 2Variable
1.53      jwilke   2797: T has? rom H [IF]
1.108     jwilke   2798: Build: ( -- ) T here 0 A, H switchram T align here swap ! 0 , 0 , H ( switchrom ) ;Build
1.54      pazsan   2799: by (Constant)
                   2800: [ELSE]
1.108     jwilke   2801: Build: T 0 , 0 , H ;Build
1.54      pazsan   2802: by Create
                   2803: [THEN]
                   2804: 
1.108     jwilke   2805: Builder AVariable
1.54      pazsan   2806: T has? rom H [IF]
1.108     jwilke   2807: Build: ( -- ) T here 0 A, H switchram T align here swap ! 0 A, H ( switchrom ) ;Build
1.52      jwilke   2808: by (Constant)
                   2809: [ELSE]
1.108     jwilke   2810: Build: T 0 A, H ;Build
1.1       anton    2811: by Create
1.52      jwilke   2812: [THEN]
1.1       anton    2813: 
1.3       pazsan   2814: \ User variables                                       04may94py
                   2815: 
1.139   ! jwilke   2816: : tup@ user-region >rstart @ ;
        !          2817: 
        !          2818: \ Variable tup  0 tup !
        !          2819: \ Variable tudp 0 tudp !
1.78      jwilke   2820: 
1.3       pazsan   2821: : u,  ( n -- udp )
1.139   ! jwilke   2822:   current-region >r user-region activate
        !          2823:   X here swap X , tup@ - 
        !          2824:   r> activate ;
1.78      jwilke   2825: 
1.3       pazsan   2826: : au, ( n -- udp )
1.139   ! jwilke   2827:   current-region >r user-region activate
        !          2828:   X here swap X a, tup@ - 
        !          2829:   r> activate ;
        !          2830: 
        !          2831: T has? no-userspace H [IF]
        !          2832: 
        !          2833: : buildby
        !          2834:   ghost >exec @ built >exec ! ;
        !          2835: 
        !          2836: Builder User
        !          2837: buildby Variable
        !          2838: by Variable
        !          2839: 
        !          2840: Builder 2User
        !          2841: buildby 2Variable
        !          2842: by 2Variable
        !          2843: 
        !          2844: Builder AUser
        !          2845: buildby AVariable
        !          2846: by AVariable
        !          2847: 
        !          2848: [ELSE]
1.78      jwilke   2849: 
1.108     jwilke   2850: Builder User
                   2851: Build: 0 u, X , ;Build
1.139   ! jwilke   2852: by: :douser ( ghost -- up-addr )  X @ tup@ + ;DO
1.1       anton    2853: 
1.108     jwilke   2854: Builder 2User
                   2855: Build: 0 u, X , 0 u, drop ;Build
1.3       pazsan   2856: by User
1.1       anton    2857: 
1.108     jwilke   2858: Builder AUser
                   2859: Build: 0 au, X , ;Build
1.3       pazsan   2860: by User
1.1       anton    2861: 
1.139   ! jwilke   2862: [THEN]
        !          2863: 
1.108     jwilke   2864: Builder (Value)
                   2865: Build:  ( n -- ) ;Build
                   2866: by: :docon ( target-body-addr -- n ) T @ H ;DO
                   2867: 
1.1       anton    2868: Builder Value
1.108     jwilke   2869: BuildSmart: T , H ;Build
                   2870: by (Value)
1.1       anton    2871: 
1.32      pazsan   2872: Builder AValue
1.108     jwilke   2873: BuildSmart: T A, H ;Build
                   2874: by (Value)
1.32      pazsan   2875: 
1.103     jwilke   2876: Defer texecute
                   2877: 
1.108     jwilke   2878: Builder Defer
                   2879: BuildSmart:  ( -- ) [T'] noop T A, H ;Build
1.103     jwilke   2880: by: :dodefer ( ghost -- ) X @ texecute ;DO
1.37      pazsan   2881: 
1.108     jwilke   2882: Builder interpret/compile:
1.118     pazsan   2883: Build: ( inter comp -- ) swap T A, A, H ;Build-immediate
1.37      pazsan   2884: DO: ( ghost -- ) ABORT" CROSS: Don't execute" ;DO
1.24      pazsan   2885: 
                   2886: \ Sturctures                                           23feb95py
                   2887: 
                   2888: : nalign ( addr1 n -- addr2 )
                   2889: \ addr2 is the aligned version of addr1 wrt the alignment size n
                   2890:  1- tuck +  swap invert and ;
1.109     jwilke   2891: 
1.24      pazsan   2892: 
1.108     jwilke   2893: Builder (Field)
                   2894: Build: ;Build
1.44      pazsan   2895: by: :dofield T @ H + ;DO
                   2896: 
1.108     jwilke   2897: Builder Field
1.51      anton    2898: Build: ( align1 offset1 align size "name" --  align2 offset2 )
                   2899:     rot dup T , H ( align1 align size offset1 )
1.108     jwilke   2900:     + >r nalign r> ;Build
1.44      pazsan   2901: by (Field)
1.24      pazsan   2902: 
1.109     jwilke   2903: >TARGET
1.51      anton    2904: : struct  T 1 chars 0 H ;
1.24      pazsan   2905: : end-struct  T 2Constant H ;
                   2906: 
1.52      jwilke   2907: : cell% ( n -- size align )
1.51      anton    2908:     T 1 cells H dup ;
1.109     jwilke   2909: >CROSS
1.88      pazsan   2910: 
1.105     jwilke   2911: \ Input-Methods                                            01py
1.103     jwilke   2912: 
1.108     jwilke   2913: Builder input-method
                   2914: Build: ( m v -- m' v )  dup T , cell+ H ;Build
1.88      pazsan   2915: DO:  abort" Not in cross mode" ;DO
                   2916: 
1.108     jwilke   2917: Builder input-var
                   2918: Build: ( m v size -- m v' )  over T , H + ;Build
1.88      pazsan   2919: DO:  abort" Not in cross mode" ;DO
1.24      pazsan   2920: 
1.108     jwilke   2921: \ Peephole optimization                                        05sep01jaw
                   2922: 
                   2923: \ this section defines different compilation
                   2924: \ actions for created words
                   2925: \ this will help the peephole optimizer
1.121     jwilke   2926: \ I (jaw) took this from bernds latest cross-compiler
1.108     jwilke   2927: \ changes but seperated it from the original
                   2928: \ Builder words. The final plan is to put this
                   2929: \ into a seperate file, together with the peephole
                   2930: \ optimizer for cross
                   2931: 
                   2932: 
                   2933: T has? peephole H [IF]
                   2934: 
1.139   ! jwilke   2935: \ .( loading peephole optimization) cr
        !          2936: 
1.109     jwilke   2937: >CROSS
1.118     pazsan   2938: 
1.109     jwilke   2939: : (callc) compile call T >body a, H ;          ' (callc) plugin-of colon,
1.121     jwilke   2940: : (callcm) T here 0 a, 0 a, H ;                 ' (callcm) plugin-of colonmark,
1.118     pazsan   2941: : (call-res) >tempdp resolved gexecute tempdp> drop ;
                   2942:                                                 ' (call-res) plugin-of colon-resolve
1.121     jwilke   2943: : (pprim) dup 0< IF  $4000 -  ELSE
                   2944:     cr ." wrong usage of (prim) "
                   2945:     dup gdiscover IF  .ghost  ELSE  .  THEN  cr -1 throw  THEN
                   2946:     T a, H ;                                   ' (pprim) plugin-of prim,
1.109     jwilke   2947: 
                   2948: \ if we want this, we have to spilt aconstant
                   2949: \ and constant!!
                   2950: \ Builder (Constant)
                   2951: \ compile: g>body X @ lit, ;compile
1.108     jwilke   2952: 
                   2953: Builder (Constant)
1.118     pazsan   2954: compile: g>body compile lit@ T a, H ;compile
1.108     jwilke   2955: 
                   2956: Builder (Value)
1.118     pazsan   2957: compile: g>body compile lit@ T a, H ;compile
1.108     jwilke   2958: 
                   2959: \ this changes also Variable, AVariable and 2Variable
                   2960: Builder Create
1.117     pazsan   2961: compile: g>body alit, ;compile
1.108     jwilke   2962: 
                   2963: Builder User
                   2964: compile: g>body compile useraddr T @ , H ;compile
                   2965: 
                   2966: Builder Defer
1.118     pazsan   2967: compile: g>body compile lit-perform T A, H ;compile
1.102     jwilke   2968: 
1.108     jwilke   2969: Builder (Field)
1.118     pazsan   2970: compile: g>body T @ H compile lit+ T , H ;compile
1.117     pazsan   2971: 
                   2972: Builder interpret/compile:
                   2973: compile: does-resolved ;compile
                   2974: 
                   2975: Builder input-method
                   2976: compile: does-resolved ;compile
                   2977: 
                   2978: Builder input-var
                   2979: compile: does-resolved ;compile
1.102     jwilke   2980: 
1.108     jwilke   2981: [THEN]
1.103     jwilke   2982: 
1.52      jwilke   2983: \ structural conditionals                              17dec92py
                   2984: 
                   2985: >CROSS
1.103     jwilke   2986: : (ncontrols?) ( n -- ) 
                   2987: \g We expect n open control structures
                   2988:   depth over u<= 
                   2989:   ABORT" CROSS: unstructured, stack underflow"
                   2990:   0 ?DO I pick 0= 
                   2991:         ABORT" CROSS: unstructured" 
                   2992:   LOOP ;                                       ' (ncontrols?) plugin-of ncontrols?
                   2993: 
                   2994: \ : ?struc      ( flag -- )       ABORT" CROSS: unstructured " ;
                   2995: \ : sys?        ( sys -- sys )    dup 0= ?struc ;
                   2996: 
1.52      jwilke   2997: : >mark       ( -- sys )        T here  ( dup ." M" hex. ) 0 , H ;
                   2998: 
1.133     pazsan   2999: X has? abranch [IF]
                   3000:     : branchoffset ( src dest -- )  drop ;
                   3001:     : offset, ( n -- )  X A, ;
                   3002: [ELSE]
                   3003:     : branchoffset ( src dest -- )  - tchar / ; \ ?? jaw
                   3004:     : offset, ( n -- )  X , ;
                   3005: [THEN]
1.52      jwilke   3006: 
1.133     pazsan   3007: :noname compile branch X here branchoffset offset, ;
1.54      pazsan   3008:   IS branch, ( target-addr -- )
1.133     pazsan   3009: :noname compile ?branch X here branchoffset offset, ;
1.54      pazsan   3010:   IS ?branch, ( target-addr -- )
1.133     pazsan   3011: :noname compile branch T here 0 H offset, ;
1.54      pazsan   3012:   IS branchmark, ( -- branchtoken )
1.133     pazsan   3013: :noname compile ?branch T here 0 H offset, ;
1.54      pazsan   3014:   IS ?branchmark, ( -- branchtoken )
1.133     pazsan   3015: :noname T here 0 H offset, ;
1.54      pazsan   3016:   IS ?domark, ( -- branchtoken )
1.78      jwilke   3017: :noname dup X @ ?struc X here over branchoffset swap X ! ;
1.54      pazsan   3018:   IS branchtoresolve, ( branchtoken -- )
1.78      jwilke   3019: :noname branchto, X here ;
1.54      pazsan   3020:   IS branchtomark, ( -- target-addr )
1.52      jwilke   3021: 
                   3022: >TARGET
                   3023: 
                   3024: \ Structural Conditionals                              12dec92py
                   3025: 
1.103     jwilke   3026: \ CLEANUP Cond: BUT       sys? swap ;Cond
                   3027: \ CLEANUP Cond: YET       sys? dup ;Cond
1.52      jwilke   3028: 
                   3029: >CROSS
                   3030: 
1.78      jwilke   3031: Variable tleavings 0 tleavings !
1.52      jwilke   3032: 
1.129     jwilke   3033: : (done) ( do-addr -- )
                   3034: \G resolve branches of leave and ?leave and ?do
                   3035: \G do-addr is the address of the beginning of our
                   3036: \G loop so we can take care of nested loops
1.54      pazsan   3037:     tleavings @
                   3038:     BEGIN  dup
                   3039:     WHILE
                   3040:        >r dup r@ cell+ @ \ address of branch
                   3041:        u> 0=      \ lower than DO?     
                   3042:     WHILE
                   3043:        r@ 2 cells + @ \ branch token
                   3044:        branchtoresolve,
                   3045:        r@ @ r> free throw
                   3046:     REPEAT  r>  THEN
                   3047:     tleavings ! drop ;
                   3048: 
1.53      jwilke   3049: >TARGET
                   3050: 
1.103     jwilke   3051: \ What for? ANS? JAW Cond: DONE   ( addr -- )  (done) ;Cond
1.53      jwilke   3052: 
                   3053: >CROSS
1.54      pazsan   3054: : (leave) ( branchtoken -- )
1.53      jwilke   3055:     3 cells allocate throw >r
                   3056:     T here H r@ cell+ !
                   3057:     r@ 2 cells + !
                   3058:     tleavings @ r@ !
                   3059:     r> tleavings ! ;
                   3060: >TARGET
                   3061: 
1.103     jwilke   3062: : (leave,) ( -- ) 
                   3063:   branchmark, (leave) ;                        ' (leave,) plugin-of leave,
                   3064: 
                   3065: : (?leave,) ( -- )
                   3066:   compile 0= ?branchmark, (leave) ;            ' (?leave,) plugin-of ?leave,
                   3067: 
                   3068: Cond: LEAVE     leave, ;Cond
                   3069: Cond: ?LEAVE    ?leave, ;Cond
1.53      jwilke   3070: 
1.54      pazsan   3071: >CROSS
                   3072: \ !!JW ToDo : Move to general tools section
                   3073: 
                   3074: : to1 ( x1 x2 xn n -- addr )
1.103     jwilke   3075: \G packs n stack elements in am allocated memory region
1.54      pazsan   3076:    dup dup 1+ cells allocate throw dup >r swap 1+
                   3077:    0 DO tuck ! cell+ LOOP
                   3078:    drop r> ;
1.103     jwilke   3079: 
1.54      pazsan   3080: : 1to ( addr -- x1 x2 xn )
                   3081: \G unpacks the elements saved by to1
                   3082:     dup @ swap over cells + swap
                   3083:     0 DO  dup @ swap 1 cells -  LOOP
                   3084:     free throw ;
                   3085: 
1.129     jwilke   3086: : loop] ( target-addr -- )
                   3087:   branchto, 
1.133     pazsan   3088:   dup  X here branchoffset offset, 
1.129     jwilke   3089:   tcell - (done) ;
1.54      pazsan   3090: 
                   3091: : skiploop] ?dup IF branchto, branchtoresolve, THEN ;
                   3092: 
                   3093: >TARGET
                   3094: 
1.52      jwilke   3095: \ Structural Conditionals                              12dec92py
                   3096: 
1.103     jwilke   3097: : (cs-swap) ( x1 x2 -- x2 x1 )
                   3098:   swap ;                                       ' (cs-swap) plugin-of cs-swap
                   3099: 
                   3100: : (ahead,) branchmark, ;                       ' (ahead,) plugin-of ahead,
                   3101: 
                   3102: : (if,) ?branchmark, ;                                 ' (if,) plugin-of if,
                   3103: 
                   3104: : (then,) branchto, branchtoresolve, ;                 ' (then,) plugin-of then,
                   3105: 
                   3106: : (else,) ( ahead ) branchmark, 
                   3107:           swap 
                   3108:           ( then ) branchto, branchtoresolve, ;        ' (else,) plugin-of else,
                   3109: 
                   3110: : (begin,) branchtomark, ;                     ' (begin,) plugin-of begin,
                   3111: 
                   3112: : (while,) ( if ) ?branchmark,
                   3113:            swap ;                              ' (while,) plugin-of while,
                   3114: 
                   3115: : (again,) branch, ;                           ' (again,) plugin-of again,
                   3116: 
                   3117: : (until,) ?branch, ;                          ' (until,) plugin-of until,
                   3118: 
                   3119: : (repeat,) ( again ) branch,
                   3120:             ( then ) branchto, branchtoresolve, ; ' (repeat,) plugin-of repeat,
                   3121: 
                   3122: : (case,)   ( -- n )
                   3123:   0 ;                                          ' (case,) plugin-of case,
                   3124: 
                   3125: : (of,) ( n -- x1 n )
                   3126:   1+ >r 
                   3127:   compile over compile = 
                   3128:   if, compile drop r> ;                                ' (of,) plugin-of of,
                   3129: 
                   3130: : (endof,) ( x1 n -- x2 n )
                   3131:   >r 1 ncontrols? else, r> ;                   ' (endof,) plugin-of endof,
                   3132: 
                   3133: : (endcase,) ( x1 .. xn n -- )
                   3134:   compile drop 0 ?DO 1 ncontrols? then, LOOP ; ' (endcase,) plugin-of endcase,
                   3135: 
1.53      jwilke   3136: >TARGET
1.103     jwilke   3137: Cond: AHEAD     ahead, ;Cond
                   3138: Cond: IF        if,  ;Cond
                   3139: Cond: THEN      1 ncontrols? then, ;Cond
                   3140: Cond: ENDIF     1 ncontrols? then, ;Cond
                   3141: Cond: ELSE      1 ncontrols? else, ;Cond
                   3142: 
                   3143: Cond: BEGIN     begin, ;Cond
                   3144: Cond: WHILE     1 ncontrols? while, ;Cond
                   3145: Cond: AGAIN     1 ncontrols? again, ;Cond
                   3146: Cond: UNTIL     1 ncontrols? until, ;Cond
                   3147: Cond: REPEAT    2 ncontrols? repeat, ;Cond
                   3148: 
                   3149: Cond: CASE      case, ;Cond
                   3150: Cond: OF        of, ;Cond
                   3151: Cond: ENDOF     endof, ;Cond
                   3152: Cond: ENDCASE   endcase, ;Cond
1.1       anton    3153: 
                   3154: \ Structural Conditionals                              12dec92py
                   3155: 
1.103     jwilke   3156: : (do,) ( -- target-addr )
                   3157:   \ ?? i think 0 is too much! jaw
1.54      pazsan   3158:     0 compile (do)
1.103     jwilke   3159:     branchtomark,  2 to1 ;                     ' (do,) plugin-of do,
1.54      pazsan   3160: 
1.103     jwilke   3161: \ alternative for if no ?do
                   3162: \ : (do,)
1.54      pazsan   3163: \     compile 2dup compile = compile IF
                   3164: \     compile 2drop compile ELSE
                   3165: \     compile (do) branchtomark, 2 to1 ;
                   3166:     
1.103     jwilke   3167: : (?do,) ( -- target-addr )
1.54      pazsan   3168:     0 compile (?do)  ?domark, (leave)
1.103     jwilke   3169:     branchtomark,  2 to1 ;                     ' (?do,) plugin-of ?do,
                   3170: 
                   3171: : (for,) ( -- target-addr )
                   3172:   compile (for) branchtomark, ;                        ' (for,) plugin-of for,
                   3173: 
                   3174: : (loop,) ( target-addr -- )
                   3175:   1to compile (loop)  loop] 
                   3176:   compile unloop skiploop] ;                   ' (loop,) plugin-of loop,
                   3177: 
                   3178: : (+loop,) ( target-addr -- )
                   3179:   1to compile (+loop)  loop] 
                   3180:   compile unloop skiploop] ;                   ' (+loop,) plugin-of +loop,
                   3181: 
                   3182: : (next,) 
                   3183:   compile (next)  loop] compile unloop ;       ' (next,) plugin-of next,
                   3184: 
                   3185: Cond: DO       do, ;Cond
                   3186: Cond: ?DO      ?do, ;Cond
                   3187: Cond: FOR      for, ;Cond
                   3188: 
                   3189: Cond: LOOP     1 ncontrols? loop, ;Cond
                   3190: Cond: +LOOP    1 ncontrols? +loop, ;Cond
                   3191: Cond: NEXT     1 ncontrols? next, ;Cond
1.52      jwilke   3192: 
1.1       anton    3193: \ String words                                         23feb93py
                   3194: 
1.103     jwilke   3195: : ,"            [char] " parse ht-string, X align ;
1.1       anton    3196: 
1.130     pazsan   3197: X has? control-rack [IF]
1.103     jwilke   3198: Cond: ."        compile (.")     T ," H ;Cond
                   3199: Cond: S"        compile (S")     T ," H ;Cond
                   3200: Cond: C"        compile (C")     T ," H ;Cond
                   3201: Cond: ABORT"    compile (ABORT") T ," H ;Cond
1.130     pazsan   3202: [ELSE]
                   3203: Cond: ."        '" parse tuck 2>r ahead, there 2r> ht-mem, X align
                   3204:                 >r then, r> compile ALiteral compile Literal compile type ;Cond
                   3205: Cond: S"        '" parse tuck 2>r ahead, there 2r> ht-mem, X align
                   3206:                 >r then, r> compile ALiteral compile Literal ;Cond
                   3207: Cond: C"        ahead, there [char] " parse ht-string, X align
                   3208:                 >r then, r> compile ALiteral ;Cond
                   3209: Cond: ABORT"    if, ahead, there [char] " parse ht-string, X align
                   3210:                 >r then, r> compile ALiteral compile c(abort") then, ;Cond
                   3211: [THEN]
1.1       anton    3212: 
                   3213: Cond: IS        T ' >body H compile ALiteral compile ! ;Cond
1.66      pazsan   3214: : IS            T >address ' >body ! H ;
1.9       pazsan   3215: Cond: TO        T ' >body H compile ALiteral compile ! ;Cond
                   3216: : TO            T ' >body ! H ;
1.1       anton    3217: 
1.52      jwilke   3218: Cond: defers   T ' >body @ compile, H ;Cond
                   3219: 
1.1       anton    3220: \ LINKED ERR" ENV" 2ENV"                                18may93jaw
                   3221: 
                   3222: \ linked list primitive
1.79      jwilke   3223: : linked        X here over X @ X A, swap X ! ;
1.52      jwilke   3224: : chained      T linked A, H ;
1.1       anton    3225: 
                   3226: : err"   s" ErrLink linked" evaluate T , H
1.103     jwilke   3227:          [char] " parse ht-string, X align ;
1.1       anton    3228: 
                   3229: : env"  [char] " parse s" EnvLink linked" evaluate
1.103     jwilke   3230:         ht-string, X align X , ;
1.1       anton    3231: 
                   3232: : 2env" [char] " parse s" EnvLink linked" evaluate
1.103     jwilke   3233:         here >r ht-string, X align X , X ,
1.1       anton    3234:         r> dup T c@ H 80 and swap T c! H ;
                   3235: 
                   3236: \ compile must be last                                 22feb93py
                   3237: 
1.103     jwilke   3238: Cond: [compile] ( -- ) \ name
                   3239: \g For immediate words, works even if forward reference
                   3240:       bl word gfind 0= ABORT" CROSS: Can't compile"
                   3241:       (gexecute) ;Cond
                   3242:           
                   3243: Cond: postpone ( -- ) \ name
                   3244:       bl word gfind 0= ABORT" CROSS: Can't compile"
                   3245:       dup >magic @ <fwd> =
                   3246:       ABORT" CROSS: Can't postpone on forward declaration"
                   3247:       dup >magic @ <imm> =
                   3248:       IF   (gexecute)
                   3249:       ELSE compile (compile) addr, THEN ;Cond
1.54      pazsan   3250:           
1.77      jwilke   3251: \ save-cross                                           17mar93py
                   3252: 
                   3253: hex
                   3254: 
                   3255: >CROSS
1.131     anton    3256: Create magic  s" Gforth3x" here over allot swap move
1.77      jwilke   3257: 
                   3258: bigendian 1+ \ strangely, in magic big=0, little=1
                   3259: tcell 1 = 0 and or
                   3260: tcell 2 = 2 and or
                   3261: tcell 4 = 4 and or
                   3262: tcell 8 = 6 and or
                   3263: tchar 1 = 00 and or
                   3264: tchar 2 = 28 and or
                   3265: tchar 4 = 50 and or
                   3266: tchar 8 = 78 and or
                   3267: magic 7 + c!
                   3268: 
                   3269: : save-cross ( "image-name" "binary-name" -- )
                   3270:   bl parse ." Saving to " 2dup type cr
                   3271:   w/o bin create-file throw >r
1.113     jwilke   3272:   s" header" X $has? IF
1.80      anton    3273:       s" #! "           r@ write-file throw
                   3274:       bl parse          r@ write-file throw
                   3275:       s"  --image-file" r@ write-file throw
1.77      jwilke   3276:       #lf       r@ emit-file throw
                   3277:       r@ dup file-position throw drop 8 mod 8 swap ( file-id limit index )
                   3278:       ?do
                   3279:          bl over emit-file throw
                   3280:       loop
                   3281:       drop
                   3282:       magic 8       r@ write-file throw \ write magic
                   3283:   ELSE
                   3284:       bl parse 2drop
                   3285:   THEN
1.139   ! jwilke   3286:   dictionary >rmem @ there
1.77      jwilke   3287:   r@ write-file throw \ write image
1.113     jwilke   3288:   s" relocate" X $has? IF
1.139   ! jwilke   3289:       dictionary >rbm @ there 1- tcell>bit rshift 1+
1.77      jwilke   3290:                 r@ write-file throw \ write tags
                   3291:   THEN
                   3292:   r> close-file throw ;
                   3293: 
                   3294: : save-region ( addr len -- )
                   3295:   bl parse w/o bin create-file throw >r
                   3296:   swap >image swap r@ write-file throw
                   3297:   r> close-file throw ;
                   3298: 
1.110     jwilke   3299: \ save-asm-region                                      29aug01jaw
1.103     jwilke   3300: 
                   3301: Variable name-ptr
                   3302: Create name-buf 200 chars allot
                   3303: : init-name-buf name-buf name-ptr ! ;
                   3304: : nb, name-ptr @ c! 1 chars name-ptr +! ;
                   3305: : $nb, ( adr len -- ) bounds ?DO I c@ nb, LOOP ;
                   3306: : @nb name-ptr @ name-buf tuck - ;
                   3307: 
                   3308: \ stores a usefull string representation of the character
                   3309: \ in the name buffer
                   3310: : name-char, ( c -- )
                   3311:   dup 'a 'z 1+ within IF nb, EXIT THEN
                   3312:   dup 'A 'Z 1+ within IF $20 + nb, EXIT THEN
                   3313:   dup '0 '9 1+ within IF nb, EXIT THEN
                   3314:   CASE '+ OF s" _PLUS" $nb, ENDOF
                   3315:        '- OF s" _MINUS" $nb, ENDOF
                   3316:        '* OF s" _STAR" $nb, ENDOF
                   3317:        '/ OF s" _SLASH" $nb, ENDOF
                   3318:        '' OF s" _TICK" $nb, ENDOF
                   3319:        '( OF s" _OPAREN" $nb, ENDOF
                   3320:        ') OF s" _CPAREN" $nb, ENDOF
                   3321:        '[ OF s" _OBRACKET" $nb, ENDOF
                   3322:        '] OF s" _CBRACKET" $nb, ENDOF
                   3323:        '! OF s" _STORE" $nb, ENDOF
                   3324:        '@ OF s" _FETCH" $nb, ENDOF
                   3325:        '> OF s" _GREATER" $nb, ENDOF
                   3326:        '< OF s" _LESS" $nb, ENDOF
                   3327:        '= OF s" _EQUAL" $nb, ENDOF
                   3328:        '# OF s" _HASH" $nb, ENDOF
                   3329:        '? OF s" _QUEST" $nb, ENDOF
                   3330:        ': OF s" _COL" $nb, ENDOF
                   3331:        '; OF s" _SEMICOL" $nb, ENDOF
                   3332:        ', OF s" _COMMA" $nb, ENDOF
                   3333:        '. OF s" _DOT" $nb, ENDOF
                   3334:        '" OF s" _DQUOT" $nb, ENDOF
                   3335:        dup 
                   3336:        base @ >r hex s>d <# #s 'X hold '_ hold #> $nb, r> base !
                   3337:   ENDCASE ;
                   3338:  
                   3339: : label-from-ghostname ( ghost -- addr len )
                   3340:   dup >ghostname init-name-buf 'L nb, bounds 
                   3341:   ?DO I c@ name-char, LOOP 
                   3342:   \ we add the address to a name to make in unique
                   3343:   \ because one name may appear more then once
                   3344:   \ there are names (e.g. boot) that may be reference from other
                   3345:   \ assembler source files, so we declare them as unique
                   3346:   \ and don't add the address suffix
                   3347:   dup >ghost-flags @ <unique> and 0= 
                   3348:   IF   s" __" $nb, >link @ base @ >r hex 0 <# #s 'L hold #> r> base ! $nb, 
                   3349:   ELSE drop 
                   3350:   THEN
                   3351:   @nb ;
                   3352: 
1.111     jwilke   3353: \ FIXME why disabled?!
1.103     jwilke   3354: : label-from-ghostnameXX ( ghost -- addr len )
                   3355: \ same as (label-from-ghostname) but caches generated names
                   3356:   dup >asm-name @ ?dup IF nip count EXIT THEN
                   3357:  \ dup >r (label-from-ghostname) 2dup
                   3358:   align here >r string, align
                   3359:   r> r> >asm-name ! ;
                   3360: 
                   3361: : primghostdiscover ( xt -- ghost true | xt false )
                   3362:   dup 0= IF false EXIT THEN
                   3363:   >r last-prim-ghost
                   3364:   BEGIN @ dup
                   3365:   WHILE dup >asm-dummyaddr @ r@ =
                   3366:         IF rdrop true EXIT THEN
                   3367:   REPEAT
                   3368:   drop r> false ;
                   3369: 
                   3370: : gdiscover2 ( xt -- ghost true | xt false ) 
                   3371:   dup taddr>region 0= IF false EXIT THEN
                   3372:   dup (>regiontype) @ dup 0= IF drop false EXIT THEN
                   3373:   addr-xt-ghost @ dup 0= IF drop false EXIT THEN
                   3374:   nip true ;
                   3375: \  dup >ghost-name @ IF nip true ELSE drop false THEN ;
                   3376: 
                   3377: \ generates a label name for the target address
                   3378: : generate-label-name ( taddr -- addr len )
                   3379:   gdiscover2
                   3380:   IF dup >magic @ <do:> =
                   3381:      IF >asm-name @ count EXIT THEN
                   3382:      label-from-ghostname
                   3383:   ELSE
                   3384:      primghostdiscover
                   3385:      IF   >asm-name @ count 
                   3386:      ELSE base @ >r hex 0 <# #s 'L hold #> r> base !
                   3387:      THEN
                   3388:   THEN ;
                   3389: 
                   3390: Variable outfile-fd
                   3391: 
                   3392: : $out ( adr len -- ) outfile-fd @ write-file throw  ;
                   3393: : nlout newline $out ;
                   3394: : .ux ( n -- ) 
                   3395:   base @ hex swap 0 <# #S #> $out base ! ;
                   3396: 
                   3397: : save-asm-region-part-aligned ( taddr len -- 'taddr 'len )
                   3398:   dup cell/ 0 
                   3399:   ?DO nlout s"    .word " $out over @relbit 
                   3400:       IF   over X @ generate-label-name $out
                   3401:       ELSE over X @ s" 0x0" $out .ux
                   3402:       THEN
                   3403:       tcell /string
                   3404:   LOOP ;
                   3405: 
                   3406: : print-bytes ( taddr len n -- taddr' len' )
                   3407:   over min dup 0> 
                   3408:   IF   nlout s"    .byte " $out 0 
                   3409:        ?DO  I 0> IF s" , " $out THEN
                   3410:             over X c@ s" 0x0" $out .ux 1 /string 
                   3411:        LOOP 
                   3412:   THEN ;
                   3413: 
                   3414: : save-asm-region-part ( addr len -- )
                   3415:   over dup X aligned swap - ?dup
                   3416:   IF   print-bytes THEN
                   3417:   save-asm-region-part-aligned
                   3418:   dup dup X aligned swap - ?dup
                   3419:   IF   2 pick @relbit ABORT" relocated field splitted"
                   3420:        print-bytes
                   3421:   THEN
                   3422:   2drop ;
                   3423: 
                   3424: : print-label ( taddr -- )
                   3425:   nlout generate-label-name $out s" :" $out ;
                   3426: 
                   3427: : snl-calc ( taddr taddr2 -- )
                   3428:   tuck over - ;
                   3429: 
                   3430: : skip-nolables ( taddr -- taddr2 taddr len )
                   3431: \G skips memory region where no lables are defined
                   3432: \G starting from taddr+1
                   3433: \G Labels will be introduced for each reference mark
                   3434: \G in addr-refs.
                   3435: \G This word deals with lables at byte addresses as well.
                   3436: \G The main idea is to have an intro part which
                   3437: \G skips until the next cell boundary, the middle part
                   3438: \G which skips whole cells very efficiently and the third
                   3439: \G part which skips the bytes to the label in a cell
                   3440:   dup 1+ dup (>regiontype) 
                   3441:   ( S taddr taddr-realstart type-addr )
                   3442:   dup @ dup IF addr-refs @ THEN
                   3443:   swap >r
                   3444:   over align+ tuck tcell swap - rshift swap 0
1.126     jwilke   3445:   ?DO dup 1 and 
1.103     jwilke   3446:      IF drop rdrop snl-calc UNLOOP EXIT THEN 
                   3447:      2/ swap 1+ swap 
                   3448:   LOOP
                   3449:   drop r> cell+
                   3450:   ( S .. taddr2 type-addr ) dup
                   3451:   BEGIN dup @ dup IF addr-refs @ THEN 0= WHILE cell+ REPEAT
                   3452:   dup >r swap - 1 cells / tcell * + r>
                   3453:   ( S .. taddr2+skiplencells type-addr )
                   3454:   @ addr-refs @ 1 tcell lshift or
                   3455:   BEGIN dup 1 and 0= WHILE swap 1+ swap 2/ REPEAT drop
                   3456:   ( S .. taddr2+skiplencells+skiplenbytes )
                   3457:   snl-calc ;
                   3458: 
                   3459: : insert-label ( taddr -- )
                   3460:   dup 0= IF drop EXIT THEN
                   3461:   \ ignore everything which points outside our memory regions
                   3462:   \ maybe a primitive pointer or whatever
                   3463:   dup taddr>region 0= IF drop EXIT THEN
                   3464:   dup >r (>regiontype) define-addr-struct addr-refs dup @ 
                   3465:   r> tcell 1- and 1 swap lshift or swap ! ;
                   3466: 
                   3467: \ this generates a sorted list of addresses which must be labels
                   3468: \ it scans therefore a whole region
                   3469: : generate-label-list-region ( taddr len -- )
                   3470:   BEGIN over @relbit IF over X @ insert-label THEN
                   3471:         tcell /string dup 0< 
                   3472:   UNTIL 2drop ;
                   3473: 
                   3474: : generate-label-list ( -- )
                   3475:   region-link
                   3476:   BEGIN @ dup WHILE 
                   3477:         dup 0 >rlink - extent 
                   3478:         ?dup IF generate-label-list-region ELSE drop THEN
                   3479:   REPEAT drop ;
                   3480: 
                   3481: : create-outfile ( addr len -- )
                   3482:   w/o bin create-file throw outfile-fd ! ;
                   3483: 
                   3484: : close-outfile ( -- )
                   3485:   outfile-fd @ close-file throw ;
                   3486: 
                   3487: : (save-asm-region) ( region -- )
                   3488:   \ ." label list..."
                   3489:   generate-label-list
                   3490:   \ ." ok!" cr
                   3491:   extent ( S taddr len )
                   3492:   over insert-label
                   3493:   2dup + dup insert-label >r ( R end-label )
                   3494:   ( S taddr len ) drop
                   3495:   BEGIN
                   3496:      dup print-label
                   3497:      dup r@ <> WHILE
                   3498:      skip-nolables save-asm-region-part
                   3499:   REPEAT drop rdrop ;
                   3500: 
                   3501: : lineout ( addr len -- )
                   3502:   outfile-fd @ write-line throw ;  
                   3503: 
                   3504: : save-asm-region ( region adr len -- )
                   3505:   create-outfile (save-asm-region) close-outfile ;
                   3506: 
1.54      pazsan   3507: \ \ minimal definitions
                   3508:           
1.77      jwilke   3509: >MINIMAL also minimal
                   3510: 
1.1       anton    3511: \ Usefull words                                        13feb93py
                   3512: 
                   3513: : KB  400 * ;
                   3514: 
1.54      pazsan   3515: \ \ [IF] [ELSE] [THEN] ...                             14sep97jaw
                   3516: 
                   3517: \ it is useful to define our own structures and not to rely
1.109     jwilke   3518: \ on the words in the host system
                   3519: \ The words in the host system might be defined with vocabularies
1.54      pazsan   3520: \ this doesn't work with our self-made compile-loop
                   3521: 
                   3522: Create parsed 20 chars allot   \ store word we parsed
                   3523: 
                   3524: : upcase
                   3525:     parsed count bounds
                   3526:     ?DO I c@ toupper I c! LOOP ;
                   3527: 
                   3528: : [ELSE]
                   3529:     1 BEGIN
                   3530:        BEGIN bl word count dup WHILE
1.77      jwilke   3531:            comment? 20 umin parsed place upcase parsed count
1.128     anton    3532:            2dup s" [IF]" str= >r 
                   3533:            2dup s" [IFUNDEF]" str= >r
                   3534:            2dup s" [IFDEF]" str= r> or r> or
1.54      pazsan   3535:            IF   2drop 1+
1.128     anton    3536:            ELSE 2dup s" [ELSE]" str=
1.54      pazsan   3537:                IF   2drop 1- dup
                   3538:                    IF 1+
                   3539:                    THEN
                   3540:                ELSE
1.128     anton    3541:                    2dup s" [ENDIF]" str= >r
                   3542:                    s" [THEN]" str= r> or
1.54      pazsan   3543:                    IF 1- THEN
                   3544:                THEN
                   3545:            THEN
                   3546:            ?dup 0= ?EXIT
                   3547:        REPEAT
                   3548:        2drop refill 0=
                   3549:     UNTIL drop ; immediate
                   3550:   
                   3551: : [THEN] ( -- ) ; immediate
                   3552: 
                   3553: : [ENDIF] ( -- ) ; immediate
                   3554: 
                   3555: : [IF] ( flag -- )
                   3556:     0= IF postpone [ELSE] THEN ; immediate 
                   3557: 
                   3558: Cond: [IF]      postpone [IF] ;Cond
                   3559: Cond: [THEN]    postpone [THEN] ;Cond
                   3560: Cond: [ELSE]    postpone [ELSE] ;Cond
                   3561: 
1.1       anton    3562: \ define new [IFDEF] and [IFUNDEF]                      20may93jaw
                   3563: 
1.77      jwilke   3564: : defined? tdefined? ;
1.44      pazsan   3565: : needed? needed? ;
                   3566: : doer? doer? ;
1.1       anton    3567: 
1.52      jwilke   3568: \ we want to use IFDEF on compiler directives (e.g. E?) in the source, too
                   3569: 
                   3570: : directive? 
1.77      jwilke   3571:   bl word count [ ' target >wordlist ] literal search-wordlist 
1.52      jwilke   3572:   dup IF nip THEN ;
                   3573: 
                   3574: : [IFDEF]  >in @ directive? swap >in !
1.77      jwilke   3575:           0= IF tdefined? ELSE name 2drop true THEN
1.52      jwilke   3576:           postpone [IF] ;
                   3577: 
1.77      jwilke   3578: : [IFUNDEF] tdefined? 0= postpone [IF] ;
1.1       anton    3579: 
1.54      pazsan   3580: Cond: [IFDEF]   postpone [IFDEF] ;Cond
                   3581: 
                   3582: Cond: [IFUNDEF] postpone [IFUNDEF] ;Cond
                   3583: 
1.1       anton    3584: \ C: \- \+ Conditional Compiling                         09jun93jaw
                   3585: 
1.77      jwilke   3586: : C: >in @ tdefined? 0=
                   3587:      IF    >in ! X :
1.1       anton    3588:      ELSE drop
                   3589:         BEGIN bl word dup c@
1.128     anton    3590:               IF   count comment? s" ;" str= ?EXIT
1.1       anton    3591:               ELSE refill 0= ABORT" CROSS: Out of Input while C:"
                   3592:               THEN
                   3593:         AGAIN
                   3594:      THEN ;
                   3595: 
1.74      jwilke   3596: : d? d? ;
                   3597: 
1.123     jwilke   3598: : \D ( -- "debugswitch" ) 
1.74      jwilke   3599: \G doesn't skip line when debug switch is on
1.123     jwilke   3600:     D? 0= IF postpone \ THEN ;
1.52      jwilke   3601: 
1.123     jwilke   3602: : \- ( -- "wordname" )
1.48      anton    3603: \G interprets the line if word is not defined
1.123     jwilke   3604:    tdefined? IF postpone \ THEN ;
1.48      anton    3605: 
1.123     jwilke   3606: : \+ ( -- "wordname" )
1.48      anton    3607: \G interprets the line if word is defined
1.123     jwilke   3608:    tdefined? 0= IF postpone \ THEN ;
                   3609: 
                   3610: : \? ( -- "envorinstring" )
                   3611: \G Skip line if environmental variable evaluates to false
                   3612:    X has? 0= IF postpone \ THEN ;
1.1       anton    3613: 
1.48      anton    3614: Cond: \- \- ;Cond
                   3615: Cond: \+ \+ ;Cond
1.52      jwilke   3616: Cond: \D \D ;Cond
1.123     jwilke   3617: Cond: \? \? ;Cond
1.48      anton    3618: 
                   3619: : ?? bl word find IF execute ELSE drop 0 THEN ;
                   3620: 
                   3621: : needed:
                   3622: \G defines ghost for words that we want to be compiled
1.103     jwilke   3623:   BEGIN >in @ bl word c@ WHILE >in ! Ghost drop REPEAT drop ;
1.48      anton    3624: 
1.1       anton    3625: \ words that should be in minimal
1.52      jwilke   3626: 
                   3627: create s-buffer 50 chars allot
                   3628: 
1.77      jwilke   3629: bigendian Constant bigendian
1.1       anton    3630: 
1.52      jwilke   3631: : here there ;
1.67      jwilke   3632: : equ constant ;
                   3633: : mark there constant ;
1.54      pazsan   3634: 
                   3635: \ compiler directives
1.52      jwilke   3636: : >ram >ram ;
                   3637: : >rom >rom ;
                   3638: : >auto >auto ;
                   3639: : >tempdp >tempdp ;
                   3640: : tempdp> tempdp> ;
                   3641: : const constflag on ;
1.103     jwilke   3642: 
                   3643: : Redefinitions-start
                   3644: \G Starts a redefinition section. Warnings are disabled and
                   3645: \G existing ghosts are reused. This is used in the kernel
                   3646: \G where ( and \ and the like are redefined
                   3647:   twarnings off warnings off reuse-ghosts on ;
                   3648: 
                   3649: : Redefinitions-end
                   3650: \G Ends a redefinition section. Warnings are enabled again.
                   3651:   twarnings on warnings on reuse-ghosts off ;
                   3652: 
                   3653: : warnings name 3 = 
                   3654:   IF twarnings off warnings off ELSE twarnings on warnings on THEN drop ;
1.102     jwilke   3655: 
1.60      anton    3656: : | ;
                   3657: \ : | NoHeaderFlag on ; \ This is broken (damages the last word)
1.52      jwilke   3658: 
1.48      anton    3659: : save-cross save-cross ;
1.52      jwilke   3660: : save-region save-region ;
                   3661: : tdump swap >image swap dump ;
                   3662: 
1.48      anton    3663: also forth 
1.52      jwilke   3664: [IFDEF] Label           : Label defempty? Label ; [THEN] 
                   3665: [IFDEF] start-macros    : start-macros defempty? start-macros ; [THEN]
1.77      jwilke   3666: \ [IFDEF] builttag     : builttag builttag ;   [THEN]
1.48      anton    3667: previous
                   3668: 
1.52      jwilke   3669: : s" [char] " parse s-buffer place s-buffer count ; \ for environment?
1.43      pazsan   3670: : + + ;
1.52      jwilke   3671: : 1+ 1 + ;
                   3672: : 2+ 2 + ;
1.43      pazsan   3673: : 1- 1- ;
                   3674: : - - ;
1.52      jwilke   3675: : and and ;
                   3676: : or or ;
1.43      pazsan   3677: : 2* 2* ;
                   3678: : * * ;
                   3679: : / / ;
                   3680: : dup dup ;
1.139   ! jwilke   3681: : ?dup ?dup ;
1.43      pazsan   3682: : over over ;
                   3683: : swap swap ;
                   3684: : rot rot ;
                   3685: : drop drop ;
1.139   ! jwilke   3686: : 2drop 2drop ;
1.43      pazsan   3687: : =   = ;
1.122     jwilke   3688: : <>  <> ;
1.43      pazsan   3689: : 0=   0= ;
                   3690: : lshift lshift ;
                   3691: : 2/ 2/ ;
1.139   ! jwilke   3692: : hex. base @ $10 base ! swap . base ! ;
        !          3693: : invert invert ;
1.103     jwilke   3694: \ : . . ;
1.1       anton    3695: 
1.79      jwilke   3696: : all-words    ['] forced?    IS skip? ;
1.43      pazsan   3697: : needed-words ['] needed?  IS skip? ;
1.75      jwilke   3698: : undef-words  ['] defined2? IS skip? ;
                   3699: : skipdef skipdef ;
1.1       anton    3700: 
1.40      pazsan   3701: : \  postpone \ ;  immediate
1.47      pazsan   3702: : \G T-\G ; immediate
1.40      pazsan   3703: : (  postpone ( ;  immediate
1.1       anton    3704: : include bl word count included ;
1.103     jwilke   3705: : included swap >image swap included ;
1.52      jwilke   3706: : require require ;
1.103     jwilke   3707: : needs require ;
1.1       anton    3708: : .( [char] ) parse type ;
1.139   ! jwilke   3709: : ERROR" [char] " parse 
        !          3710:   rot 
        !          3711:   IF cr ." *** " type ."  ***" -1 ABORT" CROSS: Target error, see text above" 
        !          3712:   ELSE 2drop 
        !          3713:   THEN ;
1.52      jwilke   3714: : ." [char] " parse type ;
1.1       anton    3715: : cr cr ;
                   3716: 
1.77      jwilke   3717: : times 0 ?DO dup X c, LOOP drop ; \ used for space table creation
                   3718: 
                   3719: \ only forth also cross also minimal definitions order
1.1       anton    3720: 
                   3721: \ cross-compiler words
                   3722: 
1.103     jwilke   3723: : decimal       decimal [g'] decimal >exec2 @ ?dup IF EXECUTE THEN ;
                   3724: : hex           hex [g'] hex >exec2 @ ?dup IF EXECUTE THEN ;
1.1       anton    3725: 
1.77      jwilke   3726: \ : tudp          X tudp ;
                   3727: \ : tup           X tup ;
                   3728: 
                   3729: : doc-off       false to-doc ! ;
                   3730: : doc-on        true  to-doc ! ;
1.39      pazsan   3731: 
1.103     jwilke   3732: : declareunique ( "name" -- )
1.127     anton    3733: \ Sets the unique flag for a ghost. The assembler output
                   3734: \ generates labels with the ghostname concatenated with the address
                   3735: \ while cross-compiling. The address is concatenated
                   3736: \ because we have double occurences of the same name.
                   3737: \ If we want to reference the labels from the assembler or C
                   3738: \ code we declare them unique, so the address is skipped.
1.103     jwilke   3739:   Ghost >ghost-flags dup @ <unique> or swap ! ;
                   3740: 
                   3741: \ [IFDEF] dbg : dbg dbg ; [THEN]
1.39      pazsan   3742: 
1.1       anton    3743: \ for debugging...
1.103     jwilke   3744: \ : dbg dbg ;
                   3745: : horder         order ;
                   3746: : hwords        words ;
                   3747: \ : words      also ghosts 
                   3748: \                words previous ;
1.105     jwilke   3749: : .s            .s ;
1.122     jwilke   3750: : depth         depth ;
1.1       anton    3751: : bye           bye ;
1.99      pazsan   3752: 
1.103     jwilke   3753: \ dummy
                   3754: 
1.1       anton    3755: \ turnkey direction
                   3756: : H forth ; immediate
                   3757: : T minimal ; immediate
                   3758: : G ghosts ; immediate
                   3759: 
                   3760: 
                   3761: \ these ones are pefered:
                   3762: 
1.74      jwilke   3763: : unlock previous forth also cross ;
1.52      jwilke   3764: 
1.77      jwilke   3765: \ also minimal
1.103     jwilke   3766: >cross
                   3767: 
                   3768: : turnkey 
                   3769:    ghosts-wordlist 1 set-order
                   3770:    also target definitions
                   3771:    also Minimal also ;
                   3772: 
                   3773: >minimal
                   3774: 
                   3775: : [[+++
                   3776:   turnkey unlock ;
1.1       anton    3777: 
                   3778: unlock definitions also minimal
1.77      jwilke   3779: 
1.103     jwilke   3780: : lock   turnkey ;
                   3781: 
                   3782: Defer +++]]-hook
                   3783: : +++]] +++]]-hook lock ;
                   3784: 
                   3785: LOCK
1.77      jwilke   3786: \ load cross compiler extension defined in mach file
                   3787: 
                   3788: UNLOCK >CROSS
                   3789: 
                   3790: [IFDEF] extend-cross extend-cross [THEN]
                   3791: 
                   3792: LOCK

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