head	1.1;
access;
symbols
	itcl-4-0b5:1.1.2.5
	itcl-4-0b41:1.1.2.5
	itcl-4-0b4:1.1.2.5
	itcl-4-0b3:1.1.2.5
	itcl-4-0b2:1.1.2.5
	itcl-ng:1.1.0.2;
locks; strict;
comment	@# @;


1.1
date	2009.01.07.18.15.06;	author wiede;	state dead;
branches
	1.1.2.1;
next	;

1.1.2.1
date	2009.01.07.18.15.06;	author wiede;	state Exp;
branches;
next	1.1.2.2;

1.1.2.2
date	2009.01.07.19.53.23;	author wiede;	state Exp;
branches;
next	1.1.2.3;

1.1.2.3
date	2009.01.09.13.39.28;	author wiede;	state Exp;
branches;
next	1.1.2.4;

1.1.2.4
date	2009.01.09.13.45.27;	author wiede;	state Exp;
branches;
next	1.1.2.5;

1.1.2.5
date	2009.01.09.19.37.51;	author wiede;	state Exp;
branches;
next	;


desc
@@


1.1
log
@file README was initially added on branch itcl-ng.
@
text
@@


1.1.2.1
log
@initial version
@
text
@a0 103
README: [incr Tcl] (itcl)

   This is the 4.0b1 source distribution of [incr Tcl] an object oriented
   extension for Tcl. [incr Tcl] is available from Sourceforge at:
   http://sourceforge.net/project/showfiles.php?group_id=13244&package_id=295641

RCS: @@(#) $Id: README,v 1.2 2008/12/17 23:05:48 dgp Exp $

1. Introduction

This directory contains the source code, documentation, and test scripts
for the [incr Tcl] extension. This version is a mostly rewritten version
derived from [incr Tcl] 3.4. The rewriting had several reasons which can
be found here: http://wiki.tcl.tk/19873

In short: it is now based on TclOO and it was tried to make it less dependent
on interial features of Tcl core.

This version claims to be script level compatible with Itcl 3.4.

There are a lot of new features in that version: delegation additional
to inheritance, where the ideas are mostly "stolen" from snit written by Will
Duquette. The class types are: ::itcl::type, ::itcl::widget and
::itcl::widgetadaptor.

There is also an experimental class type ::itcl::extended class available,
which will be used to build itk like megawidgets (a la iwidgets) without
the need to use itk.

The additional class types need no Tk at load time, Tk is loaded automatically
for ::itcl::widget and ::itcl::widgetadaptor if needed. To use these features
you need also the package itclwidget installed, to be also found on the 
above link.

[incr Tcl] is a freely-available open source package as in the past. 
You can do virtually anything you like with it, such as modifying it,
redistributing it, and selling it either in whole or in part.  See the file
"license.terms" for complete information.

2. Documentation

The 'doc' subdirectory in this release contains a set of reference manual
entries for [incr Tcl].  Files with an extension '.n' are for Tcl classes and
commands; files with an extension '.3' are for C library functions.

3. Compiling and Installing.

[incr Tcl] is built in much the same way that Tcl itself is. Once you have
a Tcl build environment set up, you should be able to simply
enter the commands:

    cd itcl
    ./configure
    make all
    make test
    make install

4. Tcl newsgroup.

There is a USENET news group, "comp.lang.tcl", intended for the exchange of
information about Tcl, Tk, and related applications.  The newsgroup is a
great place to ask general information questions.  For bug reports, please
see the "Support and bug fixes" section below.

5. Tcl'ers Wiki

A Wiki-based open community site covering all aspects of Tcl/Tk is at:

	http://wiki.tcl.tk/

It is dedicated to the Tcl programming language and its extensions.  A
wealth of useful information can be found there.  It contains code
snippets, references to papers, books, and FAQs, as well as pointers to
development tools, extensions, and applications.  You can also recommend
additional URLs by editing the wiki yourself.

6. Mailing lists

SourceForge hosts a mailing list, incrtcl-users to discuss issues with using
and developing [incr Tcl]. For more information and to subscribe, visit

    http://sourceforge.net/projects/incrtcl

and go to the 'Mailing Lists' page.

7. Support

We are very interested in receiving bug reports, patches, and suggestions
for improvements.  We prefer that you send this information to us via the
bug database, rather than emailing us directly.  The bug database is at:

	http://sourceforge.net/tracker/?group_id=13244

We will log and follow-up on each bug, although we cannot promise a
specific turn-around time.  Enhancements, reported via the Feature
Requests form at the same web site, may take longer and may not happen
at all unless there is widespread support for them.

The Tcl community is too large for us to provide much individual support
for users.  If you need help we suggest that you post questions to
comp.lang.tcl.  We read the newsgroup and will attempt to answer esoteric
questions for which no one else is likely to know the answer.

@


1.1.2.2
log
@bump version to 4.0b2
@
text
@d3 1
a3 1
   This is the 4.0b2 source distribution of [incr Tcl] an object oriented
d7 1
a7 1
RCS: @@(#) $Id: README,v 1.1.2.1 2009/01/07 18:15:06 wiede Exp $
@


1.1.2.3
log
@rewording and moving some stuff into releasenotes.txt
@
text
@d1 1
a1 1
README: itcl ([incr Tcl])
d3 3
a5 5
RCS: @@(#) $Id: README,v 1.1.2.2 2009/01/07 19:53:23 wiede Exp $

This is the 4.0b2 source distribution of itcl, an object oriented
extension for Tcl. Itcl is available from Sourceforge at:
http://sourceforge.net/project/showfiles.php?group_id=13244&package_id=295641
d7 1
d12 2
a13 2
for the itcl extension. This version is a mostly rewritten version
derived from itcl 3.4. The rewriting had several reasons which can
d21 15
a35 1
Itcl is a freely-available open source package as in the past. 
d40 7
a46 1
2. Compiling and Installing.
d58 20
a77 1
3. Mailing lists
d86 1
a86 1
4. Support
d99 5
@


1.1.2.4
log
@added a note on package require itcl
@
text
@d3 1
a3 1
RCS: @@(#) $Id: README,v 1.1.2.3 2009/01/09 13:39:28 wiede Exp $
a38 8
to use the package add a line
    package require itcl
or
    package require itcl 4.0
at the top of your script file. Attention this version uses all lower case
for the package name . There is an additional entry for "package require Itcl"
in there for compatibility, but that will probably disapear in the future

@


1.1.2.5
log
@next round of "rewording" and adding description of new features
@
text
@d1 1
a1 1
README: Itcl
d3 1
a3 1
RCS: @@(#) $Id: README,v 1.1.2.4 2009/01/09 13:45:27 wiede Exp $
d5 1
a5 1
This is the 4.0b2 source distribution of Itcl, an object oriented
d13 6
a18 3
for the itcl extension. This version is the next major release to follow
Itcl 3.4. Aditional details to that version can be found here:
http://wiki.tcl.tk/19873
d29 1
a29 1
Itcl is built in much the same way that Tcl itself is. Once you have
d39 8
d50 1
a50 1
and developing Itcl. For more information and to subscribe, visit
@


