Diff for /gforth/see.fs between versions 1.1 and 1.18

version 1.1, 1994/02/11 16:30:47 version 1.18, 1997/07/06 14:29:34
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.
   
   \ This file is part of Gforth.
   
   \ Gforth is free software; you can redistribute it and/or
   \ modify it under the terms of the GNU General Public License
   \ as published by the Free Software Foundation; either version 2
   \ of the License, or (at your option) any later version.
   
   \ This program is distributed in the hope that it will be useful,
   \ but WITHOUT ANY WARRANTY; without even the implied warranty of
   \ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   \ GNU General Public License for more details.
   
   \ You should have received a copy of the GNU General Public License
   \ along with this program; if not, write to the Free Software
   \ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
   
   
 \ May be cross-compiled  \ May be cross-compiled
   
 \ I'm sorry. This is really not "forthy" enough.  \ I'm sorry. This is really not "forthy" enough.
   
 \ Ideas:        Level should be a stack  \ Ideas:        Level should be a stack
   
   require look.fs
   require termsize.fs
   require wordinfo.fs
   [IFUNDEF] .name : .name name>string type space ; [THEN]
   
 decimal  decimal
   
 \ Screen format words                                   16may93jaw  \ Screen format words                                   16may93jaw
Line 29  VARIABLE Level Line 53  VARIABLE Level
 : 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 80 XPos @ - spaces                  IF C-Clearline @ IF cols XPos @ - spaces
                                  ELSE cr THEN                                   ELSE cr THEN
                 1 YPos +! 0 XPos !                  1 YPos +! 0 XPos !
                 Level @ spaces                  Level @ spaces
Line 45  DEFER nlcount ' noop IS nlcount Line 70  DEFER nlcount ' noop IS nlcount
   
 : warp?         ( len -- len )  : warp?         ( len -- len )
                 nlflag @ IF (nl) nlflag off THEN                  nlflag @ IF (nl) nlflag off THEN
                 XPos @ over + 79 u> IF (nl) THEN ;                  XPos @ over + cols u>= IF (nl) THEN ;
   
   : c-to-upper
     dup [char] a >= over [char] z <= and if  bl -  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@ c-to-upper 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
Line 77  VARIABLE Colors Colors on Line 108  VARIABLE Colors Colors on
 ' (.string) IS .string  ' (.string) IS .string
   
   
 : .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 89  VARIABLE Colors Colors on Line 121  VARIABLE Colors Colors on
 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
   
   \ The branchtable consists of three entrys:
   \ address of branch , branch destination , branch type
   
 CREATE BranchTable 500 allot  CREATE BranchTable 500 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 132  ACONSTANT MaxTable Line 173  ACONSTANT MaxTable
         2drop true          2drop true
         THEN ;          THEN ;
   
   : MyBranch      ( a-addr -- a-addr a-addr2 )
   \ finds branch table entry for branch at a-addr
                   dup @ over +
                   BranchAddr?
                   BEGIN
                   WHILE 1 cells - @
                         over <>
                   WHILE dup @ over +
                         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 181  VARIABLE C-Pass Line 236  VARIABLE C-Pass
 : ahead? ( n -- flag ) 0> ;  : ahead? ( n -- flag ) 0> ;
   
 : c-(compile)  : c-(compile)
         Display? IF s" POSTPONE " Com# .string      Display?
                     dup @ look 0= ABORT" SEE: No valid XT"      IF
                     cell+ count $1F and 0 .string bl cemit          s" POSTPONE " Com# .string
                  THEN          dup @ look 0= ABORT" SEE: No valid XT"
         cell+ ;          name>string 0 .string bl cemit
       THEN
       cell+ ;
   
 : c-lit  : c-lit
         Display? IF dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit THEN      Display? IF
         cell+ ;          dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit
       THEN
 : c-s"      cell+ ;
         count 2dup + aligned -rot  
         Display?  : .name-without ( addr -- addr )
         IF      [char] S cemit [char] " cemit bl cemit 0 .string  \ prints a name without () e.g. (+LOOP) or (s")
                 [char] " cemit bl cemit    dup 1 cells - @ look 
         ELSE    2drop    IF   name>string over c@ '( = IF 1 /string THEN
         THEN ;         2dup + 1- c@ ') = IF 1- THEN .struc ELSE drop 
     THEN ;
 : c-."  
         count 2dup + aligned -rot  
         Display?  
         IF      [char] . cemit  
                 [char] " cemit bl cemit 0 .string  
                 [char] " cemit bl cemit  
         ELSE    2drop  
         THEN ;  
   
 : 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 ;
   
   
 : Forward? ( a-addr true | false -- )  : Forward? ( a-addr true | false -- a-addr true | false )
   \ a-addr1 is pointer into branch table
   \ returns true when jump is a forward jump
         IF      dup dup @ swap 1 cells - @ -          IF      dup dup @ swap 1 cells - @ -
                 Ahead? IF true ELSE drop false THEN                  Ahead? 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 dup @ +
                    u<=                     u<=
Line 262  VARIABLE C-Pass Line 314  VARIABLE C-Pass
                         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      dup cell+ @ WhileCode2 =                          IF      S" LEAVE " .struc
                                 IF nl S" ELSE" .struc level+                          ELSE
                                 ELSE level- nl S" ELSE" .struc level+ THEN                                  dup cell+ BranchAddr? Forward?
                                 cell+ Disable swap !                                  IF      dup cell+ @ WhileCode2 =
                         ELSE    S" AHEAD" .struc level+                                          IF nl S" ELSE" .struc level+
                         THEN                                          ELSE level- nl S" ELSE" .struc level+ THEN
                                           cell+ Disable swap !
                                   ELSE    S" AHEAD" .struc level+
                                   THEN
                           THEN
                 THEN                  THEN
         THEN          THEN
         Debug?          Debug?
Line 276  VARIABLE C-Pass Line 332  VARIABLE C-Pass
         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 @ over + swap THEN ; \ return 2 different addresses
Line 309  VARIABLE C-Pass Line 352  VARIABLE C-Pass
                                          IF WhileCode2 swap !                                           IF WhileCode2 swap !
                                          ELSE drop THEN                                           ELSE drop THEN
                                 level- nl                                  level- nl
                                 S" WHILE" .struc                                  S" WHILE " .struc
                                 level+                                  level+
                         ELSE    nl S" IF" .struc level+                          ELSE    MyBranch cell+ @ LeaveCode =
                                   IF   s" 0= ?LEAVE " .struc
                                   ELSE nl S" IF " .struc level+
                                   THEN
                         THEN                          THEN
                 THEN                  THEN
         THEN          THEN
         DebugBranch          DebugBranch
         cell+ ;          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 bl cemit nl 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-leave  
         Display? IF S" LEAVE " .struc THEN  
         Debug? IF dup @ + THEN cell+ ;  
   
 : c-?leave  : c-?do
         Display? IF S" ?LEAVE " .struc THEN          Display? IF nl S" ?DO" .struc level+ THEN
         cell+ DebugBranch swap cell+ swap cell+ ;          DebugBranch cell+ ;
   
 : c-exit  dup 1 cells -  : c-exit  dup 1 cells -
         CheckEnd          CheckEnd
Line 357  VARIABLE C-Pass Line 393  VARIABLE C-Pass
         THEN          THEN
         Debug? IF drop THEN ;          Debug? IF drop THEN ;
   
 : c-;code               \ end of create part  : c-does>               \ end of create part
         Display? IF S" DOES> " Com# .string THEN          Display? IF S" DOES> " Com# .string THEN
         Cell+ cell+ ;          Cell+ cell+ ;
   
Line 372  VARIABLE C-Pass Line 408  VARIABLE C-Pass
   
   
 CREATE C-Table  CREATE C-Table
         ' lit A,         ' c-lit A,                  ' lit A,            ' c-lit A,
         ' (s") A,        ' c-s" A,                  ' (s") A,           ' c-c" A,
         ' (.") A,        ' c-." A,                   ' (.") A,          ' c-c" A,
         ' "lit A,        ' c-c" A,                  ' "lit A,           ' c-c" A,
         ' ?branch A,     ' c-?branch A,  [IFDEF] (c")    ' (c") A,           ' c-c" A, [THEN]
         ' branch A,      ' c-branch A,                  ' (do) A,           ' c-do A,
         ' leave A,       ' c-leave A,  [IFDEF] (+do)   ' (+do) A,          ' c-do A, [THEN]
         ' ?leave A,      ' c-?leave A,  [IFDEF] (u+do)  ' (u+do) A,         ' c-do A, [THEN]
         ' (do) A,        ' c-do A,  [IFDEF] (-do)   ' (-do) A,          ' c-do A, [THEN]
         ' (?do) A,       ' c-?do A,  [IFDEF] (u-do)  ' (u-do) A,         ' c-do A, [THEN]
         ' (for) A,       ' c-for A,                  ' (?do) A,          ' c-?do A,
         ' (loop) A,      ' c-loop A,                  ' (for) A,          ' c-for A,
         ' (+loop) A,     ' c-+loop A,                  ' ?branch A,        ' c-?branch A,
         ' (next) A,      ' c-next A,                  ' branch A,         ' c-branch A,
         ' exit A,        ' c-exit A,                  ' (loop) A,         ' c-loop A,
         ' (;code) A,     ' c-;code A,                  ' (+loop) A,        ' c-loop A,
         ' (abort") A,    ' c-abort" A,  [IFDEF] (s+loop) ' (s+loop) A,       ' c-loop A, [THEN]
         ' (compile) A,   ' c-(compile) A,  [IFDEF] (-loop) ' (-loop) A,        ' c-loop A, [THEN]
         0 ,                  ' (next) A,         ' c-loop A,
                   ' ;s A,             ' c-exit A,
                   ' (does>) A,        ' c-does> A,
                   ' (abort") A,       ' c-abort" A,
                   ' (compile) A,      ' c-(compile) A,
                   0 ,             here 0 ,
   
   avariable c-extender
   c-extender !
   
 \ DOTABLE                                               15may93jaw  \ DOTABLE                                               15may93jaw
   
 : DoTable ( cfa -- flag )  : DoTable ( cfa -- flag )
         C-Table          C-Table
         BEGIN   dup @ dup          BEGIN   dup @ dup 0= 
         WHILE   2 pick <>                  IF drop cell+ @ dup 
                     IF ( next table!) dup @ ELSE 
                           ( end!) 2drop false EXIT THEN 
                   THEN
                   \ jump over to extender, if any 26jan97jaw
                   2 pick <>
         WHILE   2 cells +          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 427  CREATE C-Table Line 475  CREATE C-Table
         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= ABORT" SEE: Bua!"          IF look 0= IF  drop dup 1 cells - @ .  \ ABORT" SEE: Bua!"
            cell+ dup count 31 and rot wordinfo .string bl cemit          ELSE
               dup cell+ count dup immediate-mask and
               IF  bl cemit  ." POSTPONE " THEN
               31 and rot wordinfo .string  THEN  bl cemit
         ELSE drop          ELSE drop
         THEN ;          THEN ;
   
Line 440  CREATE C-Table Line 491  CREATE C-Table
         Branches on ;          Branches on ;
   
 : makepass ( a-addr -- )  : makepass ( a-addr -- )
         c-stop off      c-stop off
         BEGIN      BEGIN
                 analyse          analyse
                 c-stop @          c-stop @
         UNTIL drop ;      UNTIL drop ;
   
 DEFER dosee  Defer xt-see-xt ( xt -- )
   \ this one is just a forward declaration for indirect recursion
 : dopri .name ." is primitive" cr ;  
 : dovar .name ." is variable" cr ;  : .defname ( xt c-addr u -- )
 : docon  dup .name ." is constant, value: "      rot look
          cell+ (name>) >body @ . cr ;      if ( c-addr u nfa )
 : doval .name ." is value" cr ;          -rot type space .name
 : dodef .name ." is defered word, is: "      else
          here @ look 0= ABORT" SEE: No valid xt in defered word"          drop ." noname " type
         .name cr here @ look drop dosee ;      then
 : dodoe .name ." is created word" cr      space ;
         S" DOES> " Com# .string XPos @ Level !  
         here @ dup C-Pass @ DebugMode = IF ScanMode c-pass ! EXIT THEN  Defer discode ( addr -- )
         ScanMode c-pass ! dup makepass  \  hook for the disassembler: disassemble code at addr (as far as the
         DisplayMode c-pass ! makepass ;  \  disassembler thinks is sensible)
 : doali .name ." is alias of "  :noname ( addr -- )
         here @ .name cr      drop ." ..." ;
         here @ dosee ;  IS discode
 : docol S" : " Com# .string  
         cell+ dup count $1F and 2 pick wordinfo .string bl cemit bl cemit  : seecode ( xt -- )
         ( XPos @ ) 2 Level !      dup s" Code" .defname
         name> >body      >body discode
         C-Pass @ DebugMode = IF ScanMode c-pass ! EXIT THEN      ."  end-code" cr ;
         ScanMode c-pass ! dup makepass  : seevar ( xt -- )
         DisplayMode c-pass ! makepass ;      s" Variable" .defname cr ;
   : seeuser ( xt -- )
 create wordtypes      s" User" .defname cr ;
         Pri# ,   ' dopri A,  : seecon ( xt -- )
         Var# ,   ' dovar A,      dup >body ?
         Con# ,   ' docon A,      s" Constant" .defname cr ;
         Val# ,   ' doval A,  : seevalue ( xt -- )
         Def# ,   ' dodef A,      dup >body ?
         Doe# ,   ' dodoe A,      s" Value" .defname cr ;
         Ali# ,   ' doali A,  : seedefer ( xt -- )
         Col# ,   ' docol A,      dup >body @ xt-see-xt cr
         0 ,      dup s" Defer" .defname cr
       >name dup ??? = if
 : (dosee) ( lfa -- )          drop ." lastxt >body !"
         dup cell+ dup c@ 32 and IF over .name ." is an immediate word" cr THEN      else
         wordinfo          ." IS " .name cr
         wordtypes      then ;
         BEGIN dup @ dup  : see-threaded ( addr -- )
         WHILE 2 pick = IF cell+ @ nip EXECUTE EXIT THEN      C-Pass @ DebugMode = IF
               2 cells +          ScanMode c-pass !
         REPEAT          EXIT
         2drop      THEN
         .name ." Don't know how to handle" cr ;      ScanMode c-pass ! dup makepass
       DisplayMode c-pass ! makepass ;
 ' (dosee) IS dosee  : seedoes ( xt -- )
       dup s" create" .defname cr
 : see   name find cr 0= IF ." Word unknown" cr drop exit THEN      S" DOES> " Com# .string XPos @ Level !
         >name c-init      >does-code see-threaded ;
         dosee ;  : seecol ( xt -- )
       dup s" :" .defname nl
 : xtc ( xt -- )       \ do see at xt      2 Level !
         Look 0= ABORT" SEE: No valid XT"      >body see-threaded ;
         cr c-init  : seefield ( xt -- )
         dosee ;      dup >body ." 0 " ? ." 0 0 "
       s" Field" .defname cr ;
 : lfc   cr c-init cell+ dosee ;  
 : nfc   cr c-init dosee ;  : xt-see ( xt -- )
       cr c-init
       dup >does-code
       if
           seedoes EXIT
       then
       dup xtprim?
       if
           seecode EXIT
       then
       dup >code-address
       CASE
           docon: of seecon endof
           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] ]
           over >body of seecode endof
           2drop abort" unknown word type"
       ENDCASE ;
   
   : (xt-see-xt) ( xt -- )
       xt-see cr ." lastxt" ;
   ' (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@ ['] 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 (.immediate)
           then
       then
       rdrop drop ;
   
   : see ( "name" -- ) \ tools
       name find-name dup 0=
       IF
           drop -&13 bounce
       THEN
       name-see ;
   
   

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


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