--- gforth/see.fs 1995/11/02 14:20:53 1.8 +++ gforth/see.fs 1997/01/29 21:32:38 1.15 @@ -1,11 +1,32 @@ \ 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 \ I'm sorry. This is really not "forthy" enough. \ Ideas: Level should be a stack +require termsize.fs + decimal \ Screen format words 16may93jaw @@ -29,6 +50,7 @@ VARIABLE Level : level- -7 Level +! ; VARIABLE nlflag +VARIABLE uppercase \ structure words are in uppercase DEFER nlcount ' noop IS nlcount @@ -37,7 +59,7 @@ DEFER nlcount ' noop IS nlcount XPos @ Level @ = ?Exit C-Formated @ IF C-Output @ - IF C-Clearline @ IF 80 XPos @ - spaces + IF C-Clearline @ IF cols XPos @ - spaces ELSE cr THEN 1 YPos +! 0 XPos ! Level @ spaces @@ -45,10 +67,16 @@ DEFER nlcount ' noop IS nlcount : warp? ( len -- len ) 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 -- ) - 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? over bl = Level @ XPos @ = and @@ -77,7 +105,8 @@ VARIABLE Colors Colors on ' (.string) IS .string -: .struc Str# .string ; +: .struc + uppercase on Str# .string ; \ CODES 15may93jaw @@ -181,54 +210,16 @@ VARIABLE C-Pass : ahead? ( n -- flag ) 0> ; : c-(compile) - Display? IF s" POSTPONE " Com# .string - dup @ look 0= ABORT" SEE: No valid XT" - cell+ count $1F and 0 .string bl cemit - THEN - cell+ ; - -: c-lit - Display? IF - dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit - THEN - cell+ ; - -: c-@local# - Display? IF - S" @local" 0 .string - dup @ dup 1 cells / abs 0 <# #S rot sign #> 0 .string bl cemit - THEN - cell+ ; - -: c-flit - Display? IF - 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# - Display? IF - S" f@local" 0 .string - dup @ dup 1 floats / abs 0 <# #S rot sign #> 0 .string bl cemit + Display? + IF + s" POSTPONE " Com# .string + dup @ look 0= ABORT" SEE: No valid XT" + name>string 0 .string bl cemit THEN cell+ ; -: c-laddr# - Display? IF - S" laddr# " 0 .string - dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit - THEN - cell+ ; - -: c-lp+!# +: c-lit Display? IF - S" lp+!# " 0 .string dup @ dup abs 0 <# #S rot sign #> 0 .string bl cemit THEN cell+ ; @@ -360,44 +351,22 @@ VARIABLE C-Pass DebugBranch 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 Display? IF nl S" FOR" .struc level+ THEN ; -: c-next - Display? IF level- nl S" NEXT " .struc nl THEN - DebugBranch cell+ cell+ ; +: .name-without + dup 1 cells - @ look IF name>string 1 /string 1- .struc ELSE drop THEN ; : c-loop - Display? IF level- nl S" LOOP " .struc nl THEN + Display? IF level- nl .name-without bl cemit nl THEN DebugBranch cell+ cell+ ; -: c-+loop - Display? IF level- nl S" +LOOP " .struc nl 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-do + Display? IF nl .name-without level+ THEN ; -: 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-?do + Display? IF nl S" ?DO" .struc level+ THEN + DebugBranch cell+ ; : c-leave Display? IF S" LEAVE " .struc THEN @@ -431,56 +400,55 @@ VARIABLE C-Pass CREATE C-Table ' lit A, ' c-lit A, - ' @local# A, ' c-@local# A, - ' flit A, ' c-flit A, - ' f@local# A, ' c-f@local# A, - ' laddr# A, ' c-laddr# A, - ' lp+!# A, ' c-lp+!# A, - ' (s") A, ' c-s" A, - ' (.") A, ' c-." A, + ' (s") A, ' c-s" A, + ' (.") A, ' c-." A, ' "lit A, ' c-c" A, - ' leave A, ' c-leave A, - ' ?leave A, ' c-?leave A, + comp' leave drop A, ' c-leave A, + comp' ?leave drop A, ' c-?leave A, ' (do) A, ' c-do A, + ' (+do) A, ' c-do A, + ' (u+do) A, ' c-do A, + ' (-do) A, ' c-do A, + ' (u-do) A, ' c-do A, ' (?do) A, ' c-?do A, ' (for) A, ' c-for A, ' ?branch A, ' c-?branch A, ' branch A, ' c-branch A, ' (loop) A, ' c-loop A, - ' (+loop) A, ' c-+loop A, - ' (s+loop) A, ' c-s+loop A, - ' (-loop) A, ' c--loop A, - ' (next) A, ' c-next 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, + ' (+loop) A, ' c-loop A, + ' (s+loop) A, ' c-loop A, + ' (-loop) A, ' c-loop A, + ' (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 , + 0 , here 0 , + +avariable c-extender +c-extender ! \ DOTABLE 15may93jaw : DoTable ( cfa -- flag ) C-Table - BEGIN dup @ dup - WHILE 2 pick <> + BEGIN dup @ dup 0= + 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 + REPEAT - nip cell+ @ EXECUTE + nip cell+ perform true - ELSE - 2drop drop false - THEN ; + ; : BranchTo? ( a-addr -- a-addr ) Display? IF dup BranchAddr? - IF BEGIN cell+ @ dup 20 u> + IF + BEGIN cell+ @ dup 20 u> IF drop nl S" BEGIN " .struc level+ ELSE dup Disable <> @@ -512,75 +480,126 @@ CREATE C-Table Branches on ; : makepass ( a-addr -- ) - c-stop off - BEGIN - analyse - c-stop @ - UNTIL drop ; - -DEFER dosee - -: dopri .name ." is primitive" cr ; -: dovar ." Variable " .name cr ; -: douse ." User " .name cr ; -: docon dup cell+ (name>) >body @ . ." Constant " .name cr ; -: doval dup cell+ (name>) >body @ . ." Value " .name cr ; -: dodef ." Defer " dup >r .name cr - r@ cell+ (name>) >body @ look - 0= ABORT" SEE: No valid xt in deferred word" - dup dosee cr - ." ' " .name r> ." IS " .name cr ; -: dodoe ." Create " dup .name cr - S" DOES> " Com# .string XPos @ Level ! name> - >does-code dup C-Pass @ DebugMode = IF ScanMode c-pass ! EXIT THEN - ScanMode c-pass ! dup makepass - DisplayMode c-pass ! makepass ; -: doali here @ .name ." Alias " .name cr - here @ dosee ; -: docol S" : " Com# .string - dup cell+ count $1F and 2 pick wordinfo .string bl cemit bl cemit - ( XPos @ ) 2 Level ! - name> >body - C-Pass @ DebugMode = IF ScanMode c-pass ! EXIT THEN - ScanMode c-pass ! dup makepass - DisplayMode c-pass ! makepass ; - -create wordtypes - Pri# , ' dopri A, - 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 - dosee ; - -: see name sfind 0= IF ." Word unknown" cr exit THEN - xtc ; - -: lfc cr c-init cell+ dosee ; -: nfc cr c-init dosee ; + c-stop off + BEGIN + analyse + c-stop @ + UNTIL drop ; + +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 -- ) +\ hook for the disassembler: disassemble code at addr (as far as the +\ disassembler thinks is sensible) +:noname ( addr -- ) + drop ." ..." ; +IS discode + +: seecode ( xt -- ) + dup s" Code" .defname + >body discode + ." end-code" cr ; +: seevar ( xt -- ) + s" Variable" .defname cr ; +: seeuser ( xt -- ) + s" User" .defname cr ; +: seecon ( xt -- ) + dup >body ? + s" Constant" .defname cr ; +: seevalue ( xt -- ) + dup >body ? + s" Value" .defname cr ; +: seedefer ( xt -- ) + dup >body @ xt-see-xt cr + dup s" Defer" .defname cr + >name dup ??? = if + drop ." lastxt >body !" + else + ." IS " .name cr + then ; +: see-threaded ( addr -- ) + C-Pass @ DebugMode = IF + ScanMode c-pass ! + EXIT + THEN + ScanMode c-pass ! dup 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 ; + +: xt-see ( xt -- ) + cr c-init + dup >does-code + if + seedoes EXIT + then + dup forthstart u< + if + seecode EXIT + then + dup >code-address + CASE + docon: of seecon endof + docol: of seecol endof + dovar: of seevar endof + douser: of seeuser endof + dodefer: of seedefer endof + dofield: of seefield endof + 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 ;