From: Csaba Nemethi on
This is to announce version 5.1 of the multi-column listbox and tree
widget package Tablelist.

What is new in Tablelist 5.1?
-----------------------------

This is a bugfix-only release. The corrected files in the "scripts"
directory are "tablelistBind.tcl", "tablelistSort.tcl",
"tablelistUtil.tcl", and "tablelistWidget.tcl".

1. Fixed a bug related to item deletion, introduced in the previous
Tablelist version (thanks to Aric Bills and Roger Niva for their bug
reports).

2. Fixed a bug related to multi-column sorting, introduced in the
previous Tablelist version (thanks to Albrecht Mucha for his bug
report).

3. Fixed a long-standing bug related to column deletion (thanks to
Liang Sian Yin for his bug report).

4. Fixed a few further minor bugs and typos, introduced in the previous
Tablelist version (thanks to Patrick Fradin, Roger Niva, Harald
Oehlmann, and Peter Spjuth for their bug reports).

How to get it?
--------------

Tablelist is available for free download from the URL

http://www.nemethi.de

The distribution file is "tablelist5.1.tar.gz" for UNIX and
"tablelist5_1.zip" for Windows. These files contain the same
information, except for the additional carriage return character
preceding the linefeed at the end of each line in the text files for
Windows.

Tablelist is also hosted on SourceForge, as part of tklib, which in
turn is contained in the tcllib project, having the address

http://sourceforge.net/projects/tcllib

How to install it?
------------------

Install the package as a subdirectory of one of the directories given
by the "auto_path" variable. For example, you can install it as a
directory at the same level as the Tcl and Tk script libraries. The
locations of these library directories are given by the "tcl_library"
and "tk_library" variables, respectively.

To install Tablelist on UNIX, "cd" to the desired directory and unpack
the distribution file "tablelist5.1.tar.gz":

gunzip -c tablelist5.1.tar.gz | tar -xf -

This command will create a directory named "tablelist5.1", with the
subdirectories "demos", "doc", and "scripts".

On Windows, use WinZip or some other program capable of unpacking the
distribution file "tablelist5_1.zip" into the directory "tablelist5.1",
with the subdirectories "demos", "doc", and "scripts".

Next, you should check the exact version number of your Tcl/Tk
distribution, given by the "tcl_patchLevel" and "tk_patchLevel"
variables. If you are using Tcl/Tk version 8.2.X, 8.3.0 - 8.3.2, or
8.4a1, then you should proceed as described in the "How to install it?"
section of the file "tablelist.html", located in the "doc" directory.

How to use it?
--------------

The Tablelist distribution provides two packages, called Tablelist and
Tablelist_tile. The main difference between the two is that
Tablelist_tile enables the tile-based, theme-specific appearance of
tablelist widgets; this package requires Tcl/Tk 8.4 or higher and tile
0.6 or higher. It is not possible to use both packages in one and the
same application, because both are implemented in the same "tablelist"
namespace and provide identical commands.

To be able to use the commands and variables implemented in the package
Tablelist, your scripts must contain one of the lines

package require tablelist ?version?
package require Tablelist ?version?

Likewise, to be able to use the commands and variables implemented in
the package Tablelist_tile, your scripts must contain one of the lines

package require tablelist_tile ?version?
package require Tablelist_tile ?version?

Since the packages Tablelist and Tablelist_tile are implemented in the
"tablelist" namespace, you must either import the procedures you need,
or use qualified names like "tablelist::tablelist".

For a detailed description of the commands and variables provided by
Tablelist and of the examples contained in the "demos" directory, see
the tutorial "tablelist.html" and the reference pages, all located in
the "doc" directory.

--
Csaba Nemethi http://www.nemethi.de mailto:csaba.nemethi(a)t-online.de