Document id

        $Id: README.txt,v 1.2 2002/01/01 23:34:26 jaalto Exp $

    Steps to install

        This document describes how to install the procmail library to your
        system. The procedure is quite simple:

        _1)_ Unpack the kit somewhere, like under `~/procmail/'.

        _2)_ Add startup code to your `~/.procmailrc' to let it
        know about the modules:

        _3)_ peek inside any of the *rc files and see how the installation
        instruction tell to take it into use. Have fun!

    Sample ~/.procmailrc

            # ~/.procmailrc

            # ...................................................................
            # Initial procmail setup.

            #   SHELL
            #   - it is highly important that you set shell to /bin/sh. See faq
            #
            #   DEFAULT
            #   - This is where your mail is delivered by default.
            #   - Usually /var/mail/USER
            #
            #   PATH
            #   - be sure the `sendmail' binary's path is included. See man page for
            #     path. Typically /usr/sbin
            #   - My path includes both SunOS and HP-UX 9 and 10 paths so that
            #     I can use same .procmailrc in every machine.

            UMASK       = 007           # James Bond :-)
            LINEBUF     = 8192          # make sure procmail won't choke
            SHELL       = /bin/sh       # VERY IMPORTANT

            #  This path structure will work accross various
            #  platforms: SunOS, HP-UX, Linux. It doesn't matter if there
            #  are non-exixtent paths.

            PATH =\
            :$HOME/bin\
            :/usr/contrib/bin\
            :/bin\
            :/usr/bin\
            :/usr/lib\
            :/usr/ucb\
            :/usr/sbin\
            :/usr/local/bin\
            :/usr/local/sbin\
            :/opt/bin\
            :/opt/local/bin\
            :/usr/lib\
            :/usr/ccs/bin\
            :/usr/contrib/bin\
            :/vol/bin\
            :/vol/lib\
            :/vol/local/bin\
            :${PATH}

            # ...................................................................
            #  Installation of the [procmail-lib/lib] by Jari Aalto

            #  Define path where the libraries are
            #  THIS VARIABLE MUST BE NAMED LIKE THIS `PMSRC' - All code
            #  depend on in Jari's library install depend on it.

            PMSRC  = "$HOME/procmail/pm-lib/lib"

            #  Load the central initial startup code
            #  This will define all the modules an variables

            INCLUDERC = $PMSRC/pm-javar.rc

            #   Now you can read any module simple by calling like above
            #   The complete list is defined in pm-javar.rc, peek there.

            INCLUDERC = $RC_LIST

            # ...................................................................
            #  Installation of the [procmail-lib/lib-stebbens] by Alan K. Stebbens
            #  This is Alan stebben's procmail library portion, it has no
            #  central setup like Jari's libraries have. Peek inside every code

            PMSRC2 = "$HOME/procmail/pm-lib/lib-stebbens"

            INCLUDERC = $PMSRC2/date.rc

            # End of example


End
