Specifying a Custom Interpreter or Custom Initialization Files

Specifying a Custom Interpreter or Custom Initialization Files

The prowrap executable option specifies a Tcl interpreter to wrap with your application. If you include both the uses and executable options when wrapping, TclPro Wrapper automatically wraps all the initialization library files required for the standard interpreter (for example, init.tcl), but includes the custom interpreter you specify rather than the standard interpreter.

The prowrap tcllibrary option specifies where the wrapped application can find the Tcl initialization library files at the time that it is run (rather than at the time you wrap the application). In other words, it sets the value of the Tcl tcl_library variable used by your application during its initialization. You don't need to include the prowrap tcllibrary option if your application uses the standard initialization files and you wrap the application using a built-in uses option. The built-in uses options automatically wrap the standard initialization files and sets the tcl_library variable appropriately.

Note: As with any other file reference in a wrapped application, the prowrap tcllibrary value you specify can refer to either a file on the disk or a file in the internal file archive. In other words, if you provide an absolute pathname, your application looks for the initialization files on the disk when it runs. On the other hand, if you specify a relative pathname, your application first looks in its internal file archive for the initialization files, and looks on the disk only if the files don't exist in the archive. For more information on file access in a wrapped application, see "How the Internal File Archive Works in a Wrapped Application".

Note: Always use the prowrap tcllibrary option to set the value of the Tcl tcl_library variable rather than setting it using a prowrap code option. Your application needs the correct value of the Tcl tcl_library variable during the initialization of the Tcl interpreter (primarily to find the character encoding files). Code that you include with the code option is executed after initialization of the core Tcl interpreter.

Note: The prowrap tcllibrary option does not set the value of the Tcl tk_library variable or any other similar variable used by a Tcl package. Use the prowrap code option to set these variables if you don't use a built-in uses option.

The proper combination of uses, executable, and tcllibrary options depends on:

Whether you are creating a statically- or dynamically-linked application
Whether or not you use a custom interpreter
Whether or not you use custom initialization files

Obviously, if you use a standard interpreter and standard initialization file, you can simply use the built-in uses options as described in "Specifying the Tcl Interpreter". The other cases are described in the following sections.

http://www.ajubasolutions.com
Voice: (650) 210-0100
Fax: (650) 210-0101
support@ajubasolutions.com