= Release Notes for Clozure CL 1.5 =

== Supported Platforms ==
Clozure CL 1.5 runs on the following platforms:
   * Mac OS X 10.5 and later (PowerPC and x86)
   * Linux (PowerPC and x86)
   * FreeBSD 6.x and later (x86)
   * Solaris (x86)
   * Microsoft Windows XP and later (x86)

The preferred way to get Clozure CL is via Subversion.  For example,
to get CCL for Mac OS X on x86, one would run the following command
from a shell prompt:

{{{
$ svn co http://svn.clozure.com/publicsvn/openmcl/release/1.5/darwinx86/ccl
}}}

Versions for other platforms are available by changing the `darwinx86` to
one of `linuxx86`, `freebsdx86`, `solarisx86`, `windows`, `darwinppc`, or
`linuxppc`.

Both 32 bit and 64 bit binaries are included with all versions.

See also http://trac.clozure.com/openmcl/wiki/SystemRequirements.

== Reporting Bugs ==
Please use the Trac instance at  http://trac.clozure.com/ccl to review existing bug reports and to submit new ones.

== Known Problems ==
The 32-bit Windows lisp still doesn't run on 64-bit Windows.

== Notable Changes ==
There have been numerous bug fixes and minor enhancements;  here we call out
a few that seem worth highlighting.

The fasl file and image file versions have changed.

Mac OS X 10.5 (Leopard) is now the minimum operating system version for
Macintosh systems.  The lisp kernel is build against the 10.5 SDK, so Snow Leopard
users no longer have to do anything special to rebuild it.

CL:RANDOM has been improved.
It now uses the MRG321k3p generator described in
P. L'Ecuyer and R. Touzin, "Fast Combined Multiple Recursive
Generators with Multipliers of the form a = +/- 2^d^ +/- 2^e^",
Proceedings of the 2000 Winter Simulation Conference, Dec. 2000,  683--689.
This generator has a period of about 2^185^
and its output has good statistical properties.

=== Analyzing memory ===
CCL:HEAP-UTILIZATION has grown some more options;  see the docstring.
CCL:COLLECT-HEAP-UTILIZATION is the guts of HEAP-UTILIZATION, now sold separately.

CCL:HEAP-IVECTOR-UTILIZATION lists the types and sizes of allocated heap ivectors (cf.
MAKE-HEAP-IVECTOR).

On Linux/x8664 systems, a number of utilities are available for post-mortem analysis
of Unix core files produced from a lisp process.  See MemoryUtils for documentation.






=== Cocoa IDE ===

The format of the preferences files for the Cocoa-based IDE has changed.

This will probably cause the following error message:
{{{
Error: Objective-C runtime exception:
*** -[NSKeyedUnarchiver initForReadingWithData:]: non-keyed archive cannot be decoded by NSKeyedUnarchiver
}}}
To solve it, go to ~/Library/Preferences/ and delete the preference files beginning with "com.clozure.Clozure".