INSTALL

** For the latest information, please visit http://taoframework.com

There are three ways of building Tao; one requiring GNU make, a win32-only
batch file build and one using the Prebuild tool. 
Please contact the tao mailing list with any problems;
see http://lists.ximian.com/mailman/listinfo/tao-list .

1. Using GNU make
=================

This is the preferred way to build Tao; however, it does require that GNU make
and a minimal toolset (cp, mkdir) be installed.  A minimal cygwin install
should be sufficient.

The build has two steps:

* Config file selection.  Type "make help" to see the options:

% make help
Use "make [targetname]" to configure the build
valid targets:
  net-1.1        .NET 1.1
  mono-1.1       Mono 1.1

other variables:
  MONODIR        Location to find mono install, mcs will be used from $MONODIR/bin

Selecting one build involves typing "make net-1.1", e.g.:

% make net-1.1
rm -f config.mk; cp config/net-1-1.mk config.mk
config.mk installed; re-run make.

* Building.  Simply type "make clean && make".  The "make clean" is neccessary
because there is a post-processing step which needs to be cleaned out 
before a build. The resulting DLLs will be placed in dist/bin,
and examples will be in dist/clean. If you wish to strongname the 
assemblies (as is recommended), build with "make clean && make STRONG=1".

2. Using batch files
====================

Two batch files are provided, "build.bat" and "buildmono.bat".  The second
is equivalent to the first, except that it builds Mono 2.0 Profile assemblies.

3. Using Prebuild
=================
Several scripts in the root directory of the code use the Prebuild tool to 
create project files for several IDE such as Visual Studio 2003, 2005, 
MonoDevelop, SharpDevelop, SharpDevelop2 and NAnt. These scripts are not
meant to do complete builds of the project like the make and batch script. 
Notably, the Prebuild builds will not do the post-processing step that properly
sets up P/Invoking callbacks.
They are meant to help you build parts of the Tao project. 
When you run a Prebuild script, you can find the main project file 
(*.sln, *.cmbx, *.build) in the src/Tao.<project> directory

Tao.Sdl - Builds Tao.Sdl and Sdl Examples
Tao.PhysFs - Builds Tao.PhysFs and PhysFs Examples
Tao.Lua - Build Tao.Lua and Lua Examples
Tao.Ode -  Builds Tao.Ode and Ode Examples
Tao.Cg - Builds Tao.Cg
Tao.DevIl - Builds Tao.DevIl and DevIl Examples
Tao.OpenGl - Due to the fact that Tao.OpenGl is used in many subprojects,
I had to put them altogether so they would build properly.
Tao.OpenGl builds Tao.OpenGl, Tao.OpenGl.Glu, Tao.OpenGl.ExtensionLoader,
Tao.OpenAl, OpenAl Examples, Tao.Glfw, Glfw Examples, 
Tao.Platform.Windows and Tao.GlPostProcess