All Manuals > LispWorks Release Notes and Installation Guide > 2 Installation on Mac OS X


2.4 Installing LispWorks for Macintosh

2.4.1 Main installation and patches

The LispWorks 7.1 installer contains each of the Editions. Additionally, there may be a patch installer which upgrades LispWorks to version 7.1.x. You need to complete the main installation before adding patches.

2.4.2 Information for Beta testers

Users of LispWorks 7.1 Beta should completely uninstall it (including any patches added to the beta installation) before installing LispWorks 7.1.

See Uninstalling LispWorks for Macintosh for instructions.

2.4.3 Information for users of previous versions

You can install LispWorks 7.1 in the same location as LispWorks 7.0 or previous versions. If you always choose the default install location, a new folder named LispWorks 7.1 (32-bit) or LispWorks 7.1 (64-bit) will be created alongside the other versions.

2.4.4 Launch the LispWorks installer

The LispWorks installer is a pkg file, with the following name:

LispWorks71-32bit_Installer.pkg (32-bit LispWorks)

LispWorks71-32bit_Installer.pkg (64-bit Lispworks)

LispWorksPersonal71_Installer.pkg (LispWorks Personal Edition)

To install LispWorks, launch this file, which should run the Mac OS X Installer application. If this does not happen, right-click on th file and choose Open With > Installer.

The Introduction page should be displayed. Click Continue to go to the next step.

2.4.5 The Read Me

The Read Me presented next by the installer is a plain text version of this LispWorks Release Notes and Installation Guide .

2.4.6 The License Agreement

Check the license agreement, then click Continue . You will be asked if you agree to the license terms. Click the Agree button only if you accept the terms of the license. If you click Disagree , then the installer will not proceed.

2.4.7 Install Location

All the files installed with LispWorks are placed in the LispWorks folder, which is named LispWorks 7.1 (32-bit), LispWorks 7.1 (64-bit) or LispWorks Personal 7.1 depending on which edition you are installing. The LispWorks folder is placed in the main Applications folder for use by all users.

Note: The Applications folder may display in the Finder with a name localized for your language version of Mac OS X.

2.4.8 Choose your installation type

The default Standard Install includes the native Mac OS X GUI and the documentation, but you can also customize the install, for examle to select the X11 GUI option.

Different executables and supporting files are supplied for the two GUI options. If you install just one of these and later decide to install the other, you can simply run the installer again. The native Mac OS X GUI

If you simply want to install LispWorks for the native Mac OS X GUI, and the documentation, click Install . The X11 GTK+ and Motif GUIs

If you want to use LispWorks with either of the alternative X11 GUIs, click Customize and select the option LispWorks with X11 IDE under Extra items .

The default X11 GUI is GTK+. Motif is also available, but is deprecated. You can select Motif at run time.

Note: to run LispWorks with an X11 GUI, you will need both of these installed:

If you use Open Motif, you will also need Imlib2 version 1.4.9 or later.

None of these are required at the time you install LispWorks, however.

The X11 GUIs are not available for the Personal Edition. The Documentation

If you use the Standard Install the documentation will be installed.

If you do not wish to install the documentation, click Customize and uncheck the LispWorks documentation option under Standard items .

2.4.9 Installing and entering license data

Now click Install .

You will be prompted for an administrator's name and password.

If you are not installing the LispWorks Personal Edition, then enter your serial number and license key when the installer asks for these details.

Your license key will be supplied to you in email from Lisp Support or Lisp Sales.

If you have problems with your LispWorks license key, send it to, showing the complete output after you enter it, preferably with a screenshot.

2.4.10 LispWorks is added to the Dock

The installer adds LispWorks to the Dock.

2.4.11 Finishing up

You should now see a message confirming that installation of LispWorks was successful. Click the Close button.

Note: LispWorks needs to be able find its library at run time and therefore the LispWorks installation should not be moved around piecemeal. If you must move it, move the entire LispWorks installation folder. If you simply want to run LispWorks from somewhere more convenient, then consider adding an alias.

2.4.12 Installing Patches

After completing the main installation of LispWorks, ensure you install the latest patches which are available for download at . Patch installation instructions are in the README file accompanying the patch download.

2.4.13 Obtaining X11 GTK+

LispWorks does not provide GTK+ libraries, so you need to install third-party libraries, such as

Note: you need the x11 gtk2 libraries, not GTK-OSX (Quartz).

2.4.14 Obtaining Open Motif and Imlib2

LispWorks 7.1 for Macintosh on X11/Motif requires Open Motif 2.3 and Imlib2 1.4.9.

The Open Motif library for LispWorks is /usr/local/lib/libXm.4.dylib.

Lisp Support can supply suitable Motif and Imlib2 libraries if you need them.

Note: The Motif GUI is deprecated. A GTK+ GUI is available.

LispWorks Release Notes and Installation Guide - 19 Oct 2017