Welcome to... ------------- A tcl binding to Motif Who by ------ Jan Newmarch (jan@pandonia.canberra.edu.au). Availability ------------ The primary site for this is csc.canberra.edu.au under /pub/motif/tclMotif/tclMotif.*.tar.z. It is also placed on X and tcl sites ftp.x.org and harbor.ecn.purdue.edu. From these sites it will be available on mirrors in lots of places. A binary version for Linux is also available from Linux sites such as sunsite and tsx-11. What ---- This package consists of a set of functions and a standalone interpreter "moat" that allow tcl programs to use the Motif set of widgets. A tcl file can be read by the standalone interpreter much as the Tk "wish" does. The difference is that instead of using the Tk library to create and manipulate Tk widgets, this system uses the Tm library to create and manipulate Motif widgets. Major changes in version 1.1 ---------------------------- - Popup and Option menus added. - XmDialogShell added. - TopLevel widget added, and Root uses its methods (popup, popdown). - Icons can now be set for toplevel widgets. - Various bug fixes. - More examples: xmeditor and wtour. - Imakefile improved for shared libraries, contributed by Joseph E. Sacco (jsacco@ssl.com). Relation to Wafe ---------------- The Wafe project also provides a binding of Xt widgets to tcl. Originally just the Athena widgets, it has been extended to other sets, and has a Motif binding in beta. - Wafe uses Motif 1.1, tclMotif uses Motif 1.2. This gives me better coverage of some parts of Motif, because Motif 1.2 supplies extra hooks. - The language syntax differs. tclMotif is closer to Tk than Wafe is. Wafe (and WKSH) use command object ... syntax. Both Tk and tclMotif use object command ... - I use the standard Motif callbacks, Wafe has its own callback model. - Wafe has more Xt support. - The primary aim of wafe is as a tcl/Xt front-end to other languages. My binding is just tcl to Motif, so I have been able to tune this to the Motif model easier. I am in correspondence with the authors of Wafe, and we share code and developments. Status ------ This is now in beta status. Please report any bugs either in existing code, or omissions that reduce the way you would like to use tclMotif. The changes over the releases are summarised in the file CHANGES Requirements ------------ This has been built using tcl7.3 and the Motif 1.2.1 development libraries. You need both. I have so far tested this stuff on a Sun O/S 4.1 and a 486 running Linux. Earlier versions used tcl6.7, but this is no longer supported. It should compile using tcl7.0b3 onwards, and all versions of Motif 1.2. There is some Motif 1.1 support i.e. it will compile and most things will run, but some things such as getting resource values of scalars such as XmNarrowDirection won't. Files ----- The directory "src" contains the source files. "doc" contains the man pages, a skimpy user manual, and a draft paper. The "examples" directory contains a number of good programs that show how Tm works. The "wtour" directory contains a widget-tour program based on Andrew Payne's wtour program for Tk. The "tests" directory contains the regression test files for Tm. These cover many features of Tm, but are not designed for easy reading. The file "index" in this directory shows what is tested. The "programs" directory contains adhoc programs used in developing Tm. These are in no particular order, not documented. You may see some useful examples in here, but it is pot-luck. At the top level, INSTALL tells you how to build Tm and moat, MOTIFBUGS explains why things aren't my fault and COPYRIGHT tells who owns it and why. CHANGES documents what has happened between versions.