Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

dribble

dribble

type: function (subr)  
location: built-in
source file: xlisp.c  xlsys.c  msstuff.c 
Common LISP compatible: yes
supported on: all machines

SYNTAX

(transcript [ <file-str> ] )
        <file-str>      -       a string expression for a file name

DESCRIPTION

The DRIBBLE function, when called with a <file-str> argument, opens the specified file and records a transcript of the XLISP session. When DRIBBLE is called with no <file-str> argument, it closes the current transcript file (if any). DRIBBLE will return T if the specified <file-str> was successfully opened. It will return a NIL if the <file-str> was not opened successfully or if DRIBBLE was evaluated to close a transcript.

EXAMPLES

(dribble "my-trans-file")               ; open file "my-trans-file"
                                        ; for a session transcript
(+ 2 2)                                 
(dribble)                               ; close the transcript

NOTE: It is also possible to start a transcript when invoking XLISP. To start xlisp with a transcript file of 'myfile' type in "xlisp -tmyfile".

NOTE: The DRIBBLE function works in XLISP 2.0 for MS-DOS systems. However, depending on the sources you use - or where you got XLISP 2.0, the generic (non-DOS) systems might not have the appropriate code for DRIBBLE to work properly.


Go to the first, previous, next, last section, table of contents.