Release Notes and Installation Guide
Total Page:16
File Type:pdf, Size:1020Kb
LispWorks® Release Notes and Installation Guide Version 4 .4.5 Copyright and Trademarks LispWorks Release Notes and Installation Guide Version 4.4.5 March 2005 Copyright © 2005 by LispWorks Ltd. All Rights Reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of LispWorks Ltd. The information in this publication is provided for information only, is subject to change without notice, and should not be construed as a commitment by LispWorks Ltd. LispWorks Ltd assumes no responsibility or liability for any errors or inaccuracies that may appear in this publication. The software described in this book is furnished under license and may only be used or copied in accordance with the terms of that license. LispWorks and KnowledgeWorks are registered trademarks of LispWorks Ltd. Adobe and PostScript are registered trademarks of Adobe Systems Incorporated. Other brand or product names are the registered trade- marks or trademarks of their respective holders. The code for walker.lisp and compute-combination-points is excerpted with permission from PCL, Copyright © 1985, 1986, 1987, 1988 Xerox Corporation. CLX and CLUE bear the following copyright notice, which applies to the parts of LispWorks derived therefrom: Texas Instruments Incorporated, P.O. Box 149149, MS 2151, Austin, Texas 78714-9149 Copyright © 1987, 1988, 1989, 1990, 1991 Texas Instruments Incorporated. Permission is granted to any individual or institution to use, modify and distribute this software, provided that this complete copyright and permission notice is maintained, intact, in all copies and documentation. Texas Instruments Incorporated provides this software “as is” with- out express or implied warranty. The XP Pretty Printer bears the following copyright notice, which applies to the parts of LispWorks derived therefrom: Copyright © 1989 by the Massachusetts Institute of Technology, Cambridge, Massachusetts. Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, pro- vided that this copyright and permission notice appear in all copies and supporting documentation, and that the name of M.I.T. not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. M.I.T. makes no representa- tion about the suitability of this software for any purpose. It is provided “as is” without express or implied warranty. M.I.T. disclaims all war- ranties with regard to this software, including all implied warranties of merchantability and fitness. In no event shall M.I.T. be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of con- tract, negligence or other tortious action, arising out of or in connection with the use or performance of this software. US Government Use The LispWorks Software is a computer software program developed at private expense and is subject to the following Restricted Rights Leg- end: “Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in (i) FAR 52.227-14 Alt III or (ii) FAR 52.227-19, as applicable. Use by agencies of the Department of Defense (DOD) is subject to LispWorks Ltd’s customary commercial license as contained in the accompanying license agreement, in accordance with DFAR 227.7202-1(a). For purposes of the FAR, the Software shall be deemed to be `unpublished’ and licensed with disclosure prohibitions, rights reserved under the copyright laws of the United States. LispWorks Ltd, St. John’s Innovation Centre, Cowley Road, Cambridge, CB4 0WS, England” LispWorks Ltd St. John’s Innovation Centre Cowley Road Cambridge CB4 0WS England tel: +44 1223 421860 fax: +44 870 2206189 toll-free number for calls from the US: tel: 877 759 8839 www.lispworks.com Contents 1Introduction1 LispWorks Editions 1 LispWorks for UNIX 3 Further details 3 About this Guide 4 2 Installation on Mac OS X 7 Choosing the Graphical User Interface 7 Documentation 7 Software and hardware requirements 8 Installing LispWorks for Macintosh 8 Starting LispWorks for Macintosh 11 3 Installation on Windows 15 Documentation 15 Installing LispWorks for Windows 16 4 Installation on Linux 19 Software and hardware requirements 19 License agreement 21 Software on the CD-ROM 22 Installing LispWorks for Linux 23 LispWorks looks for a license key 28 Running LispWorks 28 Configuring the image 29 Printable LispWorks documentation 30 Uninstalling LispWorks for Linux 30 5 Installation on UNIX 31 Introduction 31 Extracting software from the CD-ROM 31 Installing the image and runtime files 33 Keyfiles and License server permissions 34 Configuring the LispWorks image 35 Using the Documentation 37 Using Layered Products 37 6 Configuration Details on Mac OS X 39 Introduction 39 License keys 40 Configuring your LispWorks installation 40 Saving and testing the configured image 42 Initializing LispWorks 44 Loading CLIM 2.0 45 The Common SQL interface 46 Common Prolog and KnowledgeWorks 47 7 Configuration Details on Windows 49 Introduction 49 License keys 50 Configuring your LispWorks installation 50 Saving and testing the configured image 51 Initializing LispWorks 53 Loading CLIM 2.0 54 Loading the Common SQL interface 56 Common Prolog and KnowledgeWorks 56 8 Configuration Details on Linux 57 Introduction 57 License keys 58 Configuring your LispWorks installation 58 Saving and testing the configured image 60 Initializing LispWorks 61 Loading CLIM 2.0 62 Loading the Common SQL interface 64 Common Prolog and KnowledgeWorks 64 9 Configuration Details on UNIX 65 Memory Requirements 65 Software Requirements 66 Unpacking the CD-ROM 66 Installing LispWorks 72 Initializing LispWorks 80 10 Troubleshooting, Patches and Reporting Bugs 83 Troubleshooting 83 Troubleshooting on Mac OS X 84 Troubleshooting on Linux 85 Troubleshooting on UNIX 89 Troubleshooting on X11/Motif 90 Updating with patches 93 Reporting bugs 96 11 Release Notes 101 Changes since LispWorks 4.4 release 101 User preferences 105 New CAPI features 105 New graphics ports features 108 Objective-C interface on Mac OS X 108 SSL interface 109 IDE improvements 109 Other new features 111 Known Problems 114 Documentation Changes 118 Binary Incompatibilty 118 1 1 Introduction 1.1 LispWorks Editions LispWorks is available in four product editions on the Macintosh, Windows and Linux platforms: • Personal Edition - includes a native graphical IDE on all platforms, and COM/Automation on Windows. • Professional Edition – includes all Personal Edition features, plus Application Delivery, CLIM 2.0 on X11/Motif and Windows, and a X11/Motif GUI on Mac OS X. • Enterprise Edition – includes all Professional Edition features, plus KnowledgeWorks, LispWorks ORB, and Common SQL. • Academic Edition - includes all Enterprise Edition features except Application Delivery. Note: on non-Linux UNIX platforms (includes Solaris, HP-UX, Tru64 UNIX) LispWorks is licensed differently, as detailed in “LispWorks for UNIX” on page 3. 1 1Introduction 1.1.1 Personal Edition The LispWorks Personal Edition, distributed free of charge, allows you to explore a fully enabled Common Lisp programming environment and to develop small- to medium-scale programs for personal and academic use. Please note, however, that the Personal Edition has the following limitations designed to prevent commercial exploitation of this free product: • There is a heap size limit which, if exceeded, causes the image to exit. A warning is provided when the limit is approached. On Mac OS X, at this point there is an option to abort all processes, allowing you to stop consing and save your work before you actually reach the heap size limit. • There is a time limit of 5 hours for each session, after which the image is exited. You are warned after 4 hours of use. Note: If the image is dismissed because of heap size or time limitations, there are no exit cleanups. For example, you are not asked about saving changed buffers. Also, working and temporary files are not removed. In particular, this may result in .htm files generated by manual searches being left behind in /tmp or your TEMP folder. • The functions save-image, deliver,andload-all-patches are not available. • Initialization files are not available. • Professional and Enterprise Edition module loading is not included in the Personal Edition. 1.1.2 Professional Edition LispWorks 4.4.5 Professional Edition includes the following features: • Fully supported commercial product • Delivery of commercial end-user applications • CLIM 2.0 on X11/Motif and Windows • 30-dayfree“GettingStarted”technicalsupport 2 1.2 LispWorks for UNIX 1.1.3 Enterprise Edition LispWorks 4.4.5 Enterprise Edition provides further support for the software needs of the modern enterprise, including: • All the features of the Professional Edition • Database access through the Common SQL interface • Portable distributed computing through CORBA • Expert systems programming through KnowledgeWorks and embed- ded Prolog compiler 1.1.4 Academic Edition LispWorks 4.4.5 Academic Edition offers a solution for teaching and research institutions which require multiple seats at an economic price. It includes: • All the features of the Enterprise Edition except delivery of commercial end-user applications • Unlimited number of users at one site 1.2 LispWorks for UNIX On non-Linux UNIX platforms (includes Solaris, HP-UX, Tru64 UNIX) the Edition model described above does not apply. LispWorks for UNIX 4.4.5 is available with a basic developer license, and the add-on products CLIM, KnowledgeWorks, LispWorks ORB and Application Delivery are each separately available: 1.3 Further details For further details of LispWorks products visit the LispWorks Web Site: www.lispworks.com To purchase LispWorks please use the contact details at: www.lispworks.com/buy 3 1Introduction 1.4 About this Guide This document is an installation guide and release notes for LispWorks 4.4.5 on Mac OS X, Windows, Linux and UNIX platforms.