--- gforth/see.fs	2000/03/11 20:35:05	1.25
+++ gforth/see.fs	2000/11/13 22:10:30	1.33
@@ -1,6 +1,6 @@
 \ SEE.FS       highend SEE for ANSforth                16may93jaw
 
-\ Copyright (C) 1995 Free Software Foundation, Inc.
+\ Copyright (C) 1995,2000 Free Software Foundation, Inc.
 
 \ This file is part of Gforth.
 
@@ -16,7 +16,7 @@
 
 \ 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.
+\ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
 
 
 \ May be cross-compiled
@@ -28,7 +28,19 @@
 require look.fs
 require termsize.fs
 require wordinfo.fs
-[IFUNDEF] .name : .name name>string type space ; [THEN]
+[IFUNDEF] .name
+: id. ( nt -- ) \ gforth
+    \G Print the name of the word represented by @var{nt}.
+    \ this name comes from fig-Forth
+    name>string type space ;
+
+' id. alias .id ( nt -- )
+\G F83 name for @code{id.}.
+
+' id. alias .name ( nt -- )
+\G Gforth <=0.5.0 name for @code{id.}.
+
+[THEN]
 
 decimal
 
@@ -480,7 +492,7 @@ c-extender !
         dup cell+ swap @
         dup >r DoTable r> swap IF drop EXIT THEN
         Display?
-        IF look 0= IF  drop dup 1 cells - @ .  \ ABORT" SEE: Bua!"
+        IF look 0= IF  drop dup 1 cells - @ ." <" 0 .r ." >"
 	ELSE
 	    dup cell+ count dup immediate-mask and
 	    IF  bl cemit  ." POSTPONE " THEN
@@ -514,12 +526,43 @@ Defer xt-see-xt ( xt -- )
     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
+Defer discode ( addr u -- ) \ gforth
+\G hook for the disassembler: disassemble code at addr of length u
+' 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?
+	if
+	    i unloop exit
+	then
+    cell +loop
+    here ;
+
+: umin ( u1 u2 -- u )
+    2dup u>
+    if
+	swap
+    then
+    drop ;
+	
+: 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> + ;
 
 : seecode ( xt -- )
     dup s" Code" .defname
@@ -527,8 +570,14 @@ IS discode
     if
 	>code-address
     then
-    discode
-    ."  end-code" cr ;
+    dup in-dictionary? \ user-defined code word?
+    if
+	dup next-head
+    else
+	dup next-prim
+    then
+    over - discode
+    ." end-code" cr ;
 : seevar ( xt -- )
     s" Variable" .defname cr ;
 : seeuser ( xt -- )
@@ -542,10 +591,10 @@ IS discode
 : seedefer ( xt -- )
     dup >body @ xt-see-xt cr
     dup s" Defer" .defname cr
-    >name dup ??? = if
-	drop ." lastxt >body !"
-    else
+    >name ?dup-if
 	." IS " .name cr
+    else
+	." lastxt >body !"
     then ;
 : see-threaded ( addr -- )
     C-Pass @ DebugMode = IF
@@ -566,7 +615,8 @@ IS discode
     dup >body ." 0 " ? ." 0 0 "
     s" Field" .defname cr ;
 
-: xt-see ( xt -- )
+: xt-see ( xt -- ) \ gforth
+    \G Decompile the definition represented by @i{xt}.
     cr c-init
     dup >does-code
     if
@@ -590,7 +640,8 @@ IS discode
 [ [IFDEF] dofield: ]
 	dofield: of seefield endof
 [ [THEN] ]
-	over >body of seecode endof
+	over       of seecode endof \ direct threaded code words
+	over >body of seecode endof \ indirect threaded code words
 	2drop abort" unknown word type"
     ENDCASE ;