Next: sqrt() Up: MacAnova Help File Previous: split()   Contents


spool(FileName [,new:T] [,everything:T or F])
spool() toggles spooling on and off.
spool(,new:T) restarts spooling on the same file
spool(,everything:T or F)

Keywords: output, files
spool(FileName) begins printing MacAnova input and output into the file
with name given in the CHARACTER variable FileName.  If the named file
already exists, the spooled output will be added at the end of the file,
thus allowing a cumulative record of several runs.  Comments to annotate
what you have done may be added to input lines by preceding them with
'#'.  See topic 'comments'.  In a version with windows (Macintosh,
Windows, Motif), when FileName is "", you will be prompted for a name.

Output to the screen or window that is suppressed because option 'quiet'
has been set True, is not spooled to the file either.

spool() suspends spooling if spooling is currently in effect and
restarts it on the same file if spooling was previously in effect but is
not now.

spool(FileName, new:T) restarts spooling at the beginning of the spool
file, destroying any lines previously spooled.

spool(, new:T) restarts or resumes spooling at the beginning of the most
recently used spool file, destroying any lines previously spooled.

spool(FileName, everything:T [,new:T]) does the same, except lines are
spooled even when output to the screen or window is suppressed by option

spool(, everything:T or F) allows or suppresses spooling of lines
suppressed by setoptions(quiet:T).  It does not turn toggle spooling on
or off.

On a Macintosh, selecting item Spool Output to File on the File menu is
equivalent to typing 'spool("")'.  If a spool file name has previously
been provided, the item is labeled either Suspend Spooling or Resume
Spooling and is equivalent to 'spool()'.  In both cases it first erases
everything after the prompt.

Gary Oehlert 2003-01-15