= Installing on Debian from SVN =
Install from SVN requires that you download and compile the source code on your own. The main supported version of Debian is version 6, "Squeeze", but it is possible that later versions are working. If you plan to use a newer version like "Wheezy" (version 7) or "Sid" (unstable), please see the bottom paragraph.

<<TOC(3)>>

== Installation ==
=== Setup ===
 . {{{
sudo apt-get install build-essential python-yaml cmake subversion wget python-setuptools mercurial
}}}

Depending on the configuration you choosed, it is possible that you need to add "contrib" to your /etc/apt/sources.list for some packages. Especially for nvidia-cg-toolkit. Don't forget to do an "apt-get update" after this change to search for the new packages !

Install bootstrap dependencies: 

 {{{
sudo apt-get install build-essential python-yaml cmake subversion wget python-setuptools mercurial git-core
}}}

Install core library dependencies (aka, 'ROS Base'):

 {{{
sudo apt-get install python-yaml libapr1-dev libaprutil1-dev  libbz2-dev python-dev libgtest-dev python-paramiko libboost-all-dev liblog4cxx10-dev pkg-config python-empy swig
}}}

The Python "nose" package version 1.0 or later is required. If you are using Debian 6 (squeeze) or earlier,  use pip to install it:
 {{{
sudo apt-get install python-pip
sudo pip install nose
 }}}
Otherwise, if you are using Debian 7 (wheezy) or later, use the Debian package:
 {{{
sudo apt-get install python-nose
 }}}

Next, install graphical library dependencies, if you plan on using ROS graphical tools (aka 'ROS Full'):

 {{{
sudo apt-get install python-wxgtk2.8 python-gtk2 python-matplotlib libwxgtk2.8-dev python-imaging libqt4-dev graphviz qt4-qmake python-numpy
}}}

Next, you must build swig-wx from source if you wish to use the graphical tools in ROS in this installation.  swig-wx requires bison and the GNU autotools to build.
 {{{
sudo apt-get install bison++ automake autoconf
git clone https://github.com/ros/swig-wx.git
cd swig-wx
./autogen.sh && ./configure && make && sudo make install
 }}}

=== Locales ===

Currently, there is a known issue with Fuerte's svn scripts if you do not have US-english locales : https://code.ros.org/trac/ros/ticket/3305

A workaround is possible if you do not have US locales :

 . {{{
LANG=en_US.utf-8
}}}

It will provoke svn warnings during checkout that you may ignore. Here is an example :

 . {{{
svn: warning: cannot set LC_CTYPE locale
svn: warning: environment variable LANG is en_US.utf-8
svn: warning: please check that your locale name is correct
svn: warning: cannot set LC_CTYPE locale
svn: warning: environment variable LANG is en_US.utf-8
svn: warning: please check that your locale name is correct
}}}

<<Include(fuerte/Installation/rosinstall)>>

<<Include(fuerte/Installation/PostInstall)>>

== Installation on newer versions ==
If you are using a "Wheezy" or "Sid" version you may have to overwrite the rosinstall OS version detection, with luck it will work as in "Squeeze". Please add this to your environment variables before installing :

 . {{{
export ROS_OS_OVERRIDE=debian:squeeze
}}}

If this is not enough, you will have to customize your rosdep.yaml files. Please read  http://www.ros.org/wiki/rosdep/rosdep.yaml#Overriding_Mapping_File

==== Compilation failure ====
Since "Wheezy" and "Sid" include packages for gcc-4.6 and g++-4.6, you may find that your compilation fails if you have these versions of the compilers installed. To remedy this and successfully compile, you can add these environment variables to your session (or shell defaults, such as in ~/.bashrc).

{{{
export CC=gcc-4.5
export CXX=g++-4.5
}}}