README-LINUX.txt
Last updated: 19 June 2012
Maintainer: Mike Benjamin (issues@moos-ivp.org)

OVERVIEW
========
This file gives GNU/Linux-specific steps for building and running 
MOOS-IvP software.

Testing is primarily done on Ubuntu 12.2LTS 32bit and 64bit. We are 
happy to feedback from user of other GNU/Linux distros.

UBUNTU PACKAGES
========

Packages you probably already have installed:

  g++        - GNU C++ compiler
  subversion - Advanced version control system
  cmake      - cross-platform, open-source make system
  xterm      - X terminal application 

Additional packages:

  libfltk1.3-dev  - Fast Light Toolkit - development files
  freeglut3-dev   - OpenGL Utility Toolkit development files
  libpng12-dev    - PNG library - development
  libjpeg-dev     - Independent JPEG Group's JPEG runtime library 
  libxft-dev      - FreeType-based font drawing library for X
  libxinerama-dev - X11 Xinerama extension library (development headers)
  libtiff4-dev    - Tag Image File Format library (TIFF), development files

To do it all, cut and paste this:

  sudo apt-get install g++ subversion xterm cmake libfltk1.3-dev freeglut3-dev libpng12-dev libjpeg-dev libxft-dev libxinerama-dev libtiff4-dev


NOTE: As of this date we are no longer including FLTK as part of the 
      MOOS-IvP tree. If you have trouble finding FLTK 1.3 in your 
      system's package manager, we recommend that you install from the
      source code from the FLTK website.


BUILDING MOOS-IvP
=================
  ./build-moos.sh
  ./build-ivp.sh


ENVIRONMENT VARIABLES
=====================
When you build the MOOS software, the MOOS executable programs get placed in 
the "MOOS/bin" subdirectory of the source code tree.

When you build the IvP software, the IvP executable programs get placed in
the "bin/" subdirectory of the source code tree (moos-ivp/bin/).

We recommend that you put the absolute path to both of those directories into
your PATH environment variable.  This is especially important because the 
"pAntler" program, which can launch other MOOS/IvP programs, relies on the
PATH variable to find those programs.

We normally just add lines to our ~/.bashrc or ~/.cshrc files to always append
these two directories to the PATH environment variable.