save-current-session Function

Summary

Saves the LispWorks session.

Package

hcl

Signature

save-current-session pathname &rest save-image-args => result

Arguments

pathname⇩	A pathname designator.
save-image-args⇩	Arguments.

Values

result

A boolean.

Description

The function save-current-session closes all windows and stops multiprocessing, saves an image at the location supplied in pathname, and restarts multiprocessing and the windows. For more information see 13.4 Saved sessions.

save-image-args are passed to the saving function, which is save-image on Windows, GTK and Motif, or save-image-with-bundle on Cocoa.

save-current-session returns nil if the pathname supplied is unacceptable (not writable), otherwise it returns t. The actual operation is done asynchronously.

Notes

1. save-current-session is intended for saving the state of a windowing image. While save-current-session can be used to save a session in a console image, this achieves nothing more than save-image.
2. The released LispWorks image runs the default session. Therefore after you have used save-current-session, starting the supplied image (for example via the Windows start menu or macOS Dock) will run itself only if the default session is "LispWorks Release".

See also

save-image
save-image-with-bundle