RoboBuggy

How to get started and Install BuggySim Dev Environment

======================================================

Summary: This file will get you started, from installing

    the right VM, get catkin install, and your first

    catkin_make.

Step 1. Get the VM

-------------------

We will be using a VirtualBox VM as a dev environment, 

 since setting up ROS is a bit annoying, 

1a. Download and install VirtualBox

1b.   We will be using Ubuntu Precise LTS

1c.   We will be using ROS Groovy (might migrate to hydro)

1d.   Go the groovy/Installation page on the wiki, or download

       the prepackaged VM directly. 

        wiki.ros.org/groovy/Installation

Step 2. Pull the Repo

---------------------

From your home directory, run: 

   # Make the top-level directory

   mkdir ~/buggyworkspace

   cd buggyworkspace

   # Clone the repo into a folder named 'src'. This name

   # is chosen, because it will be expected by the build

   #  system (i believe).

   git clone https://github.com/msebek/BuggySim.git src

You have now have all of the source pulled. Next, we'll

 get it to build. 

Step 3. Init your catkin workspace

-----------------------------------

The following instructions paraphrase the instructions found 

at wiki.ros.org/ROS/Tutorials/InstallingandConfiguringROSEnvironment

   cd ~/buggyworkspace/src

   catkin_init_workspace

   # We have now created our workspace! Hooray!

   #  We will now make it, and source the build executables.

   cd ~/buggyworkspace

   # Note that we are calling this from the directory one level above 

   #  the src folder we pulled the repository into. 

   catkin_make

   # Add just-made executables to our rospath, so we can run them. 

   cd ~/buggyworkspace

   source devel/setup.bash

Step 4. Getting Acquainted with the Repo

----------------------------------------