--- gforth/debugs.fs	2002/12/04 16:56:31	1.7
+++ gforth/debugs.fs	2009/02/20 19:32:35	1.20
@@ -1,12 +1,12 @@
 \ Simple debugging aids
 
-\ Copyright (C) 1995,1997,1999 Free Software Foundation, Inc.
+\ Copyright (C) 1995,1997,1999,2002,2003,2004,2005,2006,2007 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
+\ as published by the Free Software Foundation, either version 3
 \ of the License, or (at your option) any later version.
 
 \ This program is distributed in the hope that it will be useful,
@@ -15,8 +15,7 @@
 \ 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., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
+\ along with this program. If not, see http://www.gnu.org/licenses/.
 
 
 \ They are meant to support a different style of debugging than the
@@ -39,6 +38,9 @@ require source.fs
 defer printdebugdata ( -- ) \ gforth print-debug-data
 ' .s IS printdebugdata
 defer .debugline ( nfile nline -- ) \ gforth print-debug-line
+\G Print the source code location indicated by @var{nfile nline}, and
+\G additional debugging information; the default @code{.debugline}
+\G prints the additional information with @code{printdebugdata}.
 
 : (.debugline) ( nfile nline -- )
     cr .sourcepos ." :"
@@ -47,7 +49,19 @@ defer .debugline ( nfile nline -- ) \ gf
     printdebugdata
     cr ;
 
+stderr value debug-fid ( -- fid )
+\G (value) Debugging output prints to this file
+
 ' (.debugline) IS .debugline
 
-: ~~ ( compilation  -- ; run-time  -- ) \ gforth tilde-tilde
-    compile-sourcepos POSTPONE .debugline ; immediate
+: .debugline-directed ( nfile nline -- )
+    ['] .debugline debug-fid outfile-execute ;
+
+:noname ( -- )
+    current-sourcepos .debugline-directed ;
+:noname ( compilation  -- ; run-time  -- )
+    compile-sourcepos POSTPONE .debugline-directed ;
+interpret/compile: ~~ ( -- ) \ gforth tilde-tilde
+\G Prints the source code location of the @code{~~} and the stack
+\G contents with @code{.debugline}.
+