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 Evaluation quick guide

1.4 Further details

1.5 About this Guide

1.5.1 Installation and Configuration

1.5.2 Troubleshooting

1.5.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 Launch the LispWorks installer

2.4.5 The Read Me

2.4.6 The License Agreement

2.4.7 Install Location

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

2.4.9 Installing and entering license data

2.4.10 LispWorks is added to the Dock

2.4.11 Finishing up

2.4.12 Installing Patches

2.4.13 Obtaining X11 GTK+

2.4.14 Obtaining Open Motif and Imlib2

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 (x86 and x86_64 only) 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 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.1 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, 8 & 10

14.3 Troubleshooting on Mac OS X

14.3.1 Uninstall requires administrator 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.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.1

15.2.1 Conditionalizing code for different versions of LispWorks

15.3 Platform support

15.3.1 Runtimes iOS

15.3.2 AIX/PowerPC implementation supports SMP

15.3.3 ARM64 Linux implementation

15.3.4 FreeBSD 10.x support

15.3.5 Running on 64-bit machines

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

15.4 Multiprocessing

15.4.1 Additional functions for use with mailboxes

15.4.2 Additional arguments to mp:process-send

15.4.3 Additional functions for use with unlocked queues

15.4.4 Evaluation environment for initial bindings in foreign threads

15.4.5 Newly exported system classes for synchronization objects

15.4.6 Safely using globally accessible data

15.4.7 Timers can cause themselves to be stopped

15.5 GTK+ window system

15.5.1 Using Motif instead of GTK+

15.5.2 X11/Motif requires Imlib2 instead of Imlib

15.6 New CAPI features

15.6.1 capi:stacked-tree class added

15.6.2 Customizing graph-pane edge objects

15.6.3 Waiting for a function call to return in a pane's process

15.6.4 Displaying HTML from a string

15.6.5 Set the appearance of panes inside interfaces of a specific type

15.6.6 Simplified way to update internal scroll parameters

15.6.7 Optional new directory prompter on Windows

15.6.8 Allowing a layout to change its background color

15.7 New graphics ports features

15.7.1 Writing an image to a stream using externalize-and-write-image

15.7.2 Controlling the type of image in externalize-image

15.7.3 New function to make a scaled image from part of another image

15.7.4 New functions to draw and measure glyphs on Cocoa

15.8 Other CAPI and Graphics Ports changes

15.8.1 capi:set-text-input-pane-selection works before capi:display

15.8.2 Extra options for capi:start-drawing-with-cached-display

15.8.3 capi:interface-customize-toolbar is now implemented on Cocoa

15.8.4 pane-can-scroll has been replaced by coordinate-origin

15.8.5 Korean input methods

15.8.6 Graphics Ports drawing functions with scale-thickness

15.8.7 Clearing graphics port works as documented on Windows

15.8.8 Pixels no longer copied from outside the source port

15.8.9 Drawing metafiles to pixmap graphics ports on Cocoa

15.8.10 scaled-image-set now works with extended-selection-tree-view

15.9 More new features

15.9.1 Support for remote debugging

15.9.2 Support for using Asynchronous I/O with SSL

15.9.3 Support for OpenSSL 1.1

15.9.4 Support for SNI in socket streams

15.9.5 Control over handshake time in SSL

15.9.6 User-defined declaration handlers

15.9.7 Tracing and advising subfunctions

15.9.8 Specifying function names using a declaration

15.9.9 Additional function for use with code coverage

15.9.10 Rotating bits within an integer

15.9.11 reduce-memory implemented for 64-bit LispWorks

15.9.12 New function to return the current function name

15.9.13 New function to close a pipe stream

15.9.14 New function to return a date/time string

15.9.15 Saving profiler results to a file

15.9.16 New arguments to set-up-profiler

15.9.17 New keyword to print timing information when profiling

15.9.18 New output stream variable in the Java interface

15.9.19 lw-ji:send-message-to-java-host can add text without a newline

15.9.20 Change to meaning of append in com.lispworks.Manager.addMessage

15.9.21 Changing the Java interface callbacks

15.9.22 New Java method to wait for Lisp initialization

15.9.23 New constant to represents Java null values

15.9.24 New length and predicate for simple-int32-vector and simple-int64-vector

15.9.25 Counting occurrences of a regular expression in a string

15.9.26 Trimming whitespace from a string

15.9.27 Using color and menus in text output

15.9.28 Pushing an element on the end of a list

15.9.29 Serial Port API implemented on non-Windows platforms

15.9.30 Obtaining a dspec for an object

15.9.31 The debugger now shows unused variables at debug level 3

15.9.32 Automatic detection of valid file encodings

15.9.33 New functions to handle errors while printing

15.9.34 Creating a volatile registry key

15.9.35 Accessing android.os.Build on Android

15.10 IDE changes

15.10.1 Support for remote debugging

15.10.2 Profiler layout changes

15.10.3 New way to display the Profiler results

15.10.4 New ways to filter the Profiler results

15.10.5 Storing the Profiler results in a file

15.10.6 Importing Profiler results

15.10.7 Profiling background processes

15.10.8 Improved setting of profiling parameters

15.10.9 Syntax coloring in the Listener

15.10.10 Protection from deletion of prompts

15.10.11 Position of the point after double-click in the Editor

15.10.12 Customizing text and background colors

15.10.13 New multiple-click-drag behavior in the Editor

15.10.14 Chrome, Opera and newer versions of Firefox supported

15.11 Editor changes

15.11.1 Improved editor handling of byte order mark in Unicode

15.11.2 Face objects documented

15.12 Foreign Language interface changes

15.12.1 Support for vector types

15.12.2 The fastcall calling convention

15.12.3 Support for calling variadic functions

15.12.4 Foreign blocks supported on iOS

15.12.5 Aligning fields in a structure

15.13 COM/Automation changes

15.13.1 Support for methods with the vararg attribute

15.14 Objective-C changes

15.14.1 Support for specifying method argument types for objc:invoke

15.14.2 Accessing Objective-C instance variables

15.15 Common SQL changes

15.15.1 Common SQL support for SQLite

15.15.2 Using non-ASCII strings on Microsoft SQL Server

15.15.3 Added support for fetching Oracle LOBs directly

15.15.4 varbinary(max)

15.16 KnowledgeWorks changes

15.16.1 Profiling KnowledgeWorks forward rules

15.16.2 Improved performance of forward chaining in KnowledgeWorks

15.17 Application delivery changes

15.17.1 New default for the :keep-modules deliver keyword argument

15.17.2 Saving a split dynamic library on non-Windows platforms

15.17.3 Passing extra linker arguments when making a dynamic library

15.17.4 LispWorks dlls on Linux now require specific versions of the C library symbols

15.17.5 Simplified use of LispWorks as a dynamic library in Java

15.17.6 Macintosh computers with non-ASCII names

15.18 CLIM changes

15.18.1 Evaluation within the process of a sheet

15.18.2 API for Drawing with Graphics Ports

15.18.3 Making device font text styles

15.19 Other changes

15.19.1 ensure-process-cleanup in foreign threads

15.19.2 Configuration files now explicitly qualify LW and HCL symbols.

15.19.3 Improved performance of sequence functions with :from-end

15.19.4 defparser combined rules

15.19.5 async-io-state-read-with-checking now resets the old length to 0

15.19.6 Profiling new processes

15.19.7 The profiler now defaults to monitoring all packages

15.19.8 Deprecated profiler symbols

15.19.9 Naming of flet subfunctions

15.19.10 Saving a split dynamic library on non-Windows platforms

15.19.11 Passing extra linker arguments when making a dynamic library

15.19.12 find-regexp-in-string with :case-sensitive :default

15.19.13 Reduced memory allocation on Unix platforms with large RLIMIT_NOFILE

15.19.14 lw-ji:get-java-virtual-machine can return an existing JVM

15.19.15 The default JVM library on Windows

15.19.16 cl:software-version now detects Windows 10

15.19.17 Running 32-bit ARM Linux LispWorks on 64-bit ARM Linux

15.19.18 LispWorks for Linux on some Intel CPUs

15.19.19 Hibernation on Macintosh computers

15.19.20 dbg:log-bug-form message-stream has a different default

15.19.21 Various Code Coverage bug fixes

15.19.22 Changes in *features*

15.19.23 ASDF version

15.19.24 Loading old data files

15.20 Changes in the installers

15.20.1 Package format on Mac OS X

15.20.2 Package format on FreeBSD

15.21 Documentation changes

15.21.1 Documentation improved

15.21.2 New self-contained examples

15.21.3 Removed self-contained examples

15.21.4 Corrections

15.22 Known Problems

15.22.1 Problems with CAPI on GTK+

15.22.2 Problems with LispWorks for Macintosh

15.22.3 Problems with the LispWorks IDE on Cocoa

15.22.4 Problems with CAPI and Graphics Ports on Cocoa

15.23 Binary Incompatibility


LispWorks Release Notes and Installation Guide - 19 Oct 2017