All Manuals > Release Notes and Installation Guide

Contents

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

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

2.4.8.1 The native macOS GUI

2.4.8.2 The X11 GTK+ and Motif GUIs

2.4.8.3 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 macOS 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

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

3.2.5.1 Entering the License Data

3.2.5.2 Installation location

3.2.5.3 Installing the Documentation

3.2.5.4 Installing Patches

3.2.5.5 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

4.1.1.1 GTK+

4.1.1.2 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 Installing over previous versions

4.4.3 Information for Beta testers

4.4.4 Installation from the binary RPM file (x86 and x86_64 only)

4.4.4.1 Installation directories

4.4.4.2 Selecting the correct RPM files

4.4.4.3 Installing or upgrading LispWorks for Linux

4.4.4.4 Installing CLIM 2.0

4.4.4.5 Installing loadable Enterprise Edition modules

4.4.4.6 Documentation and saving space

4.4.4.7 Installing Patches

4.4.5 Installation from the tar files

4.4.5.1 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

5.1.1.1 GTK+

5.1.1.2 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 Installing over previous versions

5.3.3 Information for Beta testers

5.3.4 Installation directories

5.3.5 Selecting the correct software package file

5.3.6 Installing the package file

5.3.7 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

6.1.1.1 GTK+

6.1.1.2 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 Installing over previous versions

6.4.3 Information for Beta testers

6.4.4 Installation directories

6.4.5 Selecting the correct software package file

6.4.6 Installing LispWorks for FreeBSD

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 of LispWorks for Mobile Runtime

7.1 Installing LispWorks for Android Runtime

7.2 Installing LispWorks for iOS Runtime

8 Configuration on macOS

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

8.7.3.1 Location of .odbc.ini

8.7.3.2 Errors using PSQLODBC

8.7.3.3 psqlODBC version

8.7.3.4 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

9.9 Runtime library requirement on Windows

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/x64 Solaris and FreeBSD

11 Troubleshooting, Patches and Reporting Bugs

11.1 Troubleshooting

11.1.1 License key errors

11.1.2 Failure of the load-on-demand system

11.1.3 Build phase (delivery-time) errors

11.1.4 Memory requirements

11.1.5 Corrupted LispWorks executable

11.2 Troubleshooting on Windows

11.2.1 Private patches not loaded on Windows 7, 8 & 10

11.3 Troubleshooting on macOS

11.3.1 Uninstall requires administrator on macOS

11.4 Troubleshooting on Linux

11.4.1 Processes hanging

11.4.2 RPM_INSTALL_PREFIX not set

11.4.3 Using multiple versions of Motif on Linux

11.5 Troubleshooting on x86/x64 Solaris

11.5.1 GTK+ version

11.6 Troubleshooting on FreeBSD

11.7 Troubleshooting on X11/Motif

11.7.1 Problems with the X server

11.7.2 Problems with fonts on Motif

11.7.3 Problems with colors

11.7.4 Motif mnemonics and Alt

11.7.5 Non-standard X11/Motif key bindings

11.7.6 X11/Motif resources

11.7.7 Motif installation on macOS

11.8 Updating with patches

11.8.1 Extracting simple patches

11.8.2 If you cannot receive email

11.8.3 Different types of patch

11.8.3.1 Public patches

11.8.3.2 Private patches

11.9 Reporting bugs

11.9.1 Check for existing fixes

11.9.2 Performance Issues

11.9.3 Generate a bug report template

11.9.4 Add details to your bug report

11.9.5 Reporting crashes

11.9.6 Log Files

11.9.7 Reporting bugs in delivered images

11.9.8 Send the bug report

11.9.9 Sending large files

11.9.10 Information for Personal Edition users

11.10 Transferring LispWorks to a different machine

12 Release Notes

12.1 Keeping your old LispWorks installation

12.2 Updating your code for LispWorks 8.0

12.2.1 Conditionalizing code for different versions of LispWorks

12.3 Platform support

12.3.1 LispWorks for Macintosh supports Apple silicon Macs natively

12.3.2 LispWorks for Macintosh is always 64-bit

12.3.3 Runtimes for Android

12.3.4 Runtimes for iOS

12.3.5 FreeBSD 12.x support

12.3.6 SPARC Solaris and AIX no longer supported

12.3.7 Running on 64-bit machines

12.3.8 Code signing LispWorks images

12.3.8.1 Signing of the distributed executable

12.3.8.2 Signing your development image

12.3.8.3 Signing your runtime application

12.3.8.4 Required runtime entitlements on Apple silicon Macs

12.3.9 macOS universal binaries are supported again

12.3.10 macOS images are now split into two files by default

12.4 GTK+ window system

12.4.1 Using Motif instead of GTK+

12.4.2 X11/Motif requires Imlib2 except on Solaris

12.5 New CAPI features

12.5.1 New thread-safe function to force a redisplay part of an capi:output-pane

12.5.2 Row and column separators in list panels

12.5.3 Support for reorderable columns in capi:multi-column-list-panel on GTK

12.5.4 New :x-adjust initarg for capi:multi-column-list-panel

12.5.5 Specifying the initial selection in capi:prompt-with-list

12.5.6 Menus can now display with both images and text on Microsoft Windows

12.5.7 Support for dark themes in capi:interface

12.5.8 Support for dark themes in capi:set-editor-parenthesis-colors

12.5.9 Support for dark themes in capi:stacked-tree

12.5.10 New capi:rich-text-pane callback on Windows called when the user clicks a link

12.5.11 Adding additional filters in capi:list-panel and capi:filtering-layout

12.5.12 Coordinates for keyboard events in the input model take account of scrolling

12.5.13 capi:current-pointer-position always takes account of scrolling in capi:output-pane

12.5.14 Forcing scroll bars to be visible on macOS

12.6 Other CAPI and Graphics Ports changes

12.6.1 Drawing to an output-pane outside the display-callback

12.7 More new features

12.7.1 Package-local nicknames

12.7.2 Support for pinning objects while in foreign code

12.7.3 Specialized complex number array representations

12.7.4 Double-float complex number optimization in the compiler

12.7.5 The console now supports external formats on non-Windows platforms

12.7.6 Encoding file names on non-Windows platforms based on locale

12.7.7 Operating system interfaces on non-Windows based on locale

12.7.8 system:open-pipe and system:run-shell-command work with external formats

12.7.9 Specifying a timeout for system:pipe-exit-status

12.7.10 system:run-shell-command can now return a signal number

12.7.11 Support for the GB18030 character encoding

12.7.12 Configurable named services for remote debugging

12.7.13 Error handling and callbacks when starting remote debugging

12.7.14 Using SSL for remote debugging

12.7.15 Using IPv6 for remote debugging

12.7.16 Identifying object allocation in the profiler

12.7.17 Ignoring time in the garbage collector during profiling

12.7.18 Version checking in compile-file-if-needed

12.7.19 OpenSSL version defaults to 1.1 on Windows

12.7.20 Support for SSL using Apple Security Framework

12.7.21 Specifying and accessing SSL certificates

12.7.22 SSL certificate generalized time API

12.7.23 Reading DH parameters from a file

12.7.24 Detecting the SSL protocol version

12.7.25 comm:open-tcp-stream now returns information about errors

12.7.26 Listen on the same port with more than one socket

12.7.27 New function to close a socket handle

12.7.28 Newly documented customization for socket I/O error signaling

12.7.29 New condition classes in the socket interface

12.7.30 New condition classes in the Java interface

12.7.31 Calling static or non-static methods in the Java interface

12.7.32 Making a non-virtual call to a method in the Java interface

12.7.33 lw-ji:define-java-caller and lw-ji:setup-java-caller can now return lw-ji:jobject

12.7.34 Specifying a Java class loader for Lisp proxy objects

12.7.35 Access to JNI jvalue objects

12.7.36 Getting a backtrace from a Java throwable object

12.7.37 lw-ji:create-instance-jobject-list is now exported from lw-ji

12.7.38 Controlling aspects of LispWorks initialization on Android

12.7.39 New error codes from the InitLispWorks C function

12.7.40 Stricter meaning of the :link-transparency argument to cl:directory

12.7.41 Checking whether a file is a symbolic link

12.7.42 Reading a file into an array of bytes

12.7.43 cl:read-sequence and cl:write-sequence now depend on cl:stream-element-type

12.7.44 Specializing cl:read-sequence and cl:write-sequence is now documented

12.7.45 New functions to compare strings without checking the length

12.7.46 Newly documented macro if-let

12.7.47 Scheduling a repeating timer relative to the current time

12.7.48 hcl:get-temp-directory no longer returns a truename

12.7.49 Source location for macros that group other definition

12.7.50 The precompiled-regexp system class

12.7.51 "Lax whitespace" regexp searching

12.7.52 New arguments to the parser function defined by defparser

12.7.53 New system class gesture-spec

12.7.54 Limiting the number of splits in split-sequence

12.7.55 Writing messages to system log files

12.8 IDE changes

12.8.1 Support for Dark mode on macOS

12.8.2 Configurable external format for the Shell tool

12.8.3 A Commands menu has been added

12.8.4 Showing IDE interfaces in the Windows Browser

12.8.5 The Works menu when displaying user-defined interfaces on Windows

12.8.6 Identifying object allocation in the Profiler tool

12.8.7 The Profiler automatically displays the results after profiling

12.8.8 New operations in the Cumulative tab of the Profiler

12.8.9 Building universal binaries on macOS with the Application Builder

12.8.10 Customizing the string used for hidden comments in folded definitions

12.8.11 Operating on previous results in the Listener

12.9 Editor changes

12.9.1 Lax whitespace matches

12.9.2 Unique buffer names based on the directory of the file

12.9.3 Definition folding

12.9.4 Indentation of loop

12.9.5 Control how files are loaded

12.9.6 Reverting a buffer with a different external format

12.9.7 Toggling between the main and Output tabs in a Listener or Editor

12.9.8 Editor Ctrl+[ and Ctrl+] key bindings in Windows emulation mode

12.10 Foreign Language interface changes

12.10.1 :allow-null now defaults to nil for foreign strings as documented

12.10.2 Checking for a valid foreign type

12.10.3 fli:incf-pointer and fli:decf-pointer signal an error for types of size 0

12.10.4 Support for the C99 _Bool type (stdbool.h)

12.10.5 Control of when fli:install-embedded-module deletes it temporary file

12.10.6 Use of dlopen on macOS

12.11 Objective-C changes

12.11.1 objc:can-invoke-p can now be used with the result of current-super

12.11.2 objc:objc-bool on Macs based on Apple silicon

12.11.3 The :darwin-lw-objc foreign module has been removed

12.12 Common SQL changes

12.12.1 New helper functions and macro for prepared statements

12.12.2 Calling connect with :if-exists and without :name

12.12.3 New condition class signaled by connect

12.12.4 Some missing LOB functions are now exported

12.13 KnowledgeWorks changes

12.13.1 New phrase predicate

12.14 Application delivery changes

12.14.1 New values for the :interrupt-function keyword

12.15 Other changes

12.15.1 Changes in *features*

12.15.2 ASDF version

12.15.3 The loop macro no longer allows "finally do" or "finally return"

12.15.4 The loop macro now allows "of-type" with any atomic type

12.15.5 Compiler macros are no longer expanded by the setf macro

12.15.6 hcl:fast-directory-files for a non-wild pathname

12.15.7 cl:type-of now returns more specific types

12.15.8 Loading old data files

12.16 Documentation changes

12.16.1 Hyperlinks between manuals

12.16.2 The HTML documentation directory

12.16.3 Regular expression syntax

12.16.4 Physical pathnames in LispWorks

12.16.5 New self-contained examples

12.16.6 Removed self-contained examples

12.17 Known Problems

12.17.1 Problems with CAPI on GTK+

12.17.2 Problems with LispWorks for Macintosh

12.17.3 Problems with the LispWorks IDE on Cocoa

12.17.4 Problems with CAPI and Graphics Ports on Cocoa

12.18 Binary Incompatibility

Index


Release Notes and Installation Guide - 01 Dec 2021 19:38:51