If you are upgrading from a previous version of ifile, please read the UPGRADE
file.
If you haven't already, please read the NOTES file before installing.

To install the ifile executables in /usr/local/bin, do the following:

	./configure --prefix=/usr/local
	gmake
	gmake install

If your "make" executable is GNU make, you should substitute "make"
for "gmake".  If no errors are reported, all the executables will have been
installed.  All of the executables can be executed from the command line
and most of them will yield usage instructions if given a "--help" command
line option.

After having installed the executables, you should check to make sure
that the ifile executables are in directories which are part of your
path. An easy way to check is to run "ifile --version" from the
command line.  ifile should print a version number and exit.

Next, you should run the knowledge_base.<mail_client> executable which
corresponds to your mail client.  This will build a database of your
mail, storing it in "~/.idata".

Once you've done this, you will need to give your mail client an
interface to the ifile system.  This entails giving your mail client
knowledge of how and when it should call the ifilter and irefile
executables.

Below lists mail clients I or other ifile users have adapted ifile to.  If
you find your mail client in the list, follow the given instructions on how
to complete your installation.  If you do not find your mail client on the
list, then if such adaption is possible, it will require a bit of hacking.

##############
# --- MH --- #
##############

Add the following line to your .mh_profile (changing /usr/local/bin to
the directory where irefile.mh was installed):

fileproc: /usr/local/bin/irefile.mh

If you use slocal to filter your mail, add the following line to your
.maildelivery file:

* - ^ ? ifilter.mh

If you add this at the beginning of your ~/.maildelivery file, all of your
mail will be directly filtered through ifile.

If you do not use slocal for mail delivery, you will need to devise a method
for passing messages through ifilter.mh.  Run "ifilter.mh --help" for
information on the ifilter.mh interface.

Last updated: Wed Dec 24 23:15:38 EST 1997 by jr6b+@andrew.cmu.edu

################
# --- EXMH --- #
################

This installation assumes that your MH binaries are in directories which
are part of your PATH environment variable.  If they are not, you will need
to add such directories to your PATH or you will need to edit ifilter.mh
and irefile.mh and specify their full path names.

If ~/.tk/exmh/ does not already exist, create the directory.  Copy ifile.tcl
to ~/.tk/exmh/.  Run "wish" and at the command prompt, type the following
lines:

# auto_mkindex ~/.tk/exmh ifile.tcl
# exit

After having done this, EXMH will call the ifile version of refile,
thus allowing it to keep track of mail that is moved to a different
mailbox.  Additionally, EXMH will have a new option under the
Incorporate Mail->Ways to Inc Preferences listing.  Choosing the
"ifile" option under this menu will cause all incorporated mail to
immediately be filtered through ifile.

If you do not want mail to be filtered upon arrival (rather having it
arrive in a common mailbox, filtering it at a later time), it is possible
to have ifile filter a message which is located in one of your mailboxes.
A procedure called "Msg_Filter" is created when ifile.tcl is added to the TK
procedure database.  This can be used to filter the currently highlighted
message.  This function can be activated either via a keyboard key, or via
a menu button.  To activate it through a key, open up the
Bindings...->Commands window, type "Msg_Filter" for the Command, some key
sequence for the Key (I use <Key-i>) and then press the Define button.
To activate it via a menu button, add the following lines to your
.exmh-defaults file:

*Mops.ubuttonlist: ifilter
*Mops.ifilter.text: Filter
*Mops.ifilter.command: Msg_Filter
*Mops.ug_nodraft: ifilter
*Mops.ug_current: ifilter

A new button called "Filter" will pop up the next time you use EXMH.  Simply
press this button when you wish the currently highlighted message to be
filtered.

$Id: INSTALL,v 1.6 1998/02/03 02:00:04 jr6b Exp $
