Documentation for MAILBOX.PRG - a NEWSie Utility
November 22, 1997
Updated: August 16, 1998

MAILBOX.PRG is a GEM utility program designed to recover email messages from the 
NEWSie MAIL path and rebuild Mailbox files (.MBX) to index the recovered email 
messages.

There is a single input from the user.  The user is asked to identify the MAIL 
path via file selector.  The selection will be echoed in an alert box, giving 
the user the option to continue or cancel.

Once the MAIL path has been selected and verified, the program will scan the 
directory for all *.MBX files and report their names.  At the same time, an 
index of all email messages within those mailbox files is produced.  Next the 
directory is scanned for all MAILnnnn.TXT files (email text), and the index is 
updated to identify all of the email text files that are not contained in a
mailbox.

If any orphan email messages (MAILnnnn.TXT) files exist, they are included in 
a new set of Mailbox files, starting with RECOVER0.MBX thru RECOVER9.MBX.  These 
Mailboxes can contain up to 100 email messages each, for a total recovery of 
1000 orphaned messages.  If you have more lost messages, you should rename the 
RECOVERn.MBX files to something else (i.e. FOUNDn.MBX) and run MAILBOX.PRG 
again.

Reasons for orphaned emails include:
	Erased or corrupted .MBX file(s)
	Sending email when the OUTBOX.MBX files has more than 100 messages.

This program has been updated to support mailboxes with more that 100 
messages.  Only 100 messages will be placed into RECOVERn.MBX files 
for compatibility.

An update for NEWSie v0.92 includes scanning the Mail directory for 
any sub-directories, and will include any 'MAILnnnn.TXT' files found 
in those sub-directories.  This support is necessary for the 'Create 
Mail Direcories' option created to provide multiple directories for 
the saving of email within a 'daily' directory.

There are three new alert boxes that display the number of directories, 
the number of mail messages in those directories, and the number of 
mail messaegs in those directories that are "unassigned".

Please let me know if you find any problems with using this program.
John Rojewski
rojewski@primenet.com