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

Copyright (c) 2001 by Jari Aalto. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). Distribution of the work or derivative of the work for commercial purposes in any form is prohibited unless prior permission is obtained from the copyright holder. (VI.B LICENSE OPTIONS)

This file has been automatically generated from plain text file with perl script t2html.pl 1.28
Document author: Jari Aalto
Contact: <jari.aalto@poboxes.com>
Html date: 2001-07-28 03:53