summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2017-09-08 11:04:34 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2017-09-08 11:04:34 (GMT)
commit15f27ca8f22cf02047544fa5d06f227d9f1d14f8 (patch)
treee6ce49deb69fd3115a9a2055b3272390e65bedb0 /doc
parent413fe66650f5b1467098f19daeee0c8843bebc4c (diff)
parentb5273bc1fa5f55149f34824435b65ea807794abc (diff)
downloadtcl-15f27ca8f22cf02047544fa5d06f227d9f1d14f8.zip
tcl-15f27ca8f22cf02047544fa5d06f227d9f1d14f8.tar.gz
tcl-15f27ca8f22cf02047544fa5d06f227d9f1d14f8.tar.bz2
Rebase to trunk
Diffstat (limited to 'doc')
-rw-r--r--doc/Panic.313
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/Panic.3 b/doc/Panic.3
index af86665..fa86908 100644
--- a/doc/Panic.3
+++ b/doc/Panic.3
@@ -7,7 +7,7 @@
.BS
'\" Note: do not modify the .SH NAME line immediately below!
.SH NAME
-Tcl_Panic, Tcl_PanicVA, Tcl_SetPanicProc \- report fatal error and abort
+Tcl_Panic, Tcl_PanicVA, Tcl_SetPanicProc, Tcl_ConsolePanic \- report fatal error and abort
.SH SYNOPSIS
.nf
\fB#include <tcl.h>\fR
@@ -21,6 +21,9 @@ void
void
\fBTcl_SetPanicProc\fR(\fIpanicProc\fR)
.sp
+void
+\fBTcl_ConsolePanic\fR(\fIformat\fR, \fIarg\fR, \fIarg\fR, \fI...\fR)
+.sp
.SH ARGUMENTS
.AS Tcl_PanicProc *panicProc
.AP "const char*" format in
@@ -54,6 +57,14 @@ message is sent to the debugger in stead. If the windows executable
does not have a stderr channel (e.g. \fBwish.exe\fR), then a
system dialog box is used to display the panic message.
.PP
+If your application doesn't use \fBTcl_Main\fR or \fBTk_Main\fR
+and you want to implicitly use the stderr channel of your
+application's C runtime (in stead of the stderr channel of the
+C runtime used by Tcl), you can call \fBTcl_SetPanicProc\fR
+with \fBTcl_ConsolePanic\fR as its argument. On platforms which
+only have one C runtime (almost all platforms except Windows)
+\fBTcl_ConsolePanic\fR is equivalent to NULL.
+.PP
\fBTcl_SetPanicProc\fR may be used to modify the behavior of
\fBTcl_Panic\fR. The \fIpanicProc\fR argument should match the
type \fBTcl_PanicProc\fR: