Keywords: HowToBuildFromSource

# 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
`