Path: ...!weretis.net!feeder8.news.weretis.net!reader5.news.weretis.net!news.tota-refugium.de!.POSTED!not-for-mail
From: nemethi <csaba.nemethi@t-online.de>
Newsgroups: comp.lang.tcl
Subject: ANNOUNCE: Toggle switch widget package Tsw
Date: Mon, 24 Mar 2025 11:15:47 +0100
Message-ID: <vrrbcj$apra$1@tota-refugium.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Injection-Date: Mon, 24 Mar 2025 10:15:47 -0000 (UTC)
Injection-Info: tota-refugium.de;
	logging-data="354154"; mail-complaints-to="abuse@news.tota-refugium.de"
User-Agent: Mozilla Thunderbird
Cancel-Lock: sha1:1/Wg6w0Jv8DdkfOcx1MtCGwEjzs=
X-User-ID: eJwNx8EBwCAIA8CVihCEcQzC/iPY+x3UxWubww2DsUM6V+HIZfPaztZgJgv9aU+NStrfiIGuBz5fEfo=
Content-Language: en-US
Bytes: 3754
Lines: 84

I am pleased to announce version 1.0 of the toggle switch widget package 
Tsw.

What is Tsw?
------------

Tsw is a library package for Tcl/Tk versions 8.6 or higher.  If the
version is 8.6 then in addition it is required that the tksvg extension
can be loaded into the interpreter (Tk versions 8.7 and 9.0 or higher
have built-in SVG support).  The package is written in pure Tcl/Tk code
and contains:

   - the implementation of the "toggleswitch" mega-widget, including a
     general utility module for mega-widgets;
   - two richly commented demo scripts containing the typical steps
     needed to create and handle toggleswitch widgets;
   - a tutorial in HTML format;
   - a reference page in HTML format.

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

Tsw is available for free download from the Web page

     https://www.nemethi.de

The distribution file is "tsw1.0.tar.gz" for UNIX and "tsw1_0.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.

Tsw is also included in tklib, which has the address

     https://core.tcl.tk/tklib

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
subdirectory of the "lib" directory within your Tcl/Tk installation (at
the same level as the tk8.X or tk9.X subdirectory).

To install Tsw on UNIX, "cd" to the desired directory and unpack the
distribution file "tsw1.0.tar.gz":

     gunzip -c tsw1.0.tar.gz | tar -xf -

On most UNIX systems this can be replaced with

     tar -zxf tsw1.0.tar.gz

Both commands will create a directory named "tsw1.0", with the
subdirectories "demos", "doc", and "scripts".

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

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

To be able to access the commands and variables of the Tsw package, your
scripts must contain one of the lines

     package require tsw ?version?
     package require Tsw ?version?

Since the Tsw package is implemented in its own namespace called "tsw",
you must either invoke the

     namespace import tsw::toggleswitch

command to import the only public procedure of the tsw namespace, or use
the qualified name tsw::toggleswitch.  To access Tsw variables, you must
use qualified names.

For a detailed description of the commands and variables provided by Tsw
and of the examples contained in the "demos" directory, see the tutorial
"tsw.html" and the reference page "toggleswitch.html", both located in
the "doc" directory.

-- 
Csaba Nemethi  https://www.nemethi.de  mailto:csaba.nemethi@t-online.de