// README for Packit, an X11 pakfile browser/manipulator


This is an extremely alpha release, so don't expect
it to do anything.  I am not responsible for any bad stuff 
that happens to you, your computer, your pets, or the 
universe because you ran this program.  

That said, Packit is supposed to do two things right now:

	* Read the contents of a pak file and tell you 
	  about it.
	
	* Extract any file from the pakfile.

	* Play a wav file that you have selected.


To run this program you need the VGUI library (libV.so.1), 
of which I've helpfully included a binary ELF version (compiled
under Linux kernel 2.0.29).  Also, the shared object library 
libPackit.so must be in the Packit working directory.  Run 
the script "installPackit.sh" as root to install the libs and 
ldconfig them.

To play a .wav file, you've got to have the program "wavplay"
installed in your path, or in the working directory.  Aren't
I nice, I've included it for you.  

This is a first project for me and I've tried to do a lot of
things with it.  (Most of them I've disabled because they're 
particularly unstable and need more work).  I'm not a programmer 
by trade or training and I've done this in my spare time.

If you like this program and want to see it become better, or
just feel like supporting a starving student of chemical 
engineering, send a few bucks my way:

	David Brunberg
	129 Berkey Drive
	Johnstown, PA 15904 (USA)

I'll take any money, but I prefer U.S. dollars.


email:  dwb115@psu.edu
Web Page:  http://www.personal.psu.edu/dwb115/Packit

The VGUI Library is under the GPL Copyright.  The V website
is:   http://www.cs.unm.edu/~wampler/vgui/vgui.html
I'm including the V library binary merely for your convenience.
All V source code and official binaries are available at the 
above address.


If anyone can help me, I'm wondering if there's a way to compile
a program under Linux such that the required libraries 
(i.e. libPackit.so) do not have to be in the LD_LIBRARY_PATH.
Is there a way to just have the program load the library at
execution (I know about dlopen(), etc. but I don't know how
to use that stuff to create a library that defines a class and 
only load it when the program needs it).

Some things to be added in the future:

	* Editing of pakfiles (cut, paste)
		
	* Creation of pakfiles

	* Viewing of textures, graphics, models, native .wav playing.

	* Nicer GUI
		
	* Win95, NT version in works (i.e. compile VGUI library 
	  and app for win32).


KNOWN BUGS:

	Don't even try to load more than one file at once.

	Error checking not very good.  As long as everything's ok, 
	the program will work fine.  But just try to play a wav file
	or extract a file when no pakfile is loaded--crashes ungracefully.

	Some problems with the Registered Quake I pak0.pak (WHY?)

	Some debug code left--sorry.