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.

NOTE: if you will be using slocal (via MH or EXMH) to filter your
mail, please read the section entitled SLOCAL.

##################
# --- SLOCAL --- #
##################

If you have yet to create a .maildelivery file, make sure that after you
create it, it is given permissions 0600 (chmod 0600 ~/.maildelivery).

If you plan to 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.

You should make sure to include a default rule in your .maildelivery file
which filters all mail to your inbox (or some other chosen default folder).
This default rule should go after all other rules and should look something
like the following:

default - ^ ? "/path/to/rcvstore/rcvstore +inbox"

If something goes wrong with ifilter.mh, this line will cause your
mail to be placed in your inbox instead of causing it to be lost.

slocal does not seem to pass the PATH environment variables to the
programs it executes.  Thus, before using slocal with the ifile
system, you will need to edit ifilter.mh and specify the locations of
the rcvstore and ifile binaries (by modifying the initial values of
the $mh_rcvstore and $ifile_binary varaibles).

##############
# --- 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.

################
# --- 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.8 1998/03/05 08:24:49 jr6b Exp $
