--- gforth/kernel/Attic/special.fs	1997/09/13 12:05:53	1.4
+++ gforth/kernel/Attic/special.fs	1999/02/03 00:10:25	1.7
@@ -1,6 +1,6 @@
 \ words with non-default and non-immediate compilation semantics
 
-\ Copyright (C) 1996 Free Software Foundation, Inc.
+\ Copyright (C) 1996,1998 Free Software Foundation, Inc.
 
 \ This file is part of Gforth.
 
@@ -21,17 +21,21 @@
 \ this file comes last, because these words override cross' words.
 
 create s"-buffer /line chars allot
-has? ionly 
+has? compiler 0= 
 [IF] : s" [ELSE] :noname [THEN]
 	[char] " parse
     	/line min >r s"-buffer r@ cmove
     	s"-buffer r> ;
-has? ionly 0= [IF]
+has? compiler [IF]
 :noname [char] " parse postpone SLiteral ;
 interpret/compile: S" ( compilation 'ccc"' -- ; run-time -- c-addr u )	\ core,file	s-quote
+  \G Compilation: Parse a string ccc delimited by a " (double quote). At run-time,
+  \G return the length, u, and the start address, c-addr of the string. Interpretation:
+  \G parse the string as before, and return c-addr, u. The string is stored in a
+  \G temporary buffer which may be overwritten by subsequent uses of @code{S"}.
 [THEN]
 
-has? ionly 0= [IF]
+has? compiler [IF]
 : [IS] ( compilation "name" -- ; run-time xt -- ) \ possibly-gforth bracket-is
     ' >body postpone ALiteral postpone ! ; immediate restrict
 
@@ -46,6 +50,11 @@ interpret/compile: What's ( "name" -- ad
 :noname    [char] " parse type ;
 :noname    postpone (.") ,"  align ;
 interpret/compile: ." ( compilation 'ccc"' -- ; run-time -- )  \ core	dot-quote
+  \G Compilation: Parse a string ccc delimited by a " (double quote). At run-time,
+  \G display the string. Interpretation semantics for this word are undefined in
+  \G the ANS Forth Standard. Gforth's interpretation semantics are to display the
+  \G string. This is the simplest way to display a string from
+  \G within a definition; see examples below.
 
 \ DOES>                                                17mar93py
 
@@ -62,49 +71,11 @@ immediate
 
 [THEN]
 
-doer? :docon [IF]
-: docon: ( -- addr )	\ gforth
-    \G the code address of a @code{CONSTANT}
-    ['] bl >code-address ;
-[THEN]
-
-: docol: ( -- addr )	\ gforth
-    \G the code address of a colon definition
-    ['] on >code-address ;
-\ !! mark on
-
-doer? :dovar [IF]
-: dovar: ( -- addr )	\ gforth
-    \G the code address of a @code{CREATE}d word
-    \ in rom-applications variable might be implemented with constant
-    \ use really a created word!
-    ['] ??? >code-address ;
-[THEN]
-
-doer? :douser [IF]
-: douser: ( -- addr )	\ gforth
-    \G the code address of a @code{USER} variable
-    ['] sp0 >code-address ;
-[THEN]
-
-doer? :dodefer [IF]
-: dodefer: ( -- addr )	\ gforth
-    \G the code address of a @code{defer}ed word
-    ['] source >code-address ;
-[THEN]
-
-doer? :dofield [IF]
-: dofield: ( -- addr )	\ gforth
-    \G the code address of a @code{field}
-    ['] reveal-method >code-address ;
-[THEN]
-
-has? prims 0= [IF]
-: dodoes: ( -- addr )	\ gforth
-    \G the code address of a @code{field}
-    ['] spaces >code-address ;
-[THEN]
-
+has? compiler [IF]
 : interpret/compile? ( xt -- flag )
     >does-code ['] S" >does-code = ;
+[ELSE]
+: interpret/compile?
+    false ;
+[THEN]