****************************************************************************
*                                                                          *
*       HappyMail                                                          *
*                                                                          *
*       Version 1.18 Release Notes                                         *
*                                                                          *
*       HappyMail is a Windows based e-mail client for the Banyan Vines    *
*       Mail System.  The client was originally designed for the 4.11      *
*       release of Vines, but has recently been modified to take           *     
*       advantage of some of version 5.5's improvements.  In addition,     *
*       HappyMail features several enhancements such as a spell-checker,   *
*       a text search capability, a sorting capability, and a WordPerfect  *
*       text viewer.                                                       *
*                                                                          *
*                                                                          *
****************************************************************************


Contents
========

1.  Disclaimer Notice
2.  File Listing
3.  Installing HappyMail
4.  Setting up the User
5.  Undocumented Features Documented
6.  Who to complain to


----------------------------------------------------------------------------

1.  Disclaimer Notice
=====================

THE HAPPYMAIL PROGRAM AND THE INFORMATION PROVIDED HEREUNDER 
(COLLECTIVELY REFERRED TO AS "SOFTWARE") IS PROVIDED AS IS WITHOUT 
SUPPORT OR WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, 
INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE DEVELOPER 
OR THE FINANCIAL MANAGEMENT SERVICE BE LIABLE FOR ANY DAMAGES 
WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, 
LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF THE DEVELOPER OR 
THE FINANCIAL MANAGEMENT SERVICE HAVE BEEN ADVISED OF THE POSSIBILITY 
OF SUCH DAMAGES. 

This Software may be copied and distributed royalty-free subject to
the following conditions:

1. You must copy all Software without modification and must include
   all source code and documentation, if the Software is distributed 
   without inclusion in your software product. If you are incorporating 
   the Software in conjunction with and as a part of your software product
   which adds substantial value, you may modify and include portions of 
   the Software.

2. You must place all protective disclaimers and notices contained on 
   the Software on all copies of the Software and your software product.

3. Unless the Software is incorporated in your software product which
   adds substantial value, you may not distribute this Software for
   profit.

4. You may not use the developer's or the Financial Management Service's
   name, logo, or trademarks to market your software product.

5. You agree to indemnify, hold harmless, and defend the developer and
   the Financial Management Service from and against any claims or 
   lawsuits, including attorneys' fees, that arise or result from the 
   use or distribution of your software product and any modifications 
   to the Software.



----------------------------------------------------------------------------

2.  File Listing
================


HappyMail requires the following files to run correctly:

BWCC.DLL
COMMDLG.DLL
VNSMAIL.DLL
HMSPELL.DLL
HAPEMAIL.EXE
HMHELP.HLP
HMCONFIG.INI
DICT.D
DICT.S
DICT.I
DICT.APP
WORDDOS.XTD
WORDWIN.XTD
WPERFECT.XTD

Two other files are included with the HappyMail system, this file, README.TXT,
and a user guide, HMUSER.DOC.  The user guide is in Microsoft Word 2.0 format.

When a user opens HappyMail for the first time, one additional file is 
generated, HAPEMAIL.INI. This file is used to store all the user-defined 
options, window sizes and placements, and all the HappyMail AddressBook 
entries. 


----------------------------------------------------------------------------

3.  Installing HappyMail
========================


Standard Warning
----------------
Before installing HappyMail on your Network, please read the rest of this 
file (especially the first four sections).  It will surely answer some
questions, and it will definitely save you some headaches.


Network Install
---------------
HappyMail is designed to run from a shared network drive.  All the files 
listed above should be placed in a single directory on a shared file service 
with Read Only access for end-users.  A SETDRIVE command for the file service 
should then be added to the end-user's profile (or preferably the sample 
profile). Each end-user should then have an item added to one of their 
Program Manager groups which points to the network drive and directory of 
HappyMail.


HMCONFIG.INI
------------
The HMCONFIG.INI file is used to set some global parameters,  and should be 
manually modified before allowing users access to HappyMail.  The file may
be modified with any text editor or with the Windows Notepad program. The 
initial configuration of the file is as follows:

[Options]
INI File Directory=P:\SETUP
Default Save Directory=P:\


The 'INI File Directory' setting is used to define the default location
of the HAPEMAIL.INI file.  Optimally, this parameter should be set to a 
directory on a network file service which is dedicated for individual use.  
Doing so will offer two major benefits.  First, the user-defined options and
the HappyMail address book will be available from any workstation a user 
happens to login on.   Additionaly, this means the INI file settings can be
reviewed by an administrator without being physically present.  This can be
helpful in debugging user problems.

The 'Default Save Directory' setting defines a default drive and directory 
for saving attachments.  This setting is designed for novice users who expect
to always see attachments saved to the same place.  For more experienced 
users, this default setting may be overriden by selecting 'Default Directory'
from the Options menu.


----------------------------------------------------------------------------

4.  Setting up the User
=======================


Minimum Client Requirements
---------------------------
The following is a set of MINIMUM system requirements for HappyMail. However, 
this is not necessarily a recommended setup.  In fact, I personally would 
never run Windows on a machine with 2M of RAM, or a VGA monitor, but it can 
be done. So, with that in mind, the minimums are:

-  an 80386 based microcomputer
-  two megabytes of RAM
-  a VGA monitor.
-  DOS 3.2 
-  Banyan Vines 4.11 
-  Windows 3.1 


Network Support
---------------
Before a user can begin to use HappyMail (or any other network based app), 
the network support should be enabled in their Windows setup. If a machine
does not display the Banyan Logo during Windows startup process, then most
likely the Banyan Network Support has not been implemented.  The following 
is a quick overview of the steps necessary to enable this support.

To setup the network support follow these steps:
1) If you are in Windows, exit out.
2) Login to the LAN.
3) Move to the Windows sub-directory (usually C:\WINDOWS).
4) Run SETUP.EXE.
5) Follow the on-screen directions to change the Network line to 
   Banyan Vines (Version 4.1).
6) Highlight "Accept the above configuration" and press [ENTER].

   (The next steps apply to Vines 5.50 or greater)

7) When you return to the DOS prompt, run Windows.
8) After Windows loads the Banyan driver it will detect it is not the 
   current version and ask your permission to upgrade. Select the [INSTALL] 
   button to begin the automatic update process. 


SYSTEM.INI Changes
------------------
Once network support is enabled in Windows, one final change is necessary.  
The SYSTEM.INI file has a setting which should be modified or added. Under 
the [386Enh] Section is a setting called EmmExclude.  This setting prevents 
Windows from using the specified block of memory.  Any upper memory which is 
in use by add-on hardware (ie your network card), should be specified with 
this parameter.  For example, if your network card uses c800-cbFF then add 
the line EmmExclude=c800-cbff.  Some folks suggest excluding the whole upper 
memory range (a000-fffe).  While this is the easiest method of eliminating 
memory problems, it can cause some DOS programs not to run under Windows.  
Therefore, I suggest excluding the whole range only when trying to diagnose 
a problem machine.

Adding the HappyMail Icon to Program Manager
--------------------------------------------
This section will briefly describe how to add the HappyMail program to a 
group in the Program Manager.  If you are familiar with this process already,
you should skip on to the next section.

Before adding the icon to a users desktop, you will need the full pathname of
the HappyMail executable.  The following directions assume the HappyMail
files were placed in the N:\HMAIL directory, and so the pathname is:
N:\HMAIL\HAPEMAIL.EXE.  You must substitute the proper pathname when executing
these directions (step 5).

1) Login to the LAN, then run Windows.
2) Select the Program Manager group, you wish to add HappyMail to, by moving
   the mouse cursor over the desired group icon or window and clicking the 
   left mouse button once.
3) Execute the File | New command from the menu bar in Program Manager.  This
   will cause a "New Program Object" window to appear.
4) Select the "Program Item" choice, then select the [OK] button.  Now a
   "Program Item Properties" window will appear.
5) Complete the fields in the Program Item Properties window as shown below:
        
        Description:            HappyMail
        Command Line:           N:\HMAIL\HAPEMAIL.EXE
        Working Directory:
        Shortcut Key:           None

  Note that the Working Directory field is intentionally left empty.  Once
  you have completed filling in these fields, select the [OK] button.  A
  HappyMail icon will now be added to the selected Program Manager group.


----------------------------------------------------------------------------

5.  Undocumented Features Documented
====================================


Due to time considerations, not all of the HappyMail features are documented
in the HappyMail User guide.  This section attempts to briefly cover these
features.


Text Search
-----------
The HappyMail text search, located on the Options Menu, will search envelopes
or full messages in one or more folders, for a specified text string.  Hits
are then displayed in the Search Window as they are found.  Once the search has
been completed (or aborted) the messages may then be read.  The message will
appear with the first hit in the message highlighted.

The search string may include mulitple words separeted by blanks. Additionally,
the '&' operator may be used to indicate a search for two unconnected strings
in a single document.  A search may be aborted at any time by clicking on the
[ABORT] button.  This will stop the search, but still display all matches found
up till that point.


Command Line Switches
---------------------
HappyMail incorporates one command line switch, /q or /Q (q as in quiet).
Using this switch causes HappyMail to bypass the display of the HappyMail
logo when first opened.  This feature is designed to speed up access for
remote users over dial-up lines (eg PC-Anywhere or Chatterbox users).
However, since the logo does not implement any time delay, there is no
advantage for directly connected LAN users to use this switch.


Window Sizing and Placement
---------------------------
HappyMail will store its own size, position, and icon placement, whenever
it is closed or exited.  These values are then restored when the program
is restarted.  Because HappyMail 'remembers' the previous icon position,
it will overlay another icon if that icon is now in the position HappyMail
previously occupied.  This can cause some confusion for those folks not
expecting it.  I recommend having users place the HappyMail icon in a
prominent place (ie NOT the left bottom corner), then close HappyMail to
save the new position.

HappyMail also stores the size, names, and positions of all open folders.
These folders are then re-opened and re-positioned whenever HappyMail is
re-started.

Finally, HappyMail will also store the size of the top-most read window,
if, and only if, HappyMail is closed while a read window is open.  Note that
the positioning is not saved, only the size.  


----------------------------------------------------------------------------

6.  Who To Complain To
======================


First, remember that HappyMail is not officially supported and no guarantees
or warranties are offered.  With that in mind, I do encourage bug reports,
enhancement suggestions, and general comments, so, send your e-mail to:

X.400:     N=DAVID RITCHIE/C=US/A=TELEMAIL/P=GOV+FMS
Internet:  DAVID.RITCHIE@FMS.SPRINT.COM

And, if all else fails...

David Ritchie
Financial Management Service
3700 East-West Highway
Hyattsville, MD 20782



----------------------------------------------------------------------------

