##############################################################################
# tb2kmail - exports mailboxes from The Bat! to a KMail compatible directory #
############ structure                                                       #
           ###################################################################


PREREQUISITES
=============

What you should have if you want to use tb2kmail:

* Windows  -- Don't trash it yet, you still need it.

* The Bat! -- I don't think you need an installed copy of the Mailer, it
              should work with a plain thebat.exe (plus some DLLs maybe),
              too. However, I haven't tested this.
              If you don't have it yet (what do you want to export then?),
              you can get it at <http://www.ritlabs.com/the_bat/>. Think
              about registering it if you stick with Windows. It's really
              worth it.

* Perl     -- Maybe you should give ActiveState's Windows port a try. It's
              available at <http://www.activestate.com>. If you use another
              one, then make shure you've got the following Modules (those
              are all shipped with ActiveState's Perl):
              * Getopt::Long v2.24+
              * Pod::Usage
              * File::Spec
              * File::Path
              * Win32::TieRegistry v0.20+
              If you miss one of them, try <http://www.cpan.org/modules/>.

* A cute little penguin (optional)

* A brain (recommended)


NEED MORE HELP?
===============

Try reading the man page. Call tb2kmail with the option --man to get it.

The script tb2kmail-finalize.sh might be worth a try. Call it on your Linux
box in the directory where the exported mailbox dwells. It'll rename your
Inbox, Outbox, etc. the way KMail likes it. The option -Y keeps it from
asking you when it's about to delete or overwrite a file.

Maybe (and I mean maybe) there's more information or a new version of
tb2kmail available at <http://msquadrat.de/projects/tb2kmail/>. Check
it out.

Don't forget to have a look at the file BUGS.txt!


COPYRIGHT
=========

Copyright (c) 2001-2002 by Malte S. Stretz <tb2kmail@msquadrat.de>

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License Version 2 as published
by the Free Software Foundation.