---------------------------------------------------------------------------------------------------------
|  DSW2Makev2 - converts MS Dev. Studio Workspace and Project files into Unix Makefiles                 |
---------------------------------------------------------------------------------------------------------
|                                                                                                       |
|    Copyright (C) 2003 Cyan Worlds, Inc.                                                               |
|                                                                                                       |
|  This program is free software; you can redistribute it and/or                                        |
|  modify it under the terms of the GNU General Public License                                          |
|  as published by the Free Software Foundation; either version 2                                       |
|  of the License, or (at your option) any later version.                                               |
|                                                                                                       |
|  This program is distributed in the hope that it will be useful,                                      |
|  but WITHOUT ANY WARRANTY; without even the implied warranty of                                       |
|  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                        |
|  GNU General Public License for more details.                                                         |
|                                                                                                       |
|  You should have received a copy of the GNU General Public License                                    |
|  along with this program; if not, write to the Free Software                                          |
|  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.                          |
|                                                                                                       |
---------------------------------------------------------------------------------------------------------
|                                                                                                       |
|  Latest Version is always at: http://open.cyanworlds.com                                              |
|                                                                                                       |
|  __Please send back your changes!__                                                                   |
|                                                                                                       |
|  We are very accepting of modifications and improvements                                              |
|                                                                                                       |
---------------------------------------------------------------------------------------------------------
| Version: 0.0.1 (initial public release)                                                               |
| Date: March 25, 2003                                                                                  |
---------------------------------------------------------------------------------------------------------

All of the Scripts are all located in ExampleTree/Scripts/Build/DSW2Makev2

I have included a simple HelloWorld Application as a demo inside the ExampleTree.

To use this tool without modification, you must keep your source tree, the MsDevStudio projects and 
workspaces seperated. This is how we are setup:

   /MsDevProjects/ -> all .dsw and .dsp files
   
   /Sources/       -> All source files (.c,.h,.cpp ... etc ... )

   /UnixProjects/  -> All Unix Makefiles and binaries are built inside here.

Please look in the ExampleTree for how this is done. Anyone looking to improve this is welcome to 
submit their changes.


To build the example HelloWorld Project:

   We rely on the enviromental variable SETTINGSMK for the location of machine/build specific information.
   For example, we put different linking information for mysql on a redhat and a debian machine because their 
   libraries are in different locations.  We also change the name of the compiler(redhat: g++3, debian: g++).

   Inside the DSW2Makev2 folder there is an example settings.mk.  You must change the MKDIR variable to the 
   directory your DSW2Makev2 programs are located in. eg:

   MKDIR = /home/myuser/dsw2makev2-0.0.1/ExampleTree/Scripts/Build/DSW2Makev2
   
   Once that is done, set the enviromental variable:
   bash/sh:
	SETTINGSMK=`pwd`/ExampleTree/Scripts/Build/DSW2Makev2/settings.mk
   tcsh:
	setenv SETTINGSMK `pwd`/ExampleTree/Scripts/Build/DSW2Makev2/settings.mk

   Now cd to ExampleTree/UnixProjects/AllProjects and type make.  The HelloWorld App should build both a release 
   and debug version. If somthing goes wrong, make sure your SETTINGSMK file is correct.

   You should be able to open ExampleTree/MsDevProjects/HelloWorld/HelloWorld.dsw in MsDev Studio and add more 
   projects, source files, or even another workspace, provided you make the changes in the UnixProjects Folder 
   to also build them.  If it seems dependicies are not being calculated correctly doing a "make clean" should 
   fix that.

