LispWorks Release Notes and Installation Guide



1 Introduction

1.1 LispWorks Editions

1.1.1 Personal Edition

1.1.2 Professional Edition

1.1.3 Enterprise Edition

1.2 LispWorks for UNIX

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 adminstrator 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 Upgrading to LispWorks Enterprise Edition

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 Upgrading to LispWorks Enterprise Edition

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 on the CD-ROM

4.3.1 Professional and Enterprise Edition distributions

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 to LispWorks Enterprise Edition

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 on the CD-ROM

5.2.1 Professional and Enterprise Edition distributions

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 to LispWorks Enterprise Edition

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 on the CD-ROM

6.3.1 Professional and Enterprise Edition distributions

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 to LispWorks Enterprise Edition

7 Installation on UNIX

7.1 Introduction

7.2 Extracting software from the CD-ROM

7.2.1 Finding out which CD-ROM files you need

7.2.2 Unpacking the CD-ROM files

7.3 Moving the LispWorks image and library

7.4 Obtaining and Installing your license keys

7.4.1 Keyfiles and the license server for HP PA and Sun Sparc (32-bit) If you are using the keyfile system If you are using the License Server

7.5 Configuring the LispWorks image

7.5.1 Saving a configured image

7.5.2 Testing the newly saved image

7.6 Using the Documentation

7.7 Using Layered Products on HP PA or Sun Sparc (32-bit)

8 Configuration on Mac OS X

8.1 Introduction

8.2 License keys

8.3 Configuring your LispWorks installation

8.3.1 Levels of configuration

8.3.2 Configuring images for the different GUIs

8.3.3 Configuration files available

8.4 Saving and testing the configured image

8.4.1 Create a configuration file

8.4.2 Create and use a save-image script

8.4.3 What to do if no image is saved

8.4.4 Testing the newly saved image

8.4.5 Saving a non-windowing image

8.5 Initializing LispWorks

8.6 Loading CLIM 2.0

8.7 The Common SQL interface

8.7.1 Loading Common SQL

8.7.2 Supported databases

8.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

8.8 Common Prolog and KnowledgeWorks

9 Configuration on Windows

9.1 Introduction

9.2 License keys

9.3 Configuring your LispWorks installation

9.3.1 Levels of configuration

9.3.2 Configuration files available

9.4 Saving and testing the configured image

9.4.1 Create a configuration file

9.4.2 Create and use a save-image script

9.4.3 What to do if no image is saved

9.4.4 Testing the newly saved image

9.4.5 Saving a non-windowing image

9.5 Initializing LispWorks

9.6 Loading CLIM 2.0

9.6.1 Running the CLIM demos

9.7 The Common SQL interface

9.7.1 Loading the Common SQL interface

9.8 Common Prolog and KnowledgeWorks

10 Configuration on Linux, x86/x64 Solaris, and FreeBSD

10.1 Introduction

10.2 License keys

10.3 Configuring your LispWorks installation

10.3.1 Levels of configuration

10.3.2 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 Testing the newly saved image

10.4.4 Saving a non-windowing image

10.5 Initializing LispWorks

10.6 Loading CLIM 2.0

10.6.1 Running the CLIM demos

10.7 The Common SQL interface

10.7.1 Loading the Common SQL interface

10.8 Common Prolog and KnowledgeWorks

10.9 Documentation on x86/x86 Solaris and FreeBSD

11 Configuration on UNIX

11.1 Disk requirements

11.2 Software Requirements

11.3 The CD-ROM

11.3.1 The LispWorks 6.0 CD-ROM CD-ROM format

11.3.2 Unpacking LispWorks products

11.3.3 Mounting the CD-ROM HP UX (HP Precision Architecture) Solaris (Sun Sparc)

11.4 Installing LispWorks

11.4.1 Unpacking the TAR files Considerations to be made before extracting product files Keeping your old LispWorks installation How to extract the product files from the tar container files HP UX (HP Precision Architecture) SPARC Solaris (LispWorks 32-bit) SPARC Solaris (LispWorks 64-bit)

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

11.4.3 The License Server

11.5 Components of the LispWorks distribution

11.5.1 The LispWorks image

11.5.2 The LispWorks library

11.6 Printing copies of the LispWorks documentation

11.7 Configuring your LispWorks installation

11.7.1 Multiple-platform installations

11.7.2 Configuration files available

11.7.3 Saving and testing the configured image

11.7.4 Create a configuration file

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

11.8 LispWorks initialization arguments

12 Troubleshooting, Patches and Reporting Bugs

12.1 Troubleshooting

12.1.1 License key errors in the Professional and Enterprise Editions

12.1.2 Failure of the load-on-demand system

12.1.3 Memory requirements

12.2 Troubleshooting on Mac OS X

12.2.1 Default installation requires administrator on Mac OS X

12.2.2 Text displayed incorrectly in the editor on Mac OS X

12.3 Troubleshooting on Linux

12.3.1 Processes hanging

12.3.2 RPM_INSTALL_PREFIX not set

12.3.3 Using multiple versions of Motif on Linux

12.4 Troubleshooting on x86/x64 Solaris

12.4.1 GTK+ version

12.5 Troubleshooting on FreeBSD

12.5.1 Poor latency when using multiple threads

12.6 Troubleshooting on UNIX

12.6.1 Problems with CD-ROM file system

12.6.2 License key errors

12.7 Troubleshooting on X11/Motif

12.7.1 Problems with the X server

12.7.2 Problems with fonts on Motif

12.7.3 Problems with colors

12.7.4 Motif mnemonics and Alt

12.7.5 Non-standard X11/Motif key bindings

12.7.6 X11/Motif resources

12.7.7 Motif installation on Mac OS X

12.8 Updating with patches

12.8.1 Extracting simple patches

12.8.2 If you cannot receive electronic mail

12.8.3 Different types of patch Public patches Private patches

12.9 Reporting bugs

12.9.1 Check for existing fixes

12.9.2 Performance Issues

12.9.3 Generate a bug report template

12.9.4 Add details to your bug report

12.9.5 Reporting crashes

12.9.6 Log Files

12.9.7 Reporting bugs in delivered images

12.9.8 Send the bug report

12.9.9 Sending large files

12.9.10 Information for Personal Edition users

12.10 Transferring LispWorks to a different machine

13 Release Notes

13.1 Platform support

13.1.1 x86/x64 Solaris

13.1.2 Running on 64-bit machines

13.1.3 Older platforms

13.2 Symmetric Multiprocessing

13.2.1 Old interrupt blocking APIs removed

13.2.2 New ways to block interrupts

13.2.3 Atomic operations

13.2.4 New features of locks

13.2.5 Efficient ways to synchronize between threads

13.2.6 Access to specials

13.2.7 Processing and handling events

13.2.8 Automatic creation of a mailbox

13.2.9 Sending and interpreting events

13.2.10 mp:mailbox-read distinguishes a read value from a timeout

13.2.11 mp:process-plist deprecated

13.2.12 mp:process-event-queue deprecated

13.3 GTK+ window system

13.3.1 Using Motif instead of GTK+

13.4 New CAPI features

13.4.1 Break gesture available in CAPI Cocoa applications

13.4.2 Setting the break gestures

13.4.3 Lisp mode parenthesis coloring

13.4.4 Toolbar API for capi:interface

13.4.5 Lightweight positioning of panes

13.4.6 Grid cells spanning multiple columns or rows

13.4.7 Separators in rows and columns

13.4.8 Ratio specification for dividers and separators

13.4.9 Lists with a filter

13.4.10 Lists which do not take input focus

13.4.11 Finding the child pane with input focus

13.4.12 Automatic scrolling to show the focus pane

13.4.13 Programmatic scrolling of lists etc implemented on Cocoa

13.4.14 Edit/select operations for the active pane

13.4.15 Buffered output to improve drawing on Windows and Motif

13.4.16 Detecting key presses and releases

13.4.17 Modifiers in button and motion input-model gestures

13.4.18 Stop playing of a sound file

13.4.19 Drag'n'drop enhancements Drag'n'drop in lists and trees Drag lists of files on Cocoa Drop coordinates on Microsoft Windows

13.4.20 Matching GTK+ and Motif resources

13.4.21 Callback types including element

13.4.22 read-only editor-panes

13.4.23 Uniform error handling in dialogs

13.4.24 Dialogs that are dismissed by any input

13.4.25 Enabling menu items when a dialog is on screen

13.4.26 Support for file packages as directories on Cocoa

13.4.27 Efficient modification of a range-pane

13.4.28 Testing for support of display of text and image in menus

13.4.29 Preserving interface state during session saving

13.5 Other CAPI changes

13.5.1 Cocoa default fonts corrected

13.5.2 editor-pane scroller size

13.5.3 opengl-pane package change

13.5.4 menu items-function called earlier

13.5.5 Interpretation of repeated initargs and geometric hints

13.5.6 Change preventing premature destruction of a gp:image

13.5.7 Redisplay of image buttons, and change to accessors

13.5.8 Limiting text in a Cocoa text-input-pane

13.5.9 Change in set-rich-text-pane-character-format

13.6 More new features

13.6.1 Load and evaluate from the command line

13.6.2 Unicode character and string functions Unicode case insensitive character comparision Unicode case insensitive string comparision Unicode character predicates

13.6.3 System message log

13.6.4 Logging errors

13.6.5 Debugger command to obtain the current function object

13.6.6 Debugger wrapper

13.6.7 Profiling multiple threads

13.6.8 Profiler shows each thread separately

13.6.9 Profiler does not count calls by default

13.6.10 Profiling inside foreign calls, or not

13.6.11 Long and short forms of paths

13.6.12 Finding a directory for writing temporary files

13.6.13 Splitting saved images to allow code signing

13.6.14 Saving a Mac OS X application bundle

13.6.15 Split sequence utilities

13.6.16 Predicate for weak arrays

13.6.17 Free action for weak hash tables

13.7 IDE changes

13.7.1 ASDF integration

13.7.2 Break gesture available in the Cocoa IDE

13.7.3 Enhanced Break gesture handling

13.7.4 Mac OS X toolbars

13.7.5 Customizable toolbars

13.7.6 Preferences consolidated

13.7.7 Editor font preference changed

13.7.8 Parenthesis coloring

13.7.9 Snapshot debugging on initialization

13.7.10 The default directory for opening files

13.7.11 Prompt on exit for modified buffers not associated with a file

13.7.12 Scroller size in Editor and other tools

13.7.13 Editor status bar shows line numbers

13.7.14 New and changed Edit menu operations

13.7.15 Standard Edit gestures on Cocoa

13.7.16 More control over Process Browser automatic updates

13.7.17 Search Files with known definitions

13.7.18 Search Files option for relative or full paths

13.7.19 Search Files highlights first match for file

13.7.20 Symbol Browser sortable

13.7.21 Completion in Tracer

13.7.22 Inspecting the function in a stack frame

13.7.23 Bad interaction with pretty printer eliminated

13.7.24 Removal of breakpoints

13.7.25 Output Browser accelerator

13.7.26 Listen operations move Listener point

13.8 Editor changes

13.8.1 Change to Tab key in Lisp mode

13.8.2 New commands

13.8.3 New echo area commands

13.8.4 Position indicator shows line numbers

13.8.5 Popping marks rotates the mark ring like GNU Emacs

13.8.6 File completion shows trailing slash for directories

13.8.7 Escaped symbols recognized correctly

13.8.8 prompt-for-file :direction and :create-directories

13.8.9 Definers for editor variables

13.8.10 Buffer variable value

13.8.11 New exports

13.9 Foreign Language interface changes

13.9.1 Using arbitrary Lisp integers in the FLI

13.9.2 Enum type values and symbols

13.9.3 :ignore in define-foreign-function lambda list

13.9.4 define-foreign-variable with aggregate types

13.9.5 Pointer and array type information

13.9.6 New foreign types FLI types for ISO C size_t and ptrdiff_t ISO C99 types FLI type for ssize_t FLI type for ISO C time_t

13.9.7 define-foreign-function result-type :void

13.9.8 define-foreign-converter documented

13.9.9 Deprecated macro

13.10 COM/Automation changes

13.10.1 Building a COM server

13.10.2 com:get-object

13.10.3 Automation server example

13.11 Objective-C changes

13.11.1 Creating a standalone Objective-C executable

13.12 Common SQL changes

13.12.1 Refreshing select recomputes deferred join slots

13.12.2 Oracle on 64-bit Mac OS X

13.12.3 PostgreSQL TIMESTAMP and sql:universal-time

13.13 Application delivery changes

13.13.1 Splitting delivered images to allow code signing

13.13.2 Application control over multiprocessing startup

13.13.3 GTK+ is the default GUI on some platforms

13.13.4 Building Motif applications

13.13.5 Control of make-instance initarg checking simplified

13.14 CLOS/MOP changes

13.15 CLIM changes

13.15.1 Default I/O streams corrected.

13.16 Other changes

13.16.1 Switching off Windows themes before windows are made

13.16.2 Non-string argument in find-symbol and intern

13.16.3 Compiler messages are written to *error-output*

13.16.4 Re-reading from terminal stream on Cocoa fixed

13.16.5 Explaining failed funcall optimizations

13.16.6 Change in make-random-state

13.16.7 Escaping of printed symbols depends on macro chars

13.16.8 dotimes count type-checked

13.16.9 Changes in cl:*features*

13.16.10 Gesture Spec changes Gesture Spec keyword changes Combining both-case-p characters with Shift

13.16.11 64-bit OpenSSL on Mac OS X

13.16.12 Lambda lists corrected

13.16.13 Loading old data files

13.16.14 Deprecated APIs

13.16.15 Harlequin

13.17 Documentation changes

13.18 Known Problems

13.18.1 Runtime library requirement on Windows

13.18.2 Problems with CAPI on GTK+

13.18.3 Problems with LispWorks for Macintosh

13.18.4 Problems with the LispWorks IDE on Cocoa

13.18.5 Problems with CAPI and Graphics Ports on Cocoa

13.19 Binary Incompatibilty



LispWorks Release Notes and Installation Guide - 21 Dec 2009