UmodPack
========
UmodPack is a crossplatform suite of all-purpose umod tool.  You can
use it to install a umod, or decompile it by extracting individual files
inside and showing the .ini file changes the umod will instate.
Additionally, it provides facilities for listing installed umods and
checking the integrity of your umod installation.

umod files are packages containing files with setup instructions for an
Unreal mod (modification). For more information on Unreal mods in
general see Mod Central Unreal:
http://www.planetunreal.com/modcentral/

xumod Usage Examples
--------------------
*** xumod currently does not work under Windows

Fire up xumod on the Digital Extremes umod:
	xumod DE.umod

The first time you use xumod the program will try to detect an
installed Unreal game on various locations on your system.  If it is
not found you will be prompted to enter the base directory for an
Unreal game.

Once xumod fires up showing the particulars of the umod, you can
select "Install" from the "umod" menu to install it.

The top part of the window shows the product name, version and
developer of the umod.  If you right-click on the entries, the "browse"
context menu will pop up allowing you to view the corresponding web
page using Netscape.

Double-clicking files in the file list area will let you view their
contents if they are viewable.  By default xumod invokes xv, netscape,
umr, and xmms on the files to do this.  The exact command lines can be
customized from the "XUmod Setup" dialog.

Below the file list is a tree display of .ini file changes.

The tab labelled "System" shows all the installed products.  You can
expand the branch of a particular product by clicking on the "+" sign
besides it.  An expanded branch shows also the installed files
underneath.  To uninstall a product, highlight it and select "Uninstall"
from the "umod" menu.

umod Usage Examples
-------------------------
To identify an umod:
	umod -l DE.umod

To list the contents of the Digital Extremes umod:
	umod -l -v DE.umod

To install DE.umod inside /usr/local/games/ut:
	umod -b /usr/local/games/ut -i DE.umod
The first time you use the -b option, the argument is saved in
~/.umodrc (\Windows\umod.ini for Windows users) so next time when you
want to install for example the Bonus Pack it suffice to type:
	umod -i UTBonusPack.umod

To examine the content of de.int out of DE.umod:
	umod -d 'System\de.int' DE.umod
Windows users need not put the single quotes around the file argument.

To list all the installed products:
	umod -l
Note that the Linux version of UT does not installed the Manifest.ini
file, which keeps track of the installed products.  Umods installed
using our umod/xumod will update the Manifest.ini though.  As such, the
-l listing may not be complete under Linux.

To list the files that belong to installed products:
	umod -l -v

To check for the integrity of product installation:
	umod -c
Currently this will check for dangling group entries (those product
having a Group= line in the Setup group, but the corresponding group is
not present), and missing files.

For detailed instructions type "perldoc umod".
