Read Me

README -- instructions for installing mesa++ using an svn checkout


If you need information about using svn, take a look at the first
two chapters of the on-line book "Version Control with Subversion":

	http://svnbook.red-bean.com/nightly/en/index.html
	
	
##############################################################################

Step 1: First build mesa

	mesa++ is a C++ interface for mesa and so you must first build
	mesa. Since you're reading this, you've probably already done
	the checkout of mesa++, and the checkout procedure for mesa is
	little different.  If not, do it now.  The last term on the
	command line is the name of the new directory to hold your
	mesa. This should be on the same directory level as your
	mesa++ directory and you should use the name
	"mesa". Otherwise, mesa++ may not install correctly.

	svn co https://mesapp.svn.sourceforge.net/svnroot/mesa/trunk mesa

	Then look at mesa/README for directions on installing mesa.

	
##############################################################################

Step 2: Checkout the sources

	With mesa successfully built, the next step is to build
	mesa++. If you have not already checked it out, do so now:

	svn co https://mesa.svn.sourceforge.net/svnroot/mesapp mesa++


##############################################################################

Step 2: Setup for your fortran and C++ compilers

	Edit mesa++/utils/makefile_header for your compiler
	configuration. You must use the same Fortran94 compiler for
	mesa++ as you did for mesa, and you must use a C++ compiler
	that is compatible with your Fortran95 compiler.


##############################################################################

Step 4: Install

	Now you're set to do the mesa++ install. Change working
	directory to your mesa++ directory, and then do:

	./install
	
	NOTE: run the install script from the top level mesa++ directory.
	
	
##############################################################################

Clean
	
	Each package has a 'clean' shell script that removes object
	files and libraries.  The toplevel mesa++ 'clean' script does
	a clean for each of the packages.  This comes in handy if
	you've changed to a different compiler or changed some flags
	such as optimization level.  After doing 'clean', you can
	simply redo 'install' to get everything rebuilt.

	
##############################################################################

Update

	The svn update function just fetches things that have changed
	since the last time you retrieved things by a checkout or
	update.  Note that not all revisions are intended for general
	use -- some are just "work in progress" working versions.  The
	"getting started" page on the website will have the most
	up-to-date revision number that's expected to be okay.

	http://mesapp.sourceforge.net/getting_started.html#download

	Note that each mesa++ version is tied to a specific mesa
	version as indicated on the "getting started" page. Thus, you
	should update mesa to the correct version at the same time
	that you update mesa++.

	After doing an update, you should do ./clean before doing
	./install just to be safe.