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



modules (in the location you specified for LIB)



ObjCDDB.pm

ripenc.pm



