head	1.7;
access;
symbols
	iwidgets-4-0-1:1.6
	iwidgets-4-0-0:1.4
	iwidgets_overhaul:1.1.0.6
	iwidgets-2-2-0:1.1.1.1
	lucent:1.1.1
	tclpro-1-5-0:1.1
	tclpro-1-4-1:1.1
	tclpro-1-4-0:1.1
	itcl-3-2-0:1.1
	ajuba-ajuba2-2-0:1.1
	scriptics-sc-2-0-b5:1.1
	scriptics-sc-2-0-fixed:1.1
	scriptics-sc-2-0-b2:1.1
	scriptics-sc-2-0-b1:1.1
	scriptics-sc-1-1:1.1
	scriptics-sc-1-1-b1:1.1
	scriptics-sc-1-1-branch:1.1.0.4
	scriptics-sc-1-1-base:1.1
	scriptics-sc-1-0:1.1
	scriptics-sc-1-0-branch:1.1.0.2
	scriptics-sc-1-0-base:1.1
	scriptics-bc-1-0-b1:1.1
	scriptics-tclpro-1-3-0:1.1
	scriptics-tclpro-1-3-b4:1.1
	itcl-3-1-0:1.1
	scriptics-tclpro-1-3-b3:1.1
	scriptics-tclpro-1-2:1.1
	scriptics-tclpro-1-2-b2:1.1
	scriptics-tclpro-1-2-b1:1.1
	scriptics-tclpro-1-2-a1:1.1
	itcl-3-0-1:1.1
	itcl3-0-1:1.1
	stanton:1.1;
locks; strict;
comment	@# @;


1.7
date	2002.09.17.07.10.50;	author mgbacke;	state Exp;
branches;
next	1.6;

1.6
date	2002.09.13.18.39.48;	author smithc;	state Exp;
branches;
next	1.5;

1.5
date	2001.11.29.20.51.34;	author smithc;	state Exp;
branches;
next	1.4;

1.4
date	2001.09.10.19.04.04;	author smithc;	state Exp;
branches;
next	1.3;

1.3
date	2001.09.10.18.48.13;	author smithc;	state Exp;
branches;
next	1.2;

1.2
date	2001.08.07.19.56.47;	author smithc;	state Exp;
branches;
next	1.1;

1.1
date	98.07.27.18.50.14;	author stanton;	state Exp;
branches
	1.1.1.1
	1.1.6.1;
next	;

1.1.1.1
date	2001.04.25.04.01.12;	author davygrvy;	state Exp;
branches;
next	;

1.1.6.1
date	2001.08.07.19.18.25;	author smithc;	state Exp;
branches;
next	;


desc
@@


1.7
log
@Prep for Iwidgets 4.0.2 release
@
text
@------------------------------------------------------------------------------
                    [incr Widgets] - version 4.0.2
------------------------------------------------------------------------------
Please send general comments, suggestions, and questions to chad_smith@@adc.com
or itclguy@@yahoo.com.  Much of this file was written by Mark Ulferts, the
original [incr Widgets] guy, several years ago when the Iwidgets were first
released.  Chad has assumed responsibilities for updates and maintenance.

==============================================================================
           Copyright (c) 1995   DSC Technologies Corporation
==============================================================================
 This software is copyrighted by DSC Technologies and private individual 
 contributors.  The copyright holder is specifically listed in the header 
 of each file.  The following terms apply to all files associated with the
 software unless explicitly disclaimed in individual files by private
 contributors.
  
 Permission to use, copy, modify, distribute and license this software and 
 its documentation for any purpose, and without fee or written agreement 
 with DSC, is hereby granted, provided that the above copyright notice 
 appears in all copies and that both the copyright notice and warranty 
 disclaimer below appear in supporting documentation, and that the names of
 DSC Technologies Corporation or DSC Communications Corporation not be used 
 in advertising or publicity pertaining to the software without specific, 
 written prior permission.
  
 DSC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, AND NON-INFRINGEMENT.
 THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND 
 DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,
 ENHANCEMENTS, OR MODIFICATIONS. IN NO EVENT SHALL DSC BE LIABLE FOR ANY
 SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
 RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
 CONTRACT, NEGLIGENCE OR OTHER TORTUOUS ACTION, ARISING OUT OF OR IN
 CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  
 RESTRICTED RIGHTS: Use, duplication or disclosure by the government
 is subject to the restrictions as set forth in subparagraph (c) (1) (ii)
 of the Rights in Technical Data and Computer Software Clause as DFARS
 252.227-7013 and FAR 52.227-19.
==============================================================================

 OVERVIEW
------------------------------------------------------------------------------
 - Introduction
 - Distribution
 - Web site
 - Getting started
 - Contributions
 - Acknowledgements
------------------------------------------------------------------------------


 Introduction
------------------------------------------------------------------------------
 [incr Widgets] is an object-oriented mega-widget set which extends 
 Tcl/Tk and is based on [incr Tcl] and [incr Tk].  This set of mega-widgets
 delivers many new, general purpose widgets like option menus, comboboxes, 
 selection boxes, and various dialogs whose couterparts are found in Motif 
 and Windows. Since [incr Widgets] is based on the [incr Tk] extension, the 
 Tk framework of configuration options, widget commands, and default bindings
 is maintained.  In other words, each [incr Widgets] mega-widget seamlessly 
 blends with the standard Tk widgets. They look, act and feel like Tk 
 widgets. In addition, all [incr Widgets] mega-widgets are object oriented and 
 may themselves be extended, using either inheritance or composition.

 [incr Widgets] offers a strong object-oriented foundation which addresses 
 the need for a flexible and extensible mega-widget set. Its usage replaces 
 common widget combinations with higher level abstractions, simplifying code,
 reducing errors, increasing readability, adding productivity, and promoting 
 a singular look-and-feel.  The ability to extend [incr Widgets] enables 
 developers to create new mega-widgets based on previous work.

 In short, [incr Widgets] is a library of reusable mega-widgets that can 
 be easily extended using composition or inheritance, allowing quicker 
 development of large scale applications. Usage drastically reduces 
 development time. New dialogs can be created in hours. Whole applications 
 in a few days. Reuse becomes a reality. Many projects are benefitting frm
 the intergration of this mega-widget set into their development strategy. 
 [incr Widgets] is an [incr Tcl] and [incr Tk] success story. Good products 
 come from good foundations.


 Distribution
------------------------------------------------------------------------------
 The [incr Widgets] distribution may be downloaded at SourceForge:
 www.sourceforge.net/projects/incrtcl.  The current distribution is
 version 4.0.2.


 Web site
------------------------------------------------------------------------------
 For the most current news regarding [incr Widgets] please consult the web
 site - http://incrtcl.sourceforge.net/iwidgets.  Many thanks to Brett Schwarz
 who has done an incredible job overhauling this site.  Take a look!
  

 Getting started
------------------------------------------------------------------------------
 The "doc" directory contains man pages and a technical paper. The man
 pages are installed under the man directory off your --prefix, and as of
 version 4.0.1 are prepended with the text "iwidgets_" to easily differentiate
 [incr Widgets] man pages from those of other extensions.

   doc/iwidgets.ps ... Updated paper presented at Tcl Workshop 95.

   doc/*.n ........... Man pages

 The "demos" directory contains demo scripts for each mega-widget as
 well as html versions of all the [incr Widgets] man pages.  The
 demos are also installed under the lib directory off your --prefix.

   demos/catalog ..... Comprehensive demo package which illustrates
                       [incr Widgets] usage additionally displaying the 
                       source.

   demos/html    ..... HTML version of the [incr Widgets] man pages.

 The "tests" directory contains a set of test scripts for [incr Widgets].
 They also make for a great demo of the flexiblity of the mega-widgets.


 Installation
------------------------------------------------------------------------------
  NOTE: Having the itcl distribution is a prerequsite to using iwidgets.
  Thus, if you don't have itcl you need to visit Source Forge to download
  and install it first.  Once you have downloaded and installed [incr Tcl]
  and [incr Tk], you can proceed with [incr Widgets] installation as follows:

  1)  Copy the iwidgets4.0.2.tar.gz file to your toplevel [incr Tcl]
      directory.  For example, if you have the itcl3.2.1 distribution in
      a directory named /usr/local/tcl/itcl3.2.1, then you should copy
      the iwidgets file to this directory.

      Note, if you don't copy the iwidgets archive to this directory,
      then you will need to specify the --with-itcl flag when you run
      the configure script.

  2)  Untar/unzip the archive:

	gunzip -c iwidgets4.0.2.tar.gz |tar xvf -

  3)  Run the configuration script:

        cd iwidgets4.0.0
        ./configure

      By default, the configuration script will set things up to be
      installed in "/usr/local".  You can change this by specifying a
      different "prefix" in the "configure" command.  You'll want to
      use the same value you used for the prefix in the configuration
      of your [incr Tcl/Tk] distribution.

        ./configure --prefix=/your/install/path

      The "configure" script generates a Makefile from the Makefile.in
      template.

      Also, as mentioned eariler, you may need to tell the [incr Widgets]
      where the [incr Tcl] source is located.  For example, if your toplevel
      [incr Tcl] directory is located in /opt/tools/tcl/itcl3.2.1 and you
      are building the [incr Widgets] in a directory other than this, then
      you will need to use the following:

	./configure --prefix=/your/install/path \
	  --with-itcl=/opt/tools/tcl/itcl3.2.1

  4)  Run the test suite:

        make test

  7)  Install the [incr Widgets] man pages, demos, and script files.

        make install


 Acknowledgements
------------------------------------------------------------------------------
 Thanks to Brett Schwarz for a ton of work done on the new [incr Widgets]
 web site, http://incrtcl.sourceforge.net/iwidgets.

 Thanks to the original develment team, comprised of Mark Ulferts, Sue 
 Yockey, Bret Schuhmacher, Alfredo Jahn, John Sigler, and Bill Scott.  Also 
 thanks to Mark Harrison for his influence, confidence, and ideas.

 Thanks also to the new set of contributors which include John Tucker,
 Mitch Gorman, John Reekie, Alfredo Jahn, Ken Copeland, Tako Schotanus,
 Tony Parent and Michael McLennan

 Thanks to Michael McLennan, creator of [incr Tcl] and [incr Tk], for the 
 beta copies, training, assistance, and his infectious enthusiasm.

 Thanks to DSC Communications for picking up the copyright and supporting
 the public release of this software.

 Thanks to John P. Davis for creating the [incr Widgets] "Flaming Toaster"
 logo which can be seen at http://www.tcltk.com/iwidgets

 Thanks to WebNet Technologies for their assistance is designing the [incr
 Widgets] web site, as well as hosting it.

 Special thanks to my wife Karen for supporting this effort and to our two 
 girls, Katelyn and Bailey, who occasionally shared the PC with me.  Also
 thanks to my Discman and its relentless power supply as well as my rock
 and roll CD collection.  No music, no software.

--
 ____________________________________________________________________________
    _/_/   _/_/    _/        _/    _/   Mark L. Ulferts
   _/ _/ _/ _/    _/        _/    _/    ulferts@@swbell.net
  _/  _/_/ _/    _/        _/    _/     mulferts@@austin.dsccc.com 
 _/   _/  _/ _/ _/_/_/ _/ _/_/_/_/ _/   DSC Communications Corp, Austin Texas
@


1.6
log
@Some updates for the 4.0.1 release.
@
text
@d2 1
a2 1
                    [incr Widgets] - version 4.0.1
d88 1
a88 1
 version 4.0.1.
d130 1
a130 1
  1)  Copy the iwidgets4.0.1.tar.gz file to your toplevel [incr Tcl]
d141 1
a141 1
	gunzip -c iwidgets4.0.1.tar.gz |tar xvf -
@


1.5
log
@Lots of cleanup to configure.in and Makefile.in templates.  Added patch by
Andreas Gustaffson for SF ticket #486735.  Updated ChangeLog and README.
@
text
@d5 3
a7 1
or itclguy@@yahoo.com.
d87 2
a88 4
 www.sourceforge.net/projects/incrtcl.  The current distribution (release
 4.0.0), is the first one in which the [incr Widgets] is a separate module.
 All previous releases of the [incr Widgets] were bundled with the [incr Tcl]
 distribution.
d94 2
a95 5
 set - http://www.tcltk.com/iwidgets.  The site contains a lot of good
 information such as tutotials, man pages, and examples.  Plus, I'm real
 proud of our new logo.  Also, catch our picture under the development
 team link.  Many thanks to the good people at Webnet Technologies for
 the excellent web production work.  Joe Bob says "Check it out !"
d101 3
a103 1
 pages are installed under the man directory off your --prefix.
d130 3
a132 3
  1)  Copy the iwidgets4.0.0.tar.gz file to your toplevel [incr Tcl]
      directory.  For example, if you have the itcl3.2.0 distribution in
      a directory named /usr/local/tcl/itcl3.2.0, then you should copy
d141 1
a141 1
	gunzip -c iwidgets4.0.0.tar.gz |tar xvf -
d148 5
a152 5
      By default, the configuration script will set things up
      to be installed in "/usr/local".  You can change this
      by specifying a different "prefix" in the "configure" command.
      You'll want to use the same value you used for the prefix in 
      the configuration of your itcl3.x distribution.
d159 9
d179 3
@


1.4
log
@Missed a few updates with last commit.
@
text
@d2 1
a2 1
                    [incr Widgets] - version 4.0.0
d4 2
a5 2
Please send general comments or suggestions to csmith@@adc.com or
itclguy@@yahoo.com.
d104 1
a104 4
 pages are installed under the man directory off your --prefix.  In
 addition, the makefile includes an install-html target for creating 
 a HTML version of the man pages.  They are placed under your prefixed
 doc directory.
d110 2
a111 1
 The "demos" directory contains demo scripts for each mega-widget.  The
d118 2
a121 2
 Once you've built your itkwish, try firing it up and sourcing "all" in
 the tests directory.
d137 2
a138 2
      then you will need to specify the --with-itcl and --with-itk flags
      when you run the configure script.
d157 2
a158 2
      The "configure" script generates new Makefiles from their
      respective templates (Makefile.in).
d164 1
a164 1
  7)  Install the iwidgets library, man pages and script files.
a166 24


 Contributions
------------------------------------------------------------------------------
 I feel that [incr Widgets] is a good start in the direction of establishing 
 a strong set of object-oriented mega-widgets, but I swear that everytime I 
 go back and look at the source I see an even better more simplier way 
 something could have been accomplished.  Should anybody within the Tcl/Tk 
 community come upon an even better way, a great enhancement, or an awesome 
 new mega-widget altogether, please don't hesitate to send it to the author 
 listed in the header or myself, mulferts@@spd.dsccc.com, as moderator. I or 
 any of the development team members are always available via email for a 
 technical interchange of ideas.

 [incr Widgets] is a continuing effort. We have many new mega-widgets 
 currently under development and are actively looking for volunteers willing
 to contribute their own [incr Tk] based mega-widgets for inclusion into 
 the [incr Widgets] set. The distribution is moderated. Contributed 
 mega-widgets should be of good quality and complete with documentation, 
 tests, and demonstrations. Please follow the coding style found in the 
 distribution source. This includes man page and test script formats as well.
 The languages and extensions on which [incr Widgets] is based are of high 
 standards. [incr Widgets] strives to attain this same level.  Be fore
 warned, the moderator is a facist.
@


1.3
log
@Updated some of the installation directions - they were way out of date.
@
text
@d84 6
a89 18
 The [incr Widgets] distribution is included with [incr Tcl] version 2.0
 and greater. It is available via ftp at ftp.neosoft.com/tcl. Consult the 
 included release documentation for installation notes.  For the latest 
 in distribution information, this web site should be consulted.

 The [incr Tcl] distribution will always include the most current release 
 of [incr Widgets] which was possible at the time of its release. It is
 anticipated that [incr Widgets] will change more rapidly than [incr Tcl]. 
 This being the case, in between [incr Tcl] releases, the latest version 
 of [incr Widgets] is also separately available via ftp at the same
 location list above as well as the web site. 

 The version number of [incr Widgets] tracks the release of [incr Tcl] 
 for which it is compatible. The version numbering system for [incr Widgets]
 includes an extra number. For example version 2.1.1 of [incr Widgets] is 
 compatible with [incr Tcl] 2.1. As the minor number of [incr Tcl] increases
 the second digit of the [incr Widgets] version varies. This makes for
 easy release identification.
d128 4
a131 7
  [incr Widgets]

  Having the itcl distribution is a prerequsite to using iwidgets.  Thus,
  if you don't have itcl you need to visit Source Forge to download and
  install it first.  The URL is www.sourceforege.net/projects/incrtcl.
  Once you have downloaded and installed [incr Tcl] and [incr Tk], you
  can proceed with [incr Widgets] installation as follows:
@


1.2
log
@Merging iwidgets_overhaul branch to CVS head.
@
text
@d4 2
a5 1
 This version is compatible with itcl3.0
a6 3
 Please send general comments or suggestions to mulferts@@spd.dsccc.com.
 Should you have an enhancement or comment regarding a specific mega-widget,
 please send email to the author listed in the source header.
d140 1
a140 1
  [incr Tcl] with [incr Widgets]
d142 5
a146 4
  As previously stated, the latest version of itcl contains the latest
  version of iwidgets.  Having the itcl distribution is a prerequsite
  to using iwidgets.  Thus, if you don't have itcl follow the these steps
  to acquire itcl and iwidgets.
d148 4
a151 1
  1)  Read the distribution section notes above.
d153 3
a155 1
  2)  Obtain the [incr Tcl] 3.x distribution from the archive site like this:
d157 1
a157 6
	ftp ftp.neosoft.com
        cd /pub/tcl/sorted/devel/
        binary
        get itcl3.0.tar.gz
        get itcl3.0.README
        quit
d159 1
a159 1
  3)  Follow the directions in the itcl README file.
d161 1
a161 2
  If you've already got itcl and have found a newer version of iwidgets
  at neosoft, then follow the following steps.
d163 1
a163 23
  1)  Read the distribtion scetion notes above.

  2)  Obtain the [incr Widgets] 3.x.y distribution from the archive site 
      like this:

	ftp ftp.neosoft.com
        cd /pub/tcl/sorted/devel/
        binary
        get iwidgets3.0.1.tar.gz
        quit
 
  3)  cd to your compatable itcl source directory.  For example:

        cd /usr/local/src/itcl3.0

  4)  Uncompress and untar the iwidgets distribution:

        gunzip iwidgets3.0.1.tar.gz
        tar xvf iwidgets3.0.1.tar

  5)  Run the configuration script:

        cd iwidgets3.0.1
a165 5
      or, for systems that don't recognize "#!" in shell scripts:

        cd itcl3.0
        /bin/sh ./configure

d170 1
a170 1
      the configuration of your itcl3.0 distribution.
a173 5
      You can also add options for a particular "cc" compiler and
      compiler flags:

        ./configure --with-cc=gcc --with-cflags=-g

d177 1
a177 1
  6)  Build the iwidgets library:
d179 1
a179 1
        make all
a183 5

  8)  Optionally, you can install the html'ed version of the iwidgets
      man pages:

        make install-html
@


1.1
log
@Initial revision
@
text
@d2 1
a2 1
                    [incr Widgets] - version 3.0.0
@


1.1.6.1
log
@This merge is from the iwidgets_overhaul branch created by Chad Smith
to extract the [incr Widgets] from the [incr Tcl] distribution.  See
the CHANGES file for a list of changes I made to this distribution.
The new [incr Widgets] version number is 4.0.0.
@
text
@d2 1
a2 1
                    [incr Widgets] - version 4.0.0
@


1.1.1.1
log
@import of current 2.2.0
@
text
@d2 1
a2 1
                    [incr Widgets] - version 2.2.0
d4 1
a4 1
 This version is compatible with itcl2.2.
d86 4
a89 4
 The [incr Widgets] distribution is included with [incr Tcl] version 2.2
 and greater. It is available via ftp at ftp.aud.alcatel.com/tcl/extensions. 
 Consult the included release documentation for installation notes.  For
 the latest in distribution information, this web site should be consulted.
d100 2
a101 2
 includes an extra number. For example version 2.0.3 of [incr Widgets] is 
 compatible with [incr Tcl] 2.0. As the minor number of [incr Tcl] increases
d130 1
a130 1
   catalog ........... Comprehensive demo package which illustrates
d151 1
a151 1
  2)  Obtain the [incr Tcl] 2.x distribution from an archive site like this:
d153 2
a154 2
        ftp ftp.aud.alcatel.com
        cd pub/tcl/extensions
d156 2
a157 1
        get itcl2.2.tar.gz
d163 1
a163 1
  at alcatel, then follow the following steps.
d167 1
a167 1
  2)  Obtain the [incr Widgets] 2.x.y distribution from an archive site 
d170 2
a171 2
        ftp ftp.aud.alcatel.com
        cd pub/tcl/extensions
d173 1
a173 1
        get iwidgets2.2.0.tar.gz
d178 1
a178 1
        cd /usr/local/src/itcl2.2
d182 2
a183 2
        gunzip iwidgets2.2.0.tar.gz
        tar xvf iwidgets2.2.0.tar
d187 1
a187 1
        cd iwidgets2.2.0/unix
d192 1
a192 1
        cd iwidgets2.2.0/unix
d199 1
a199 1
      the configuration of your itcl2.2 distribution.
d203 5
a247 14
 Those mega-widgets which we are looking for include but are not limited 
 to the following list. Should you be interested in signing up for any of 
 those listed here, please send email to the distribution moderator: 
 mulferts@@spd.dsccc.com.  Also, should you have any ideas on others not 
 listed, please send email to the same.

    Dial                        Table                     Tree
    Spreadsheet                 Printdialog               Labledframe
    Timer                       Fontdialog                Biswitch
    Colordialog                 Colorgrid                 Istrumentation
    Printdialog                 Graphs

 Any other ideas ?

d255 4
a270 4
 Additional thanks to Ken Copeland for enhancing the panedwindow, smoothing 
 out the scrolling and making panes bumpable.  Also, thanks to Tako Schotanus 
 for contributing the canvasprintdialog mega-widget.

d272 1
a272 1
 girls, Katelyn and Bailey, who shared the PC with me (occasionally).  Also
d278 4
a281 5
    _/_/   _/_/    _/        _/    _/    Mark L. Ulferts
   _/ _/ _/ _/    _/        _/    _/     ulferts@@ix.netcom.com
  _/  _/_/ _/    _/        _/    _/      mulferts@@spd.dsccc.com 
 _/   _/  _/ _/ _/_/_/ _/ _/_/_/_/ _/    DSC Communications Corp, Plano Texas
 ____________________________________________________________________________
@

