Document id

        $Id: README.txt,v 1.1 2001/07/28 00:35:55 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/'. The
        created directories are `~/procmail/pm-lib/lib' and
        `~/procmail/pm-lib/doc'

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

        _3)_ peek inside any of the pm*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}

            # ...................................................................
            #  Define path where the libraries are:

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

            #  Load the initial startup, this defines 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

            # End of example


End
