The binary release comes as a
.zip archive that
includes Kawa itself (as a
some third-party helper libraries,
kawa command scripts
(for GNU/Linux/Unix/MacOS or Windows),
and documentation (basically this manual).
After downloading (see Getting Kawa), extract the files
.zip archive using a suitable
which will create a directory
In the following, we assume the environment variable
refers to this directory:
version.zip export KAWA_HOME=`pwd`/kawa-
The binary release requires Java 7 or later. Java 8 is recommended. (Java 8 is needed for the JLine input editor, which is recommended for the REPL.) If you have an older Java implementation, or build for a mobile environment like Android, then you will need to get the source distribution.
If you want to use Kawa as part of some other application,
you just need the
To run a Kawa script file or the Kawa read-eval-print-loop run the Kawa application. There are various way to do so.
The recommended way is to execute the
This should work on most Unix-like platforms that have Bash installed,
including GNU/Linux, BSD, MacOS, and Cygwin/MingW.
(Please report if you have problems.)
The script assumes that either a suitable
java program is
PATH; or the
JAVA environment variable
names a suitable
java executable; or that
is set so
$JAVA_HOME/bin/java is suitable.
If you want to put
kawa in your search path you can of course do:
Alternatively you can create a symbolic link in an already-searched directory. For example:
cd /usr/local/bin ln -s $KAWA_HOME/bin/kawa kawa
bin/kawa.bat script works on Windows.
Both scripts add some helper libraries, including support for input editing.
It is also possible to run Kawa using
java -jar $KAWA_HOME/lib/kawa.jar
CLASSPATH=$KAWA_HOME/lib/kawa.jar export CLASSPATH java kawa.repl
To run Kawa in a fresh window use the -w flag:
java kawa.repl -w
doc/kawa-manual.epub contains the Kawa documention
packaged as an electronic book, which is readable by most
e-book readers. Plugins are also available for common browsers,
for example EPUBReader for
Even easier is to invoke
(or on Windows:
epub is essentially a zip archive, which you can unzip:
cd $KAWA_HOME/doc unzip kawa-manual.epub
Then you can use a plain browser
with the URL