Release Notes

Welcome to the Embedthis Ejscript™ install release notes. This document provides release-specific information for Ejscript.  

This release is an early preview snapshot to enable developers to have early access to the Ejscript language. It is currently pre-release and is incomplete in functionality, quality and compliance with the ECMAScript 4 specifications. See the Project Status for details about features and omissions.

System Requirements

Operating System Support

Binary releases are supplied for the following operating systems.

• Linux (Fedora (x86 and x86_64), Red Hat, Ubuntu (x86 and x86_64)
• Windows (XP, Vista)
• MAC OS X (Tiger, Leopard)

The following operating systems may be supported by recompiling Ejscript from source.

• Linux 2.4 and 2.6
• FreeBSD
• VxWorks 5.4 and 6.X

Run-time System Requirements

To install Ejscript on a development system and run Ejscript programs, your system will need at least the following:

• 10 MB Disk
• 1 MB disk

To deploy Ejscript in an embedded environment, you will need at least the following:

• 400 KB Disk / ROM space
• 400 KB RAM

To rebuild Ejscript from source code, you will need at least

• 15 MB disk space

Development Environment Hardware Platform Support

If you wish to build Ejscript from source code, you will need to use a C compiler and associated development tools. Several development environments are supported. You may choose any of the following to compile and build samples and source code.

• Linux GNU tools
• Windows Visual Studio (Visual Studio 2008 and Visual Studio 2008 Express)
• Windows XP with Cygwin UNIX emulation tools. See www.cygwin.com

Windows Vista is not supported with Cygwin as the cygwin tools are currently unreliable on Vista.

Release Build

This distribution is a RELEASE build and has little trace and or debug assertions to help find bugs. If you rebuild from source code, a DEBUG build will be created which has more trace to assist in debugging. Performance with the DEBUG build will be slower and the memory footprint will be larger than with the release build.

Helpful Hints

Debug Trace and Logging

Ejscript has a debug logging and trace facility that can help greatly when debugging configuration issues or developing your application code that uses Ejscript. You can see each script statement as it is executed and what op codes the VM is executing. You can vary the level of logging via the --log logfile command line switch for the ejs and ejsvm commands. The log command line switch has the format

ejs --log logFile:logLevel

where level can be from 0 to 9, with 9 being the most verbose level. If compiling your scripts with debug, a level 2 setting will trace each source statement and assembly op code to the log file.

Limitations and Special Notes

1. This release snapshot is not compliant with ECMAscript 4 as the specification is still evolving.
2. There are still many features outstanding. See the Release Status for full details.

Resolved Issues

See the new features and fixes in the New Features document.