diff options
| author | jan.nijtmans <nijtmans@users.sourceforge.net> | 2017-09-08 11:04:34 (GMT) |
|---|---|---|
| committer | jan.nijtmans <nijtmans@users.sourceforge.net> | 2017-09-08 11:04:34 (GMT) |
| commit | b804e45a82d7c686dd3e8aeddfc876e7bfc24aa6 (patch) | |
| tree | e6ce49deb69fd3115a9a2055b3272390e65bedb0 /doc/Panic.3 | |
| parent | 48ce21e3a9c2c9da4e4674bf08275e378629a0e3 (diff) | |
| parent | 378d7bad7917f7cd43bd1af0b23ea6be4e01f1e3 (diff) | |
| download | tcl-win_console_panic.zip tcl-win_console_panic.tar.gz tcl-win_console_panic.tar.bz2 | |
Rebase to trunkwin_console_panic
Diffstat (limited to 'doc/Panic.3')
| -rw-r--r-- | doc/Panic.3 | 13 |
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: |