The One Ripper INSTALL
--------------

Please be sure to read the README before installing The One Ripper

To install The One Ripper in the default location (perl-version dependant, use the perl
-V command to find out, look for the @INC list at the end of the command's
output):

	perl Makefile.PL
	make
	make install

	The executable scripts will go to the same place the perl binary is
	installed in, while the modules will land somewhere in the system perl
	library tree.

To uninstall (does not always work though...):

	make uninstall

If you want to install the icon and the desktop entry, you'll have to do it
manually (or, if you platform supports it, use the rpm).


But I want to do things 'different'...
--------------------------------------

If you want to install The One Ripper somewhere else (like  /usr/local)
you nedd the following incantation of perl:

	perl Makefile.PL PREFIX=INSERT_LOCATION_HERE
	make
	make install

And if you dislike the way perl's MakeMaker & co. put the perl version number
in your `private' module directory, you may try this:

	perl Makefile.PL PREFIX=LOCATION LIB=LOCATION/lib/perl5
	make
	make install

It is up to you what you put behind the LIB in the last example, but it is also
your responsibility to make sure perl can find the modules at runtime. You can
accomplish this by including the location you enter behind LIB in your PERL5LIB
environment variable. If that var does not yet exist, create it using your
shell's specific syntax. PERL5LIB is structured just like PATH or
LD_LIBRARY_PATH, you enter multiple directories separated by commas.

In all these special cases, the scripts will end up in a `bin' directory
underneath your chosen LOCATION, man-pages will go to LOCATION/man/man(num),
etc. If you set up a profile or .profile script to search /opt or /usr/local
for these directories and if found include them in your environment, you can
add and remove packages at will without bothering about environment settings.
All you have to do after adding or removing a package is to rerun the profile
script.

To remove The One Ripper, you may try the:

	make uninstall

command. This sometimes works, and sometimes it does not. If it refuses to work,
you can simply remove all files by hand. Look for the .packlist file which perl
created when installing George and remove all files you find in there. Make sure
you're using George's packlist though... To ease the burden a bit I'll give a
rundown of the file which will be installed SOMEWHERE on your system:

scripts (in some bin directory)

oneripper
id3strip

modules (in the location you specified for LIB)

ObjCDDB.pm
ripenc.pm