this is cipres\cipres-build-scripts\build-for-windows\readme.txt

=======================================================================
BUILDING CIPRES ON WINDOWS 
=======================================================================

PREREQUISITES:
	You need to have the following tools installed:

		- Microsoft Visual Studio .NET 2003

		- Python 2.4

		- Ant 1.6.5

		- A subversion client: svn (only required for maintainers, not for users
			of the SDK)

		- Java 1.5 SDK (make sure you can run the "javac", "jar" and "java" commands).

		- Paup version 4 (is required to run CIPRes, not to build it).


	You must have certain environment variables set.  Create a batch file to  set
	the following:

		- ANT_HOME must be set to the top of your ant installation

		- Variables for running the MSVC compiler from the command line must be
		set. You can set the required variables by running vsvars32.bat which is typically
		found in C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\Tools\vsvars32.bat.

		- Set your PATH environment variable such that python, ant, java, svn, paup and devenv
		can be run from the command line.  (vsvars32.bat should have added the necessary
		directory to your PATH for running devenv).

	Maintainers: verify that you can access the cipres svn server at sdsc.  
	Read-only access, using the username=guest, password=guest, account will do.

	You will find it very helpful to install a UNIX like "ps" command that lets you 
	list and kill processes from the command line.  MKS toolkit provides a nice one 
	(but it isn't free).  Microsoft also provides one, though I have no experience
	using it.


INITIAL BUILD:
1.	Maintainers: download cipres-deps.zip from the maintainer's page of the
	www.phylo.org site.  SDK users: download cipres-deps-and-source.zip from 
	the SDK page.  Extract the contents to create a directory
	named cipres-and-deps.

2.	In a command window,
		cd cipres-and-deps
		configureTools.bat

	This installs, under cipres-and-deps, required third party libraries. 
	
	With the maintainer's archive, the script also checks out the latest cipres code from 
	subversion to cipres-and-deps\cipres.  The SDK archive includes a cipres-1.0.1 directory
	instead.


3.	If you've run CIPRes before, make sure to remove any old configuration files:
	cd %HOME%
	rm -rf cipres 

5.	Try running cipres:
	cd cipres-and-deps\cipres\build\bin
	cipres.bat



SUBSEQUENT PARTIAL BUILDS:

	When you ran configureTools.bat a file named buildConfig.bat was created.  
	You must run buildConfig.bat before using ant or visual studio to compile any 
	java or C++ changes.  Or you can always go to the CIPRES-and-deps directory
	and run:
		cipres\cipres-build-scripts\build-for-windows\makeCipres.bat
		cipres\cipres-build-scripts\build-for-windows\instalCipres.bat
	to rebuild everything that may have changed.  The makeCipres.bat
	and installCipres.bat automatically call buildConfig.bat.
	
	If you're using visual studio to work on C++ parts of CIPRes, you'll
	need to start visual studio from the command line as "devenv", so that it has
	access to the environment variables set by buildConfig.bat.

	If you're a Java developer have a look at the end of the page at
	http://www.phylo.org/software/maintainer/index.php
	for information on using Eclipse.



RUNNING ANT/JUNIT TESTS:
	These require a junit jar in the %ANT_HOME%\lib.  You can copy
	c:\cipres-and-deps\cipres\cipres_dist\lib\junit\jars\junit-3.8.1 to
	%ANT_HOME%\lib. 

	You can run an automated test, from the CIPRES-and-deps directory, enter:
		cipres\cipres-build-scripts\build-for-windows\installCipres.bat --only-test

	The automated test pops up a gui application, BUT DON'T INTERACT WITH THE GUI.  The
	test will supply the input and should terminate after several minutes.  The
	command shell should either indicate "InstallCipres had an error" or "InstallCipres
	finished OK".



BUGS AND PROBLEMS:
	Mail to terri@sdsc.edu and/or mholder@csit.fsu.edu.

ADDITIONAL INFORMATION: