Dev guide

Build

Type ant to build scriptella.jar

Type ant test to run jUnit tests, you may need to add jUnit to Ant's classpath.

Sometimes you may get JVM crashes during unit testing, like EXCEPTION_ACCESS_VIOLATION (0xc0000005) at pc= This bug is caused by a default client JVM, as a workaround use -server JVM ,e.g. -Xmx256m -Xms64m - XX:MaxPermSize=128m -server

Releasing

1. Checkout into a separate folder

2. Create custom.build.properties in the root folder and update as appropriate. dtddoc.dir/forrest.dir required to be set. (Both forrest and DTDDoc can be downloaded from Scriptella's Google Drive scriptella-forrest-dependencies.zip.)

3. Type ant dist to produce source/binary artifacts

4. Type ant -f build-docs.xml site to generate site

5. Type ant -f build-docs.xml site_postprocess to apply customization to site, like stats, ads etc.

TODO: Use maven release plugin.

Forrest/docs

Install

Follow Installing Forrest

Add env variables:

    export FORREST_HOME=/full/path/to/forrest
      
    PATH=$PATH:$FORREST_HOME/bin

Install DTDDoc.

Note: Both forrest and DTDDoc can be downloaded from Scriptella's Google Drive scriptella-forrest-dependencies.zip. Forrest was combined from 2 tar files - sources and dependencies.

Use