Installation
------------

* Follow these instructions very carefully *

REMEMBER to use gmake (on FreeBSD for example).

* IF THIS INSTALLATION BREAKS YOUR XMMS, THEN GO TO XMMS INPUT PLUGIN
  DIRECTORY AND DELETE libdeli.* FILES. Both global and user defined input
  plugin directories should be processed. Check:
   1. ~user/.xmms/Plugins/Input
   2. xmms-config --input-plugindir


* AS NORMAL USER (DON'T DO THIS AS ROOT) *

1. ./configure

 You can give a installation prefix if you wish but is not necessarily
 needed since it's by default $home/.xmms/uade and UADE doesn't need to be installed
 globally on the system (everything can be installed into users home
 directory). You might want to say ./configure --prefix=/opt here.

 You can also specify a default dir for pwrap.pl. This is the default dir that
 will be opened when you try to add files/dirs from pwrap.pl tk interface.
 Usage: ./configure --mymods/dir/to/your/modules

 Ofcourse both --prefix and --mymods can be used in conjunction. 

2. Edit config.h (if you like)

   - #defines in config.h should be self-explanatory for users who actually
     need those features

   - you shouldn't edit #define UADEDATADIR since it should have been given
     with --prefix for ./configure. However you can do it if you wish,
     of course, but then you should also edit 'uadedatadirpath' file

3. gmake

   Compiles XMMS plugin and cmdline tool.

4. gmake test

   You should hear a song playing (Future Composer 1.3 song using players/FC1.3
   as a player and fc/fc13.Smod7 as a song). If it doesn't play anything, you
   might still have a working xmms plugin, but proceed with pessimism. UADE
   cmdline tool only supports /dev/dsp as audio playback system so it might
   not work in the future. XMMS plugin should handle this problem indirectly
   by only using XMMS plugin API.

* AS ROOT OR AS NORMAL USER (CHOOSE YOUR WAY - I PREFER NORMAL USER) *

	AS NORMAL USER

5. gmake install

   Do this if you didn't specify a prefix or if you're sure that you have
   read and write permissions in the directory specified to --prefix.

   (this will copy default configs and players to ~/.xmms/uade)

	OR AS ROOT
5. su
   <root passwd>
   gmake install
   
   Do this if you don't have read/write permissions to the directory
   specified to --prefix. 

   (this will copy default configurations and players to
    /usr/local/share/uade/ or something depending on your configure options)

6. You're done. Good luck and have fun!

First: Run XMMS from a shell. You can see all the useless debug messages and
errors in a shell. If your XMMS jams, there might be some weird debug
messages trying to explain the reason why your XMMS jammed (those debug
messages are really worth reading if you can understand them ;-)

The frontends pwrap.pl and playuade is installed in $prefix/bin. So if you
didn't specify a prefix they will be installed in ~/.xmms/bin. So make sure
you copy them to a directory that is in your path or add the above dir.