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

Requirements
------------
NOTE: required version numbers may not be strict. The ones
mentioned are those currently used for devel.

For leeching news and web galleries:

 - Linux 2.x.x
 - MySQL. (>= v5.0.18) (PIMPPA 0.5.7 works with the MySQL 3.x series). 
   You can get it for free for noncommercial use from "http://www.mysql.org/"
 - suck (>= v4.3.2) for downloading newsgroups. It should be 
   available at "http://www.sucknews.org/"
 - uudeview (>= v0.5.19) for decoding news. It should be 
   available at "http://www.fpx.de/fp/Software/UUDeview/"
 - wget (>= 1.10.2) for downloading web image galleries. 
   From "http://www.gnu.org/software/wget/"
  
Less useful (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) Install optional components 
   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. It contains important
   configuration stuff, like the temporary directory location. 
   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). This script
   will also copy the default config file to ~/.my.cnf, unless
   it exists already.
   
5) Set a new password for SQL user pimppa by editing ~/.my.cnf, 
   the file should have e.g.
   
   [client]
   user=pimppa
   password=your_new_pass
   
   Then use

   $ mysql -u root -p --execute="USE mysql; UPDATE user \
       SET password=PASSWORD('your_new_pass') where user='pimppa';"


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.