== How to install Magnolia ==

'''1. Install Eclipse for Magnolia
'''

Note the Eclipse version.

Make the directory ''Magnolia''. This is recommended, but not necessary.

Download Eclipse from http://www.eclipse.org/downloads
Choose Eclipse RCP/Plug-in Developers 3.5 32-bit Java with 32-bit Eclipse (These choices will make sense when you see the Eclipse website.) Download the package to the newly created ''Magnolia'' directory.

Go to a terminal and move to the directory ''Magnolia''. In a terminal unpack Eclipse by writing
{{{
tar xzvf [name of downloaded package]
}}}


You may now remove the installation files.

If you have 64-bit Linux installed on your machine, skip this next step. Otherwise (if you have 32-bit Linux) open the file ''eclipse.ini'' in the newly unpackaged directory and change
{{{
-vmargs
}}}
to 
{{{
-vmargs -Xss8m
}}}

You can open the ''eclipse.ini'' file in e.g. Emacs.

If you have 64-bit Linux or a different operating system these settings will be changed later in the installation procedure.

'''2. Install Java for Magnolia'''

Download Sun Java 32-bit (choose Java SE, JDK6 and Linux platform) from http://java.sun.com/javase/downloads/widget/jdk6.jsp Download to the directory ''Magnolia''.

The Sun Java site will offer you to log in, create accounts and similar. Skip these steps, which will be one of your options, and simply download the files. 

Go to a terminal and move to the directory ''Magnolia''. Install Sun Java by writing 
{{{
sh [name of downloaded file]
}}}
 
This will result in the install program asking you to accept the licence. Flip through the licence by using the space bar, then accept the licence. You do not need to register. 

You may now remove the installation files. 

'''3. Making it work with 64-bit Linux'''

If you have 32-bit Linux or another operating system skip this step.

Make the following script to run Eclipse.

{{{
#! /bin/sh

export JAVA_HOME=$HOME/magnolia/jdk1.6.0_20/bin
export PATH=$JAVA_HOME:$PATH
export GDK_NATIVE_WINDOWS=1

exec $HOME/magnolia/eclipse/eclipse -vmargs -Xss8m -d32
}}}

Making a script means opening a file in an editor, e.g., Emacs and saving the file. A good name for the file in this instant might be ''run-eclipse''. Save the file in the directory ''Magnolia''. Add the above text to the file precisely as shown.

'''4. Adapting Eclipse to Rascal, Magnolia and adding some helpful tools'''

Start Eclipse. If you did not write a script in step 3, start Eclipse by writing in a terminal 
{{{
eclipse
}}}

If you made a script in step 3, writing the name of the file you made in a terminal. For example like this:

{{{
run-eclipse
}}}
 
You may start Eclipse by clicking on the icon in your desktop or similar only if you did not write a script in step 3.  

Now, go to the menu "Help ---> Install new software ..."

Click on the button ''Add'' in the dialogue that pops up.