Action:
|
Sets debug output to be printed to the specified output device.
|
|
Filename:
|
kern/kern_scm/dbg_scm.cxx
|
|
Syntax:
|
(debug:file [filename | "stderr" | "stdout"])
|
|
Arg Types:
|
filename
|
string
|
|
Returns:
|
boolean
|
|
Description:
|
entity:check,
entity:debug,
part:debug,
roll:debug, and
view:debug are Scheme extensions that generate debug information.
|
|
|
If no permissions are granted for the directory or file in question, this extension generates an error and returns
#f.
|
|
|
filename is an optional argument that defines the name of the path and output file. If no file extension is given for the file, a
.dbg extension is added. If no
filename is provided, the default for standard output is
stderr. By default,
stderr is the same as
stdout.
stdout is set by default to be the Scheme AIDE command window.
|
|
Example:
|
; debug:file
|
|
; Create entity 1.
|
|
(define block1
|
|
|
(solid:block (position 0 0 0)
|
|
|
(position 30 30 30)))
|
|
;; block1
|
|
; Redirect the debugging output to
|
|
; a file called errinfo.dbg.
|
|
(debug:file "errinfo")
|
|
;; #[file-input-output-port "errinfo.dbg"]
|
|
; Set the debug level.
|
|
(entity:debug block1 4)
|
|
;; "solid body"
|
|
; Redirect the debugging output to standard output.
|
|
(debug:file "stdout")
|
|
;; #[file-input-output-port "stdout"]
|