Diff for /gforth/code.fs between versions 1.18 and 1.21

version 1.18, 2010/04/05 22:17:56 version 1.21, 2010/04/17 21:31:36
Line 22 Line 22
 \ defined for all machines.  \ defined for all machines.
   
 vocabulary assembler ( -- ) \ tools-ext  vocabulary assembler ( -- ) \ tools-ext
   \g A vocubulary: Replaces the wordlist at the top of the search order
   \g with the assembler wordlist.
   
 : init-asm ( -- ) \ gforth  : init-asm ( -- ) \ gforth
   \g Pushes the assembler wordlist on the search order.
     also assembler ;      also assembler ;
       
 : code ( "name" -- colon-sys )  \ tools-ext  : code ( "name" -- colon-sys )  \ tools-ext
     \ start a native code definition      \G Start a native code definition that runs in the context of the
       \G Gforth virtual machine (engine).  Such a definition is not
       \G portable between Gforth installations, so we recommend using
       \G @code{abi-code} instead of @code{code}.  You have to end a
       \G @code{code} definition with a dispatch to the next virtual
       \G machine instruction.
     header      header
     here >body cfa,      here >body cfa,
     defstart init-asm ;      defstart init-asm ;
   
 : abi-code ( "name" -- colon-sys )      \ gforth  [ifdef] doabicode:
    \ start a native code definition that is called using the platform's  : abi-code ( "name" -- colon-sys )      \ gforth        abi_code
    \ ABI conventions corresponding to C-prototype     \G Start a native code definition that is called using the platform's
    \ struct{Cell*sp;double*fp;} function (Cell *sp, double *fp);     \G ABI conventions corresponding to the C-prototype:
      \G @example
      \G Cell *function(Cell *sp, Float **fpp);
      \G @end example
      \G The FP stack pointer is passed in by providing a reference to a
      \G memory location containing the FP stack pointer and is passed
      \G out by storing the changed FP stack pointer there (if necessary).
     header        header  
     doabicode: cfa,      doabicode: cfa,
     defstart init-asm ;      defstart init-asm ;
   [endif]
   
 : (;code) ( -- ) \ gforth  : (;code) ( -- ) \ gforth
     \ execution semantics of @code{;code}      \ execution semantics of @code{;code}
Line 52  vocabulary assembler ( -- ) \ tools-ext Line 67  vocabulary assembler ( -- ) \ tools-ext
     ;-hook postpone (;code) basic-block-end finish-code ?struc postpone [      ;-hook postpone (;code) basic-block-end finish-code ?struc postpone [
     defstart init-asm ;      defstart init-asm ;
 interpret/compile: ;code ( compilation. colon-sys1 -- colon-sys2 )      \ tools-ext     semicolon-code  interpret/compile: ;code ( compilation. colon-sys1 -- colon-sys2 )      \ tools-ext     semicolon-code
   \g The code after @code{;code} becomes the behaviour of the last
   \g defined word (which must be a @code{create}d word).  The same
   \g caveats apply as for @code{code}, but Gforth does not have a
   \g @code{;abi-code} yet.  As a workaround, you can use @code{does> foo
   \g ;} instead, where @code{foo} is defined with @code{abi-code}.
   
 : end-code ( colon-sys -- )     \ gforth        end_code  : end-code ( colon-sys -- )     \ gforth        end_code
     ( end a code definition )      \G End a code definition.  Note that you have to assemble the
       \G return from the ABI call (for @code{abi-code}) or the dispatch
       \G to the next VM instruction (for @code{code} and @code{;code})
       \G yourself.
     latestxt here over - flush-icache      latestxt here over - flush-icache
     previous ?struc reveal ;      previous ?struc reveal ;
   

Removed from v.1.18  
changed lines
  Added in v.1.21


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