This manual contains a user guide section (previously published separately as the LispWorks User Guide ) and a reference section (previously the LispWorks Reference Manual ).
The user guide section of this manual describes the main language-level features and tools available in LispWorks, and how to use them.
These chapters describe the central programming tools and features in LispWorks:
The next chapter, Customization of LispWorks, explains how to perform some commonly required customizations, such as controlling start-up appearance of LispWorks.
The remaining user guide chapters describe features of specialist interest:
Please note that documentation for Graphics Ports is in the LispWorks CAPI User Guide and LispWorks CAPI Reference Manual .
Most of the reference section is organized by package: each chapter contains reference material for the exported symbols in a given package. The chapters are organized alphabetically by package name.
Generally one chapter covers each package, but the
WIN32
package symbols are split into four chapters, and the last chapter contains reference material for C functions. Within each chapter, the symbols are organized alphabetically (ignoring non-alphanumeric characters that are common in Lisp symbols, such as *). The chapters are:
COMMON-LISP
package. You should refer to the Common Lisp Hyperspec, supplied in HTML format with LispWorks, for full documentation about standard Common Lisp symbols.
COMPILER
package.
DBG
package, used to configure the debugging information produced by LispWorks.
DSPEC
package, which are used for naming and locating definitions.
EXTERNAL-FORMAT
package.
HCL
package.
LINK-LOAD
package. It applies to LispWorks for UNIX only (not LispWorks for Linux, FreeBSD, or x86/x64 Solaris).
LISPWORKS
package.
MP
package, giving you access to the multi-processing capabilities of LispWorks.
PARSERGEN
package, the LispWorks parser generator.
STREAM
package that provide users with the functionality to define their own streams for use by the standard I/O functions.
SYSTEM
package.
WIN32
package. It applies only to LispWorks for Windows.Many of these reference chapters should be used in conjunction with corresponding chapters in the user guide section. Reference material for some aspects of LispWorks can be found in other manuals.
The LispWorks manual set comprises the following books:
The LispWorks manuals are all available in Portable Documentation Format (PDF). You can use Adobe Reader to browse the PDF documentation online or to print it. Adobe Reader is available for free download from Adobe's web site at
www.adobe.com
.
The LispWorks manuals are also available in HTML format. Commands in the Help menu of any of the LispWorks IDE tools give you direct access to the HTML documentation, using your web browser. Details of how to use these commands can be found in the LispWorks IDE User Guide .
Please let us know if you find any mistakes in the LispWorks documentation, or if you have any suggestions for improvements.
The LispWorks manuals do not attempt to describe Lisp itself. For definitive information on Common Lisp, including CLOS, consult the American National Standard X3.226 for Common Lisp. An HTML version of this document is supplied with LispWorks and can be accessed from the Help menu.
For information on CLOS, Sonya E. Keene's book Object-Oriented Programming in Common Lisp: A Programmers' Guide is very helpful. This book is published by Addison-Wesley.
For an account of Metaobject protocols as well as a detailed study of an implementation of CLOS see Kiczales, Rivieres and Bobrow, The Art of the Meta-Object Protocol , published by MIT Press, often referred to as AMOP. The LispWorks MOP mostly conforms chapters 5 & 6 of AMOP; the differences are mentioned here in The Metaobject Protocol.
Throughout this manual you will find references such as "... the LispWorks file
foo/bar.lisp
...". This means a file
bar.lisp
in a subdirectory
foo
of the LispWorks library directory. You can obtain the full path of such a file by evaluating this form in your LispWorks image:
(sys:lispworks-file "foo/bar.lisp")
The LispWorks manuals follow the notation used in Common Lisp: the Language (2nd Edition).
Please note that your windows may differ in some respects from the illustrations given in the LispWorks manuals. This is because some details are controlled by the window manager that you are using, not by LispWorks itself.