Quick install (full explaination below):

- Unzip this package to a directory of your choice.
- If you do not have perl in /usr/bin/, edit the first line of
  install.perl so that it reflects the location of perl on your system.
- Execute install.perl and answer any prompts given by the program
- Set up your mail program to use slocal for mail filtering

To use ifile without any modifications, you must...

- use MH (or an MH-based program, such as EXMH) to handle your mail.
- have slocal installed on your system
- have "root" (or system administration) priviledges on your system

Please see the 'CHANGES' file if you have any trouble with installation and/or
the running of ifile.


Full installation explaination/instructions:

Unzip this package in the directory of your choice (I would suggest
/usr/local/ - it will create a subdirectory for its own files) and then
try to compile the binaries with a 'make clean; make all' command.  The
install program will also perform this command, but you should do it
beforehand to make sure the programs compile.  If you receive any warnings
or errors, you will most likely have difficulties running ifile.  Before
reporting these problems, please read the CHANGES file.  If after trying the
suggestions in CHANGES, report these problems to "jr6b+@andrew.cmu.edu".  Make
sure to include such information as operating system name and version,
compiler name and version and ifile version.

Once having seen a successful compile, run the install script (if you do not
have perl installed in /usr/bin, you will need to edit 'install.perl' and
change the first line to the proper directory).  Note that you must run the
install script as root.

The script will search for certain binaries, prompting you if it cannot find
them.  If you are prompted and aren't sure of their location, stop the
installation (Ctrl-C) and take the time to find them.

Once it has the directory information, the installation program will modify
your ~/.maildelivery file (creating it if necessary) so that slocal will call
the ifilter program.  It will then modify the programs to reflect the binary
locations and compile the necessary code to create executable ifilter and
irefile programs.  After having done that, it will backup the current MH
refile program (renaming it as refile.bak) and make a link to the location
of irefile.  It is important that refile.bak is not moved or deleted as ifile
relies on it to perform refile actions.

If you are using EXMH, you will need to change the [Preferences]
"Incorporate Mail -> Ways to Inc" option to "presort".

If you are using MH, you will need to have your mail sent to slocal (which
is what the above option will do for EXMH.  One possible way to do this is
to create a .forward file which pipes your mail to slocal.  If that
doesn't work, just about anything you do which will properly execute
slocal will allow ifile to filter your mail.

With the install program run, ifile is ready to be used by your user account.
Unfortunately, if you do not have a single-user system, this WILL effect the
other users on your system who use MH or EXMH.  The two major effects will be
a noticable slowdown when refiling mail and the creation of file in their
home directory, ".idata".  In the near future, I will be doing testing to see
if I can make it possible to have a local installation (i.e. levying no
ill-effect on other users of the system).

To allow other users to use the ifile filtering system, each user must
change their Inc option to presort and must add the following line to their
.maildelivery file:

* - ^ ? /ifile/install/directory/ifilter

The ifilter line acts as any other entry in the .maildelivery file.  If you
wish, you may add entries before the ifilter line if there are messages with
certain keywords which you always want handled in a certain way.

With this version of ifile, I have included a program which will search through
your currently stored messages and create your .idata file accordingly.  I
have found that this system of knowlege accumulation allows ifile much better
knowlege of your preferences and does a much better job of filtering messages.
To use this program, run "knowledge_base.perl" from your user account (i.e.
NOT as root).  If there are any folders which you do not want ifile to
attempt to filter messages into (like a 'drafts' folder), create a ".skip_me"
file in that folder.

Read the README file for more general information.
Read the CHANGES file for details on what new features have been incorporated
  in to ifile and for information about compilation problems and difficulties.

