= Installation Guide to ORXONOX on Tardis =


There are generally two ways to install ORXONOX (from source) onto the System
The first one is the default approach, and requires you to have a copy (and all svn-files) on your account.
The Second approach requires you to check out orxonox every time you switch your workstation again.

== The Home-Account approach ==
  1. Download  the source either from svn (https://svn.orxonox.net/orxonox/trunk) or (http://svn.orxonox.net/orxonox/trunk)
{{{
$ svn co https://svn.orxonox.net/orxonox/trunk orxonox/trunk
}}}
  2. Enter the newly checked out directory and configure it (this requires a special switch (--with-tardis), that automatically sets all environment flags for you at configure-time.
{{{
$ ./autogen.sh
$ ./configure --with-tardis
$ make
}}}
  3. now you are ready to work with the Source


== The Tardis-Local approach ==
  1. Download this script: https://svn.orxonox.net/orxonox/trunk/scripts/tardis-scratch-checkout.pl. Probably you will have to change the Permissions of the file, so you can execute it  
{{{
$ wget https://svn.orxonox.net/orxonox/trunk/scripts/tardis-scratch-checkout.pl
$ chmod 755 tardis-scratch-checkout.pl
}}}
  2. Then you will have to execute the script (to get the trunk):
{{{
$ ./tardis-scratch-checkout.pl
}}}
  This will automatically check out the trunk to /scratch/{username}/orxonox/trunk.
  If you'd like a branche you can use the script to do this too:
{{{
$ ./tardis-scratch-checkout.pl branches/myBranche
}}}     
  3. Now you can work with your trunk/branche

== Pro/Contra ==
|| / || Home-Account || Tardis-Local ||
|| Checkout || once per account || once per tardis and account ||
|| Compiling || Network->slow || local->very much faster ||
|| Linking || stinking slow (30 seconds+)|| adequately fast ||