
This is a quick step-by-step PIMPPA installation guide.
Usage information, help, etc. is available in README.

Requirements
------------

 - Linux 2.x.x
 - MySQL. RPMs of v3.22.30 will do. 
   You can get them free for noncommercial use from "http://www.tcx.se/"
 - Suck (v4.2.2 will do) for downloading newsgroups. It should be 
   available at "ftp://metalab.unc.edu/pub/Linux/system/news/transport/"
 - Uudeview (v0.5.13 will do) for decoding news. It should be 
   available at "ftp://metalab.unc.edu/pub/Linux/utils/text/"

Optional:

 - fget (v1.1 will do) for ftp leeching. From
   "http://www-dev.cso.uiuc.edu/fget/". Remember that it must
   be patched for pimppa (patch included in "patches/")!
 - GNOME for GUI. See "http://www.gnome.org/"


Install
-------
Follow these steps for first time installation:

1) Get and install MySQL, Suck and Uudeview. 
   See their respective manuals for installation.

1a) If you want FTP leeching supported, patch and compile 
   fget with a patch from "patches/" dir. See "patches/fget_patch.txt"
   for further instructions.
   
2) mysqld must always be running when you use PIMPPA utils and scripts.
   You should start it from your /etc/rc.d/ files. Suck and uudeview
   must be on command execution path.

3) Modify "src/pimppa.h" to suit your needs. Then do 
   "./configure", "make", followed by "make install". 
   All files will be installed as default to the subdirs 
   of "/usr/local/".

4) Enter "sql/" directory and execute "./createdb". (It's a 
   shell script for adding PIMPPA's MySQL tables)

   [ NOTE: Currently there is no password for PIMPPA's SQL user,
     so anyone who can access your MySQL can access "pimppa"
     database! If you have a comfortable and secure solution for
     this, one that does not ask for password every time some 
     util is used, I'd like to hear it. ]


Wow, all done! Quick and easy, eh? ;)


Upgrading
---------
If you're upgrading from a previous version, see file
"ChangeLog" for lines "CHANGE:" to see what you MUST do.
After that, just do step 3 above.


