INSTALLING AUTOMATICALLY

The easiest way to install is via CPAN or CPANPLUS:

CPAN

% perl -MCPAN -e shell [as root] > install WWW::Shorten::Qwer
> quit

CPANPLUS

% cpanp
> i WWW::Shorten::Qwer
> 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 WWW::Shorten::Qwer can be downloaded from any CPAN site:

http://www.cpan.org/modules/by-authors/id/D/DA/DAVECROSS/ http://search.cpan.org/dist/WWW-Shorten-Qwer/

Interim and development versions may also be available from the author's web site:

http://code.mag-sol.com/

WWW::Shorten::Qwer is distributed as a gzipped tar archive file:

WWW-Shorten-Qwer-<version>.tar.gz

where <version> represents the current version number, e.g. 1.88.

To install the module, unpack the distribution archive to create an installation directory. Something like this:

tar zxf WWW-Shorten-Qwer-1.00.tar.gz or

gunzip WWW-Shorten-Qwer-1.00.tar.gz tar xf WWW-Shorten-Qwer-1.00.tar

You can then 'cd' into the directory created,

cd WWW-Shorten-Qwer-1.00

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/dave/

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/dave/lib/perl5/site_perl/5.6.0 );

If you're not after a custom location, just do:

% perl Build.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:

% ./Build && ./Build 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 './Build test'

ideally do './Build test TEST_VERBOSE=1 >& errs'

Send those to bug-WWW-Shorten-Qwer@rt.cpan.org and I'll get back to you as soon as I'm able.

If it worked, then become root and type:

# ./Build install

Congratulations. You've just installed WWW::Shorten::Qwer.

cheers,
Dave Cross
Magnum Solutions Ltd
http://mag-sol.com/