Installation Instructions The instructions are basically as per any Perl module. INSTALLING AUTOMATICALLY ------------------------ The easiest way to install is via CPAN or CPANPLUS: CPAN: % perl -MCPAN -e shell [as root] > install Test-CPAN-Meta-YAML > quit CPANPLUS: % cpanp > i Test-CPAN-Meta-YAML > q See your local 'perldoc CPAN' or 'perldoc CPANPLUS' for instructions on setting up and configuring CPAN or CPANPLUS. OBTAINING THE MODULE -------------------- The latest release version of Test-CPAN-Meta-YAML can be downloaded from any CPAN site: http://www.cpan.org/modules/by-authors/id/B/BA/BARBIE/ http://search.cpan.org/dist/Test-CPAN-Meta-YAML/ Phrasebook is distributed as a gzipped tar archive file: Test-CPAN-Meta-YAML-<version>.tar.gz where <version> represents the current version number, e.g. 0.17. To install the module, unpack the distribution archive to create an installation directory. Something like this: tar zxf Test-CPAN-Meta-YAML-0.17.tar.gz or gunzip Test-CPAN-Meta-YAML-0.17.tar.gz tar xf Test-CPAN-Meta-YAML-0.17.tar You can then 'cd' into the directory created, cd Test-CPAN-Meta-YAML-0.17 INSTALLING MANUALLY ------------------- The 'make install' (done later) will install the modules and scripts on your system. You may need administrator privileges to perform this task. Alternately you can install the module to a local directory (see ExtUtils::MakeMaker for full details), e.g. % perl Makefile.PL PREFIX=/home/me/ Don't forget to update your PERL5LIB environment variable if you do this, or add a line to your script to tell Perl where to find the files, e.g. use lib qw( /home/me/lib/perl5/site_perl/5.6.0 ); If you're not after a custom location, just do: % perl Makefile.PL If you are lacking any of the prerequisite modules, running that program will tell you. All prerequisites are available from CPAN. When you have them all: % make && make test If there are any failures, it's best if you contact me. It may help other people who have the same problem. I don't tend to read the Perl newsgroups or PerlMonks, so it's no use posting there. When you report your trouble, be sure to send me the following information; + result of `perl -V' + output from 'make test' - ideally do 'make test TEST_VERBOSE=1 >& errs' Send those to bug-Test-CPAN-Meta-YAML@rt.cpan.org and I'll get back to you as soon as I'm able. If it worked, then become root and type: # make install Congratulations. You've just installed Data::Phrasebook. If you have a copy of cpantest installed, type: % cpantest -g pass -nc -p `basename \`pwd\`` -auto Or: % cpantest -g pass -nc -p Test-CPAN-Meta-YAML-0.17 -auto That will tell both me and other potential users that the module built correctly on your machine. Cheers, Barbie. http://www.missbarbell.co.uk/