Next: , Previous: Installation, Up: Overview


1.3 Running Jacal

If you successfully executed one of the installations of the previous section, then typing ‘jacal’ or clicking an icon will begin an interactive session.

To manually start jacal, start your Scheme implementation with SLIB. This may involve setting up that implementation's initialization file or LOADing a ‘.init’ file from the slib directory. Then type:

     (slib:load "/usr/local/lib/jacal/math")

where /usr/local/lib/jacal/ is a path to the JACAL directory. JACAL should then print:

     JACAL version 1c3, Copyright 1989-1999, 2002 Aubrey Jaffer
     JACAL comes with ABSOLUTELY NO WARRANTY; for details type `(terms)'.
     This is free software, and you are welcome to redistribute it
     under certain conditions; type `(terms)' for details.
     ;;; Type (math) to begin.

Do as it says:

     (math)
     ⇒
     type qed; to return to scheme, type help; for help.
     e0 :

And you are ready to try the commands described in the rest of the manual.

Demonstrating Jacal

There are several demonstration files in the jacal directory. To run, use the batch command batch.

batch("demo");
Demonstrates a variety of JACAL features.
batch("test.math");
Tests each operator.
batch("rw.math");
Demonstrates tensors and The Robertson-Walker Cosmology Model.

Recovery from Errors

As JACAL is a complicated program there are bugs which will occasionally cause the program to stop with some sort of error reported by the underlying Scheme system. In interactive implementations (such as SCM) you can usually continue your session by typing (math). The expression which was input to JACAL just before the error will be lost but you should be able to otherwise continue with your session.

Stopping Jacal

The command quit(); will end your JACAL session.

With non-interactive Scheme implementations the JACAL command qed(); or typing the end-of-file character (<C-z> on MS-DOS and VMS, <C-d> on others) will end your JACAL session.

The command qed(); will return to the interactive Scheme session. Typing (math) will return to the JACAL session.

From the interactive Scheme session (exit) or possibly an end-of-file character will terminate the session.