Getting Started Guide
=====================

First of all you need erlang installed, version should be >= 17.0, on
ubuntu it should be enough with::

    sudo apt-get install erlang-nox erlang-dev

If something failes try installing this others (should be dependencies of the
ones above)::

    sudo apt-get install erlang-parsetools erlang-syntax-tools

Then you need to install rebar3, follow the instructions on http://www.rebar3.org/
should be enough with::

    mkdir -p ~/bin
    cd ~/bin
    wget https://s3.amazonaws.com/rebar3/rebar3
    chmod u+x rebar3

Add ~/bin to your $PATH if you don't have it already::

    export PATH=$PATH:$HOME/bin

Add it to your shell rc file to have it permanently set (.zshrc for zsh, .bashrc for bash)

Clone the interfix repository::

    git clone https://github.com/marianoguerra/interfix

Build it::

    make

If you don't have make install it, on ubuntu it's::

    sudo apt-get install build-essential

The binary is located at `./_build/default/bin/interfix`, to make your life easier create
a symbilic link::

    ln -s ./_build/default/bin/interfix

Now you can start compiling, to test that it works, convert some of the examples to erlang::

    ./interfix erl examples/calls.ifx

Now let's build a hello world, put this on a file called `hello.ifx`::

    fn+ hello:
        hello "world".

    fn+ hello Name:
        io :: format "hello ~s!~n" [Name].

Now compile it::

     ./interfix beam hello.ifx .

The second argument is the destination directory, in this case, the current directory.

Now let's try it from the erlang shell::

    $ erl

    Erlang/OTP 18 [erts-7.0] [source] [64-bit] [smp:4:4] [async-threads:10] [kernel-poll:false]

    Eshell V7.0  (abort with ^G)
    1> hello:hello().
    hello world!
    ok
    2> hello:hello("Bob").
    hello Bob!
    ok
    3> q().
    ok