Switch from Getopt::Std to Getopt::Long and Pod::Usage.  This is much
better even though we don't use long options.

Improve NAME and SYNOPSIS pod.

(AUTHORS): Update.

Update svn:executable to modern Subversion convention.

Here you go.

This has no information not already in the POD, and minc is now ready
to run out of the box.  Bye bye README.

Drop Log::Dispatch (finally) and simplify logging.

Kill global constants LOG_DEBUGLEVEL, SCREEN_DEBUGLEVEL, DEBUGCHAR,
INFOCHAR, INCOMINGCHAR, SAVECHAR, WARNCHAR, ERRORCHAR.

Kill global $logger and functions logsave, loginfo, logdebug, logwarn,
logerr.

(mylog): Kill first two parameters; all @_ are now catenated for the
log message.  Simply open $logfile and write the timestamp and
message, no more.

(logheader): Renamed from logincoming.  Adapt to new mylog.

(log_headers): s/logincoming/logheader/

(store_message): Call mylog instead of logsave.

Two optimizations:

Don't load .mincspam until it is actually needed, in filter_mail.

Print the first status message (the number of messages to process)
as soon as we can, in getfiles.

File::Basename hasn't been used since we stopped using `mhpath new`.

(filter_mail): Only calculate $msgcount len once.

Killed the sysexits stuff a while back.

Don't break when -m is not specified.

whitespace police

Add new -m option to stop processing after a certain number of messages.

Switch to %opts style getopts.

Note licensing terms (same as Perl itself).

Whoops, SYNOPSIS was out of sync again.

Drop -h and use Getopt::Std automatic --help.  New $VERSION global.

Move STDOUT auto-flushing to filter_mail where it belongs.

Whoops, remove -f and -s options from getopts call.

Drop -f (filter-only) and -s (spam-only) options.

Er, put in the rest of the @SPAM changes.  Also make store_message
return the new message number.

Collapse the spam-checking and filtering passes into a single pass and
adapt the diagnostic output to make sense in the new single pass.

(store_message): Don't print anything.

(preprocess): Move the message sorting to MAIN and spam processing to
filter_mail.

(filter_mail): Do spam filtering in this loop and do all status
printing here.

(%FOLDERS): This should not have been global; move it into
filter_mail.

(MAIN): Sort messages before calling filter_mail.  If any SPAM
messages were detected, scan(1) them.

Drop sysexits.ph, _errprint, err, and errx.  Use die in place of err
and errx, and exit(2) for invalid options.

doc fixes

(preprocess): Return the @result list sorted by mtime.

Rename kill_spam to preprocess in preparation for bloat.  Clean up a
bit.

(getfiles): If no messages are found, silently exit early.

New option -p.  Using this option causes minc to print the filename
for each message before checking it for spam, which is useful for
debugging the spam filter.

use FileHandle and set autoflush on STDOUT since the new spam checking
is so fast the status reporting is now funky without autoflushing.

Document spam_check, spam_start_hook, spam_stop_hook.

My trick for defining is_spam() was broken and i never noticed because
i wasn't doing use strict in .mincspam; fix it with eval and also add
spam_start_hook and spam_stop_hook.

(kill_spam): Now call spam_start_hook(), save the list it returns, and
pass it to each spam_check() call (formerly known as is_spam()).  Also
pass it to spam_stop_hook() after processing all spam.  This allows
the spam processor to maintain state, and do other things like talk to
a co-process.

(store_message): Don't log the SPAM folder; since we hadn't logged
any headers in the spam case, it just fills the log with useless
crap.

(find_mh_folder): DOH!  The // match operation must be done
case-insensitive.  I think it used to be and i accidentally changed it
when i changed the substitution operation to matching.

mdeliver/current/mdeliver.c:
    (deliver): In rev 1582 i changed this from using rename(2) to
    the recommended link(2) + unlink(2).  But in minc i was using
    open(2) + rename(2) instead, which is just as safe as link +
    unlink but with one advantage.  So switch to that model.

minc/current/minc:
    (store_message): Document the open + rename procedure and
    explain why it is used instead of link + unlink.

Now that the new stuff has proved solid, switch back to reading
.mincfilter instead of .mincfilter2.

(logincoming): Move part of log_headers here.

(log_headers): Pass the array of contents for each header to
logincoming rather than indexing here.  logincoming now checks for an
empty array (i.e. message missing this header) before trying to index
into it (it used to bomb).

DOH!  Perl has 'next' not 'continue'.

Add a magic header filters can use to match against any To or
To-related header, based on procmail's '^TO' special regex.

(store_message): Fix usage of the system function so that the shell
won't be invoked.

Add Emacs and vi local variables at the bottom, (attempting) to
enforce four-space indents with no tabs.

(find_mh_folder): If get_headers fails, return 'malformed' instead of
'inbox' so that malformed messages are quarantined for inspection.

Doc fixes.

Implement Doug's two killer features: 1) store all occurrences of a
header, not just the last, 2) use pure ordered structure for the
filters, allowing inter-mixing of filters (i.e. you can have some
List-Id filters followed by some X-Mailing-List filters followed by
more List-Id filters and they will all be matched in the correct
order).

Earlier i was using Tie::IxHash to make the filters hash ordered, but
i wasn't using it for the internal hashes so it was incomplete.  I
didn't need hashes in teh first place; switching to nested arrays for
the filters structure solves this problem as well as Doug's killer
feature and as a bonus removes the Tie::IxHash dependency.

README:
    Remove Tie::IxHash from list of non-standard modules.

minc:
    Drop Tie::IxHash.

    FILTERS and %headers become more complex structures (code and
    documentation changes).

    For now, use .mincfilter2 instead of .mincfilter (will change
    back as soon as the new code has had a good shake-down).

    (log_headers): Adapt for new %headers structure and add comment
    cross-referencing the get_headers comment explaining the
    structure.

    (get_headers): Document the %headers structure.  Build and return
    the new structure, preserving multiple occurrences of the same
    header.

    (find_mh_folder): Use the new @FILTERS structure.

    (MAIN): Use @FILTERS instead of %FILTERS.

    In the closing pod section, fix the EXAMPLES section and add a
    section documenting @FILTERS.

Idiot.  Put error messages to STDERR where they belong.

Set MHCONTEXT environment variable to allow (a little) more
concurrency.  Document the new file.

Apparently pod2html doesn't grok E<sol>.  Suck.  Use E<047> instead.

Fix long-standing bug where filters were applied out of order because
hashes are not guaranteed to stay in the order they were defined.  Use
Tie::IxHash to make %FILTERS an ordered hash.

README:
    Note that Tie::IxHash is now required.

minc:
    use Tie::IxHash;

    (%FILTERS): Make this an ordered hash with Tie::IxHash.

Link to example .mincspam file.

Remove references to razor in documentation.

($run): Declare with our instead of my so it will be available to the
user-defined is_spam function.  Document this.

(store_message): Whoops, document that the for loop is a modified
version of the maildir delivery algorithm; now some of these other
comments make more sense.

Factor out the razor-check spam stuff.  Instead, read ~/.mincspam if
it exists, otherwise define a dummy is_spam function.  Document this.

(get_headers): Don't allow input from the message to break the
regex used to split headers.

Today i encountered a message with the following ilnes:

X-scanner: scanned by Inflex 1.0.12.3 -
(http: //www.gsm.com.my)

What we have is a broken pile of shit from gsm.com (unsurprisingly,
as i visit the URL they provide, i see that one of their frame
components spits out an HTML page with Content-Type: text/plain)
that doesn't know how to fold headers.  At some point, some "helpful"
mail software (perhaps even my very own postfix installation; who
knows?) mangled what appeared to it to be an '(http' header; it
added a space after the colon.

Whether the mangling had happened or not, i'm sure minc would have
been confused.  Doug Porter provided the fix (using perl's \Q and
\E in the split() regex to disable pattern meta-chars in $fieldname).

Er, whoops, tell getopt about the -f option.

(store_message): Splitting the two mark failure cases, i accidentally
reversed the sense of a test on one.

I was using EX_TEMPFAIL for nearly every failure case, as if this were
a delivery program.  Comb the file for each incidence and use a better
exit code if appropriate.

(store_message): Handle not being able to run the mark command and
being able to run it but having it fail separately.

Fix pod buglet.

Add new -f option, for only running filters.

(store_message): Explain why marking is done for each message individually.

Revert rev 243.

(is_spam): Move $line and $message to be declared at the top of the
function.

(%FOLDERS): Remove this global.  Whether to print the folder's name is
now being subsumed into the marking unseen messages functionality
moving into filter_mail.

(store_message): Don't run mark messages unseen, and start returning
the stored message number for callers to use.

(filter_mail): Keep a hash of folders and message numbers, printing
each folder name only once and running one mark(1) command for each
folder to mark the new messages unseen.

use Errno and Fcntl qw(O_WRONLY O_EXCL O_CREAT) .

(get_highest_msgnum): Restructure to step through readdir itself
rather than go through getfiles, since we don't want full path names
like that returns, but only the base filenames readdir returns.  Also
fix it to return the highest number in the folder, not that number
plus one, making its name accurate.

(store_message): Adapt to get_highest_msgnum returning only the
highest message number.  Use better $! test.  Only create the empty
message file with sysopen when not $run.  Use the full filename in the
error message when we couldn't find a new filename.

(get_new_msgnum): New function, loops across the list returned by
getfiles and returns the number for a new message to go into an mh
folder.  This is a replacement for the command 'mhpath new'.

(store_message): Address the XXX comment about using 'mhpath new' by
not using it, instead calling get_new_msgnum.  Furthermore, use an
algorithm similar to the maildir delivery algorithm to get the
filename to rename to.

(getfiles): Move definition of this function higher up, just below
store_message, since store_message is about to be calling (indirectly)
calling it.

Cross-reference to razor web site.

(getfiles): New function, returns a list of all entries in a
directory.

(MAIN): Call getfiles instead of using glob.

More mhpath todo commentary.

Change a couple uses of C's not operator '!' to Perl's 'not'
operator.

Write a couple XXX todo comments.

Document that HOME is used to find the maildir in the absence of
the MAILDIR environment variable.

Collapse the two 'use env' pragmas into one.

Move definition of logging constants to logging section.

(is_spam): Change logic of testing razor-check exit code slightly to
bomb if execution of razor-check failed (as opposed to sucessful
execution with a failure exit code).

(store_message): Test for failure when mark(1)ing the message unseen.

(_errprint): Use single-quotes for a printf format string.

(find_mh_folder): Fix logic: only use the lower-cased version of
the header string from %FILTERS for retrieving the header contents
from %headers.

(kill_spam): Be more clear about the meaning of the number printed
before returning.

Audit the entire file for correct -n behavior.

(store_message): Document why this calls mkfolder even in -n mode.

(is_spam): Don't actually do anything in -n mode.

(find_mh_folder): Down-case header from %FILTERS before trying to
use it.

(get_headers): Fix an XXX (print message and return () on encountering
malformed message.

(find_mh_folder): Handle get_headers failing.

(get_headers): Remove XXX question about whitespace after discussion
with dsp.

(log_headers): Adapt to the %headers hash now having all-lowercase
keys.

(kill_spam): Display progress report since this can be a lengthy
operation with no output otherwise.

(get_headers): Down-case the header name before using it as a key to
the hash.

(is_spam): Remove the system('false') line and actually call
razor-check now.

New -s option, for processing spam only.

($spamonly): New global.

(MAIN): Call filter_mail only if not $spamonly.

New error handling based on <err.h>.

(_errprint): New function, handles printing of error messages for err
and errx.

(err): err(3) for Perl.

(errx): errx(3) for Perl.

(mkfolder):
(store_message):
(is_spam): Use err instead of die.

Bomb if HOME isn't set and if MAILDIR isn't set use $HOME/Maildir.

Set svn:executable.

Add minc program, based on an earlier minc which was not developed
very far.