====== Installation of Jmol 12.0.2 ======

===== Additional libraries ===== 

Java, already installed.

===== Procedure =====

Here is the procedure to install Jmol:

  * Jmol is distributed as a JAR archive, ready to be run from a startup script. On Jmol's Sourceforge site, you need to get the ''Jmol-12.0.2-binary.tar.gz'' file. Once decompressed, you wil have a ''jmol-12.0.2'' folder which need sto be moved toward ''/opt/bio/sources''.

<code bash>
% tar -zxvf Jmol-12.0.2-binary.tar.gz
% sudo mv jmol-12.0.2 /opt/bio/sources
</code>

  * This shoulder should belong to ''root'' and its permissions set to ''755''.

<code bash>
% sudo chown -R root:root /opt/bio/sources/jmol-12.0.2
% sudo chmod 755 /opt/bio/sources/jmol-12.0.2
</code>

  * Once you are in ''/opt/bio/sources/jmol-12.0.2'', the ''jmol.sh'' script needs to be edited to add a ''JMOL_HOME'' bash environment variable. At the very top, just under the ''#!/bin/sh'' line, add this line:

<code bash>
export JMOL_HOME=/opt/bio/sources/jmol-12.0.2
</code>

  * To make sure that ''jmol'' is available to all, do this:
<code bash>
% sudo ln -s /opt/bio/sources/jmol-12.0.2/jmol.sh /usr/local/bin/runJmol
</code>

  * To add Jmol to the Impilo application menu, you need to edit the Xfce4 configuration file:
    * More to come...

  * To use Jmol from the command line:

<code bash>
% runJmol
</code>