[Newbies] Installing Squeak From the Linux Command Line

[Dale Wiles]

  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!