diff options
author | Jason Molenda <jmolenda@apple.com> | 2000-02-07 00:19:28 +0000 |
---|---|---|
committer | Jason Molenda <jmolenda@apple.com> | 2000-02-07 00:19:28 +0000 |
commit | b111a96ea19bde1004ecea63c7827a1d4b0b73ef (patch) | |
tree | 2b8155215201f5224d8f68ec53f9720a89dfbdd9 /tix/docs/SAModule.txt | |
parent | b73e43e34794f4903b0bf2e0fc1298547ef01faf (diff) | |
download | gdb-b111a96ea19bde1004ecea63c7827a1d4b0b73ef.tar.gz |
import insight-2000-02-04 snapshot (2nd try)
Diffstat (limited to 'tix/docs/SAModule.txt')
-rw-r--r-- | tix/docs/SAModule.txt | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/tix/docs/SAModule.txt b/tix/docs/SAModule.txt new file mode 100644 index 00000000000..f1cb50b93c7 --- /dev/null +++ b/tix/docs/SAModule.txt @@ -0,0 +1,89 @@ + =============================== + Stand-alone Tix Applications + ================================ + +INTRODUCTION + + Traditionally, Tcl/Tk and its extensions require an extensive set of + run-time scripts. These scripts are usually stored as + /usr/local/lib/<package>/*.tcl. When a Tcl/Tk executable starts up, + it looks for the scripts in the /usr/local directory, or as defined + by enviornment variables such as TCL_LIBRARY or TIX_LIBRARY. + + The need of an external script library sometimes causes problems + because users may need to keep track of their TCL_LIBRARY environment + variables. Also, it is quite difficult to distribute a Tcl + executable to a customer's site if the customer's machines don't + already have Tcl installed. + + One solution of this problem is to compile stand-alone versions + Tcl/Tk application. The scripts can be compiled into into the + application executable, or into shared libraries which are linked + into the executable. The distrution of a monolithic executable, or + one executable with several shared libraries, is substantially + easier than the distribution of many Tcl scripts scattered around in + differenr directories. + +COMPILING STAND-ALONE TIX + + Currently Tix supports standalone modules only for Tcl version 7.5 + and 7.6 on Unix. Read the file docs/UnixInst.html first before + reading the rest of this section. + + To exable Tix stand-alone module, change into a Unix build directory + and run the configure script with the --enable-sam option. Then, run + "make". When "make" finishes, you will get several libraries and + executables (the names may vary depending on the version of Tcl and + the Unix platform): + + libtix4.1.7.6.so Standard Tix shared library. + tixwish Standard Tix shell. + + libtixsam4.1.7.6.so Tix SAM library. + libtksam4.2.so Tk Sam library. + libtclsam7.6.so Tcl Sam library. + satixwish Stand-alone Tix shell + sawish Stand-alone Tk shell + satclsh Stand-alone Tcl shell + + +DISTRIBUTING satixwish + + satixwish is linked to the following libraries + libtixsam Tix c code and scripts + libtksam Tk scripts. + libtk Tk c code + libtclsam Tcl scripts + libtcl Tcl c code. + + If you would like to distribute satixwish, you should include the + satixwish executable, the five shared libraries and your + application's Tcl scripts. There is no need to include the Tcl, Tk + and Tix script libraries. + +DYNAMICALLY LOADING TIX SAM + + You can also dynamically load libtixsam into a running wish. If you + have properly installed Tix, you can execute the command + + package require -exact Tixsam [tixBinVer 4.1] + + If Tix has not been installed in your system, you can still use the + "load" command to dynamically load Tixsam: + + load [file join $dir \ + libtixsam[tixBinVer 4.1][info sharedlibextension]] \ + Tixsam + + See the file docs/Pkg.txt for discussions on the tixBinVer + procedure and dynamic loading of Tix. + +USING TIX WITH EMBEDDED TK + + Embedded Tk (ET) is another popular package for creating stand-alone + Tcl/Tk applications. Older versions of Tix used to support + ET. However, the scripts of this version of Tix cannot be compiled + by the et2c program. If you want to use Tix in an ET-enabled + application, you should link libtixsam with your application and + call Tixsam_Init() to initialize the stand-alone Tix module. See the + directory demos/et for an example. |