I've just heard of squeak from "FLOSS Weekly" (twit.tv) and it sounds fun, but I had a deuce of a time installing it. I'm installing from the Linux command line (I use Slackware).

I couldn't find any instructions, and the instructions in the INSTALL script are bilge, so I wrote my own instructions. If these are correct (someone verify, I'm a squeak newbie) and there isn't a better set out there, feel free to put these on the web page or wiki so others won't have to pull out their hair.

Bad installs make a rotten first impression.

Dale

* INSTALLING SQUEAK FROM THE LINUX COMMAND LINE

This describes how to install the "Linux" distribution of Squeak.

Down load the "Linux" Virtual Machine and "Basic Image File" from http://www.squeak.org/Download/. In my case the files were Squeak-3.9-8.i686-pc-linux-gnu.tar.gz and Squeak3.9-final-7067.zip respectively.

Make a temp directory and copy the tar.gz and zip file into it.

mkdir /tmp/squeak_tmp cp Squeak-3.9-8.i686-pc-linux-gnu.tar.gz /tmp/squeak cp Squeak3.9-final-7067.zip /tmp/squeak

Change directory into it.

cd /tmp/squeak_tmp

Unpack the virtual machine. This makes a directory called Squeak-3.9-8.

squeak_tmp> gzip -cd Squeak-3.9-8.i686-pc-linux-gnu.tar.gz | tar xvf -

Unzip the platform independent files. This makes the directories Squeak3.9-final-7067 and __MACOSX (we ignore __MACOSX).

squeak> unzip Squeak3.9-final-7067.zip

Copy the files from Squeak3.9-final-7067 to their proper place in Squeak-3.9-8.

squeak_tmp> cp Squeak3.9-final-7067/Squeak3.9-final-7067.image \ Squeak-3.9-8/i686-pc-linux-gnu/usr/local/lib/squeak/ squeak_tmp> cp Squeak3.9-final-7067/Squeak3.9-final-7067.changes \ Squeak-3.9-8/i686-pc-linux-gnu/usr/local/lib/squeak/ squeak_tmp> cp Squeak3.9-final-7067/SqueakV39.sources \ Squeak-3.9-8/i686-pc-linux-gnu/usr/local/lib/squeak/3.9-8/

Just to make setting up projects easier, make a couple of symbolic links.

squeak_tmp> cd Squeak-3.9-8/i686-pc-linux-gnu/usr/local/lib/squeak squeak> ln -s Squeak3.9-final-7067.image squeak.image squeak> ln -s Squeak3.9-final-7067.changes squeak.changes

Return to /tmp/squeak_tmp/Squeak-3.9-8

squeak> cd ../../../../..

As root, run the install script (but don't read it. It lies.) Note: "sudo" is a command that let's you run one command as root.

Squeak-3.9-8> sudo ./INSTALL

If all went well, your install is done.

If you do a "man squeak", it mentions the program "inisqueak". Don't waste your time looking for it. It's not there.

* HOW TO START A NEW PROJECT

Make a directory to hold the project. Say project "foo" in your home directory.

mkdir ~/foo

Change directory in to it.

cd ~/foo

Copy the Squeak "image" and "changes" files into the project directory.

foo> cp /usr/local/lib/squeak/squeak.image . foo> cp /usr/local/lib/squeak/squeak.changes .

Run the squeak command:

foo> squeak

You should be good to go!