Added -clobber switch to mhstore(1) [Bug #11160].
[mmh] / docs / historical / mh-6.8.5 / miscellany / audit / CHANGES
1 V0.2 Changes 
2 ============
3
4 The variable $friendly now is set to the friendly part of the sender's
5 email address. For example, if the sender's address is:
6
7         strike@convex.com (Martin Streicher)
8
9 $friendly would be set to "Martin Streicher"
10
11
12
13 Keys for the %headers array are all lowercase. That is to say that if a mail
14 message has headers:
15
16         To: strike
17         Cc: george
18         From: zombie@foo.edu
19         Subject: News
20
21 the keys for %header will be "to", "from", "cc", "subject". $header{"subject"}
22 would be set to "News"
23
24
25
26 The "Received" headers in a mail message are now saved in an array called
27 @received. The first element in the array is the first received header;
28 that last element in the array would show the message being delivered to
29 your machine. See the Suggestions file for how to use this feature.
30
31
32
33 If someone from your local machine sends you email, $organization
34 is set to "local". If the site name (e.g.,"convex" for "pixel.convex.com")
35 cannot be determined, $organization is set to "unknown". Also, $organization
36 is much more reliable (I have not found a case yet where $organization
37 was not set correctly.) 
38
39
40
41 $organization is always in lower-case.
42
43
44
45 audit.pl was broken up to make the code more reusable. The utilities
46 refileto and refilefrom use some of the routines in audit.pl and mh.pl.
47
48
49
50 Fixed a bug that sometimes added NULL to an empty message body.
51
52
53
54 mh.pl has new routines to recursively create a directory path, parse your
55 MH profile and parse MH-like command line options.
56
57
58 New utilities
59 =============
60 There are two new utilities: refileto and rfolder and adjunts refilefrom
61 and rfolders.
62
63 refileto is used to refile messages into log folders according to who
64 you sent the messages to. refilefrom refiles messages you   have received
65 according to who sent you the message. 
66
67 By default all messages are logged into the folder +log. You can change this
68 by adding the line:
69
70         Logdir:                 log
71
72 to your .mh_profile. Also by default, the current folder is processed.
73 You can change that also. Here are the command line options for 
74 refileto/refilefrom:
75
76 refileto -help
77 syntax: refileto [msgs] [switches]
78    switches are:
79    -debug
80    -draft
81    -file file
82    -help
83    -link
84    -log +folder
85    -nolink
86    -nopreserve
87    -preserve
88    -rmmproc program
89    -src +folder
90    -verbose
91
92
93 A sample usage might be:
94
95 refileto -src +outbox -verbose 
96
97 -verbose shows you what is being files and where. Use -debug to check what will
98 happen without actually refiling the mail messages.
99
100 Here is a sample output of the command 
101 "refileto -src +log/outgoing -verbose all":
102
103 refile  -file /gmaster/home/strike/Mail/log/outgoing/5 +log/local/holt
104 refile  -file /gmaster/home/strike/Mail/log/outgoing/7 +log/convex/sowton
105 refile  -file /gmaster/home/strike/Mail/log/outgoing/9 +log/convex/lutz 
106         +log/convex/sowton
107
108
109
110 The rfolder utility is like folders: it can recursively descend 
111 a list of folders. However, you can use rfolder to run another MH command
112 in every folder it finds. For example, let say you want to sort
113 all of the subfolders in your +log folder.
114
115 You could say:
116
117 rfolder +log -all -recurse -verbose -exec sortm -textfield subject
118
119 -debug will show you what might happen without actually executing the
120 command.
121
122 By the way, -clean can be used to remove empty folders (empty folders
123 must be completely empty, without any .# or # files from rmm's, etc.)
124
125
126 You can even use refileto/refilefrom and rfolder(s) to build a new 
127 log directory from all your existing mail. Ala:
128
129 rfolder -all -recurse -verbose -exec refilefrom -log +log -src
130
131
132 rfolders implis the -all -recurse flags