2.2 Delivering the program

Having compiled the program, the next step is to attempt delivery using the compiled file.

Programs are delivered with the function deliver . This function takes three mandatory arguments. There are also many optional keyword arguments to help Delivery make the smallest image possible.

You can read more about this function in Delivering your Application. Keywords to the Delivery Function, describes all the optional keywords available.

In this example, we do not use any of them, but just provide the mandatory arguments. They are:

• The name of a startup function .

This is the first function called when the application is run.

• A pathname saying where to put the delivered image.
• A delivery level .

This is an integer in the range 0 to 5. It controls how much work is done to make the image smaller during delivery. At level 0, little effort is put into making a smaller image, while at level 5 a variety of strategies are employed.

Continuing with the example:

1. Write a delivery script file ( deliver.lisp ) that loads the program and then call deliver :

(load "hello")

(deliver 'hello-world "hello" 5 :interface :capi)

(quit)

2. Run the lisp image using the script as an init file. For example, on Windows open a DOS window and type:
lispworks-4200.exe -init deliver.lisp

On UNIX or Linux, type the following into a shell:

unix% lispworks -init deliver.lisp

If you want to see the output, you can redirect the output with > to a file or use | , if it works on your system.

3. Run the application, which is saved in hello on UNIX and hello.exe on Windows.

2.2.1 Further example