[gforth] / gforth / see.fs  

gforth: gforth/see.fs

Diff for /gforth/see.fs between version 1.10 and 1.74

version 1.10, Sun Jan 7 17:22:14 1996 UTC version 1.74, Sat Aug 28 10:04:34 2010 UTC
Line 1 
Line 1 
 \ SEE.FS       highend SEE for ANSforth                16may93jaw  \ SEE.FS       highend SEE for ANSforth                16may93jaw
   
 \ Copyright (C) 1995 Free Software Foundation, Inc.  \ Copyright (C) 1995,2000,2003,2004,2006,2007,2008 Free Software Foundation, Inc.
   
 \ This file is part of Gforth.  \ This file is part of Gforth.
   
 \ Gforth is free software; you can redistribute it and/or  \ Gforth is free software; you can redistribute it and/or
 \ modify it under the terms of the GNU General Public License  \ modify it under the terms of the GNU General Public License
 \ as published by the Free Software Foundation; either version 2  \ as published by the Free Software Foundation, either version 3
 \ of the License, or (at your option) any later version.  \ of the License, or (at your option) any later version.
   
 \ This program is distributed in the hope that it will be useful,  \ This program is distributed in the hope that it will be useful,
Line 15 
Line 15 
 \ GNU General Public License for more details.  \ GNU General Public License for more details.
   
 \ You should have received a copy of the GNU General Public License  \ You should have received a copy of the GNU General Public License
 \ along with this program; if not, write to the Free Software  \ along with this program. If not, see http://www.gnu.org/licenses/.
 \ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  
   
   
 \ May be cross-compiled  \ May be cross-compiled
Line 25 
Line 24 
   
 \ Ideas:        Level should be a stack  \ Ideas:        Level should be a stack
   
   require look.fs
 require termsize.fs  require termsize.fs
   require wordinfo.fs
   
 decimal  decimal
   
Line 50 
Line 51 
 : level-        -7 Level +! ;  : level-        -7 Level +! ;
   
 VARIABLE nlflag  VARIABLE nlflag
   VARIABLE uppercase      \ structure words are in uppercase
   
 DEFER nlcount ' noop IS nlcount  DEFER nlcount ' noop IS nlcount
   
 : nl            nlflag on ;  : nl            nlflag on ;
 : (nl)          nlcount  : (nl)          nlcount
                 XPos @ Level @ = ?Exit                  XPos @ Level @ = IF EXIT THEN \ ?Exit
                 C-Formated @ IF                  C-Formated @ IF
                 C-Output @                  C-Output @
                 IF C-Clearline @ IF cols XPos @ - spaces                  IF C-Clearline @ IF cols XPos @ - spaces
Line 69 
Line 71 
                 XPos @ over + cols u>= IF (nl) THEN ;                  XPos @ over + cols u>= IF (nl) THEN ;
   
 : ctype         ( adr len -- )  : ctype         ( adr len -- )
                 warp? dup XPos +! C-Output @ IF type ELSE 2drop THEN ;                  warp? dup XPos +! C-Output @
                   IF uppercase @ IF bounds ?DO i c@ toupper emit LOOP
                                     uppercase off ELSE type THEN
                   ELSE 2drop THEN ;
   
 : cemit         1 warp?  : cemit         1 warp?
                 over bl = Level @ XPos @ = and                  over bl = Level @ XPos @ = and
                 IF 2drop ELSE XPos +! C-Output @ IF emit ELSE drop THEN                  IF 2drop ELSE XPos +! C-Output @ IF emit ELSE drop THEN
                 THEN ;                  THEN ;
   
 DEFER .string  
   Defer xt-see-xt ( xt -- )
   \ this one is just a forward declaration for indirect recursion
   
   : .defname ( xt c-addr u -- )
       rot look
       if ( c-addr u nfa )
           -rot type space .name
       else
           drop ." noname " type
       then
       space ;
   
   Defer discode ( addr u -- ) \ gforth
   \G hook for the disassembler: disassemble u bytes of code at addr
   ' dump IS discode
   
   : next-head ( addr1 -- addr2 ) \ gforth
       \G find the next header starting after addr1, up to here (unreliable).
       here swap u+do
           i head? -2 and if
               i unloop exit
           then
       cell +loop
       here ;
   
   [ifundef] umin \ !! bootstrapping help
   : umin ( u1 u2 -- u )
       2dup u>
       if
           swap
       then
       drop ;
   [then]
   
   : next-prim ( addr1 -- addr2 ) \ gforth
       \G find the next primitive after addr1 (unreliable)
       1+ >r -1 primstart
       begin ( umin head R: boundary )
           @ dup
       while
           tuck name>int >code-address ( head1 umin ca R: boundary )
           r@ - umin
           swap
       repeat
       drop dup r@ negate u>=
       \ "umin+boundary within [0,boundary)" = "umin within [-boundary,0)"
       if ( umin R: boundary ) \ no primitive found behind -> use a default length
           drop 31
       then
       r> + ;
   
   DEFER .string ( c-addr u n -- )
   
 [IFDEF] Green  [IFDEF] Green
 VARIABLE Colors Colors on  VARIABLE Colors Colors on
Line 97 
Line 154 
   
 ' (.string) IS .string  ' (.string) IS .string
   
   : c-\type ( c-addr u -- )
       \ type string in \-escaped form
       begin
           dup while
               2dup newline string-prefix? if
                   '\ cemit 'n cemit
                   newline nip /string
               else
                   over c@
                   dup '" = over '\ = or if
                       '\ cemit cemit
                   else
                       dup bl 127 within if
                           cemit
                       else
                           base @ >r try
                               8 base ! 0 <<# # # # '\ hold #> ctype #>> 0
                           restore
                               r@ base !
                           endtry
                           rdrop throw
                       endif
                   endif
                   1 /string
               endif
       repeat
       2drop ;
   
 : .struc        Str# .string ;  : .struc
           uppercase on Str# .string ;
   
 \ CODES                                                 15may93jaw  \ CODES (Branchtypes)                                    15may93jaw
   
 21 CONSTANT RepeatCode  21 CONSTANT RepeatCode
 22 CONSTANT AgainCode  22 CONSTANT AgainCode
Line 110 
Line 195 
 11 CONSTANT AheadCode  11 CONSTANT AheadCode
 13 CONSTANT WhileCode2  13 CONSTANT WhileCode2
 14 CONSTANT Disable  14 CONSTANT Disable
   15 CONSTANT LeaveCode
   
   
 \ FORMAT WORDS                                          13jun93jaw  \ FORMAT WORDS                                          13jun93jaw
   
 VARIABLE C-Stop  VARIABLE C-Stop
 VARIABLE Branches  VARIABLE Branches
   
 VARIABLE BranchPointer  VARIABLE BranchPointer  \ point to the end of branch table
 VARIABLE SearchPointer  VARIABLE SearchPointer
 CREATE BranchTable 500 allot  
   \ The branchtable consists of three entrys:
   \ address of branch , branch destination , branch type
   
   CREATE BranchTable 128 cells allot
 here 3 cells -  here 3 cells -
 ACONSTANT MaxTable  ACONSTANT MaxTable
   
 : FirstBranch BranchTable cell+ SearchPointer ! ;  : FirstBranch BranchTable cell+ SearchPointer ! ;
   
 : (BranchAddr?) ( a-addr -- a-addr true | false )  : (BranchAddr?) ( a-addr1 -- a-addr2 true | false )
   \ searches a branch with destination a-addr1
   \ a-addr1: branch destination
   \ a-addr2: pointer in branch table
         SearchPointer @          SearchPointer @
         BEGIN   dup BranchPointer @ u<          BEGIN   dup BranchPointer @ u<
         WHILE          WHILE
Line 153 
Line 247 
         2drop true          2drop true
         THEN ;          THEN ;
   
   : MyBranch      ( a-addr -- a-addr a-addr2 )
   \ finds branch table entry for branch at a-addr
                   dup @
                   BranchAddr?
                   BEGIN
                   WHILE 1 cells - @
                         over <>
                   WHILE dup @
                         MoreBranchAddr?
                   REPEAT
                   SearchPointer @ 3 cells -
                   ELSE    true ABORT" SEE: Table failure"
                   THEN ;
   
 \  \
 \                 addrw               addrt  \                 addrw               addrt
 \       BEGIN ... WHILE ... AGAIN ... THEN  \       BEGIN ... WHILE ... AGAIN ... THEN
Line 184 
Line 292 
         BranchPointer @ 1 cells - ! ;          BranchPointer @ 1 cells - ! ;
   
 : Branch! ( a-addr rel -- a-addr )  : Branch! ( a-addr rel -- a-addr )
         over + over ,Branch ,Branch 0 ,Branch ;      over ,Branch ,Branch 0 ,Branch ;
   \        over + over ,Branch ,Branch 0 ,Branch ;
   
 \ DEFER CheckUntil  \ DEFER CheckUntil
 VARIABLE NoOutput  VARIABLE NoOutput
Line 197 
Line 306 
 : Scan? ( -- flag ) C-Pass @ 0= ;  : Scan? ( -- flag ) C-Pass @ 0= ;
 : Display? ( -- flag ) C-Pass @ 1 = ;  : Display? ( -- flag ) C-Pass @ 1 = ;
 : Debug? ( -- flag ) C-Pass @ 2 = ;  : Debug? ( -- flag ) C-Pass @ 2 = ;
   : ?.string  ( c-addr u n -- )   Display? if .string else 2drop drop then ;
   
 : back? ( n -- flag ) 0< ;  : back? ( addr target -- addr flag )
 : ahead? ( n -- flag ) 0> ;      over u< ;
   
 : c-(compile)  : .word ( addr x -- addr )
     Display?      \ print x as a word if possible
       dup look 0= IF
           drop dup threaded>name dup 0= if
               drop over 1 cells - @ dup body> look
     IF      IF
         s" POSTPONE " Com# .string                  nip nip dup ." <" name>string rot wordinfo .string ." > "
         dup @ look 0= ABORT" SEE: No valid XT"              ELSE
         name>string 0 .string bl cemit                  2drop ." <" 0 .r ." > "
     THEN      THEN
     cell+ ;              EXIT
           then
       THEN
       nip dup cell+ @ immediate-mask and
       IF
           bl cemit  ." POSTPONE "
       THEN
       dup name>string rot wordinfo .string
       ;
   
 : c-lit  : c-call ( addr1 -- addr2 )
     Display? IF      Display? IF
         dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit          dup @ body> .word bl cemit
     THEN      THEN
     cell+ ;      cell+ ;
   
 : c-@local#  : c-callxt ( addr1 -- addr2 )
     Display? IF      Display? IF
         S" @local" 0 .string          dup @ .word bl cemit
         dup @ dup 1 cells / abs 0 <# #S rot sign #> 0 .string bl cemit  
     THEN      THEN
     cell+ ;      cell+ ;
   
 : c-flit  \ here docon: , docol: , dovar: , douser: , dodefer: , dofield: ,
     Display? IF  \ here over - 2constant doers
         dup f@ scratch represent 0=  
         IF    2drop  scratch 3 min 0 .string  
         ELSE  
             IF  '- cemit  THEN  1-  
             scratch over c@ cemit '. cemit 1 /string 0 .string  
             'E cemit  
             dup abs 0 <# #S rot sign #> 0 .string bl cemit  
         THEN THEN  
     float+ ;  
   
 : c-f@local#  [IFDEF] !does
     Display? IF  : c-does>               \ end of create part
         S" f@local" 0 .string          Display? IF S" DOES> " Com# .string THEN ;
         dup @ dup 1 floats / abs 0 <# #S rot sign #> 0 .string bl cemit  \       maxaligned /does-handler + ; \ !! no longer needed for non-cross stuff
     THEN  [THEN]
     cell+ ;  
   
 : c-laddr#  : c-lit ( addr1 -- addr2 )
     Display? IF      dup @ dup body> dup cfaligned over = swap in-dictionary? and if
         S" laddr# " 0 .string          ( addr1 addr1@ )
         dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit          dup body> @ dovar: = if
     THEN              drop c-call EXIT
           endif
       endif
       over 4 cells + over = if
           over 1 cells + @ decompile-prim ['] call xt>threaded = >r
           over 3 cells + @ decompile-prim ['] ;S xt>threaded =
           r> and if
               over 2 cells + @ ['] !does >body = if  drop
                   S" DOES> " Com# ?.string 4 cells + EXIT endif
           endif
           [IFDEF] !;abi-code
               over 2 cells + @ ['] !;abi-code >body = if  drop
                   S" ;abi-code " Com# ?.string   4 cells +
                   c-stop on
                   Display? if
                       dup   dup  next-head   over - discode
                       S" end-code" Com# ?.string
                   then   EXIT
               endif
           [THEN]
       endif
       Display? if
           \ !! test for cfa here, and print "['] ..."
           dup abs 0 <# #S rot sign #> 0 .string bl cemit
       else  drop  then
     cell+ ;      cell+ ;
   
 : c-lp+!#  : c-lit+ ( addr1 -- addr2 )
     Display? IF      Display? if
         S" lp+!# " 0 .string  
         dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit          dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit
     THEN          s" + " 0 .string
       endif
     cell+ ;      cell+ ;
   
 : c-s"  : .name-without ( addr -- addr )
         count 2dup + aligned -rot      \ !! the stack effect cannot be correct
         Display?      \ prints a name without a() e.g. a(+LOOP) or (s")
         IF      [char] S cemit [char] " cemit bl cemit 0 .string      dup 1 cells - @ threaded>name dup IF
                 [char] " cemit bl cemit          name>string over c@ 'a = IF
         ELSE    2drop              1 /string
         THEN ;          THEN
            over c@ '( = IF
 : c-."              1 /string
         count 2dup + aligned -rot          THEN
         Display?          2dup + 1- c@ ') = IF 1- THEN .struc ELSE drop
         IF      [char] . cemit  
                 [char] " cemit bl cemit 0 .string  
                 [char] " cemit bl cemit  
         ELSE    2drop  
         THEN ;          THEN ;
   
   [ifdef] (s")
 : c-c"  : c-c"
           Display? IF nl .name-without THEN
         count 2dup + aligned -rot          count 2dup + aligned -rot
         Display?          Display?
         IF      [char] C cemit [char] " cemit bl cemit 0 .string          IF      bl cemit 0 .string
                 [char] " cemit bl cemit                  [char] " cemit bl cemit
         ELSE    2drop          ELSE    2drop
         THEN ;          THEN ;
   [endif]
   
   : c-string? ( addr1 -- addr2 f )
 : Forward? ( a-addr true | false -- )      \ f is true if a string was found and decompiled.
         IF      dup dup @ swap 1 cells - @ -      \ if f is false, addr2=addr1
                 Ahead? IF true ELSE drop false THEN      \ recognizes the following patterns:
       \ c":     ahead X: len string then lit X
       \ flit:   ahead X: float      then lit X f@
       \ s\":    ahead X: string     then lit X lit len
       \ .\":    ahead X: string     then lit X lit len type
       \ !! not recognized anywhere:
       \ abort": if ahead X: len string then lit X c(abort") then
       dup @ back? if false exit endif
       dup @ >r
       r@ @ decompile-prim ['] lit xt>threaded <> if rdrop false exit endif
       r@ cell+ @ over cell+ <> if rdrop false exit endif
       \ we have at least C"
       r@ 2 cells + @ decompile-prim dup ['] lit xt>threaded = if
           drop r@ 3 cells + @ over cell+ + aligned r@ = if
               \ we have at least s"
               r@ 4 cells + @ decompile-prim ['] lit-perform xt>threaded =
               r@ 5 cells + @ ['] type >body = and if
                   6 s\" .\\\" "
               else
                   4 s\" s\\\" "
               endif
               \ !! make newline if string too long?
               display? if
                   0 .string r@ cell+ @ r@ 3 cells + @ c-\type '" cemit bl cemit
               else
                   2drop
               endif
               nip cells r> + true exit
           endif
       endif
       ['] f@ xt>threaded = if
           display? if
               r@ cell+ @ f@ 10 8 16 f>str-rdp 0 .string bl cemit
           endif
           drop r> 3 cells + true exit
       endif
       \ !! check if count matches space?
       display? if
           s\" c\" " 0 .string r@ cell+ @ count 0 .string '" cemit bl cemit
       endif
       drop r> 2 cells + true ;
   
   : Forward? ( a-addr true | false -- a-addr true | false )
       \ a-addr is pointer into branch table
       \ returns true when jump is a forward jump
       IF
           dup dup @ swap 1 cells - @ u> IF
               true
           ELSE
               drop false
           THEN
                 \ only if forward jump                  \ only if forward jump
         ELSE    false THEN ;      ELSE
           false
       THEN ;
   
 : RepeatCheck  : RepeatCheck ( a-addr1 a-addr2 true | false -- false )
         IF  BEGIN  2dup          IF  BEGIN  2dup
                    1 cells - @ swap dup @ +                     1 cells - @ swap @
                    u<=                     u<=
             WHILE  drop dup cell+              WHILE  drop dup cell+
                    MoreBranchAddr? 0=                     MoreBranchAddr? 0=
Line 300 
Line 485 
         ELSE false          ELSE false
         THEN ;          THEN ;
   
 : c-branch  : c-branch ( addr1 -- addr2 )
       c-string? ?exit
         Scan?          Scan?
         IF      dup @ Branch!          IF      dup @ Branch!
                 dup @ back?                  dup @ back?
Line 327 
Line 513 
                         IF      drop S" REPEAT " .struc nl                          IF      drop S" REPEAT " .struc nl
                         ELSE    S" AGAIN " .struc nl                          ELSE    S" AGAIN " .struc nl
                         THEN                          THEN
                 ELSE    dup cell+ BranchAddr? Forward?                  ELSE    MyBranch cell+ @ LeaveCode =
                           IF      S" LEAVE " .struc
                           ELSE
                                   dup cell+ BranchAddr? Forward?
                         IF      dup cell+ @ WhileCode2 =                          IF      dup cell+ @ WhileCode2 =
                                 IF nl S" ELSE" .struc level+                                  IF nl S" ELSE" .struc level+
                                 ELSE level- nl S" ELSE" .struc level+ THEN                                  ELSE level- nl S" ELSE" .struc level+ THEN
Line 336 
Line 525 
                         THEN                          THEN
                 THEN                  THEN
         THEN          THEN
           THEN
         Debug?          Debug?
         IF      dup @ +          IF      @ \ !!! cross-interacts with debugger !!!
         ELSE    cell+          ELSE    cell+
         THEN ;          THEN ;
   
 : MyBranch      ( a-addr -- a-addr a-addr2 )  
                 dup @ over +  
                 BranchAddr?  
                 BEGIN  
                 WHILE 1 cells - @  
                       over <>  
                 WHILE dup @ over +  
                       MoreBranchAddr?  
                 REPEAT  
                 SearchPointer @ 3 cells -  
                 ELSE    true ABORT" SEE: Table failure"  
                 THEN ;  
   
 : DebugBranch  : DebugBranch
         Debug?          Debug?
         IF      dup @ over + swap THEN ; \ return 2 different addresses          IF      dup @ swap THEN ; \ return 2 different addresses
   
 : c-?branch  : c-?branch
         Scan?          Scan?
Line 376 
Line 553 
                                 level- nl                                  level- nl
                                 S" WHILE " .struc                                  S" WHILE " .struc
                                 level+                                  level+
                           ELSE    MyBranch cell+ @ LeaveCode =
                                   IF   s" 0= ?LEAVE " .struc
                         ELSE    nl S" IF " .struc level+                          ELSE    nl S" IF " .struc level+
                         THEN                          THEN
                 THEN                  THEN
         THEN          THEN
           THEN
         DebugBranch          DebugBranch
         cell+ ;          cell+ ;
   
 : c-?branch-lp+!#  c-?branch cell+ ;  
 : c-branch-lp+!#   c-branch  cell+ ;  
   
 : c-do  
         Display? IF nl S" DO" .struc level+ THEN ;  
   
 : c-?do  
         Display? IF nl S" ?DO" .struc level+ THEN  
         DebugBranch cell+ ;  
   
 : c-for  : c-for
         Display? IF nl S" FOR" .struc level+ THEN ;          Display? IF nl S" FOR" .struc level+ THEN ;
   
 : c-next  
         Display? IF level- nl S" NEXT " .struc nl THEN  
         DebugBranch cell+ cell+ ;  
   
 : c-loop  : c-loop
         Display? IF level- nl S" LOOP " .struc nl THEN          Display? IF level- nl .name-without nl bl cemit THEN
         DebugBranch cell+ cell+ ;          DebugBranch cell+
           Scan?
           IF      dup BranchAddr?
                   BEGIN   WHILE cell+ LeaveCode swap !
                           dup MoreBranchAddr?
                   REPEAT
           THEN
           cell+ ;
   
 : c-+loop  : c-do
         Display? IF level- nl S" +LOOP " .struc nl THEN          Display? IF nl .name-without level+ THEN ;
         DebugBranch cell+ cell+ ;  
   
 : c-s+loop  
         Display? IF level- nl S" S+LOOP " .struc nl THEN  
         DebugBranch cell+ cell+ ;  
   
 : c--loop  
         Display? IF level- nl S" -LOOP " .struc nl THEN  
         DebugBranch cell+ cell+ ;  
   
 : c-next-lp+!#  c-next cell+ ;  
 : c-loop-lp+!#  c-loop cell+ ;  
 : c-+loop-lp+!#  c-+loop cell+ ;  
 : c-s+loop-lp+!#  c-s+loop cell+ ;  
 : c--loop-lp+!#  c--loop cell+ ;  
   
 : c-leave  
         Display? IF S" LEAVE " .struc THEN  
         Debug? IF dup @ + THEN cell+ ;  
   
 : c-?leave  
         Display? IF S" ?LEAVE " .struc THEN  
         cell+ DebugBranch swap cell+ swap cell+ ;  
   
 : c-exit  dup 1 cells -  : c-?do ( addr1 -- addr2 )
       Display? IF
           nl .name-without level+
       THEN
       DebugBranch cell+ ;
   
   : c-exit ( addr1 -- addr2 )
       dup 1 cells -
         CheckEnd          CheckEnd
         IF      Display? IF nlflag off S" ;" Com# .string THEN      IF
           Display? IF nlflag off S" ;" Com# .string THEN
                 C-Stop on                  C-Stop on
         ELSE    Display? IF S" EXIT " .struc THEN      ELSE
           Display? IF S" EXIT " .struc THEN
         THEN          THEN
         Debug? IF drop THEN ;      Debug? IF drop THEN ; \ !!! cross-interacts with debugger !!!
   
 : c-does>               \ end of create part  
         Display? IF S" DOES> " Com# .string THEN  
         Cell+ cell+ ;  
   
 : c-abort"  : c-abort"
         count 2dup + aligned -rot          count 2dup + aligned -rot
Line 451 
Line 606 
         ELSE    2drop          ELSE    2drop
         THEN ;          THEN ;
   
   [IFDEF] (compile)
   : c-(compile)
       Display?
       IF
           s" POSTPONE " Com# .string
           dup @ look 0= ABORT" SEE: No valid XT"
           name>string 0 .string bl cemit
       THEN
       cell+ ;
   [THEN]
   
 CREATE C-Table  CREATE C-Table
         ' lit A,            ' c-lit A,          ' lit A,            ' c-lit A,
         ' @local# A,        ' c-@local# A,                  ' does-exec A,      ' c-callxt A,
         ' flit A,           ' c-flit A,                  ' lit@ A,           ' c-call A,
         ' f@local# A,       ' c-f@local# A,  [IFDEF] call    ' call A,           ' c-call A, [THEN]
         ' laddr# A,         ' c-laddr# A,  \               ' useraddr A,       ....
         ' lp+!# A,          ' c-lp+!# A,                  ' lit-perform A,    ' c-call A,
         ' (s") A,           ' c-s" A,                  ' lit+ A,           ' c-lit+ A,
         ' (.") A,           ' c-." A,  [IFDEF] (s")    ' (s") A,           ' c-c" A, [THEN]
         ' "lit A,           ' c-c" A,  [IFDEF] (.")    ' (.") A,           ' c-c" A, [THEN]
         ' leave A,          ' c-leave A,  [IFDEF] "lit    ' "lit A,           ' c-c" A, [THEN]
         ' ?leave A,         ' c-?leave A,  [IFDEF] (c")    ' (c") A,           ' c-c" A, [THEN]
         ' (do) A,           ' c-do A,          ' (do) A,           ' c-do A,
   [IFDEF] (+do)   ' (+do) A,          ' c-?do A, [THEN]
   [IFDEF] (u+do)  ' (u+do) A,         ' c-?do A, [THEN]
   [IFDEF] (-do)   ' (-do) A,          ' c-?do A, [THEN]
   [IFDEF] (u-do)  ' (u-do) A,         ' c-?do A, [THEN]
         ' (?do) A,          ' c-?do A,          ' (?do) A,          ' c-?do A,
         ' (for) A,          ' c-for A,          ' (for) A,          ' c-for A,
         ' ?branch A,        ' c-?branch A,          ' ?branch A,        ' c-?branch A,
         ' branch A,         ' c-branch A,          ' branch A,         ' c-branch A,
         ' (loop) A,         ' c-loop A,          ' (loop) A,         ' c-loop A,
         ' (+loop) A,        ' c-+loop A,                  ' (+loop) A,        ' c-loop A,
         ' (s+loop) A,       ' c-s+loop A,  [IFDEF] (s+loop) ' (s+loop) A,      ' c-loop A, [THEN]
         ' (-loop) A,        ' c--loop A,  [IFDEF] (-loop) ' (-loop) A,        ' c-loop A, [THEN]
         ' (next) A,         ' c-next A,                  ' (next) A,         ' c-loop A,
         ' ?branch-lp+!# A,  ' c-?branch-lp+!# A,  
         ' branch-lp+!# A,   ' c-branch-lp+!# A,  
         ' (loop)-lp+!# A,   ' c-loop-lp+!# A,  
         ' (+loop)-lp+!# A,  ' c-+loop-lp+!# A,  
         ' (s+loop)-lp+!# A, ' c-s+loop-lp+!# A,  
         ' (-loop)-lp+!# A,  ' c--loop-lp+!# A,  
         ' (next)-lp+!# A,   ' c-next-lp+!# A,  
         ' ;s A,             ' c-exit A,          ' ;s A,             ' c-exit A,
         ' (does>) A,        ' c-does> A,  [IFDEF] (abort") ' (abort") A,      ' c-abort" A, [THEN]
         ' (abort") A,       ' c-abort" A,  \ only defined if compiler is loaded
         ' (compile) A,      ' c-(compile) A,  [IFDEF] (compile) ' (compile) A,      ' c-(compile) A, [THEN]
         0 ,                  0 ,             here 0 ,
   
   avariable c-extender
   c-extender !
   
 \ DOTABLE                                               15may93jaw  \ DOTABLE                                               15may93jaw
   
 : DoTable ( cfa -- flag )  : DoTable ( ca/cfa -- flag )
         C-Table      decompile-prim C-Table BEGIN ( cfa table-entry )
         BEGIN   dup @ dup          dup @ dup 0=  IF
         WHILE   2 pick <>              drop cell+ @ dup IF ( next table!)
         WHILE   2 cells +                  dup @
               ELSE ( end!)
                   2drop false EXIT
               THEN
           THEN
           \ jump over to extender, if any 26jan97jaw
           xt>threaded 2 pick <>
       WHILE
               2 cells +
         REPEAT          REPEAT
         nip cell+ @ EXECUTE      nip cell+ perform
         true          true
         ELSE  ;
         2drop drop false  
         THEN ;  
   
 : BranchTo? ( a-addr -- a-addr )  : BranchTo? ( a-addr -- a-addr )
         Display?  IF     dup BranchAddr?          Display?  IF     dup BranchAddr?
                         IF BEGIN cell+ @ dup 20 u>                          IF
                                   BEGIN cell+ @ dup 20 u>
                                 IF drop nl S" BEGIN " .struc level+                                  IF drop nl S" BEGIN " .struc level+
                                 ELSE                                  ELSE
                                   dup Disable <>                                    dup Disable <> over LeaveCode <> and
                                   IF   WhileCode2 =                                    IF   WhileCode2 =
                                        IF nl S" THEN " .struc nl ELSE                                         IF nl S" THEN " .struc nl ELSE
                                        level- nl S" THEN " .struc nl THEN                                         level- nl S" THEN " .struc nl THEN
Line 522 
Line 694 
         dup cell+ swap @          dup cell+ swap @
         dup >r DoTable r> swap IF drop EXIT THEN          dup >r DoTable r> swap IF drop EXIT THEN
         Display?          Display?
         IF look 0= IF  drop dup 1 cells - @ .  \ ABORT" SEE: Bua!"      IF
            ELSE  dup cell+ count 31 and rot wordinfo .string  THEN  bl cemit          .word bl cemit
         ELSE drop      ELSE
           drop
         THEN ;          THEN ;
   
 : c-init  : c-init
Line 541 
Line 714 
                 c-stop @                  c-stop @
         UNTIL drop ;          UNTIL drop ;
   
 DEFER dosee  : seecode ( xt -- )
       dup s" Code" .defname
 : dopri .name ." is primitive" cr ;      >code-address
 : dovar ." Variable " .name cr ;      dup in-dictionary? \ user-defined code word?
 : douse ." User " .name cr ;      if
 : docon  dup cell+ (name>) >body @ . ." Constant " .name cr ;          dup next-head
 : doval  dup cell+ (name>) >body @ . ." Value " .name cr ;      else
 : dodef ." Defer " dup >r .name cr          dup next-prim
     r@ cell+ (name>) >body @ look      then
     0= ABORT" SEE: No valid xt in deferred word"      over - discode
     dup dosee cr      ." end-code" cr ;
     ." ' " .name r> ." IS " .name cr ;  : seeabicode ( xt -- )
 : dodoe ." Create " dup .name cr      dup s" ABI-Code" .defname
         S" DOES> " Com# .string XPos @ Level ! name>      >body dup dup next-head
         >does-code dup C-Pass @ DebugMode = IF ScanMode c-pass ! EXIT THEN      swap - discode
         ScanMode c-pass ! dup makepass      ." end-code" cr ;
         DisplayMode c-pass ! makepass ;  : seevar ( xt -- )
 : doali here @ .name ." Alias " .name cr      s" Variable" .defname cr ;
         here @ dosee ;  : seeuser ( xt -- )
 : docol      s" User" .defname cr ;
     S" : " Com# .string  : seecon ( xt -- )
     dup name>string 2 pick wordinfo .string bl cemit bl cemit      dup >body ?
     ( XPos @ ) 2 Level !      s" Constant" .defname cr ;
     name> >body  : seevalue ( xt -- )
     C-Pass @ DebugMode =      dup >body ?
     IF      s" Value" .defname cr ;
         ScanMode c-pass ! EXIT  : seedefer ( xt -- )
       dup >body @ xt-see-xt cr
       dup s" Defer" .defname cr
       >name ?dup-if
           ." IS " .name cr
       else
           ." latestxt >body !"
       then ;
   : see-threaded ( addr -- )
       C-Pass @ DebugMode = IF
           ScanMode c-pass !
           EXIT
     THEN      THEN
     ScanMode c-pass ! dup makepass      ScanMode c-pass ! dup makepass
     DisplayMode c-pass ! makepass ;      DisplayMode c-pass ! makepass ;
   : seedoes ( xt -- )
       dup s" create" .defname cr
       S" DOES> " Com# .string XPos @ Level !
       >does-code see-threaded ;
   : seecol ( xt -- )
       dup s" :" .defname nl
       2 Level !
       >body see-threaded ;
   : seefield ( xt -- )
       dup >body ." 0 " ? ." 0 0 "
       s" Field" .defname cr ;
   
 create wordtypes  : xt-see ( xt -- ) \ gforth
         Pri# ,   ' dopri A,      \G Decompile the definition represented by @i{xt}.
         Var# ,   ' dovar A,  
         Con# ,   ' docon A,  
         Val# ,   ' doval A,  
         Def# ,   ' dodef A,  
         Doe# ,   ' dodoe A,  
         Ali# ,   ' doali A,  
         Col# ,   ' docol A,  
         Use# ,   ' douse A,  
         0 ,  
   
 : (dosee) ( lfa -- )  
         dup dup cell+ c@ >r  
         wordinfo  
         wordtypes  
         BEGIN dup @ dup  
         WHILE 2 pick = IF cell+ @ nip EXECUTE  
                           r> dup 32 and IF ."  immediate" THEN  
                                  64 and IF ."  restrict" THEN EXIT THEN  
               2 cells +  
         REPEAT  
         2drop rdrop  
         .name ." Don't know how to handle" cr ;  
   
 ' (dosee) IS dosee  
   
 : xtc ( xt -- )       \ do see at xt  
         Look 0= ABORT" SEE: No valid XT"  
         cr c-init          cr c-init
         dosee ;      dup >does-code
       if
 : see   name sfind 0= IF ." Word unknown" cr exit THEN          seedoes EXIT
         xtc ;      then
       dup xtprim?
 : lfc   cr c-init cell+ dosee ;      if
 : nfc   cr c-init dosee ;          seecode EXIT
       then
       dup >code-address
       CASE
           docon: of seecon endof
   [IFDEF] dovalue:
           dovalue: of seevalue endof
   [THEN]
           docol: of seecol endof
           dovar: of seevar endof
   [IFDEF] douser:
           douser: of seeuser endof
   [THEN]
   [IFDEF] dodefer:
           dodefer: of seedefer endof
   [THEN]
   [IFDEF] dofield:
           dofield: of seefield endof
   [THEN]
   [IFDEF] doabicode:
           doabicode: of seeabicode endof
   [THEN]
           over       of seecode endof \ direct threaded code words
           over >body of seecode endof \ indirect threaded code words
           2drop abort" unknown word type"
       ENDCASE ;
   
   : (xt-see-xt) ( xt -- )
       xt-see cr ." latestxt" ;
   ' (xt-see-xt) is xt-see-xt
   
   : (.immediate) ( xt -- )
       ['] execute = if
           ."  immediate"
       then ;
   
   : name-see ( nfa -- )
       dup name>int >r
       dup name>comp
       over r@ =
       if \ normal or immediate word
           swap xt-see (.immediate)
       else
           r@ ['] ticking-compile-only-error =
           if \ compile-only word
               swap xt-see (.immediate) ."  compile-only"
           else \ interpret/compile word
               r@ xt-see-xt cr
               swap xt-see-xt cr
               ." interpret/compile: " over .name drop
           then
       then
       rdrop drop ;
   
   : see ( "<spaces>name" -- ) \ tools
       \G Locate @var{name} using the current search order. Display the
       \G definition of @var{name}. Since this is achieved by decompiling
       \G the definition, the formatting is mechanised and some source
       \G information (comments, interpreted sequences within definitions
       \G etc.) is lost.
       name find-name dup 0=
       IF
           drop -&13 throw
       THEN
       name-see ;
   
   

Generate output suitable for use with a patch program
Legend:
Removed from v.1.10  
changed lines
  Added in v.1.74
CVS Admin

Powered by ViewCVS 1.0-dev 		(Powered by ViewCVS)

ViewCVS and CVS Help