INSTALLATION OF THE TURNDIAL WIDGET
===================================

TKTURNDIAL README
=================

Version 2.0

(c) 1996, Pierre-Louis Bossart (bossart@redhook.llnl.gov)

Based on the tkTurndial-1.8 copyrighted as follows
(c) 1995, Marco Beijersbergen (beijersb@rulhm1.leidenuniv.nl)

See the file "license.terms" for information on usage and redistribution,
and for a DISCLAIMER OF ALL WARRANTIES.

This package is an extension to the Tcl/Tk package, versions 7.4/4.0 and
7.5/4.1

To install the turndial widget:

* Copy the makefile of the version you want to make, either Makefile.tk4.0
  or Makefile.tk4.1, to Makefile.
 
* Edit the Makefile

* Do
	make

* As root, do

	make install

Now you have installed a library libtkTurndial4.0.a 
You can test it with the Tcl/Tk interpreter that has been made by the make
process, td_wish. Run turndial_test for an example. Run turndial_scale_test
to see how the scale and turndial widget work.


REFERENCE
=========

The general procedure to install a new widget:

* Compile the extensions to .o object files. There should be an <extension>_Init
  command that adds the new commands in the extension to the interpreter;
  see turndialInit.c. Gather the .o files in a library.

* For each extension, add a prototype to tkAppInit.c:

    extern int Turndial_Init _ANSI_ARGS_((Tcl_Interp *interp));

  or include the proper header file, and add a call to the initialization
  routine:

    if (Turndial_Init(interp) == TCL_ERROR) {
	return TCL_ERROR;
    }

* Compile and link with the extensions objects or libraries,
  libtk4.0, libtcl7.4, libX11 and libm, resulting in a new wish:

	cc -o wish tkAppInit.c <extensionlib> \
		libtk4.0.a libtcl7.4.a -lX11 -lm

* Add binding commands to tk.tcl (see tk.tcl.add) and tcl indices to tclIndex
  (see tclIndex.add) in the tk library directory, and copy <extension>.tcl
  to that directory.


The Makefile follows this procedure, producing the library libtkTurndial2.0.a.

