This the the onShore Development Common Lisp library (ODCL).
It provides a number of simple and basic utility functions.

Most functions are documented, although stand-alone API documentation
is not available.  If you have some good ideas about Lisp
documentation string to HTML or whatever documentation producers, we'd
be interested!


* Supported Implementations

ODCL's first-tier supported Common Lisp implementation is CMUCL,
meaning it is under daily use.  Our second-tier support implementation
is SBCL, meaning that we test this version before releasing.

The code should work for any Common Lisp implementation.  It is
rumored to work with Allegro Common Lisp and Lisp Works.  However, we
don't have dedicated people providing support for those
implementations, which is why they are not first- or second-tier
supported.  Volunteers welcome.

The foreign function interface is the least portable part of this
code.  We intend to port it to UFFI; volunteers welcome.


* Getting the Latest Version

The ODCL home page is <URL:http://alpha.onshored.com/lisp-software/>.

You can download the sources from CVS using a CVSROOT of
':pserver:anoncvs@alpha.onshored.com:/cvs'.  Do the following steps:

  cvs -d :pserver:anoncvs@alpha.onshored.com:/cvs login
  # password is 'anoncvs'
  cvs -d :pserver:anoncvs@alpha.onshored.com:/cvs co odcl


* Installing ODCL

** Debian

Install the 'cl-odcl' package.

** common-lisp-controller

Supposing you have the source in /home/adam/cvswork/odcl, run this in
the implementation or else add it to your implementation's startup
script:

  (common-lisp-controller:add-project-directory
   #p"/home/adam/cvswork/odcl"
   #p"/home/adam/cvswork/odcl"
   '("odcl")
   #p"/home/adam/cvswork/odcl")


* Using ODCL

This command should load ODCL:

Using defsystem:

  (with-compilation-unit ()
     (mk:oos :odcl :load))

Using ASDF:

  (with-compilation-unit ()
     (asdf:operate 'asdf:load-op 'odcl))


* Feedback

ODCL discussions are usually held on the LispWeb mailing list,
<URL:http://www.red-bean.com/mailman/listinfo/lispweb>, or directly
with the developers.

Bug reports and patches should be submitted at
<URL:http://bugs.onshored.com/>.

