= RefactorErl Debian Package Install Guide =

The currently available Debian package is RefactorErl 0.9.15.04 for 64bit computers and any operating systems that use '''dpkg''' as a package manager. Erlang 17 is required.

== Installation ==

=== Installing the right version of Erlang ===

The default Erlang version available in the current repositories in Debian and Ubuntu does not contain the files needed for RefactorErl's WX based user interface. Therefore it is recommended to use Erlang Solutions's version of Erlang.

This can be done by adding a new source link and updating the package cache.

{{{
sudo echo "deb http://packages.erlang-solutions.com/ubuntu trusty contrib" >> /etc/apt/sources.list
sudo apt-get update
sudo apt-get install erlang
}}}

=== Installing Yaws ===

With the previous step done, the right Yaws version will be installed.

{{{
sudo apt-get install yaws
}}}

=== Installing the tool ===

 * Download the [http://plc.inf.elte.hu/erlang/dl/refactorerl_0.9.15.04-beta1_amd64.deb package]
 * Execute the following commands in this order, but if after any of the steps there are error messages regarding missing dependencies, run the {{{sudo apt-get -f install}}} command:
{{{
sudo dpkg -i refactorerl_0.9.15.04-beta1_amd64.deb
}}}
 * Use the command {{{referl}}} to start RefactorErl

== Data files ==
By default the data folder of RefactorErl is put in the '''$HOME/.refactorerl''' folder.

== Uninstallation ==
To remove RefactorErl from your system you can use the {{{sudo dpkg --remove refactorerl}}} command, however this will not remove the default data folder under '''$HOME/.refactorerl'''. To remove that as well you have to use {{{sudo dpkg --purge refactorerl}}}.