[[PageOutline]]

== About Clozure CL ==
Clozure CL is a [wiki:License free] Common Lisp implementation.

See http://ccl.clozure.com/ for more information about it, including
instructions on how to get a copy of the current  release.

=== Released Version ===
The most recent released version of Clozure CL is [wiki:ReleaseNotes/1.9 version 1.9].

=== Development Version ===

Some users may wish to run the development version of Clozure CL, which is often called the "trunk".

To get the trunk version of Clozure CL for Darwin/x86, you'd type
(where the `$` is the shell prompt):
{{{
$ svn co http://svn.clozure.com/publicsvn/openmcl/trunk/darwinx86/ccl
}}}

To get a version for a different platform, change the `darwinx86` to `linuxx86`, `freebsdx86`, `solarisx86`, `windows`, `linuxppc`, or `linuxarm`.

If you choose to run the trunk, please read about [TrackingTheTrunk tracking the development version].


== Documentation ==
The Clozure CL manual is available as a single web page at http://ccl.clozure.com/ccl-documentation.html or as multiple pages at http://ccl.clozure.com/manual/.  As of Clozure CL 1.2, the !DocBook sources for the manual are included with the distribution.

We have started to collect a list of FrequentlyAskedQuestions.

== Support ==

=== Mailing Lists ===
There are two CCL-related mailing lists hosted at clozure.com.  Click on a list's link to subscribe or to view archived messages.

   * [http://clozure.com/mailman/listinfo/openmcl-devel openmcl-devel@clozure.com] is for general and technical discussion of Clozure CL.
   * [http://clozure.com/mailman/listinfo/openmcl-announce openmcl-announce@clozure.com] is a low-volume list for release announcements.

=== IRC ===
Everyone interested in Clozure CL is welcome to participate in #ccl on irc.freenode.net.  The [http://ccl.clozure.com/irc-logs/ccl/ channel logs] are available.  We also keep [http://ccl.clozure.com/irc-logs/lisp/ logs for #lisp] and [http://ccl.clozure.com/irc-logs/scheme/ logs for #scheme].

=== Bug Reports ===
To report a bug or request a feature, please [http://trac.clozure.com/openmcl/newticket create a ticket].  You must first [http://trac.clozure.com/openmcl/register register] (thanks, spammers).

=== Paid Support ===
[http://www.clozure.com/ Clozure Associates] provides commercial support and consulting services for Clozure CL as well as other Common Lisp implementations.  These services can range from helping you debug your software to adding extensions to CCL, to providing several full time Lisp programmers to help you build your application.  Please contact us at [mailto:business@clozure.com business@clozure.com] for more information.

== Starting Points ==
==== CCL Basics ====

    * [GettingAroundInOpenMcl Getting Around in CCL] - quick tips for working with CCL's toplevel.
    * [InstallingSlime Installing Slime] -- Install Slime and configure it for use with CCL.
    * [HintsForOpenmclUsers CCL Hints] -- Tips and Tricks from Clozure CL Experts (and wanna-be's). 
    * [CommandLineInspect The Inspector] -- How to use CCL's Inspector.
    * [BuildingLargeProjects Building Large Projects] -- How to construct software consisting of multiple Lisp source files.
    * [UpdatingFromSource Tracking CCL changes] -- How to keep up with the latest changes.
    * [TrackingTheTrunk Tracking the development version] -- There are reasons why the trunk is called the "bleeding edge".
    * [WindowsNotes Windows Notes] -- some notes on installing and running Clozure CL on Windows

==== Contributing to CCL ====
    * [WriteAccess Committing your own changes into SVN] -- Let us know if you want write access to the SVN repository.

==== In-Depth CCL ====
    * [OpenMclFfi Clozure CL FFI] -- Working with external libraries
    * [wiki:Cocoa Cocoa Bridge] -- Create Rich User Interfaces with the Cocoa Bridge
    * [EasyGui Easy GUI] -- Create slightly less Rich Interfaces with Easy GUI
    * [AppleCurrencyConverter Apple's Currency Converter in Lisp] -- Build Apple's Currency Converter tutorial example in Lisp
    * [OpenMclInternals Clozure CL Internals] -- Learn the magic behind the scenes
    * [DeclareOptimize Declare Optimize] -- What do optimization declarations do and how is this implemented
    * [ThreadsAndSetf Threads and Setf] -- In what ways is assignment atomic?
    * [HowFastAreWe How Fast Are We] compared to other Lisps?
    * [CocoaIdeInternals IDE Internals and architecture] -- How the CCL IDE works
    * [HemlockProgrammer IDE (Hemlock) Command Implementor's Manual]  -- detailed documentation on CCL's editor
    * [IdeDoc IDE Doc Under Development] -- future IDE manual sections, work in progress.
    * [CclUnderGdb Running CCL Under GDB]
    * [VectorStreams Vector Streams] -- CCL's bivalent byte vector streams
    * [MemoryUtils Memory Utilities] -- Find out what kinds of objects are filling up your memory
    * [CodeCoverage Code Coverage] -- Find out which parts of your source are being invoked
    * [ForeignFunctionInterface Notes on the FFI] -- Some notes on using the FFI, using the BLAS library as an example.
    * [wiki:BuildFFIGEN Building the FFI translator] - Build the "ffigen" interface translator from source.
    * CustomFramework -- Use ffigen to build interfaces for additional frameworks

==== Orient Yourself to Clozure CL Culture ====
    * [HistoryOfOpenMcl The History of CCL]
    * [OpenMclPeople People in the CCL community]
    * [OpenMclProjects CCL Projects] -- Projects using CCL
    * ToDo -- Things that need to be done, should be done, someone's doing, or someone should be doing
    * [SuccessfulLisp Successful Lisp Translations]