How to get the email survey going...
====================================

The email survey is a collection of scripts written in Perl for collecting
fairly anonymous data about your email and returning it to the author so he
can work on some nice graphs for his thesis.  See README for a general
description of usage and how it all fits together and how to use it, this file
will tell you how to make it work.

It was written on a Debian 3.1 stable box with Perl v5.8.4

Due to the constraints on time and with a nod towards sanity it was written
with a number of modules for Perl, all of which are available from CPAN (as
well as possibly from your Perl-distributor or OS-distributor).

Heres the following total list of modules needed:

File::Compare
File::Find
File::stat
Getopt::Std
Mail::IMAPClient
MIME::Parser
POSIX qw(strftime)
strict
warnings

'File::Compare', 'File::Find', 'File::stat', 'Getopt::Std', 'POSIX', 'strict',
'warnings' should all be part of your Perl distribution.

However you will almost certainly need install 'MIME::Parser' (actually the
whole of MIME-tools is probably wanted).

All these modules are available from CPAN (http://www.cpan.org), modern
Linuxes should have cpan(1), if so reading 'man cpan' should help.

Generally all you need to do is run cpan then at the prompt type:
install module::name

Alternatively you can try either of the following methods:
perl -MCPAN 'install module::name'
cpan install module::name

However On a Fedora machine the following was reported to work:
cpan
get MIME::Parser
look MIME::Parser
perl ./Makefile.PL
make
make install


Failing that you can download them from:
http://search.cpan.org/dist/MIME-tools/

File::LibMagic used to be required but was largely unreliable and a pain to
install.  A by hand classification system has replaced it.  This is a little
slower but appears more reliable.

On Debian machines you can 'apt-get install libmime-perl' to get the complete
MIME-tools package.


You only need to install Mail::IMAPClient if you want to use the stats/imap
method of gathering statistics from an IMAP account.  This can be installed on
Debian machines with:

apt-get install libmail-imapclient-perl

Otherwise it should be available from CPAN.  Or failing that
http://search.cpan.org/dist/Mail-IMAPClient/



Having Trouble?
===============

For more information consult your Sysadmin or google.com   If you mail me then
I may be able to help but it depends upon your setup.