All Manuals > LispWorks Release Notes and Installation Guide



1 Introduction

1.1 LispWorks Editions

1.1.1 Personal Edition

1.1.2 Hobbyist Edition

1.1.3 HobbyistDV Edition

1.1.4 Professional Edition

1.1.5 Enterprise Edition

1.1.6 32-bit LispWorks for SPARC Solaris

1.2 LispWorks for Mobile Runtime

1.3 Further details

1.4 About this Guide

1.4.1 Installation and Configuration

1.4.2 Troubleshooting

1.4.3 Release Notes

2 Installation on Mac OS X

2.1 Choosing the Graphical User Interface

2.2 Documentation

2.3 Software and hardware requirements

2.4 Installing LispWorks for Macintosh

2.4.1 Main installation and patches

2.4.2 Information for Beta testers

2.4.3 Information for users of previous versions

2.4.4 Use an administrator account

2.4.5 Launch the LispWorks installer

2.4.6 The Read Me

2.4.7 The License Agreement

2.4.8 Select Destination

2.4.9 Choose your installation type The native Mac OS X GUI The X11 GTK+ and Motif GUIs The Documentation

2.4.10 Installing and entering license data

2.4.11 Add LispWorks to the Dock

2.4.12 Finishing up

2.4.13 Installing Patches

2.4.14 Obtaining X11 GTK+

2.4.15 Obtaining Open Motif and Imlib

2.5 Starting LispWorks for Macintosh

2.5.1 Start the native Mac OS X LispWorks GUI

2.5.2 Start the GTK+ LispWorks GUI

2.5.3 Start the Motif LispWorks GUI

2.6 Uninstalling LispWorks for Macintosh

2.7 Upgrading the LispWorks Edition

2.8 Upgrading to 64-bit LispWorks

3 Installation on Windows

3.1 Documentation

3.2 Installing LispWorks for Windows

3.2.1 Main installation and patches

3.2.2 Visual Studio runtime components and Windows Installer

3.2.3 Installing over previous versions

3.2.4 Information for Beta testers

3.2.5 To install LispWorks Entering the License Data Installation location Installing the Documentation Installing Patches Starting LispWorks

3.3 Uninstalling LispWorks for Windows

3.4 Upgrading the LispWorks Edition

3.5 Upgrading to 64-bit LispWorks

4 Installation on Linux

4.1 Software and hardware requirements

4.1.1 GUI libraries GTK+ Motif

4.1.2 Disk requirements

4.2 License agreement

4.3 Software delivery and installer formats

4.3.1 Contents of the LispWorks distribution

4.4 Installing LispWorks for Linux

4.4.1 Main installation and patches

4.4.2 Information for Beta testers

4.4.3 Installation from the binary RPM file Installation directories Selecting the correct RPM files Installing or upgrading LispWorks for Linux Installing CLIM 2.0 Installing loadable Enterprise Edition modules Documentation and saving space Installing Patches

4.4.4 Installation from the tar files Installing Patches

4.5 LispWorks looks for a license key

4.6 Running LispWorks

4.6.1 Entering the license data

4.7 Configuring the image

4.8 Printable LispWorks documentation

4.9 Uninstalling LispWorks for Linux

4.10 Upgrading the LispWorks Edition

4.11 Upgrading to 64-bit LispWorks

5 Installation on x86/x64 Solaris

5.1 Software and hardware requirements

5.1.1 GUI libraries GTK+ Motif

5.1.2 Disk requirements

5.2 Software delivery and installer format

5.2.1 Contents of the LispWorks distribution

5.2.2 Personal Edition distribution

5.3 Installing LispWorks for x86/x64 Solaris

5.3.1 Main installation and patches

5.3.2 Information for Beta testers

5.3.3 Installation directories

5.3.4 Selecting the correct software package file

5.3.5 Installing the package file

5.3.6 Installing Patches

5.4 LispWorks looks for a license key

5.5 Running LispWorks

5.5.1 Entering the license data

5.6 Configuring the image

5.7 Printable LispWorks documentation

5.8 Uninstalling LispWorks for x86/x64 Solaris

5.9 Upgrading the LispWorks Edition

5.10 Upgrading to 64-bit LispWorks

6 Installation on FreeBSD

6.1 Software and hardware requirements

6.1.1 GUI libraries GTK+ Motif

6.1.2 Disk requirements

6.2 License agreement

6.3 Software delivery and installer format

6.3.1 Contents of the LispWorks distribution

6.3.2 Personal Edition distribution

6.4 Installing LispWorks for FreeBSD

6.4.1 Main installation and patches

6.4.2 Information for Beta testers

6.4.3 Installation directories

6.4.4 Selecting the correct software package file

6.4.5 Installing LispWorks for FreeBSD

6.4.6 Installation by non-root users

6.4.7 Installing Patches

6.5 LispWorks looks for a license key

6.6 Running LispWorks

6.6.1 Entering the license data

6.7 Configuring the image

6.8 Printable LispWorks documentation

6.9 Uninstalling LispWorks for FreeBSD

6.10 Upgrading the LispWorks Edition

6.11 Upgrading to 64-bit LispWorks

7 Installation on AIX

7.1 Software and hardware requirements

7.1.1 GUI libraries GTK+ Motif

7.1.2 Disk requirements

7.2 License agreement

7.3 Software delivery and installer format

7.3.1 Contents of the LispWorks distribution

7.4 Installing LispWorks for AIX

7.4.1 Main installation and patches

7.4.2 Information for Beta testers

7.4.3 Installation directories

7.4.4 Selecting the correct archives

7.4.5 Installing the archive

7.4.6 Installing Patches

7.5 LispWorks looks for a license key

7.6 Running LispWorks

7.6.1 Entering the license data

7.7 Configuring the image

7.8 Printable LispWorks documentation

7.9 Uninstalling LispWorks for AIX

7.10 Upgrading the LispWorks Edition

7.11 Upgrading to 64-bit LispWorks

8 Installation on SPARC Solaris

8.1 Introduction

8.2 Extracting software from the CD-ROM

8.2.1 Finding out which CD-ROM files you need

8.2.2 Unpacking the CD-ROM files

8.3 Moving the LispWorks image and library

8.4 Obtaining and Installing your license keys

8.4.1 Keyfiles and the license server on SPARC If you are using the keyfile system If you are using the License Server

8.4.2 Installing the license key on Sun Sparc (64-bit)

8.5 Configuring the LispWorks image

8.5.1 Saving a configured image

8.5.2 Testing the newly saved image

8.6 Using the Documentation

8.7 Using Delivery, LispWorks ORB, CLIM 2.0, KnowledgeWorks and Common SQL

8.7.1 Using Layered Products in 32-bit LispWorks on SPARC

8.7.2 Using Layered Products in 64-bit LispWorks on SPARC

9 Installation of LispWorks for Mobile Runtime

9.1 Installing LispWorks for Android Runtime

9.2 Installing LispWorks for iOS Runtime

10 Configuration on Mac OS X

10.1 Introduction

10.2 License keys

10.3 Configuring your LispWorks installation

10.3.1 Levels of configuration

10.3.2 Configuring images for the different GUIs

10.3.3 Configuration files available

10.4 Saving and testing the configured image

10.4.1 Create a configuration file

10.4.2 Create and use a save-image script

10.4.3 What to do if no image is saved

10.4.4 Testing the newly saved image

10.4.5 Saving a non-windowing image

10.5 Initializing LispWorks

10.6 Loading CLIM 2.0

10.7 The Common SQL interface

10.7.1 Loading Common SQL

10.7.2 Supported databases

10.7.3 Special considerations when using Common SQL Location of .odbc.ini Errors using PSQLODBC PSQLODBC version Locating the Oracle, MySQL or PostgreSQL client libraries

10.8 Common Prolog and KnowledgeWorks

11 Configuration on Windows

11.1 Introduction

11.2 License keys

11.3 Configuring your LispWorks installation

11.3.1 Levels of configuration

11.3.2 Configuration files available

11.4 Saving and testing the configured image

11.4.1 Create a configuration file

11.4.2 Create and use a save-image script

11.4.3 What to do if no image is saved

11.4.4 Testing the newly saved image

11.4.5 Saving a non-windowing image

11.5 Initializing LispWorks

11.6 Loading CLIM 2.0

11.6.1 Running the CLIM demos

11.7 The Common SQL interface

11.7.1 Loading the Common SQL interface

11.8 Common Prolog and KnowledgeWorks

11.9 Runtime library requirement on Windows

12 Configuration on Linux, x86/x64 Solaris, FreeBSD & AIX

12.1 Introduction

12.2 License keys

12.3 Configuring your LispWorks installation

12.3.1 Levels of configuration

12.3.2 Configuration files available

12.4 Saving and testing the configured image

12.4.1 Create a configuration file

12.4.2 Create and use a save-image script

12.4.3 Testing the newly saved image

12.4.4 Saving a non-windowing image

12.5 Initializing LispWorks

12.6 Loading CLIM 2.0

12.6.1 Running the CLIM demos

12.7 The Common SQL interface

12.7.1 Loading the Common SQL interface

12.8 Common Prolog and KnowledgeWorks

12.9 Documentation on x86/x64 Solaris, FreeBSD and AIX

13 Configuration on SPARC Solaris

13.1 Disk requirements

13.2 Software Requirements

13.3 The CD-ROM

13.3.1 The LispWorks 7.0 CD-ROM CD-ROM format

13.3.2 Unpacking LispWorks products

13.3.3 Mounting the CD-ROM

13.4 Installing LispWorks

13.4.1 Unpacking the archive Considerations to be made before extracting product files How to extract the product files from the tar container files SPARC Solaris (LispWorks 32-bit) SPARC Solaris (LispWorks 64-bit)

13.4.2 Keyfiles and how to obtain them Where LispWorks looks for keyfiles The contents of a keyfile How to obtain keys

13.4.3 The License Server

13.5 Components of the LispWorks distribution

13.5.1 The LispWorks image

13.5.2 The LispWorks library

13.6 Printing copies of the LispWorks documentation

13.7 Configuring your LispWorks installation

13.7.1 Multiple-platform installations

13.7.2 Configuration files available

13.7.3 Saving and testing the configured image

13.7.4 Create a configuration file

13.7.5 Create and use a save-image script Testing the newly saved image

13.8 LispWorks initialization arguments

14 Troubleshooting, Patches and Reporting Bugs

14.1 Troubleshooting

14.1.1 License key errors

14.1.2 Failure of the load-on-demand system

14.1.3 Build phase (delivery-time) errors

14.1.4 Memory requirements

14.1.5 Corrupted LispWorks executable

14.2 Troubleshooting on Windows

14.2.1 Private patches not loaded on Windows 7 & Windows 8

14.3 Troubleshooting on Mac OS X

14.3.1 Default installation requires administrator on Mac OS X

14.3.2 Text displayed incorrectly in the editor on Mac OS X

14.4 Troubleshooting on Linux

14.4.1 Processes hanging

14.4.2 RPM_INSTALL_PREFIX not set

14.4.3 Using multiple versions of Motif on Linux

14.5 Troubleshooting on x86/x64 Solaris

14.5.1 GTK+ version

14.6 Troubleshooting on FreeBSD

14.6.1 Poor latency when using multiple threads

14.7 Troubleshooting on SPARC Solaris

14.7.1 Problems with CD-ROM file system

14.7.2 License key errors

14.8 Troubleshooting on X11/Motif

14.8.1 Problems with the X server

14.8.2 Problems with fonts on Motif

14.8.3 Problems with colors

14.8.4 Motif mnemonics and Alt

14.8.5 Non-standard X11/Motif key bindings

14.8.6 X11/Motif resources

14.8.7 Motif installation on Mac OS X

14.9 Updating with patches

14.9.1 Extracting simple patches

14.9.2 If you cannot receive email

14.9.3 Different types of patch Public patches Private patches

14.10 Reporting bugs

14.10.1 Check for existing fixes

14.10.2 Performance Issues

14.10.3 Generate a bug report template

14.10.4 Add details to your bug report

14.10.5 Reporting crashes

14.10.6 Log Files

14.10.7 Reporting bugs in delivered images

14.10.8 Send the bug report

14.10.9 Sending large files

14.10.10 Information for Personal Edition users

14.11 Transferring LispWorks to a different machine

15 Release Notes

15.1 Keeping your old LispWorks installation

15.2 Updating your code for LispWorks 7.0

15.2.1 Conditionalizing code for different versions of LispWorks

15.3 Platform support

15.3.1 Runtimes for Android and iOS

15.3.2 AIX/PowerPC implementation

15.3.3 ARM Linux implementation

15.3.4 Running on 64-bit machines

15.3.5 Code signing LispWorks images Signing of the distributed executable Signing your development image Signing your runtime application

15.3.6 Mac OS X universal binaries no longer supported

15.3.7 Older platforms

15.4 Multiprocessing

15.4.1 Modifying hash tables with multiprocessing

15.4.2 Communication between processes

15.5 GTK+ window system

15.5.1 Using Motif instead of GTK+

15.6 New CAPI features

15.6.1 Touch gestures

15.6.2 editor-pane allows more fonts on Cocoa

15.6.3 Full screen windows on Cocoa

15.6.4 Transient display on output panes

15.6.5 Scroll hints for output panes and layouts

15.6.6 Minima for column width and row height

15.6.7 Improvements in multi-column-list-panel

15.6.8 Accessing a sorted-object to determine the sorting

15.6.9 Pinboard display-callback changed - no longer use capi::pinboard-pane-display

15.6.10 Modifying pinboard display

15.6.11 Modifying resize behavior of an output pane

15.6.12 Cleaning up objects associated with a pinboard layout

15.6.13 Modifier change callbacks in output-pane

15.6.14 Detecting modifier state

15.6.15 Querying fonts, text and image size, before display

15.6.16 Finding an active screen

15.6.17 Predicate for availability of browser-pane

15.6.18 Restoring disabled display of a pane

15.6.19 New default menu accelerators on Windows and GTK+

15.6.20 Cancelling a popup menu

15.6.21 New initargs to toolbar and toolbar-component

15.6.22 Display a transient message in a non-focus window

15.6.23 Positioning a non-focus list prompter

15.6.24 Experiment with your code displayed as a dialog

15.6.25 Filters in multiple file prompter

15.6.26 Stop an ongoing composition

15.7 New graphics ports features

15.7.1 New Graphic Tools API

15.7.2 invalidate-rectangle-from-points

15.7.3 port-owner

15.8 Other CAPI and Graphics Ports changes

15.8.1 Tree view RSS reader example

15.8.2 Windows 8 style improvements

15.8.3 Premultiplication of Image Access pixel values

15.8.4 Transparency from an external image

15.8.5 Flagging an editor-pane for application-only use

15.8.6 Text printing now makes a new page for formfeed

15.8.7 text-input-pane default limit increased on Windows

15.8.8 draw-image width and height default values

15.8.9 find-matching-fonts weight and slant default values on Windows

15.8.10 Temporary editor buffer for an editor-pane

15.8.11 Representing modified keyboard input

15.8.12 Changing the input model of a graph pane

15.8.13 Additional space inside frames

15.8.14 title-pane does not support :pane-menu on Microsoft Windows.

15.8.15 File dialog placement on Windows XP

15.8.16 Graphics Port classes documented

15.8.17 Bitmap ports deprecated

15.8.18 Dithers deprecated

15.8.19 Font single- and dual-width predicates deprecated

15.8.20 collection-search deprecated

15.8.21 pane-close-display deprecated

15.8.22 pane-adjusted-position, pane-adjusted-offset deprecated

15.8.23 pinboard-pane-position and pinboard-pane-size deprecated

15.8.24 pane-string deprecated

15.8.25 capi:*update-screen-interfaces-hooks* deprecated

15.8.26 interactive-pane synonyms dropped

15.9 More new features

15.9.1 Java interface

15.9.2 Android interface

15.9.3 iOS interface

15.9.4 Unicode support extended External formats :unicode and :bmp

15.9.5 Case-insensitive character comparisons and categories

15.9.6 Code Coverage

15.9.7 Asynchronous I/O on socket streams

15.9.8 Funcall a function asynchronously

15.9.9 Fast access to files in a directory

15.9.10 Unlocked queues

15.9.11 find-regexp-in-string improvement

15.9.12 Optimal 64-bit arithmetic

15.9.13 KOI8-R encoding supported

15.9.14 run-shell-command implemented for Windows

15.9.15 Change to run-shell-command with :save-exit-status t

15.9.16 Command line parsing on Windows

15.9.17 Windows event log API

15.9.18 Rings

15.9.19 find-encoding-option now looks for "coding"

15.9.20 Process terminate methods

15.9.21 Predicate for dynamically bound symbols

15.9.22 Efficient access for 8-bit simple vectors

15.9.23 Reducing size of 32-bit LispWorks when memory is low

15.9.24 Timing Garbage Collector operations

15.9.25 Temporarily suspending profiling

15.9.26 New macro dspec:replacement-source-form

15.9.27 Representing the state of Caps Lock

15.9.28 Test for delivered images

15.9.29 load-data-file additional functionality and package change

15.9.30 Compile and load without leaving the fasl file on disk

15.9.31 New function socket-stream-shutdown

15.9.32 backlog argument to TCP server functions

15.10 IDE changes

15.10.1 New check for Cocoa Event Loop hanging

15.10.2 Additional notifier controls

15.10.3 More fonts available in the Editor and other tools

15.10.4 New Code Coverage tool

15.10.5 Buffers list option in Editor

15.10.6 Preferences option to use quality drawing

15.10.7 Listener current package preserved in Saved Sessions

15.10.8 Session saving warns when Debugger or Stepper has state

15.10.9 Setting breakpoints in the Stepper

15.10.10 Tool accelerator keys in KDE/Gnome emulation

15.10.11 Find window text pre-selected

15.10.12 Search Files tool reports file count after failed search

15.10.13 Menu command to install private patches on Windows

15.10.14 Erroneous restart removed

15.11 Editor changes

15.11.1 Improved Unicode support

15.11.2 Editor bindings for keystrokes with modifiers

15.11.3 Directory mode

15.11.4 clear-undo exported and documented

15.11.5 Clear Undo command prompts

15.11.6 Un-Kill As ... commands

15.11.7 Save Buffer Pathname command

15.11.8 Find Source For Current Package

15.11.9 New Code Coverage commands

15.11.10 Regular expression improvement

15.11.11 Editor commands now search *.cpp files

15.11.12 Editor file functions renamed

15.12 Foreign Language interface changes

15.12.1 64-bit integer FLI types fully supported in 32-bit LispWorks

15.12.2 Structure pointer allowed when passing structures by value

15.12.3 Creating a pointer to a defined foreign symbol

15.12.4 make-pointer requires address or symbol-name

15.12.5 KOI8-R encoding supported

15.12.6 Incorporating a foreign module into the image with defsystem

15.12.7 New type descriptor fli:released-foreign-block-pointer

15.13 COM/Automation changes

15.13.1 Getting information about i-dispatch methods

15.13.2 Reporting of failures (un)registering a server

15.13.3 New ways to specify search paths for IDL import statements

15.13.4 New :not-specified value for optional Automation arguments

15.14 Common SQL changes

15.14.1 Converting between universal time and DATE or TIMESTAMP

15.14.2 Fix for list-attribute-types with PostgreSQL and MySQL

15.14.3 Warning re list-attribute-types with Access

15.14.4 SQL [...] syntax for = and <> generates IS NULL when used with nil

15.15 Application delivery changes

15.15.1 New ways to keep symbols and symbol names

15.15.2 Retaining cross-reference information in a delivered image

15.15.3 :versioninfo no longer supports :file-os

15.15.4 LispWorks for Windows DLLs can use private assembly

15.15.5 Creating a Mac OS X application bundle.

15.16 CLOS/MOP changes

15.16.1 Efficient copying of slot values

15.16.2 Computing the effective method function

15.17 CLIM changes

15.17.1 Drawing with LispWorks Graphics Ports in CLIM

15.18 Other changes

15.18.1 Change to default values of standard streams

15.18.2 Implementation packages in *packages-for-warn-on-redefinition*

15.18.3 process-terminate replaces process-kill

15.18.4 ensure-process-cleanup changed lambda list

15.18.5 Some calls to comm:start-up-server no longer allow IPv4 connections

15.18.6 Getting the local default IPv6 address.

15.18.7 Array allocation in a specific generation deprecated

15.18.8 Sequence and structure predicates documented

15.18.9 Changes in *features*

15.18.10 Loading old data files

15.18.11 fasl-error exported

15.18.12 find-throw-tag exported

15.19 Changes in the installers

15.19.1 Signing of the installer

15.19.2 Dependencies in the 64-bit Linux rpm have been fixed

15.20 Documentation changes

15.20.1 MOP documentation now on Help menu

15.20.2 HTML user guides improved

15.20.3 CAPI manuals consolidated and extended

15.20.4 Documentation improved

15.20.5 New self-contained examples

15.20.6 Newly documented functions

15.20.7 Newly documented Editor commands

15.21 Known Problems

15.21.1 Problems with CAPI on GTK+

15.21.2 Problems with LispWorks for Macintosh

15.21.3 Problems with the LispWorks IDE on Cocoa

15.21.4 Problems with CAPI and Graphics Ports on Cocoa

15.22 Binary Incompatibility



LispWorks Release Notes and Installation Guide - 2 Mar 2015