Whale Express (c) 1993-94  Tartan Software

INSTALLATION:

Included with the files you've downloaded is the Whale Express install
program.  Just run the program INSTALL.EXE from Program Manager,
File Manager or Windows launcher of choice.

The install program will allow you to create a special
directory for your Whale Express program files and scripts.
While you can include these files in your America Online directory
we recommend a separate directory for all Whale Express files.


IMPORTANT NOTES:  

* Whale Express requires America Online for Windows
  version 1.1 or greater.

* To cancel a script at any time use the F3 key.

* Some America Online options are required.  Use CTRL = in AOL to
  change these options. You don't have to be online at the time.

  Before using the SignOn command autopassword must be enabled.

  Before using NEWWIN.wex script you should disable confirmation of
  downloads when using the Download Later button.


DOCUMENTATION:

There are two files provided which can be printed out to provide a 
manual for Whale Express.  WHALEX.DOC is provided for users who
have Microsoft Word and would like proper documentation.  WHALEX.TXT
is the same document without all the custom formatting.



ORDERING INFO:

An order form is available in the Whale Express Help file.
The most critical information is to include your AOL screen name.
At the current time, check or money orders can be used to order
Whale Express. Your registered version will be distributed to you via
Email immediately upon receipt of $39.95 to the following address.
New York residents add sales tax.

Tartan Software
143 Horstman Dr.
Scotia,  NY 12302


For the quickest response, you may also registered directly on
CompuServe.  Go SWREG,  select "Register Shareware" and choose
Register by ID.   The Whale Express ID is  2221.


NEW FEATURES:

Previous Whale Express users please make note that we
have some good news and bad news.  New users can ignore the 
following info.


First the bad news...

There has been a change to the SelectList command
which will affect your current scripts.  We 
realize this will be bit of trouble, but we hope
you'll agree it's worth it to maintain consistancy
and allow for new functionality.

Now the good news...

SelectList now allows you to select a list item
by using text included in the list.

Example...

SelectList Lobby

Will allow you to select the Lobby regardless of it's
position in the list.  I'm sure many of you are using
SelectList to select a particular item in the list by 
it's position.

SelectList  2

We recommend you change these to include as much text
of the list item you'll need to create a match.  This 
will be worthwhile especially if AOL changes the items
in a list so that your script breaks.
If you stil require selection by position use the 
following convention.

SelectList #2

This is consistant with the SelectIcon command which also 
allows icon selection by position.

Now for the Great news!!!!!

We have a new command modifier for our powerful ReadList
command. "listMatch"

listMatch will allow you to specify particular items
you wish ReadList to process based in the text found in 
the list.

Suppose you want to read all Email from anyone named Bob.
All you need to do is add listMatch to your script.

Example:

OpenLog    bob.log
Menu       Read
listMatch	Bob
ReadList
Closelog

Any mail which has Bob anywhere in it's title will be read.
While logical operands such as AND and OR are not supported
you should find listMatch extremely useful in choosing the 
message boards you might be interested in reading.


===============================================================
New Batch Upload
===============================================================
We had a new Upload command which will allow you to include
multiple uploads in a single script.  This new command will only
be available for registered users.

Upload    filename

The Upload command may only be used when the current America
Online window is an Upload form.  This form is usually in response
to selecting the Upload icon, or using "SelectIcon Upload".


Before using the Upload command it's appropriate to set the values of
the various fields.  These values can be set once and used for each
upload or can be reset before each Upload command. If no values are set, 
default values will be used.

Subject
Author
Equipment
Needs
Description

Subject   data
This field is required by America Online
Data field is limited to 32 characters

Author  data
Data field is limitid to 20 characters

Equipment   data
Data field limited to 32 characters

Needs   data
Data field is limited to 36 characters

Description   filename
This data field should be the name of a description file.
If no file is specified default value is used.


Example script
In the following example we have a number of files, all with the same Author,
Needs and Description.  We set these fields once and then instruct Whale
Express to upload the file.  After the initial upload, we change the
Subject line and upload other parts

SelectIcon Upload
Subject PAINT: v1.3 Basic Paint Program
Author  My Software Company
Needs   An UnZIPing program
Description  C:\paint\mypaint.txt
Upload  c:\paint\mypaint.exe
Subject PAINT: Utility for MyPaint
Upload  c:\paint\paint1.dll
Upload  c:\paint\paint2.dll
Upload  c:\paint\paint3.dll
Upload  c:\paint\paint4.dll
CloseWindow

====================================================
Other Changes
====================================================
NewScreenName
Wasn't checking to be sure a user was already online.
Choosing NewScreenName while offline caused Whalex to
hang.

Screen Savers
Whale Express will not disable screen savers while
a script is running.  America Online will no respond
to Whale Express commands while a screen saver is
active.

Auto Re-Dial
Another favorite new feature has been added in response
to recent problems at America Online.  Signon and 
NewScreenName will now automatically redial when connection
fails.  The number of times can be set using the Read 
variable.  The default value is 5 time.

Fixed SendMail bug
Apparently we had reversed response when uploading files via
Email.  We were reporting file to large and failing.  You should
now have no problems uploading files via Email.

Fix some ReadList bugs.
Had some problems with listStart and listEnd, and the Read
variable.  This wasn't always accurate but should be fine
now.

Fixed Bitmap bug
Had some problems displaying bitmaps. 


