README.stubs
1This version of Togl is entirely free from
2dependencies on Tcl/Tk's internal functions. It uses the public stubs
3interface, witch means that the same binary works with any stubs-aware
4wish (i.e. version >= 8.1)
5
6It has been tested on Windows NT/2000 and Linux for several Tcl/Tk versions up
7to 8.4a3. I haven't been able to test the Mac port, it propably needs mending
8but I can't see why it shouldn't work in principle.
9
10Implementation wise, what differs from Togl 1.5 is that Togl_MakeWindowExist()
11is replaced by Togl_CreateWindow(), a function that gets registered in Tk as a callback for window creation. In Tk/Tk 8.4a3, there is a new public API call
12Tk_SetClassProcs() to register this callback, but for earlier versions of Tk
13one needs to do this using some pointer magic.
14There is a run-time check to determine which method to use, hence the
15same binary runs on all versions of Wish from 8.1 and up. For this to
16work you need to compile against the headers from Tcl/Tk 8.4a3 or later, or
17the binary will only work for Tcl/Tk 8.1-8.4a2.
18The tk8.4a3 public headers (tk8.4a3.h + tkDecls.h) are included for
19conveniance, and they are used if the flag -DUSE_LOCAL_TK_H is specified.
20
21Jonas Beskow, December 2001