ANNOUNCE: hush-1.0

Hush -- the C++ API for Tcl/Tk

Author and copyright:

  A. Eliens (Vrije Universiteit, Amsterdam)

License:

Contact the author

Email:

  eliens@cs.vu.nl

Available via ftp at

  ftp.cs.vu.nl      (130.37.24.6)

      eliens/hush-1.0.tar.Z          -- API src
      eliens/hush-contrib-1.0.tar.Z  -- contrib src

Requires:

      Tcl/Tk 7.0, 3.4

      (with TkPixmap extensions [optional])

Contributers:

       Many of the common packages, such as blt, graph, expect, steal
       etc. are used and collected in hush-contrib-1.0

Compiler:

	The code has been developed with AT&T 3.0.1
	and has subsequently been tested with g++ v2.4

Acknowledgements:

       To the developer of Tcl/Tk, and all its contributers ...

Description -- (abstract)
	
Hush -- the C++ API for Tcl/Tk

This document describes the C++ programmer interface to \fIhush\fP,
the \fIhyper utility shell\fP based on Tcl/Tk.
Tcl is a scripting language that may be embedded in C or C++.
Tk is a window and graphics toolkit based on X11.
The \fIhush\fP library contains classes that provide
convenient yet flexible access to the functionality
offered by the underlying toolkit.
The libary is intended to support the needs of both novice 
and experienced (window) programmers.
It offers widget and graphics classes with a simple interface,
but allows more experienced programmers also to
employ the Tcl scripting language to define the behavior
and functionality of widget and structured graphics objects.
The design of $hush$ has been inspired by the InterViews
library.
However, both the use of event callbacks and the functional
interface of widget and graphics classes is significantly
simpler.
An important advantage of basing \fIhush\fP on the Tk toolkit
is that existing Tk applications written for the Tk interpreter \fIwish\fP
can easily be (re)used
in a C++ context, virtually without any costs.
On the other hand programs employing \fIhush\fP may
again be used as (an enhanced version of)
the \fIwish\fP interpreter, allowing the functionality
defined in the program to be used in a (\fIhush\fP) script.

See src/doc/hush-api.ps


Installation: hush-1.0

Beware 
	hush-1.0 unpacks into  src
	hush-contrib-1.0 unpacks into  contrib

You need to make a directory, say hush in which
to unpack the *.Z files.

Installing src:

Directories:

	src/doc -- see hush-api.ps
	src/api -- the C++ interface implementation
	src/hush -- the code for the extended wish interpreter
	src/hclsh -- the same as hush, but without windows
	src/library -- tcl scripts
	src/examples -- C++ examples


To install the hush package, in principle
you need only to adapt the file

  install.mk

for setting the right paths.

Further you need to modify

  api/hush/version.h

to set the address for the hush initialization file.
If you do not have the graph and/or photo extension
to Tcl/Tk then you must undefine HUSHWIDGETS.
Alternatively you may modify api/hush-startup.c.

You might check the resource.mk files in api, demo and examples
to see if the right compiler options are set.

Each program compiled with hush reads in an installation script.
The default installation script is determined in api/hush/version.h.
It reads library/init.tcl.
You must adapt the tcl variable hush_library in hush/init.tcl
to the installation directory.

If you do not have the packages from hush-contrib
then comment out the init's in hush/hush.c and hclsh/hclsh.c.

For compilation with GNU g++ change the setting of
CC in src/resource.mk to g++ -DGCC, as indicated. 

Now, 

make all
make install

should do the job.

Installing contrib:

Modify the resource.mk file to set the appropriate
paths for the tcl/tk distribution and the hush package.

If you have any questions contact me at

   eliens@cs.vu.nl

Anton Eliens