README for ivtools 0.6


This directory contains a release of the ivtools 0.6.2 from Vectaport
Inc..  You should read the rest of this file for information on what
ivtools is and the INSTALL file for instructions on how to build it.
It is known to build with many versions of gcc (2.6.3, 2.7.2, 2.7.2.1)
and on a variety of Unix'es: SunOS 4.1 (MIT's X11R5), Solaris 5.2
(X11R6), Irix 5.2 (SGI's X11R5), Linux 1.2 (Slackware 3.0, XFree86
3.1) and Linux 2.0 (RedHat 4.0 and 4.1).  There is also a contributed
config for HPUX. You can pick up ELF binaries for Linux from the
ivtools web page (http://www.vectaport.com/ivtools/).

The overall copyright and permission notice for ivtools can be found
in the COPYRIGHT file in this directory.  If you have a question about
this software, desire to contribute code, found a bug, or wonder how
to get further assistance, please send e-mail to info@vectaport.com.

* What is ivtools?:

ivtools is a framework for building custom drawing editors and
servers.  It is a collection of C++ libraries and example programs
that incorporates and evolves the last source tree for InterViews 3.1
published by Stanford University and Silicon Graphics (3.2a.tar.Z).

ivtools comprises four sets of interrelated capabilities useful for
application programmers.  The first set is the libraries and example
programs we borrowed whole from InterViews 3.1.  The second set is for
reusing and extending the light-weight glyph objects of InterViews
3.1.  The third set reuses and extends the Unidraw library (Unidraw is
a major portion of the overall InterViews 3.1 release that provides an
application framework for custom drawing editors).  The fourth set
adds a command interpreter and server mechanism to ivtools, and
demonstrates these capabilities with text, glyph, and graphic
front-ends.

These are the libraries and example programs borrowed straight from
InterViews 3.1:

	IV		library of InterView 3.1, InterViews 2.6, Dispatch,
			OS, and TIFF objects
	dclock		digital clock with fading digits
	iclass		C++ class browser
	idemo		glyph demo 

These are the libraries and example programs that make up the glyph
part of ivtools (programs in the glyphs directory):

	IVGlyph		library of Glyph derived classes

	bdvtable        bounded-value editing 
	formdemo	value-editing 
	gclock		glyph-based clock
	meter           sliding meter
	radiogroup      radio-buttons
	scrollable	2d scrollable glyph
	scrollfield	2d scrollable field-editor
	strchooser	string chooser 
	text-editor     emacs-like text editor 
	timestamp	editable time glyph

These are the libraries and example programs that make up the Unidraw
part of ivtools:

	Unidraw		copy of Unidraw library from InterViews 3.1
	UniIdraw        librarification of 3.1 idraw 
	OverlayUnidraw  extended Unidraw framework
	TopoFace	spatial network library (nodes, edges, faces)
	GraphUnidraw    graph browser/editor library
	FrameUnidraw    multi-frame display mechanism

	idraw		idraw built on UniIdraw library
	drawtool        extended version of idraw built on OverlayUnidraw
	graphdraw       graph browser/editor integrated with drawtool
	flipbook        flipbook multi-frame editor based on drawtool

These are the libraries that make up the command interpreter part of
ivtools:

	ComUtil		command interpreter utility functions
	Attribute	attribute property list mechanism
	AttrGlyph	glyphs for Attribute library
	ComTerp		command interpreter objects
	ComGlyph	glyphs for ComTerp library	
	ComUnidraw      command interpreter augmentation
	DrawServ        drawing server framework

	comtest		test program
	comterp 	sample command interpreter 
	glyphterp	command interpreter user interface
	comdraw		drawtool with command interpreter
	drawserv        comdraw with graphs

There is also a Time library with Date and Time classes borrowed from
the NIH's class library.
	
A series of makefile targets support the checkin of sources to
cvs/rcs, and their subsequent update and modification.  This requires
cvs (at least 1.3) available from the Free Software Foundation and
ivmkcm-0.7.1 available through http://www.vectaport.com/ivmkcm/

* Acknowledgements:

ivtools programmers at Vectaport:

	Scott Johnston (johnston at vectaport.com)
	Jorge Gautier (jgautier at vectaport.com)

ivtools programmers at large:

	Brian Hogencamp (brian at ciderpress.com)
	Rick Kissh (rkissh at access.digex.net)

InterViews 3.1 programmers that we know of:

	Mark Linton
	John Vlissides
	Paul Calder
	John Interrante
	Steven Tang
	
First brought up on HPUX (HP-800) by Neal Becker (neal at ctd.comsat.com).

Patches for Debian 2.0 packaging incorporated from Guenter Geiger
(geiger at iem.mhsg.ac.at).

Patch for iv-3.1 shift key handling from 

The InterViews libraries (Dispatch, IV, IV-2_6, IV-X11, InterViews,
OS, TIFF) and example programs (iclass, idemo, idraw) are copied from
the InterViews 3.1 sources.  Here is the aggregrate copyright notice
for that software package:

/*
 * Copyright (c) 1987, 1988, 1989, 1990, 1991 Stanford University
 * Copyright (c) 1991 Silicon Graphics, Inc.
 * 
 * Permission to use, copy, modify, distribute, and sell this software and 
 * its documentation for any purpose is hereby granted without fee, provided
 * that (i) the above copyright notices and this permission notice appear in
 * all copies of the software and related documentation, and (ii) the names of
 * Stanford and Silicon Graphics may not be used in any advertising or
 * publicity relating to the software without the specific, prior written
 * permission of Stanford and Silicon Graphics.
 * 
 * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
 * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
 * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
 * 
 * IN NO EVENT SHALL STANFORD OR SILICON GRAPHICS BE LIABLE FOR
 * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
 * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
 * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
 * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
 * OF THIS SOFTWARE.
 */

The building of iv-3.1 with gcc-2.5.* (and subsequent versions)
was enabled by a patch from Adam Zell.

The TIFF library was written by Sam Leffler and published with this
copyright and permission notice:

/*
 * Copyright (c) 1991, 1992 Sam Leffler
 * Copyright (c) 1991, 1992 Silicon Graphics, Inc.
 *
 * Permission to use, copy, modify, distribute, and sell this software and 
 * its documentation for any purpose is hereby granted without fee, provided
 * that (i) the above copyright notices and this permission notice appear in
 * all copies of the software and related documentation, and (ii) the names of
 * Sam Leffler and Silicon Graphics may not be used in any advertising or
 * publicity relating to the software without the specific, prior written
 * permission of Sam Leffler and Silicon Graphics.
 * 
 * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
 * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
 * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
 * 
 * IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
 * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
 * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
 * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
 * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
 * OF THIS SOFTWARE.
 */

The strchooser example and StrChooser class were contributed by David
B. Hollenbeck (dave at fremenworks.org), as well as the
glyph-based Motif-look pull-down menus of OverlayUnidraw.  Here is his
copyright notice:

/*
 * Copyright (c) 1993 David B. Hollenbeck
 *
 * Permission to use, copy, modify, distribute, and sell this software and 
 * its documentation for any purpose is hereby granted without fee, provided
 * that (i) the above copyright notice and this permission notice appear in
 * all copies of the software and related documentation, and (ii) the name of
 * David B. Hollenbeck may not be used in any advertising or
 * publicity relating to the software without the specific, prior written
 * permission of David B. Hollenbeck.
 * 
 * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
 * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
 * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
 *
 * IN NO EVENT SHALL DAVID B. HOLLENBECK BE LIABLE FOR
 * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
 * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
 * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
 * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
 * OF THIS SOFTWARE.
 */

The scrollable example is based on code from Chen Wang
(chen at cs.toronto.edu).

The text-editor example program is by Jan Andersson of Torpa Konsult
AB (janne at torpa.se).  Here is that copyright notice:

//
// Simple Text Editor
//
//
// Copyright (C) 1993 Ellemtel Telecommunication Systems Labratories
//
// Permission is granted to any individual or institution to use, copy,
// modify, and distribute this software, provided that this complete
// copyright and permission notice is maintained, intact, in all copies
// and supporting documentation.
//
// Ellemtel Telecommunication Systems Labratories make no representation
// of the suitability of this software for any purpose. It is provided
// "as is" without any expressed or implied warranty.
//
// Jan Andersson, Torpa Konsult AB
// janne at torpa.se - 1993-08-29

The Date and Time classes in the Time library are borrowed from the
NIHCL class library, written by K. E. Gorlen, Computer Sciences
Laboratory, DCRT, National Institutes of Health, Bethesda, MD 20892,
and published with this notice:

     THIS SOFTWARE FITS THE DESCRIPTION IN THE U.S. COPYRIGHT ACT OF A
     "UNITED STATES GOVERNMENT WORK".  IT WAS WRITTEN AS A PART OF THE
     AUTHOR'S OFFICIAL DUTIES AS A GOVERNMENT EMPLOYEE.  THIS MEANS IT
     CANNOT BE COPYRIGHTED.  THIS SOFTWARE IS FREELY AVAILABLE TO THE
     PUBLIC FOR USE WITHOUT A COPYRIGHT NOTICE, AND THERE ARE NO
     RESTRICTIONS ON ITS USE, NOW OR SUBSEQUENTLY.

The ComUtil library was originally developed at Triple Vision
Inc. under NSF Grant ISI-8521259 (authors/contributors: Robert
C. Fitch, Richard A. Fundakowski, Robert K. Graber, Scott
E. Johnston).

ivtools has been developed with partial support from IET Inc.  (P.O.
Box 112450, Campbell, CA 95011) in the form of an ARPA subcontract
(Prime Contract Number DACA76-93-C-0025) to Vectaport Systems
Inc. (P.O. Box 471801, San Francisco, CA 94147).

ivtools has also been developed with partial support from Applied
Sciences Inc, San Francisco, CA, in the form of a subcontract for a
NASA Phase II SBIR.