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/Motif GUI The Documentation

2.4.10 Installing

2.4.11 Enter License Data

2.4.12 Add LispWorks to the Dock

2.4.13 Finishing up

2.4.14 Installing Patches

2.4.15 Obtaining OpenMotif

2.5 Starting LispWorks for Macintosh

2.5.1 Start the native Mac OS X LispWorks GUI

2.5.2 Start the X11/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 Motif libraries

4.1.2 Disk requirements during installation

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 FreeBSD

5.1 Software and hardware requirements

5.1.1 Motif libraries

5.1.2 Disk requirements during installation

5.2 License agreement

5.3 Software on the CD-ROM

5.3.1 Professional and Enterprise Edition distributions

5.4 Installing LispWorks for FreeBSD

5.4.1 Main installation and patches

5.4.2 Information for Beta testers

5.4.3 Installation software package file Installation directories Selecting the correct software package file Installing LispWorks for FreeBSD Installation by non-root users Installing Patches

5.5 LispWorks looks for a license key

5.6 Running LispWorks

5.6.1 Entering the license data

5.7 Configuring the image

5.8 Printable LispWorks documentation

5.9 Uninstalling LispWorks for FreeBSD

5.10 Upgrading to LispWorks Enterprise Edition

6 Installation on UNIX

6.1 Introduction

6.2 Extracting software from the CD-ROM

6.2.1 Finding out which CD-ROM files you need

6.2.2 Unpacking the CD-ROM files

6.3 Moving the LispWorks image and library

6.4 Obtaining and Installing your license keys

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

6.5 Configuring the LispWorks image

6.5.1 Saving a configured image

6.5.2 Testing the newly saved image

6.6 Using the Documentation

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

7 Configuration Details on Mac OS X

7.1 Introduction

7.2 License keys

7.3 Configuring your LispWorks installation

7.3.1 Levels of configuration

7.3.2 Configuring images for the different GUIs

7.3.3 Configuration files available

7.4 Saving and testing the configured image

7.4.1 Testing the newly saved image

7.4.2 Saving a non-windowing image

7.5 Initializing LispWorks

7.6 Loading CLIM 2.0

7.7 The Common SQL interface

7.7.1 Loading Common SQL

7.7.2 Supported databases

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

7.8 Common Prolog and KnowledgeWorks

8 Configuration Details on Windows

8.1 Introduction

8.2 License keys

8.3 Configuring your LispWorks installation

8.3.1 Levels of configuration

8.3.2 Configuration files available

8.4 Saving and testing the configured image

8.4.1 Testing the newly saved image

8.4.2 Saving a non-windowing image

8.5 Initializing LispWorks

8.6 Loading CLIM 2.0

8.6.1 Running the CLIM demos

8.7 The Common SQL interface

8.7.1 Loading the Common SQL interface

8.8 Common Prolog and KnowledgeWorks

9 Configuration Details on Linux and FreeBSD

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

9.4.2 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

9.9 Documentation for LispWorks for FreeBSD

10 Configuration Details on UNIX

10.1 Disk requirements

10.2 Software Requirements

10.3 The CD-ROM

10.3.1 The LispWorks 5.1 CD-ROM CD-ROM format

10.3.2 Unpacking LispWorks products

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

10.4 Installing LispWorks

10.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) Solaris (LispWorks 32-bit) Solaris (LispWorks 64-bit)

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

10.4.3 The License Server

10.5 Components of the LispWorks distribution

10.5.1 The LispWorks image

10.5.2 The LispWorks library

10.6 Printing copies of the LispWorks documentation

10.7 Configuring your LispWorks installation

10.7.1 Multiple-platform installations

10.7.2 Configuration files available

10.7.3 Saving and testing the configured image Testing the newly saved image

10.8 LispWorks initialization arguments

11 Troubleshooting, Patches and Reporting Bugs

11.1 Troubleshooting

11.1.1 License key errors in the Professional and Enterprise Editions

11.1.2 Failure of the load-on-demand system

11.1.3 Memory requirements

11.2 Troubleshooting on Mac OS X

11.2.1 Default installation requires administrator on Mac OS X

11.2.2 Failure to start when disconnected from the Internet

11.2.3 Text displayed incorrectly in the editor on Mac OS X

11.3 Troubleshooting on Linux

11.3.1 Processes hanging

11.3.2 RPM_INSTALL_PREFIX not set

11.3.3 Using multiple versions of Motif on Linux

11.3.4 Using LispWorks for Linux on FreeBSD

11.4 Troubleshooting on FreeBSD

11.4.1 Poor latency when using multiple threads

11.5 Troubleshooting on UNIX

11.5.1 Problems with CD-ROM file system

11.5.2 License key errors

11.6 Troubleshooting on X11/Motif

11.6.1 Problems with the X server

11.6.2 Problems with fonts

11.6.3 Problems with colors

11.6.4 Mnemonics and Alt

11.6.5 Non-standard X11 key bindings

11.6.6 X11 resources

11.6.7 Motif installation on Mac OS X

11.7 Updating with patches

11.7.1 Extracting simple patches

11.7.2 If you cannot receive electronic mail

11.7.3 Different types of patch Public patches Private patches

11.8 Reporting bugs

11.8.1 Check for existing fixes

11.8.2 Performance Issues

11.8.3 Generate a bug report template

11.8.4 Add details to your bug report

11.8.5 Reporting crashes

11.8.6 Log Files

11.8.7 Reporting bugs in delivered images

11.8.8 Send the bug report

11.8.9 Sending large files

11.8.10 Information for Personal Edition users

12 Release Notes

12.1 Additional support for 64-bit on Macintosh

12.1.1 64-bit Cocoa GUI

12.1.2 Universal binaries on Macintosh

12.2 Running on 64-bit machines

12.3 New CAPI features

12.3.1 OLE embedding

12.3.2 Drag and drop

12.3.3 "metafile" support on Cocoa

12.3.4 Keyboard shortcuts on Cocoa

12.3.5 The Mac OS X Dock menu

12.3.6 The Application Services menu

12.3.7 Vista icons

12.3.8 New class supports filtering

12.3.9 Color in list items on Windows

12.3.10 Automatic resizing of pinboard objects

12.3.11 Better control over size of tab and switchable layouts

12.3.12 Browsing for application bundles

12.3.13 editor-pane change callback

12.3.14 editor-pane input callbacks

12.3.15 New ways to control line wrapping in editor-pane

12.3.16 Help button for text input panes

12.3.17 Finding the active interface

12.3.18 Controlling window titles

12.3.19 Avoiding updates on a destroyed interface

12.3.20 OpenGL example updated

12.4 Other CAPI changes

12.4.1 Passing initargs to interface components

12.4.2 Reselection of single selection choice items

12.4.3 tree-view-update-an-item

12.5 New graphics ports features

12.5.1 Finding all available font names

12.5.2 Transparency on X11/Motif

12.6 More new features

12.6.1 LispWorks as a dynamic library

12.6.2 Relocation improvements

12.6.3 Larger heaps in LispWorks (32-bit) for Windows

12.6.4 Stream locking

12.6.5 Telling LispWorks about your own defining forms

12.6.6 Windows registry API

12.6.7 Optimize your code with compiler explanations

12.6.8 Extended profiling API

12.6.9 External format converters

12.6.10 Chinese encoding supported

12.6.11 OpenSSL interface extended


12.6.13 Memory management helper after loading

12.6.14 64-bit memory management API extended

12.6.15 Accessing symbol value cells across processes

12.6.16 Inspector command to display the rest of the current object.

12.7 IDE changes

12.7.1 Compilation output highlights warnings and errors

12.7.2 Compilation Conditions Browser improved

12.7.3 Dragging files to the Editor

12.7.4 Control of prompting on exit

12.7.5 Controlling the floating toolbar on Cocoa

12.7.6 Hiding toolbars

12.7.7 Recent Files menu

12.7.8 Listener File menu commands

12.7.9 Accelerator keys for tools

12.7.10 In-place completion in text input panes

12.7.11 Controlling completion behavior

12.7.12 Improved filtering of lists

12.7.13 Debugger display of frames and arguments

12.7.14 Pasting Clipboard objects

12.7.15 Defining Stepper breakpoints

12.7.16 Colors in the Symbol Browser

12.7.17 Hiding accessors in the Class Browser

12.7.18 System Browser graph menus

12.7.19 Preferences keyboard shortcut

12.7.20 Native editor emulation improvements Cursor width Highlighting of Lisp forms KDE/Gnome keys Enter key evaluates on Macintosh

12.8 Editor changes

12.8.1 Locking changed

12.8.2 Undo changed

12.8.3 In-place completion

12.8.4 New completion command

12.8.5 New location commands

12.8.6 Feedback on key bindings for commands

12.8.7 Editor defaults to Code Page encoding

12.8.8 Encoding for writing files

12.8.9 Encoding for reading files

12.8.10 Matching parentheses are both highlighted

12.8.11 Highlighting of the selected region is removed after scrolling

12.8.12 Editor filling and autofilling of comments in Lisp mode

12.8.13 Syntax of editor variable names

12.9 Foreign Language interface changes

12.9.1 Accessing 64-bit integer types

12.9.2 Slots in nested structures

12.9.3 More options for dynamic foreign objects

12.9.4 Dereferencing null pointer is an error

12.9.5 Defining opaque pointers

12.9.6 Byte packing

12.9.7 Protected dynamic foreign execution

12.10 COM/Automation changes

12.10.1 Calling property getters

12.10.2 Implementing COM interfaces not in the type library

12.10.3 New function com-object-from-pointer

12.11 Common SQL changes

12.11.1 Setting Oracle connection parameters

12.11.2 Calling SQL infix operators

12.11.3 Better handling of LIKE

12.12 Application delivery changes

12.12.1 Dynamic libraries

12.12.2 Default location of target application bundle

12.12.3 Vista icons

12.12.4 Save modified buffers action removed

12.12.5 Command line for delivery

12.12.6 Quitting LispWorks DLLs

12.12.7 Runtime generation for universities and colleges

12.13 CLOS/MOP changes

12.13.1 Forward referenced class and type predicates

12.13.2 slot-definition changes for AMOP compatibility

12.14 CLIM changes

12.14.1 accepting-values bug fix

12.15 Other changes

12.15.1 Changes in *features*

12.15.2 New fasl filename extension

12.15.3 Loading old data files

12.15.4 Loading logical pathnames

12.15.5 Changes to cl:directory

12.15.6 get-folder-path and get-user-profile-directory changed

12.15.7 Reader handles Unicode BOM

12.15.8 Array constant values

12.15.9 Accuracy and correctness of floating-point format directives

12.15.10 Parsing floats

12.15.11 define-modify-macro more strict

12.15.12 Setting file times

12.15.13 Implementing cl:file-position for user-defined stream classes

12.15.14 File encoding guesser improved

12.15.15 Command line for save-image scripts

12.15.16 setup-for-alien-threads removed

12.15.17 add-special-free-action accepts function designators

12.15.18 Data Execution Protection and LispWorks DLLs

12.15.19 Multiprocessing API changes

12.15.20 IDE tool icons removed

12.15.21 LessTif no longer supported

12.15.22 DDE error class

12.15.23 debugger :trap in 64-bit LispWorks

12.15.24 Objective-C protocols

12.16 Documentation changes

12.17 Binary Incompatibilty

12.18 Known Problems

12.18.1 Runtime library requirement on Windows

12.18.2 Problems with LispWorks for Macintosh

12.18.3 Problems with the LispWorks IDE on Cocoa

12.18.4 Problems with CAPI and Graphics Ports on Cocoa

12.19 Recyclable packaging



LispWorks Release Notes and Installation Guide - 18 Mar 2008