========================================================================
                               ShipList
========================================================================

Copyright (C) 2001-2002 by James E. King, III (jking@prospeed.net)
                                aka MagnumMan (MagnumMan@icop-sfc.org)

See end of file for license agreement. This file best viewed in notepad.

This is a collection of utilities that extend the functionality of the
Starfleet Command II Scripting API and make scripting easier.

------------------
Usage Instructions
------------------

ShipList is distributed with the Scripting API.  You'll find the full
source code to ShipList as well as the compiled API.

To use ShipList in your project, add the api subdirectory to both the
include path and the link path.  Then add ShipList.lib to your link
input library list.  Don't forget to initialize the random number
generator in the C run-time library by calling srand(GetTickCount())...
this is best done in the constructor for your script.

-----------------
About the Project - If you want to examine the source code
-----------------

ShipList compiles into four libraries that get linked into your project:

ShipList.lib       - Release Multithreaded (use this for linking scripts)

ShipListMD.lib     - Release Multithreaded DLL (MFC Compatible)
ShipListDbg.lib    - Debug Multithreaded
ShipListDbgMD.lib  - Debug Multithreaded DLL (MFC Compatible)

Open the ShipList.dsw project workspace.  This library gives you an
object-oriented way to use the master ship specification file.
Fighters are supported as well.  Ships are read from the shiplist.txt
file.  On a Pentium III 800MHz this takes about 0.5 seconds.

To make compilations quicker, add these lines to your StdAfx.h
precompiled header file and repair the path if necessary:

#define USE_PCH
#include <stdio.h>
#include "../../Shared/Source/PrecompiledHeaders/Precompiled.h"

The headers in the api directory contain detailed comments on the
different classes.  Use the Tester program as a learning guide.


---------------
Release History
---------------

Version	Date		Changes
-------	-----------	----------------------------------------------------
    0.5 2001 Feb 08	Private Beta
    0.6 2001 Feb 08	2.0.0.5 compatibility, Public Beta
    0.7 2001 Feb 11	Changed project name from MagnumUtils to ShipList
    1.0 2001 Feb 17	Public Release
    1.1 2001 Mar 19	Fixed some bugs loading master list, added load from 
                  	filenames, and improved the speed of loading.
  1.5b1 2001 Jun 23	Orion Pirates Release Beta 1
  1.5b2 2001 Jun 29	Orion Pirates Release Beta 2
    1.6 2002 Jan 21	Orion Pirates 2.5.2.3 API R2.2 Official Release
	                also compatible with Empires At War, programmer
			selects which game files to read in CreateMaster.

-----------------
License Agreement
-----------------

This library 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 library 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.

http://www.gnu.org/copyleft/gpl.html

