All Manuals > LispWorks User Guide and Reference Manual > 32 The HCL Package

NextPrevUpTopContentsIndex

save-image-with-bundle

Function
Summary

Saves a LispWorks for Macintosh image with an application bundle, thus allowing it to work properly in the Cocoa windowing system.

Package

hcl

Signature

save-image-with-bundle bundle-path &rest save-image-args &key bundle-arguments bundle-function &allow-other-keys

Arguments

bundle-path

A pathname designator.

save-image-args

Arguments passed to save-image.

bundle-arguments

Arguments passed to bundle-function .

bundle-function

A function designator.

Description

The function save-image-with-bundle first creates the application bundle using the function bundle-function , and then saves the LispWorks image in the bundle.

The default value of bundle-arguments is nil .

The default value of bundle-function is create-macos-application-bundle. You can modify the created bundle by supplying bundle-arguments .

With the default values of bundle-function and bundle-arguments , it copies the application bundle of the running image to the bundle path with the minimal necessary modifications, and then saves an image in it. save-image-with-bundle checks save-argument-real-p, so it can be used for saving universals without further checks.

save-image-with-bundle operates as follows:

  1. If save-argument-real-p returns true, it calls bundle-function with the bundle-path and bundle-arguments , and then uses the result as the filename for save-image. Otherwise the filename for save-image is nil .
  2. It applies save-image to the path derived in the first step and the remaining arguments passed to save-image-with-bundle (other than bundle-arguments and bundle-function ).

save-image-with-bundle is implemented only in LispWorks for Macintosh.

See also

create-macos-application-bundle
save-image


LispWorks User Guide and Reference Manual - 21 Dec 2011

NextPrevUpTopContentsIndex