Copyright (c) 1993 The Regents of the University of California.
 Copyright (c) 1994-1996 Sun Microsystems, Inc.

 See the file "license.terms" for information on usage and redistribution
 of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 
 exit n "" Tcl "Tcl Built-In Commands"
.so  man.macros
S  Note: do not modify the .SH NAME line immediately below!
 NAME
exit - End the application

 SYNOPSIS
exit ?returnCode?
E 

 DESCRIPTION

Terminate the process, returning returnCode to the
system as the exit status.
If returnCode is not specified then it defaults
to 0.

 EXAMPLE
Since non-zero exit codes are usually interpreted as error cases by
the calling process, the exit command is an important part of
signaling that something fatal has gone wrong. This code fragment is
useful in scripts to act as a general problem trap:
.CS
proc main {} {
 # ... put the real main code in here ...
}

if {[catch {main} msg options]} {
 puts stderr "unexpected script error: $msg"
 if {[info exist env(DEBUG)]} {
 puts stderr "---- BEGIN TRACE ----"
 puts stderr [dict get $options -errorinfo]
 puts stderr "---- END TRACE ----"
 }

 # Reserve code 1 for "expected" error exits...
 exit 2
}
.CE


 "SEE ALSO"
exec(n)


 KEYWORDS
exit, process