Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / miscellany / audit / Installation
1 1. Create a directory and unpack the perl files.
2
3 2. Create a perl script to audit your mail. You might name it something
4    like ~/.audit.
5
6 3. Follow the instruction in the README and require the files audit.pl
7    and mh.pl in your PERL script. 
8    
9    *
10    * BE SURE TO CHANGE THE PATH NAMES to 
11    * to the absolute path name of where you unpacked 
12    * the files in step 1.
13    *
14
15    If you install the .pl file in /usr/lib/perl, you can just
16    require them as in "require 'audit.pl';"
17
18 4. Create a .forward file in your home directory and add 
19
20    " | <pathname of audit file> <login>"
21
22    where <pathname> is the absolute path of your audit script
23    and <login> is your login name.
24
25 5. If you are going to use the refileto and rfolder utilities,
26    also edit the unshift line to reference the NEW absolute path.
27
28    By default it will look in the path reference by the environment
29    variable DELIVERPATH. You can change that to an absolute path
30    if you want to.
31
32    If you installed audit.pl and mh.pl in /usr/lib/perl,
33    you can delete the unshift line.
34
35 6. Make sure you chmod +x your audit file script!
36
37
38 For example,
39
40 1. My PERL files are in /gmaster/home/strike/work/perl/deliver.
41
42 2. My audit script is in /gmaster/home/strike/.audit and has
43
44     #! /usr/local/bin/perl
45
46     require '/gmaster/home/strike/work/perl/deliver/audit.pl' || 
47             die "deliver: cannot include audit.pl: $@";
48
49     require '/gmaster/home/strike/work/perl/deliver/mh.pl' || 
50             die "deliver: cannot include mh.pl: $@";
51
52     &initialize();
53
54
55    at the very top of the file.
56
57 4. My .forward file has:
58
59    " | /gmaster/home/strike/.audit strike"
60
61 5. I edited refileto and rfolder to say:
62
63    unshift(@INC, "/gmaster/home/strike/work/perl/deliver");
64
65    I could also have set DELIVERPATH ala
66
67    setenv DELIVERPATH /gmaster/home/strike/work/perl/deliver
68
69 6. I did:
70
71    chmod +x /gmaster/home/strike/.audit