Summary of changes for this release:

Additional container widgets now provide absolute positioning of child widgets.  
Table widget now allows custom cell and header renderers.
Window setFocusedComponent method allows focus to be set on a widget.
BrowserCommand setwaitms method sets interval for browser "Please wait" message.

--------------------------------------------------------------------------- ----

Detailed CHANGES for this release:

0.7 2008-02-22
    * Widgets from EchopointNG
        ContainerEx       (allows absolute positioning)
        ContentPaneEx     (  "        "         "     )
        Strut             (simple spacer component)
        DisplayLayoutData             (positioning info)
        ScrollableDisplayLayoutData   (     "        " )

    * Table header and cell renderers, allow custom widgets
        to be defined for headers and cells.  Tables now
        expand gracefully with null data when -rows or -columns
        are increased.

    * Strip leading "::" from widget names during Pack.
        Pack updated for new container widgets and layout data.

    * SplitPaneLayoutData -overflow option now takes a symbolic
        name instead of integer (POTENTIAL INCOMPATIBILITY)

    * Added ". setFocusedComponent $wid" to Window object, allows
        focus to be set on a widget.

    * Added "BrowserCommand setwaitms $ms" to set the interval before
        displaying the "Please wait" message box.

    * New widget_tour.tcl demos for Table renderers, absolute
        positioning for new containers.
        Check out the "analog clock" in the 'ContainersEx' demo!!

    * Updated docs.

    * Updated Echo2, Extras, EchopointNG libraries to latest versions.

--------------------------------------------------------------------------- ----

README

AEJAKS: http://aejaks.sf.net

ABOUT:
Aejaks combines the server-side Ajax windowing system Echo2 with the powerful
simplicity of the Tcl langauge.  The result is a rich development environment
in which to develop Ajax-based web applications, often with much less code to
write.  

Building a Rich Internet Application (RIA) usually means having to write
your application in a variety of languages and markup: HTML, CSS, and
Javascript for the browser, plus some backend language (PHP, Java, Tcl, etc.)
With Aejaks, you only need a single language: Tcl.  Aejaks applications
resemble desktop Tcl/Tk applications.  Aejaks uses a Tk-inspired object
interface to create and interact with widgets.

Classic "Hello world" in Aejaks:

    Button .hello -text "Hello world" -command {. exitApp /index.html}
    Pack .hello

The first line creates a Button widget named '.hello' and defines a command
to be run when the button is pressed (exit the application and tell the
browser to load the index.html page.)  The second line makes the Button widget
visible in the browser window.  That's all you need!

AUTHOR:
Aejaks was conceived and written by Tom Poindexter.  Please subscribe and use
the mailing list for Aejaks related discussion.  Subscription information at:
  http://lists.sourceforge.net/lists/listinfo/aejaks-general

If you really, absolutely need to get in touch with me privately, email:
  tpoin...@nyx.net

ACKNOWLEDGEMENTS:
Aejaks stands on the shoulders of giants, and would not be possible
without the contributions of a host of very talented programmers and
artists:

  Echo2:        Tod Liebeck, NextApp
  Tcl/Jacl      John Ousterhout, Ioi Lam, Brian Smith, Mo DeJong
  IncrTcl:      Michael J. McLennan, Mo DeJong
  Jetty:        Greg Wilkins, Mort Bay Consulting
  Clcms:        Jelte Jansen
  EchopointNG:  Brad Bakerman
  Nuvola icons: David Vignoni

DOWNLOAD:  
http://sourceforge.net/project/showfiles.php?group_id=184611
or http://sourceforge.net/projects/aejaks

Three downloads are available (where 'x.y' is the current version):

aejaks-x.y-exe.tar.gz
aejaks-x.y-exe.zip

    This package contains everything required to run, develop and deploy
    Aejaks applications.  Included are the aejaks.war file, Jetty web server,
    sample scripts, and documentation.

    Java 1.4 or higher is required to run the Aejaks and the Jetty web server.
    http://java.sun.com

aejaks-x.y-src.tar.gz
aejaks-x.y-src.zip

    Developers who wish to contribute to Aejaks development should download
    this file and the above '-exe' file, and unpack both into the same
    directory.  This package contains source for Java and Tcl files,
    documentation source, build scripts, library files, icon and image
    source, Eclipse project and classpath files.

    Java JDK 1.4 or higher is required to develop Aejaks.
    http://java.sun.com

    Ant or Eclipse is require to run the Java source build.xml file.
    Ant and Eclipse can be downloaded from
    http://ant.apache.org
    http://eclipse.org

    Clcms and Python are required to regenerate the local website &
    documentation.  Clcms and Python can be downloaded from:
    http://www.jelte.nlnetlabs.nl/Projects/clcms/index.html
    http://python.org

AejaksDemo.war

    This war is the webserver deployment file containing the Aejaks
    runtime and all required libraries, along with the 'widget_tour'
    demo script.  Simply deploy this file into your existing Java Servlet
    engine (e.g., Jetty, Tomcat, Resin, Websphere, Weblogic, Winstone, etc.
    Java 1.4 or higher is also requried.)  

    Once deployed (and depending on your servlet engine), you should be
    able to invoke the Aejaks 'widget_tour' demo by opening a browser to
    http://your-web-server-host/AejaksDemo

    AejaksDemo.war is a full run-time environment for Aejaks.  Update the
    internal WEB-INF/web.xml file or provide the runtime parameters as
    outlined in the documentation:
    http://aejaks.sourceforge.net/Documentation/Running/index.html
    http://aejaks.sourceforge.net/Documentation/Configuration/index.html

REQUIREMENTS:
Aejaks requires a Java JRE 1.4 or higher installation.  No other
external software is required, Aejaks is ready to run.  Aejaks includes
the Jetty webserver, configured to start on port 8080.

DOCUMENTATION:
See: ./website/out/index.html
This is a local copy of the website, including all documentation to related
software.  

All documentation is also available at: http://aejaks.sf.net

QUICK START:
You will need Java JDK or JRE 1.4 or higher installed.  un-tar or un-zip
the '-exe' distribution file:

  tar zxf aejaks-x.y-exe.tar.gz
  unzip aejaks-x.y-exe.zip
  winzip ...etc...

Start the Jetty webserver:

  unix/linux:
    sh run.sh

  windows, execute in a Command Prompt window:
    run.bat

Start your web browser and load the index.html page:

  unix/linux:
    firefox http://localhost:8080

  windows:
    start http://localhost:8080

  Now start exploring the demos!

To stop the web server:

  unix/linux:
    sh stop.sh

  windows:
    ^C  (in the Command Prompt window where you started jetty)

COPYRIGHT & LICENSE:
Aejaks (a.k.a. "Æjaks") Copyright 2006-2008, Tom Poindexter

Aejaks is licensed under the Mozilla Public License 1.1, or the GNU LGPL 2.1.

Aejaks includes the following software, please refer to the copyright
and license statements for each package in the ./licenses/ directory:

  Echo2
  EchopointNG
  Jacl, IncrTcl, TJC
  Jetty
  JFreeChart
  Nuvola icons