Aejaks is now 1.0 !!

http://aejaks.sf.net

This release adds many new features and stability enhancements.
New in this release:
  - MrPersister database access library.
  - H2 Database engine included for quick-start database application development.
  - Apache Log4J logging system.
  - RichTextArea widget.
  - Standard library dialogs for messages, input, color selection, data
    selection, file upload.
  - TclTutor, Aejaks Rolodex, WarMachine sample applications.
  - Hyde package for easy Tcl-to-Java integration.

Notable fixes:
  - Eliminate Jacl interp lock, now uses notifier for all interpreter access.
  - Allow pasting into TextComponents without requiring additional keystrokes.
  - Standard bgerror dialog.
  - Jacl patches applied for open resource:/, notifier liveliness, reflected
    object re-creation.
  - Echo2 libraries updated from latest code.

Several real-world applications are on display at the website, see the
'Screen Shots' and 'App Gallery' pages.

Thanks to Dennis Lima and Matt Avery for the Log4J patches.

--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
visibile 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
  MrPersister   Jacob Jenkov
  H2 Database   Thomas Mueller

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

    The Jetty web server is not included with the source distribution.
    If you would like to run with the Jetty web server, download and
    unpack the executable distribution (e.g., aejaks-x.y-exe.zip) or
    download the Jetty web server at:
    http://jetty.mortbay.com
    You may also run with Apache Tomcat, or other Java Servlet web servers.

    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)
    and
    ^C  (in the Command Prompt window running the H2 database)

COPYRIGHT & LICENSE:
Aejaks 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
  Mr Persister
  H2 Database
  TclTutor