From 3a4b0be0b1835791115d8aeabeffc2ea302f1e98 Mon Sep 17 00:00:00 2001 From: "jan.nijtmans" Date: Wed, 21 Nov 2018 07:40:13 +0000 Subject: TIP #512 documentation: Indicate which functions cannot be called through the stub table any more. --- doc/Exit.3 | 3 +++ doc/FindExec.3 | 4 +++- doc/Panic.3 | 6 +++++- doc/StaticPkg.3 | 3 +++ doc/Tcl_Main.3 | 2 ++ doc/zipfs.3 | 2 ++ generic/tcl.decls | 13 +++++++++++++ 7 files changed, 31 insertions(+), 2 deletions(-) diff --git a/doc/Exit.3 b/doc/Exit.3 index 9a04db3..a52b2e1 100644 --- a/doc/Exit.3 +++ b/doc/Exit.3 @@ -134,6 +134,9 @@ finalization of Tcl's subsystems via \fBTcl_Finalize\fR at an appropriate time. The argument passed to \fIproc\fR when it is invoked will be the exit status code (as passed to \fBTcl_Exit\fR) cast to a ClientData value. +.PP +\fBTcl_SetExitProc\fR can not be used in stub-enabled extensions. Its symbol +entry in the stub table is deprecated and it will be removed in Tcl 9.0. .SH "SEE ALSO" exit(n) .SH KEYWORDS diff --git a/doc/FindExec.3 b/doc/FindExec.3 index 1fd57db..149ef8a 100644 --- a/doc/FindExec.3 +++ b/doc/FindExec.3 @@ -58,6 +58,8 @@ internal full path name of the executable file as computed by equivalent to the \fBinfo nameofexecutable\fR command. NULL is returned if the internal full path name has not been computed or unknown. - +.PP +\fBTcl_FindExecutable\fR can not be used in stub-enabled extensions. Its symbol +entry in the stub table is deprecated and it will be removed in Tcl 9.0. .SH KEYWORDS binary, executable file diff --git a/doc/Panic.3 b/doc/Panic.3 index fa86908..ba39ddf 100644 --- a/doc/Panic.3 +++ b/doc/Panic.3 @@ -93,7 +93,11 @@ have a panic message displayed the same way that panic messages from Tcl will be displayed. .PP \fBTcl_PanicVA\fR is the same as \fBTcl_Panic\fR except that instead of -taking a variable number of arguments it takes an argument list. +taking a variable number of arguments it takes an argument list. This +function is deprecated and will be removed in Tcl 9.0. +.PP +This function can not be used in stub-enabled extensions. Its symbol +entry in the stub table is deprecated and it will be removed in Tcl 9.0. .SH "SEE ALSO" abort(3), printf(3), exec(n), format(n) .SH KEYWORDS diff --git a/doc/StaticPkg.3 b/doc/StaticPkg.3 index 41e2d65..8d04cd1 100644 --- a/doc/StaticPkg.3 +++ b/doc/StaticPkg.3 @@ -64,6 +64,9 @@ the event of an error it should set the interpreter's result to point to an error message. The result or error from the initialization procedure will be returned as the result of the \fBload\fR command that caused the initialization procedure to be invoked. +.PP +This function can not be used in stub-enabled extensions. Its symbol +entry in the stub table is deprecated and it will be removed in Tcl 9.0. .SH KEYWORDS initialization procedure, package, static linking .SH "SEE ALSO" diff --git a/doc/Tcl_Main.3 b/doc/Tcl_Main.3 index 3ec33d1..816dfeb 100644 --- a/doc/Tcl_Main.3 +++ b/doc/Tcl_Main.3 @@ -189,6 +189,8 @@ procedure (if any) returns. In non-interactive mode, after \fBTcl_Main\fR evaluates the startup script, and the main loop procedure (if any) returns, \fBTcl_Main\fR will also evaluate the \fBexit\fR command. +.PP +This function can not be used in stub-enabled extensions. .SH "SEE ALSO" tclsh(1), Tcl_GetStdChannel(3), Tcl_StandardChannels(3), Tcl_AppInit(3), exit(n), encoding(n) diff --git a/doc/zipfs.3 b/doc/zipfs.3 index 8e2eacc..23b9a93 100644 --- a/doc/zipfs.3 +++ b/doc/zipfs.3 @@ -112,6 +112,8 @@ call is a standard Tcl result code. unmounts the mounted ZIP file system that was mounted from \fIzipname\fR (at \fImountpoint\fR). Errors are reported in the interpreter \fIinterp\fR. The result of this call is a standard Tcl result code. +.PP +\fBTclZipfs_AppHook\fR can not be used in stub-enabled extensions. .SH "SEE ALSO" zipfs(n) .SH KEYWORDS diff --git a/generic/tcl.decls b/generic/tcl.decls index 000fe98..f9e4763 100644 --- a/generic/tcl.decls +++ b/generic/tcl.decls @@ -2429,6 +2429,19 @@ export { Tcl_Interp *interp) } export { + void Tcl_StaticPackage(Tcl_Interp *interp, const char *pkgName, + Tcl_PackageInitProc *initProc, Tcl_PackageInitProc *safeInitProc) +} +export { + void Tcl_SetPanicProc(TCL_NORETURN1 Tcl_PanicProc *panicProc) +} +export { + Tcl_ExitProc *Tcl_SetExitProc(TCL_NORETURN1 Tcl_ExitProc *proc) +} +export { + void Tcl_FindExecutable(const char *argv0) +} +export { const char *Tcl_InitStubs(Tcl_Interp *interp, const char *version, int exact) } -- cgit v0.12