Poet2.2 Manual | Prototype Object Extension for Tcl |
Poet is installed by extracting the Poet archive and running install.tcl from the Poet directory. Run the installer with the wish that you plan to use for development, the files will be installed in the lib/ and doc/ directories corresponding to that wish. (You may need to have adminstrator/superuser privledges to do the installation.) Poet is distributed with Tier 0 compiled for Windows, Linux, and Mac OS X, other users will have to compile it first (binaries are provided for both Tcl 8.4 and 8.5, and they can reside in the installation directory simultaneously). Note: the compilation currently fails on Mac OS X with Tcl 8.4.
If you're going to use BWidget with Tktable, you'll need to patch your BWidget installation by adding the file table.tcl from Poet's instmisc/ directory. This allows BWidget's drag-and-drop support to work with Tktable. Note that Poetics needs this patch! If you get the error "Invalid command name Table::create", you need to install the patch. The Poet installer has an option to apply the patch to your copy of BWidget (it can also uninstall the patch).
Poet is loaded by issuing the command
package require Poetfrom within tclsh or wish. To select which tiers to load, set the environment variable POET_TIER to 1, 2 (the default) or 3. For example, to load all three tiers:
set ::env(POET_TIER) 3
package
require Poet
If you're in wish and would like to see a demo of the Poet widgets, load the Poet package then send a "demo" message to the ProtoWidget object with:
ProtoWidget demo