SplitMail Version 1.0 Copyright 1998 by John Zeweniuk


OVERVIEW

     SplitMail is a shareware application written in Java which allows the user to split large
files into multiple pieces of user definable sizes.  SplitMail will then send split files or any other
file via email to another user. SplitMail also joins files split by this program.  This program is
primarily intended to make the sending of large files over email quick efficient and painless.

Features:
     
     Quickly and easily split files into arbitrary sizes
     Generate a batch file for split file reassembly by people who do not own SplitMail
     Join files split with SplitMail
     Email multiple split files with the touch of a few buttons
     Easy user interface
     Written in Java to be easily run on any platform which runs Java

DISCLAIMER/LEGAL STUFF

  The programmer of this application can accept no responsibility for any damages which may
result from the use of this program.  The software herein is provided "as is" without warranty of
any kind, either expressed or implied, but not limited to, the implied warranties of merchantability
and fitness for a particular purpose.  The user must assume the entire risk as to the quality and
performance of the software.  Should the software prove defective, the user assumes the entier
cost of all necessary servicing, repair or correction.  Any liability of the seller will be limited
exclusively to product replacement or refund of purchase price.  This warranty gives you specific
legal rights and you may also have other rights which vary from state to state and country to
country.

This program is shareware.  As an unregistered user of this software you may evaluate SplitMail
for a most 30 days after which you must either purchase the program for $15 US funds (or $20
Cdn) or remove it from your computer.  

Registration:
 After you have evaluated SplitMail you may register it by sending $15 in US funds ($20 Cdn) by
either check or money order made payable to John Zeweniuk along with your name, address and
email address to:

                    SplitMail
                    Box 1359
                    Parksville, B.C.
                    Canada
                    V9P 2H3

You will receive a registration number via email (or regular mail if you do not provide an email
address) which you enter to register the software.   A printable registration form is included with
this distribution called REGISTER.TXT  





HOW DO I USE THIS PROGRAM?

Entering configuration settings.

     The first thing you should do when you run SplitMail for the first time is to configure and
save your email and directory settings.  After you have run the program you will see five tabs 
near the top of the window.  The first four are labeled "Split", "Join", "Mail Files" and "Settings".
If you click on the Settings panel with your mouse you will see four text boxes to enter your
settings.  

     The first setting will be your SMTP Server.  This is for outgoing email.  If you do not
know what this is contact your Internet provider and ask what your SMTP Server is.  It should be
something like : mail.YourDomain.com.

     Next you must type in your email address under the heading "Your email address" This
must be your complete email address.  For example mine is "zewsoft@bcsupernet.com".

     That is all the email settings SplitMail needs.  You may also set up some directories if you
wish.  The working directory defaults to "Projects" which sits in SplitMail's current directory. 
You may assign the working directory to any directory you choose.  You may also assign an
incoming email directory.  I assign the incoming directory to my main email client's attachment
directory.  This way when I receive files split by SplitMail they are easy to find and reassemble.
Once you have typed in your desired settings click on save.  Your configuration will be saved for
the next time you run the program.  The configuration is saved in a file called Smail.cfg in
SplitMail's current directory.

Splitting Files:

     When you first run SplitMail the File splitting panel is active.   The first thing to do is to
select the filename of the file you want to split.  You do this by entering the filename (including its
path) in the text box labeled "filename".  You may browse through your files for the file you want
by clicking on the "Browse" button with the mouse.  When you have selected a file, information
about the file's size and how many pieces it will split into appears at the top of the screen.  

     Next you must select a split size.  This is the size that each split piece will split into.  The
default is 1.4 Meg (the capacity of a 3.5" floppy disk) You may type in a custom size in the text
box labled "split size" This number will be in bytes, kilobytes or megabytes depending on which
file size  switch is selected. By changing the split size you will get updated info on the number of
pieces the current file will be split into.

     After you have selected a file and the split size you may also select the target directory. 
Your options are Same directory, Working directory and Other directory.  Splitting to the Same
directory will split the files to the directory that the original file is located in.  Splitting to the
Working directory will split the files to the directory specified in the Settings panel under
"Working Directory".  Finally, you may select an alternate directory to split to by clicking on
"Other directory" and typing in the desired destination directory in the text box underneath the
"Other directory option"

     You are now almost ready to split your file.  There are only two more options to consider. 
If you select "Delete original" (underneath "Filename") the original file will be deleted after the
split operation.  Finally if you select "Batch File" the program will generate a Windows
compatible batch file so that you can send split files to someone who doesn't own SplitMail.

     With all these options selected you are now ready to split the file.  Click on the "Split"
button (beside the "Browse" button near the top of the panel) Your file will now be quickly
busted into pieces.  The Job Status and Job progress give you information about what the
computer is doing while processing the current splitting job.  

     The resulting split files are named the same as the original file with the extension
".esplitXX" added to it.  The X's are a number corresponding to the order of the split files.  A
small information file is also generated with the extension ".esplit" with no number.  This program
assumes that long file names are legitimate.

Joining Files.

      Split mail allows you to easily join files that were split with SplitMail.  By clicking on the
"Join" tab at the top of the SplitMail window the program will shift to the Joining pane.  In the
joining pane there is a list box to the left.  This box displays the files in the working directory and
incoming email directory which are eligible to be joined.  If any files appear in the list joining that
file is as simple as clicking on the item in the list and clicking on the "Join" button at the top right
of the window.  When you click on an item in the list the filename with its full path will appear in
the text box under "filename" 

     If the file you want to join does not appear in the list you may type in the file (including
the path) in the "filename" text box.  Also, you may browse through your files for the file you
want by clicking on the "Browse" button.  To join a file with SplitMail you must select the control
file (the file with the extension ".esplit" this file tells the program how many files it needs to join). 
Selecting a file other than the ".esplit" file will result in an error because the program will not
know which files to join.  

     Once you have selected a file to join all you have to do is select the directory to join to. 
The options are "Same directory", "Working directory" or "Other directory" These options work
the same as for splitting files.

     If you want to delete the split files (".esplitXX" files) then click on the "delete split files"
button below the "filename" textbox.

     When you have selected a file to join and selected a destination directory simply click on
the join button and if all the needed files exist the split files will be reassembled into the original
file.  The status window and status bar give you information while the program is joining your file.

Mailing Files

     The primary purpose of this program is to make emailing of large files easy.  To that end
you may email file right from the SplitMail program.

     First you click on the "Mail Files" tab at the top of the SplitMail window.  This will take
you to the file mailing pane.  To the left of the window you will see a list.  This is the same list as
the list in the "Join" pane.  It displays all the files that were split by SplitMail which reside in the
Working directory or the Incoming email directory.  You can select an item from the list for
emailing by clicking on that item.  The filename will appear in the Filename textbox.  Also you
may browse your files for any other file to send by clicking on the "Browse" button.  You may
select files of any type, but if you select a file that ends in the ".esplit" extension you will be asked
if you want to send just that file (the small information file) or all the split files associated with
that information file.  

     Once you have selected a file to send all you have to do is type in the destination email
address under "Send file(s) to:" Once the destination email address is set click on send and
SplitMail will contact your internet provider's email server and send the selected files to the
destination email address.  Its that simple.

Entering a registration code.

Once you have sent in your registration you will receive a registration code via email (or regular
mail if you do not provide an email address) To register your copy of SplitMail run the program
and select the "register" tab (the tab at the far right) In the registration pane click on the "register"
button.  A dialog will pop up with two text boxes one for your name and one for your registration
code.  Under name type in the name as it appears in the registration email you recieved from me. 
Be sure to put capitals and lower case letters in their proper places.  Then in the registration
number box type in the registration code you recieved via email exactly as it appears in the email. 
Click on ok, and if everything was entered correctly you should see a message thanking you for
registering the program.  The next time you run the program the inital screen telling you the
program is not registered will not appear.  Also the "register" tab will become an "about" tab
which contains the program version information and your registration information.
Note: the registration information is saved in the config file ("Smail.cfg") If for some reason this
file is lost or corrupted you may have to re-enter your registration information.
Note: To register send $15 US funds ($20 Cdn) by check or money order made payable to John
Zeweniuk  along with the version number (Version 1.0), your name, address and email address to
                            SplitMail
               Box 1359
               Parksville, B.C.
               Canada
               V9P 2H3
                 

Benefits of registering

Registered users will receive free upgrades via email, the web  (or via regular mail for a shipping
charge of $5.00) You will receive notification of upgrades via email and registered users will also
get significant discounts on other shareware software developed by me.

.  
Notes

This is the first release version of this program (Version 1.0).  There are a number of features
which I am planning to implement in subsequent versions.  I am not aware of any major bugs in
this program, though there are a few annoyances which I am in the process of fixing.  
      Sometimes popup dialogs don't popup the right size
      When you select different split sizes (ie. Bytes, kbytes or megabytes) the program
displayes numbers like 3.4 kilobytes as 3.399414 if you select a different size then go back to the
original.  This is just in the display and doesn't affect the operation of the program.
     The "Other directory" options and directory settings need browse dialogs, this is in the
works.  

There are a number of other features planned including scheduling file sending, "manually joining"
any arbitrary files, checking email from within the program and a bunch of other things so stay
tuned.

I hope this program is useful and convenient.

Speed issues

     The Win32 version of this program defaults to running without the JIT Compiler.  This
means the program starts up a little quicker but overall runs a little slower.  My experience has
been that getting the program running quicker is more convenient and you can barely notice the
overall slowdown.  However if you want to wait a little longer for the program to start, but enjoy
faster operation while the program is running you can do this by right clicking the program icon,
select properties and under shortcut, in the target box remove the "-nojit" part of the target box.  
I will make a Win95 only version of this program if there is enough interest.  It will be available
free to registered users of the Java Version.


Contact info

email: zewsoft@bcsupernet.com

 (for the latest updates and related files) 
web: http://www.bcsupernet.com/users/zewsoft/

Regular mail:

     SplitMail
     Box 1359
     Parksville, B.C.
     Canada
     V9P 2H3

I welcome any comments, suggestions, bug reports, money, postcards etc.
If you have any problems with this program I will do my best to help solve it.  Just email me.

