TIP #414: ADD (BACK) TCL_INITSUBSYSTEMS AS PUBLIC API ======================================================= Version: $Revision: 1.3 $ Author: Brian Griffin State: Draft Type: Project Tcl-Version: 8.7 Vote: Pending Created: Monday, 15 October 2012 URL: http://tcl.activestate.com/cgi-bin/tct/tip/414.html Post-History: ------------------------------------------------------------------------- ABSTRACT ========== The ability to initialize just the lower level Tcl subsystems used to be part of the public API, now it is no longer exposed. This TIP proposes that it be re-exposed. RATIONALE =========== Some parts of Tcl's API are useful in portable applications even without creating a Tcl interpreter; examples of this include Tcl_Alloc and (most of) the Tcl_DString-related functions. In order to use these functions correctly, the Tcl library /must/ be initialized, yet the function for doing so - Tcl_InitSubsystems (currently TclInitSubsystems) - was removed from Tcl's API; using Tcl_FindExecutable instead feels incorrect as we're not seeking to make the name of the executable available to Tcl scripts. PROPOSED CHANGE ================= The function TclInitSubsystems should be exposed as Tcl_InitSubsystems in Tcl's C API. This will /not/ be a part of the Stub API; it is not intended to ever be used from a stubbed environment, as it is meant to be used prior to the stub table being available. REFERENCE IMPLEMENTATION ========================== Not yet available. COPYRIGHT =========== This document has been placed in the public domain. ------------------------------------------------------------------------- TIP AutoGenerator - written by Donal K. Fellows