Working with the Ejscript Source Code

Ejscript releases are available in either a binary or source code distribution. It is your choice which distribution you choose, but the source code distribution has several advantages:

• You can recompile Ejscript to optimize it for your specific system environment
• You can reconfigure Ejscript using a wide variety of configuration options to select the specific features that you require
• You can modify the core number type to be double, int-32 or int-64

Getting the Source Code

With each Ejscript release, a complete source code snapshot is provided. You can get the latest source code from the download site or you can access the source code repository.

Source Repository

Go to https://github.com/embedthis/ejs-2 to get the latest source code. The repository source code will contain the latest features and fixes, but it will also contain bugs and issues that have not been resolved. Use of the repository source code is not recommended for production or development use.

The Ejscript source code is hosted in a Git repository. We provide open read-only access. Write access is available to regular contributing developers. To check out the source use this command:

$ git clone http://github.com/embedthis/ejs-2

You can also view the repository at https://github.com/embedthis/ejs-2. This is also a convenient way to get the source code.

Repository Branches

The repository has three branches for various phases of development and release: Master, Dev and Stable.

Master Branch

The Master branch in the repository source code is the code base for the next minor and major release. It will contain the latest features and fixes, but it will also contain bugs and issues that have not been resolved. For this reason use of the repository source code is not recommended for production or development use.

Dev Branch

The Dev branch is updated when the Master branch is relatively steady and usable, but prior to release. The Dev branch is used to create Beta releases. It is not as bug-free as the Stable branch and yet has most of the features in the master branch.

Stable Branch

The stable branch is for ongoing maintenance of the current stable release.

Building Ejscript from Source

The Ejscript source distribution contains all the required source files, headers, tools and test framework to reconfigure, build and verify Ejscript. See also the detailed building from source instructions.

Porting the Source to a New Platform

Ejscript currently runs on a wide variety of operating platforms including: FreeBSD, Linux, MAC OS X and Windows. If your system is not one of these, you may like to try porting Ejscript to your system. See the detailed porting instructions for tips on this process.