Compiling and Running ShowLine

Introduction

Currently, the most useful (and working!) part of Sally is the line drawing program, ShowLine. This page contains instructions on how to compile and run ShowLine.

Prerequisites

In order to compile ShowLine, you will need a 1.3 compliant java compiler. Throughout this document, it is assumed that you are using Sun's java compiler, jdk, available for free from http://java.sun.com/j2se/1.3/.

If you wish to make any changes to the place notation parsing code (MethodParser.jj), then you will also need JavaCC, the Java Compiler Compiler. This is available for free from WebGain at http://www.webgain.com/products/java_cc/.

Compiling ShowLine

The ShowLine program can be compiled under a UNIX-like environment by issuing the following command from within the Sally directory:

make

You may need GNU ‘make’ for this to work. If make is not available, you can use the following commands:

mkdir -p classes
javacc -output_directory:bellringer/ShowLine bellringer/ShowLine/MethodParser.jj
javac -d classes bellringer/ShowLine/ShowLine.java

Running ShowLine

ShowLine can be run by issuing the following command from within the Sally directory:

make run

If make is not available, the following command can be used instead:

java -cp classes bellringer.ShowLine.ShowLine

Other options for ‘make’

The following command-line options can be given to the make command:

ShowLine
Compiles ShowLine. This is the default behaviour if no options are given.
run
Performs any necessary compilation steps and then runs ShowLine.
clean
Deletes all files that can be generated from the Java source (class files, documentation etc). It is always safe to do this.
cleanall
Deletes all files that can be generated fromm the Java source and also the files that are generated by JavaCC. You should not do this unless you have JavaCC installed, otherwise you will no longer be able to compile ShowLine.
doc
Generates the javadoc documentation for all the Java source files. This is placed in a directory called docs.
dist
Creates a JAR file containing the class files needed to run ShowLine.
debug
Performs any necessary compilation steps and then runs ShowLine in the jdb debugger.

Home Page ~ ShowLine ~ SourceForge Page