All Manuals > 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 Uninstalling LispWorks for Macintosh

2.7 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 Uninstalling LispWorks for Windows

3.4 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.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 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 & 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.1 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 Build phase (delivery-time) errors

12.1.4 Memory requirements

12.1.5 Corrupted LispWorks executable

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 64-bit LispWorks for FreeBSD

13.1.2 Running on 64-bit machines

13.1.3 Professional and Enterprise development images need SSE2

13.1.4 Older platforms

13.2 Multiprocessing

13.2.1 gc-generation replaces mark-and-sweep

13.2.2 Simple processes not supported

13.2.3 Better ways to use condition variables

13.2.4 New function for peeking a mailbox

13.2.5 Mailbox names for easier debugging

13.2.6 New function barrier-block-and-wait

13.2.7 New function processes-count

13.2.8 More places for which low-level atomic operations are defined

13.2.9 Internal server processes

13.3 GTK+ window system

13.3.1 Using Motif instead of GTK+

13.4 New CAPI features

13.4.1 Drag'n'drop images

13.4.2 Drag'n'drop improvements on GTK+

13.4.3 Drag'n'drop improvements on Cocoa

13.4.4 New class browses and displays HTML on Windows and Cocoa

13.4.5 Support for multiple monitors

13.4.6 Initial geometry constraints

13.4.7 New support for input methods

13.4.8 Initarg for control of automatic resize

13.4.9 Setting the unsaved document indicator on Cocoa

13.4.10 Interacting with a title bar pathname on Cocoa

13.4.11 Specifying the drag image

13.4.12 More support for images in choices

13.4.13 Keyboard searching in a list-panel

13.4.14 Recent items in text-input-pane on Cocoa

13.4.15 Change callback in text-input-range

13.4.16 Controlling the selection in a display-pane

13.4.17 Selection functions in toolbar-component

13.4.18 Tab images in tab-layout on Windows

13.4.19 ICO image format supported in some situations on Windows

13.4.20 Alternative images for button now work on Windows

13.4.21 image-list in option-pane

13.4.22 option-pane with correct theme on Windows 7 and Vista

13.4.23 Image count in make-scaled-general-image-set

13.4.24 Color in list items on Cocoa

13.4.25 Alternating background color in lists and trees

13.4.26 Default initial width in a multi column list

13.4.27 list-view always highlights the selection

13.4.28 Automatically arranged icons in a list-view

13.4.29 Controlling slider display

13.4.30 Slider value on Microsoft Windows

13.4.31 Controlling the action buttons in prompt-with-list

13.4.32 Alternative action callback

13.4.33 text-input-choice can be read-only on Microsoft Windows

13.4.34 Text background in labelled-line-pinboard-object

13.4.35 Cocoa application message :finished-launching

13.4.36 Controlling the input method on GTK+

13.4.37 Tooltips on GTK+

13.4.38 Querying the state of a sorted-object

13.4.39 Controlling copying when the active pane is a choice

13.4.40 apply-in-pane-process-if-alive

13.4.41 Metafiles supported on GTK+

13.4.42 GDI+ metafiles on Windows

13.4.43 Native printing on GTK+

13.4.44 Predicate for availability of metafiles

13.4.45 Metafile example

13.4.46 Efficient redisplay of menu bar

13.4.47 :documentation option in define-interface

13.5 New graphics ports features

13.5.1 Quality drawing Specifying the drawing mode Querying the drawing mode

13.5.2 Anti-aliased text and drawing

13.5.3 Control over combining of drawn graphics

13.5.4 Path operations

13.5.5 Converting between more image formats

13.5.6 apply-rotation-around-point

13.5.7 Control over use of transforms

13.6 New color system features

13.6.1 Creating color specs with alpha

13.7 Other CAPI and Graphics Ports changes

13.7.1 Origin of coordinates of interfaces

13.7.2 Window sizes on Cocoa no longer include the interface toolbar

13.7.3 Default font type on Windows

13.7.4 Graphics state object documented

13.7.5 More font functions and types documented

13.7.6 copy-area added, pixblt deprecated

13.7.7 clear-rectangle deprecated

13.7.8 mask-x and mask-y deprecated

13.7.9 Using integers as colors is not allowed on Windows

13.7.10 rich-text-pane selection deprecated

13.7.11 Destroying a Cocoa application interface

13.7.12 Cocoa application interface example improved

13.7.13 delete-item-callback in extended-selection-tree-view

13.7.14 Home and End in text-input-pane

13.7.15 titled-menu-object fix

13.7.16 Initforms fix

13.7.17 Pixmap ports inherit background etc from their pane

13.7.18 Port graphics state accessor functions

13.7.19 Image Access dimension readers

13.7.20 pi-related constants documented

13.8 More new features

13.8.1 Environment access API

13.8.2 IPv6

13.8.3 Terminating a server process

13.8.4 Subclassing socket-stream

13.8.5 ASDF 2 included

13.8.6 Improved interface to temp files

13.8.7 New function hash-table-weak-kind

13.8.8 Predicate for single-thread arrays

13.8.9 Copy or append a file

13.8.10 Very large heap now supported on Linux

13.8.11 KiIlling a pipe's process

13.8.12 Named pipes on Windows

13.8.13 Impersonation on Windows

13.8.14 Locating the Program Files and Start menu folders

13.8.15 Hiding the DOS window when calling system commands

13.8.16 :use-pty argument in open-pipe

13.8.17 Test for displayed CAPI windows

13.9 IDE changes

13.9.1 Help menu improvements

13.9.2 Tool pre-selected in Preferences

13.9.3 Graph preferences pre-selected

13.9.4 "...Alt is Meta key" preference applies to all tools

13.9.5 New preference "Use separate Editor windows for each file"

13.9.6 Triple-click line selection

13.9.7 Better placement of the Find dialog

13.9.8 Compilation Conditions Browser tabs and preferences

13.9.9 Notifier buttons changed on Windows

13.9.10 Editor tool solely as buffers list

13.9.11 Controlling the style of incremental search highlight

13.9.12 Searching buffers

13.9.13 Searching very large files

13.9.14 Better handling of errors in display callbacks

13.9.15 Improved Saved Sessions GUI

13.9.16 Layout Dividers in the Interface Builder

13.10 Editor changes

13.10.1 Window splitting commands

13.10.2 Positioning of incremental search matches

13.10.3 Fixed line position mode for incremental search

13.10.4 New command deleting up to a specified character

13.10.5 Displaying operator and highlighted arguments in echo area

13.11 Foreign Language interface changes

13.11.1 Embedded dynamic modules

13.11.2 Foreign blocks

13.11.3 Controlling allocation of foreign objects

13.11.4 Dynamic library delivery: new example on Linux

13.11.5 process-foreign-code no longer supported

13.12 COM/Automation changes

13.12.1 Running an executable Automation server

13.12.2 Server can receive requests from more than one application

13.12.3 New Automation active object APIs

13.12.4 co-create-guid

13.12.5 get-object

13.12.6 Handling Automation exceptions

13.13 Objective-C changes

13.13.1 New function objc-class-method-signature

13.14 Common SQL changes

13.14.1 Prepared statements

13.14.2 MySQL library location on Windows

13.14.3 encoding for ODBC and PostgreSQL connections

13.14.4 PostgreSQL standard_conforming_strings

13.15 Application delivery changes

13.15.1 Runtimes on old x86 CPUs

13.15.2 Building a PowerPC (or universal) binary not supported on Mac OS X 10.7

13.15.3 Delivery now checks for patch loading

13.15.4 set-quit-when-no-windows has changed

13.15.5 :versioninfo extensions

13.15.6 :quit-when-no-windows with Automation servers

13.15.7 copy-file change may affect Mac OS X application bundle code

13.16 CLOS/MOP changes

13.16.1 Initarg checking extended

13.16.2 Stricter checking of generic function lambda list syntax

13.17 Other changes

13.17.1 The -build command line option loads patches

13.17.2 New check for patch loading when saving universal binary

13.17.3 Using an embedded build script with -build

13.17.4 Defining setf expanders in protected packages

13.17.5 Unsetting an environment variable in 64-bit LispWorks

13.17.6 String reader obeys default character element type

13.17.7 Change to package-use-list of COMMON-LISP package

13.17.8 Changes in *features*

13.17.9 Floating point optimization of +, - and *

13.17.10 Binary file type(s)

13.17.11 Loading old data files

13.17.12 ensure-directories-exist with :up

13.17.13 Limiting the printed length of strings

13.18 Documentation changes

13.19 Known Problems

13.19.1 Runtime library requirement on Windows

13.19.2 Problems with CAPI on GTK+

13.19.3 Problems with LispWorks for Macintosh

13.19.4 Problems with the LispWorks IDE on Cocoa

13.19.5 Problems with CAPI and Graphics Ports on Cocoa

13.20 Binary Incompatibilty



LispWorks Release Notes and Installation Guide - 23 Dec 2011