example Tk package using the TEA infrastructure
C Tcl Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc
generic
library
tclconfig
tests
.gitignore
Makefile.in
README
aclocal.m4
configure.ac
license.terms
pkgIndex.tcl.in
prepare.sh

README

			  TkSquare
			  ========


Topics
------

  1. Introduction
  2. License
  3. Building and installing


1. Introduction
---------------

TkSquare is  an example widget.  The source  code comes from
the  Tcl distribution  itself, it  is repackaged  here  as a
usage example for the TEA infrastructure.


2. License
----------

Copyright (c) 1997 Sun Microsystems, Inc.
Copyright (c) 1999-2000 Ajuba Solutions.
Copyright (c) 2002 ActiveState Corporation.
Copyright (c) 2003, 2010 Marco Maggi.

The  author hereby  grant permission  to use,  copy, modify,
distribute, and license  this software and its documentation
for  any purpose, provided  that existing  copyright notices
are retained in all copies  and that this notice is included
verbatim  in   any  distributions.  No   written  agreement,
license,  or  royalty  fee   is  required  for  any  of  the
authorized  uses.   Modifications to  this  software may  be
copyrighted  by  their  authors  and  need  not  follow  the
licensing terms described here,  provided that the new terms
are clearly indicated  on the first page of  each file where
they apply.

IN NO  EVENT SHALL THE  AUTHOR OR DISTRIBUTORS BE  LIABLE TO
ANY  PARTY  FOR DIRECT,  INDIRECT,  SPECIAL, INCIDENTAL,  OR
CONSEQUENTIAL  DAMAGES  ARISING  OUT  OF  THE  USE  OF  THIS
SOFTWARE,  ITS DOCUMENTATION,  OR  ANY DERIVATIVES  THEREOF,
EVEN IF THE  AUTHOR HAVE BEEN ADVISED OF  THE POSSIBILITY OF
SUCH DAMAGE.

THE  AUTHOR  AND   DISTRIBUTORS  SPECIFICALLY  DISCLAIM  ANY
WARRANTIES,  INCLUDING,  BUT  NOT  LIMITED TO,  THE  IMPLIED
WARRANTIES  OF  MERCHANTABILITY,  FITNESS FOR  A  PARTICULAR
PURPOSE, AND NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON
AN "AS  IS" BASIS, AND  THE AUTHOR AND DISTRIBUTORS  HAVE NO
OBLIGATION   TO  PROVIDE   MAINTENANCE,   SUPPORT,  UPDATES,
ENHANCEMENTS, OR MODIFICATIONS.


3. Building and installing
--------------------------

1. Uncompress and unpack the distribution

   ON UNIX:
	gzip -cd tksquare<version>.tar.gz | tar xf -

   ON WINDOWS:
	use something like WinZip to unpack the archive.

   ON MACINTOSH:
	use StuffIt Expander to unstuff the archive.

   This  will create  a subdirectory  tksquare<version> with
   all the files in it.

2. Configure

   ON UNIX:
        cd Tksquare<version>
	./configure

   tksquare  uses information left  in tkConfig.sh  when you
   built tk.  This file  will be found in $exec_prefix/lib/.
   You might  set the --prefix and  --exec-prefix options of
   configure if you don't want the default (/usr/local).  If
   building  on multiple  unix platforms,  the  following is
   recommended to isolate build conflicts:

	mkdir <builddir>/<platform>
	cd !$
	/path/to/Tksquare<version>/configure

   ON WINDOWS:

   You can retrieve cygwin from:

	http://sources.redhat.com/cygwin/

   Inside the  cygwin environment, you build the  same as on
   Unix.

3. Make and Install

   ON UNIX or WINDOWS (with cygwin):
	make
	make test (OPTIONAL)
	make install

   TkSquare  is built to  comply to  the latest  tcl package
   conventions.

4. Use it

   Start a  regular "wish" interpreter and  load the package
   with:

      package require TkSquare

   then use  the [square] command.  There is  a test program
   "square.tcl"  in  the  "tests"  directory of  the  source
   distribution.

5. Read the documentation

   There   is  a   Unix  manpage   provided  in   the  "doc"
   subdirectory and  its HTML version,  too.  These describe
   the square  widget's features and commands  in depth.  If
   something is confusing, just to try it out.


### end of file
# Local Variables:
# mode: text
# End: