ECL Build Notes
~~~~~~~~~~~~~~~

This snapshot builds ECL for iPhone from a set of patched sources of
Boehm GC and ECL 9.12.3. If you wish to work off the original sources,
please refer to:

  http://github.com/kriyative/ecl-iphone-builder

Now comes the actual build:

  cd ecl/
  ../build.sh --install ../iphone

Get yourself a cup of coffee, while this runs. When it's done, there
should be an iphone/ sub-directory in the build/directory, with the
following contents:

  device/bin/...
  device/include/...
  device/lib/...
  simulator/bin/...
  simulator/include/...
  simulator/lib/...
  universal/lib/libbytecmp.a
  universal/lib/libecl.a
  universal/lib/libeclgc.a
  universal/lib/libeclgmp.a
  universal/lib/libserve-event.a
  universal/lib/libsockets.a
  
The universal/lib/lib* contain FAT binaries of the static libraries,
which makes it easy to configure the Xcode project.


eclshell Build Notes
~~~~~~~~~~~~~~~~~~~~

Download and setup a SLIME source directory. The swank-ecl-patches.txt
has been submitted to the SLIME maintainers, and hopefully it will
make it into the CVS builds one of these days, and the patch step will
not be required.

  cd ../eclshell
  wget http://common-lisp.net/project/slime/snapshots/slime-current.tgz
  tar xzf slime-current.tgz
  ln -s slime-[0-9]* slime
  cd slime
  patch -p0 < ../../swank-ecl-patches.txt
  cd ..

Building the eclshell example requires a native ECL build on the host
OSX system. Configure the path to the ecl directory in the makefile.

  make			# see makefile for configuring ecl path

That should generate a libeclffi.a fat library. Now open
eclshell.xcodeproj and run a Simulator or Device build. Hopefully it
will just work, and there will be some noisy output as SLIME loads,
ending eventually with:

;; Swank started at port: 4005.

From a local emacs, run M-x slime-connect, to 127.0.0.1 (if running a
Simulator build, for device builds look at the IP address listed on
the device), port 4005.

Happy hacking.