Path: news.eternal-september.org!eternal-september.org!feeder3.eternal-september.org!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 1.1
Date: Tue, 10 Jun 2025 16:17:21 +0200
Message-ID: <1029eph$k8ua$3@tota-refugium.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Injection-Date: Tue, 10 Jun 2025 14:17:21 -0000 (UTC)
Injection-Info: tota-refugium.de;
	logging-data="664522"; mail-complaints-to="abuse@news.tota-refugium.de"
User-Agent: Mozilla Thunderbird
Cancel-Lock: sha1:imBzSJzmJFu74ENPtsuAOnu3KlM=
X-User-ID: eJwNysERACEIA8CWwAB3lhPC2H8J+tvHJspLX1RW5MnzQLY5B1KYQw3wDR3GP0hwVKt3r+J2uyhREWo=
Content-Language: en-US

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

What is new in Tsw 1.1?
-----------------------

1. For compatibility with the (ttk::)checkbutton, toggling the widget's
    switch state by changing the value of the variable specified by the
    "-variable" option will no longer cause the script specified by the
    "-command" option to get executed.

2. For further compatibility with the (ttk::)checkbutton, invoking the
    "switchstate" subcommand with the optional argument now has no effect
    if the widget's "disabled" state flag is set.

3. Several further improvements in the code and the demo script
    "EditingOpts.tcl".

4. Extended the reference manual by a section about choosing between
    toggleswitch and (ttk::)checkbutton widgets.

5. Improved the documentation by extending the CSS stylesheet used in
    the HTML files.

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

Tsw is available for free download from the Web page

     https://www.nemethi.de

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

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.1.tar.gz":

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

On most UNIX systems this can be replaced with

     tar -zxf tsw1.1.tar.gz

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

On Windows, use WinZip or some other program capable of unpacking the
distribution file "tsw1_1.zip" into the directory "tsw1.1", 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