
This directory contains a collection of programs to demonstrate
the features of the Tk toolkit.  The programs are all scripts for
Perl 5 with the "Tk" extension.  If Perl has been installed in
/usr/local/bin then you can invoke any of the programs in this
directory just by typing its file name to your command shell.  In
particular, try the `widget' program.


Stephen O. Lidie, lusol@Lehigh.EDU.  95/01/16
------------------------------------------------------------------------------

Stephen has done a lot of excellent work in converting the TCL/TK
demos to perl/Tk, and this suite demonstrates that majority of 
Tcl/Tk code can be converted to perl. However to make translation 
easier, and because I keep changing the interface under him, the 
style code in this demo's directory does not yet make full use 
of Object Oriented features of Tk.  

  In particular winfo() and wm() sub-commands are now methods 
of Tk::Widget and Tk::Toplevel respectively, so one can say :

$w->iconname(Scale)   rather than  $w->wm('iconname' => 'Scale')

Menubuttons will also automatically create their Menu objects and
you can say $mb->command(....)  rather than 

$menu = $mb->cget(MENU);
$menu->add('command',...);

One of the main things I would like to get out of the 'beta' stage
of Tk is which additional "convenience" methods like this should
be provided.

Nick Ing-Simmons, nik@tiuk.ti.com. 95/01/25
------------------------------------------------------------------------------

SOL, 95/02/07
	Hopefully, all the `wm', `winfo' and 'Menubutton' code has been
	cleaned up as noted above.
------------------------------------------------------------------------------

The rest of this file contains a brief description of each program.

browse -	A simple directory browser.  Invoke it with an argument
		giving the name of the directory you'd like to browse.
		Double-click on files or subdirectories to browse them.
		Control-c and control-q cause the program to exit.

ce -            Simple ColorEditor object example program.

hello -		Creates a single button;  if you click on it, a message
		is typed and the application terminates.

ixset -		A simple Tk-based wrapper for the "xset" program, which
		allows you to interactively query and set various X options
		such as mouse acceleration and bell volume.  Thanks to
		Pierre David for contributing this example.

rmt -		Allows you to "hook-up" remotely to any Tk application
		on the display.  Select an application with the menu,
		then just type commands:  they'll go to that application.

rolodex -	A mock-up of a simple rolodex application.  It has much of
		the user interface for such an application but no back-end
		database.  This program was written in response to Tom
		LaStrange's toolkit benchmark challenge.

timer -		Displays a seconds timer with start and stop buttons.
		Control-c and control-q cause it to exit.

tkd -		Illustrates how to use TkDialog.

widget -	Contains a collection of demonstrations of the widgets
		currently available in the Tk library.  Most of the .pl
		files are scripts for individual demos available through
		the "widget" program (located in directory widget_lib).
