--- gforth/doc/gforth.ds	2003/01/20 17:07:39	1.105
+++ gforth/doc/gforth.ds	2003/01/21 10:24:44	1.106
@@ -11536,6 +11536,13 @@ doc-~~
 doc-printdebugdata
 doc-.debugline
 
+@cindex filenames in @code{~~} output
+@code{~~} (and assertions) will usually print the wrong file name if a
+marker is executed in the same file after their occurance.  They will
+print @samp{*somewhere*} as file name if a marker is executed in the
+same file before their occurance.
+
+
 @node Assertions, Singlestep Debugger, Debugging, Programming Tools
 @subsection Assertions
 @cindex assertions
@@ -11599,6 +11606,12 @@ If there is interest, we will introduce
 intend to @code{catch} a specific condition, using @code{throw} is
 probably more appropriate than an assertion).
 
+@cindex filenames in assertion output
+Assertions (and @code{~~}) will usually print the wrong file name if a
+marker is executed in the same file after their occurance.  They will
+print @samp{*somewhere*} as file name if a marker is executed in the
+same file before their occurance.
+
 Definitions in ANS Forth for these assertion words are provided
 in @file{compat/assert.fs}.