1 The hard way: configure, build, install

Unix Squeak is built using the (almost) universal ``configure; make; make install''. If you haven't come across this before, read on...

Create a build directory (which we will call `blddir' from now on) and then `cd' to it:


  $ mkdir blddir
  $ cd blddir

A convenient place is just next to the platforms directory, like this:


  $ cd squeak
  $ ls
  platforms src ...
  $ mkdir bld
  $ cd bld

Create the build environment by running the script configure which lives in the platforms/unix/config directory.

Note: The configure script accepts lots of options. To see a list of them, run: `configure --help'

Assuming you've created the blddir next to platforms, this would be:


  $ ../platforms/unix/config/configure

Note: This assumes that the VMMaker sources are in `../src'. However, since the Unix Squeak support code is independent of the image version from which VMMaker generated the interpreter/plugin sources, it is possible that your source distribution comes with more than one src directory (corresponding to more than one image version used to generate the sources). In such cases you will have to tell configure which source version to use, via the `--with-src' option. For example, if there are two source directories called src-3.2gamma-4857 and src-3.3.alpha-4881 then you would use one of the following commands:

  $ .../configure --with-src=src-3.2gamma-4857
        or
  $ .../configure --with-src=src-3.3alpha-4881

Build the VM and plugins by running make:


  $ make

Note: If you want to build just the VM (without external plugins) or just the external plugins (without the VM) then you can use: `make squeak' or `make plugins' respectively.

Finally install the VM, plugins and manual pages:


  $ su root
  $ make install

2009-08-12