Subversion Repositories or1k

As much as possible, I've tried to make itcl3.0 backward-compatible
with earlier releases.  The class definition syntax has not changed
at all from itcl2.2, and the old itcl1.x syntax is still supported.
But you'll notice changes related to namespaces.  John Ousterhout
adopted a slightly different namespace model for Tcl8.  The syntax
of the "namespace" command is different, as well as the semantics
for command/variable lookups and imports.  Also, John Ousterhout
failed to adopt ensembles into the Tcl core, so itcl can't add
functions like "info objects" and "info classes" into the usual "info"
command.  These functions have been moved to a new "itcl::find" command.

The [incr Widgets] package has changed quite a bit.  There are many
new widgets, and some of the existing widgets were streamlined--some
of the widget options were removed to improve performance.  For details,
see the "CHANGES" file in the iwidgets3.0.0 directory.  Because there
are a lot of changes, this distribution contains the iwidgets2.2.0
package, which is backward-compatible with the existing [incr Widgets].

Following is a quick summary of changes, to serve as a porting guide.


----------------------------------|-------------------------------------
 You have code like this...       | change to this...
----------------------------------|-------------------------------------
 namespace foo {...}              | namespace eval foo {...}
                                  |
 delete namespace foo             | namespace delete foo
                                  |
 info which -namespace $name      | if {![string match ::* $name]} {
                                  |     set name [namespace current]::$name
                                  | }
                                  |
 info context                     | namespace current
                                  |
 info objects ...                 | itcl::find objects ...
                                  |
 info classes ...                 | itcl::find classes ...
                                  |
 In itcl2.2, commands/classes     | In Tcl8.0, all commands/classes that
 could be found in any namespace  | are not in the global namespace must
 in a hierarchy.  So within a     | be qualified.  For example, the
 namespace like "iwidgets" you    | "iwidgets" namespace has a bunch of
 could use simple names like:     | classes within it.  You must always
                                  | refer to these classes with qualified
                                  | names, like this:
                                  |
 Labeledwidget::alignlabels ...   | iwidgets::Labeledwidget::alignlabels ...
 Pane #auto                       | iwidgets::Pane #auto
                                  |
                                  |
 In itcl2.2, the "global"         | In Tcl8.0, the "variable" command is
 command was used to access       | used to access variables in a namespace:
 variables in a namespace:        |
                                  |
   namespace foo {                | namespace eval foo {
       variable x 0               |     variable x 0
       proc example {} {          |     proc example {} {
           global x               |         variable x
           return $x              |         return $x
       }                          |     }
   }                              | }
                                  |
                                  |
 public itk_component add...      | itk_component add ...
 protected itk_component add...   | itk_component add -protected ...
 private itk_component add...     | itk_component add -private ...
                                  |
                                  |

 OTHER DIFFERENCES
------------------------------------------------------------------------
- You can now use instance variables (along with the usual common
  variables) with the "scope" command.  Thus, you're no longer forced
  to use the trick with a common array like:  [scope modes($this)]

- All widget/mega-widget access commands (e.g., ".foo.bar") are
  installed in the global namespace.  Therefore, they can be accessed
  from any namespace context.

- The [incr Widgets] package used to be loaded by default.  You must
  now use the "package require" command to load it explicitly:

    package require Iwidgets              <-- loads the lastest (iwidgets3.0.0)
    package require -exact Iwidgets 2.2   <-- loads the older release

- Command/variable names are now reported with fully-qualified names
  in "info" inquiries and in error messages.

- No public/protected/private declarations outside of class definitions

- The "scope" command used to be more or less the same as the "code"
  command.  In itcl3.x, "scope" is only for variables, and if a variable
  is not recognized, you'll get an error.

- The "code" command used to return a value like "@scope ...".  It now
  returns "namespace inscope ...", to be compatible with Tcl8.

- The prototypes for Itcl_RegisterC and Itcl_FindC have changed.  You
  can now include ClientData when you register C functions.  Also, there
  is a new Itcl_RegisterObjC function for (objc,objv)-style command
  handlers.