  This is OtlkToNs, a converter from 'OutLook Express' mail files
  to 'Communicator' v4.61 mail files

===========================================================================
  History
===========================================================================
  01-23-2000:  First Alpha release 

===========================================================================
  Features
===========================================================================
  This program can be used by anyone who wants to move his e-mail files
  from 'OutLook Express' (mbx) to 'Communicator' v4.61

  It can't process files from 'OutLook Express 5' because this release
  stores e-mail data in files with a format (dbx) that OtlkToNs can't
  read.

  It is still in Alpha stage and it may not work well with some *.mbx
  files. Also, the format specifications for the *.mbx files used in this
  program, have been recopiled from the Internet and may not be complete.

  'OutLook Express' uses some index files (idx) in order to speed up
  access to e-mail data. These are not used by this program because e-mail
  bodies keep stored into *.mbx files.

  Platforms currently tested:

  - Linux 2.2.10/glibc 2.0.7 (IA32)

  Platforms not tested, but it should work:

  - Linux 2.0.x/libc5 (IA32)
  - Linux 2.2.x/libc6 (IA32)

  It is a simple command-line program that takes two arguments:

  - 'OutLook Express' mail file (mbx)
  - Output file, it can be put into 'Communicator' v4.61 'nsmail/'
    directory

  Lot of diagnogstics will be printed on standard output, errors will be
  output on standard error

  I have not tested yet the output mail files in versions of 
  'Communicator' other than v4.61, but it should work in 3.x and 4.x

===========================================================================
  Installation:
===========================================================================
  Standard distribution includes the precompiled binary file OtlkToNs, it
  should work with Linux 2.x.x and glibc 2.x.x

  If you want to compile it, just type 'make' and the binary file will
  be created. You will need gcc 2.7 or later.

===========================================================================
  Files included in distribution:
===========================================================================
  LICENSE:      GNU GPL version 2
  README:       this file
  Makefile:     make file used to compile source code
  OtlkToNs:     program precompiled binary file
  OtlkToNs.c:   program source code

===========================================================================
  Example of use:
===========================================================================
  Suppose you have been using 'OutLook Express' for a time and want to
  switch to 'Communicator'. Then you have a lot of e-mail stored in 
  several files named *.mbx (see where OutLook stored them inside your
  'Windows' box), say you want to move e-mail stored in file 'Folder1.mbx'
  to a file that 'Communicator' understands. Then you should move the file
  'Folder1.mbx' (binary transfer) to your linux box and leave it where
  your copy of OtlkToNs resides, then you type:

              ./OtlkToNs Folder1.mbx Folder1 > /tmp/err

  If it is successfull no output is displayed, you have got a new file
  named 'Folder1' that must be copied into directory 'nsmail/' of your
  Communicator. Next time you start 'Communicator' you will see a new
  folder (in mail tool) named 'Folder1' that stores all your e-mail data
  as you had in your old mail program.

  If there is some kind of trouble you will get an error message and
  you can see what happened reading the '/tmp/err' file, where you
  will find progress of conversion process.

===========================================================================
  Documentation
===========================================================================
  None

===========================================================================
  Acknowledgements:
===========================================================================
  Tom Gallagher (teg@cableinet.co.uk): hints in structure of *.mbx files
                                        derived from his package 'idxmbx'

===========================================================================
  Copyright License: GNU GPL Version 2 (or later)
===========================================================================
  Please send feedback to the autor:

	Fernando P. Mate
	E-mail: fperezma@arrakis.es

	01-24-2000

===========================================================================
  Trademarks:
===========================================================================
  'Communicator' is a Trademark of Netscape Communications Corporation
  'OutLook Express' is a Trademark of Microsoft Corporation
  'Windows' is a Trademark of Microsoft Corporation

===========================================================================
  Appendix: format of *.mbx files
===========================================================================
  All data types are assumed to correspond to IA32 Architecture.

  - File header: unsigned int Magic;          // JMF6
                 unsigned int Version;        // 0x10003 ?
                 unsigned int nMsgs;          // Number of messages including
                                              //  those marked for deletion
                 unsigned int LastUsedMsgNum; // Index of last used message
                                              //  into idx file
                 unsigned int nBytes;         // Size of the MBX file in bytes
                 char         Pad[64];        // ?

  - e-mail data (repeated nMsgs times):

         - e-mail header: unsigned int Magic;    // 0x7F007F00
                          unsigned int Idx;      // Index in the MBX file
                          unsigned int TotalLen; // Total Length taken by this
                                                 //  entry
                          unsigned int MsgLen;   // Total length of all message
                                                 //  data

         - e-mail data as received from POP server. Always padded at end with
            0x00 bytes up to a boundary of (unsigned int)
