D 2014-09-02T21:38:40.005
L Embedding\sSupport
P 93366cc3392d2a73286ed428c0cc2c6774274be7
U hypnotoad
W 2810
<h1>Source Files</h1>
* [/finfo?name=generic/tclMain.c|tclMain.c]
* [/finfo?name=generic/tclPanic.c|tclPanic.c]
* [/finfo?name=unix/tclAppInit.c|tclAppInit.c]
* [/finfo?name=win/tclAppInit.c|tclAppInit.c]
<h1>Public Interface</h1>
* Tcl_SetStartupScript
* Tcl_GetStartupScript
* Tcl_SourceRCFile
* Tcl_Main
* Tcl_MainEx
* Tcl_SetMainLoop
* Tcl_SetPanicProc
* Tcl_PanicVA
* Tcl_Panic
<h1>Private Interface</h1>
* TclFullFinalizationRequested
* TclGetMainLoop
<h1>Directly Depends On Public Interface</h1>
* [Threads]
* [Object System and Fundamental Object Types]
* [Variable Commands and Interfaces]
* [Pathname Management]
* [Filesystem Access]
* [Channel System]
* [list Object Type]
* [Preservation]
* [Parsing and Evaluation]
* [interp]
* [Event Loops]
* [dict Object Type]
* [Linked C Variables]
* [history]
* <i>unistd.h</i>
<h1>Directly Depends On Private Interface of</h1>
* [Initialization, Library, Autoloader]
* [Pathname Management]
* [Object System and Fundamental Object Types]
* [Parsing and Evaluation]
* [Allocation]
* [Environment Variables]
<h1>The core_zip_vfs Patch</h1>
The [/timeline?r=core_zip_vfs|core_zip_vfs] branch adds the ability to mount a zip archive concatenated to the current executable as a virtual file system, capable of hosting both env(TCL_LIBRARY) and kick off
a bootloader (if a file called <i>main.tcl</i> is present).
This patch:
* Adds [/finfo?name=generic/tclZipVfs.c|tclZipVfs.c]
* Modifies [/finfo?name=unix/tclAppInit.c|tclAppInit.c]
* Modifies [/finfo?name=win/tclAppInit.c|tclAppInit.c]
To build a self-contained executable:
<verbatim>
cp tclsh mynewkit
zip mynewkit.zip main.tcl
cat mynewkit.zip >> mynewkit
./mynewkit
(Launches using the code embedded in main.tcl)
</verbatim>
<h1>Discussion</h1>
This has been considered a single module, but tclPanic.c is essentially a self contained
bit without dependencies, while tclMain.c depends on nearly everything. Most other parts
of Tcl that claim a dependence on this module are really just callers of <b>Tcl_Panic</b>.
One wrinkle is the routine <b>tclWinDebugPanic</b> which is in multiple places,
tclWinError.c and tclWinFile.c. There's also a great deal of <b>#ifdef</b> in tclPanic.c.
A restructuring into a generic caller of <b>TclpPanic</b> might be a path to increasing
simplicity and conventionality.
The routine <b>TclGetMainLoop</b> is another to note. It appears in no header file.
It gets declared with <b>MODULE_SCOPE</b> but there doesn't appear to be any reason
it could not be a static function.
The routine <b>TclFullFinalizationRequested</b> probably should move into [Event Loops].
Z 36a9d082d7cbfbe6f25f9389757c63ee