1README: tktray 2 This is the tktray source distribution. 3 Current (official) location for tktray is 4 http://code.google.com/p/tktray 5 6Tktray is a binary extension for Tcl/Tk, and it requires Tcl/Tk 7development headers in build time. Supported versions of Tcl/Tk (taken 8as a whole) are 8.4.*, 8.5.*, 8.6.*. 9 10Tktray shared library built against any one of these versions will 11work on other versions from this set, both older and newer. 12 13 14BUILD-TIME REQUIREMENTS 15 16Tcl and Tk (both 8.4 or later) public headers and development 17libraries are absolutely needed to build tktray. If it's possible to 18build some other Tk 8.4+ extension on your system, tktray will 19probably build as well. 20 21For GNU/Linux distributions using RPM packages, look for tcl*devel*.rpm, 22tk*devel*rpm; for Debian-based distributions using deb packages, 23look for tcl8.*-dev*deb and tk8.*-dev*deb. 24 25Any decent development packages for Tcl and Tk should contain 26tclConfig.sh and tkConfig.sh respectively, located somewhere around 27/usr/lib: either in /usr/lib directly or in /usr/lib/tcl8.x, 28/usr/lib/tk8.x (the latter is the standard result of maintainers' 29effort to allow several minor versions of Tcl and Tk to coexist). 30 31===================================================================== 32For Debian system shipping with tcl/tk 8.4, the following commands 33will do: 34 35sudo aptitude install tk8.4-dev 36 37(then, in tktray directory) 38./configure --with-tcl=/usr/lib/tcl8.4 --with-tk=/usr/lib/tk8.4 39make 40 41(to test a fresh build; it's not strictly a test, but a small demo) 42make test 43 44(to install locally - don't do it, use checkinstall at least) 45make install 46===================================================================== 47 48In a couple of places tktray uses functions provided only in tk 49PRIVATE headers, that may not be available (or may be incomplete) in 50some distributions. There is no such problem in debian, but someone 51runned into it under Alt Linux. 52 53For these distributions, ./configure script of tktray has a special 54parameter, --with-mad-tk-packager. With this parameter, tktray is 55configured not to use private headers at the cost of some runtime 56overhead during icon creation and docking. Some pieces of code that 57will be used when it's turned on are just plain ugly. 58 59 60RUN-TIME REQUIREMENTS 61 62After the package is built and installed, it will be available for 63scripts using tk 8.4, 8.5 and 8.6. 64 65See manpage or html page (included in source archive) for usage 66instructions. 67 68Current version of tktray was tested and proved to work with the 69following system tray implementations: 70 71* lxpanel-0.5.5 from LXDE project; 72* gnome-panel 2.30 from Gnome project; 73* stalonetray 0.8.0; 74* trayer 1.0; 75* docker 1.4. 76