=== HW2 .Arciv Compiler v1.1.3
=== Created: 08/15/05 by Mikail
=== Last updated: 04/13/06
=== Homepage: http://isometricland.com/homeworld/homeworld.php


=========================================================================


INTRODUCTION
This program reads .arciv files generated by ModPackager and then compiles the 
files listed in them using LuaC. The benifits of doing this include speedier 
performance and smaller file size. The main drawback is that you won't be able 
to decompile them later, since no decompiler can do so properly yet.

**IMPORTANT**
The command-line parameters have changed in version 1.1. See the Change Log 
(below) for details.

DOWNLOAD
[url]http://www.geocities.com/Area51/Quadrant/3864/homeworld.htm[/url]

INSTALLATION
Extract the contents of this archive into a folder on your harddrive.
This program requires that Windows Scripting Host v5.6 be installed.
This program also requires that you have a copy of LuaC.exe.

INSTRUCTIONS
1) Make a backup copy of any files you wish to compile, as this program 
   overwrites all files by default (and, you won't be able to decompile them 
   later - e.g. they're irretrievable).
2) Generate an .arciv file for the files you wish to compile using ModPackager.
3) Run .Arciv Compiler using the following command-line:

	cscript [script file] [LuaC path] [.arciv file] [[destination folder]]

   where:
	[script file] is the full path to "HW2_ArcivCompiler.js".

	[LuaC path] is the full path to "LuaC.exe".

	[.arciv file] is the full path to the .arciv file you generated using 
	ModPackager.

	[[destination folder]] is the path to the folder where the compiled 
	files should be generated. Use the "-a" switch, instead, if you want 
	the files generated in the same directory as the .arciv file. Or, use
	"-o" if you want to overwrite your source files. If ommitted entirely, 
	a new file will be created with the same name and in the same directory 
	as the original file, but with an additional ".luac" extension.


=========================================================================


CHANGE LOG

v1.13
* The program now correctly creates the folder tree.

v1.12
* Some speed optimizations.
* The specified destination folder is now created if it doesn't already exist.

v1.11
* Fixed the bug where the program could not traverse through tables properly.
* Files are now compiled without the "-s" switch, so that you can decompile 
  them later using LuaDC.

v1.1
* **IMPORTANT** The order of the [.arciv file] and the [destination folder] 
  parameters has been reversed. The [destination folder] parameter is now 
  specified last.
* Now, if the [destination folder] parameter is omitted entirely, a new file 
  will be created with the same name and in the same directory as the input 
  file, but with an additional ".luac" extension. 
* A message telling the program version and usage instructions is now printed 
  to the screen when the program is run without any arguments.
* Corrected an error in the instructions.
* Added the "-a" switch to cause compiled files to be generated in the same 
  directory as the .arciv file.

v1.01
* **IMPORTANT** The [source files folder] command-line option has been changed 
  to [destination folder]. Compiled files are now WRITTEN to this folder.

v1.0
* Initial release.