NAVIGATION
----------
This section gives you some information on getting around in Goin' Postal.

Menu Bar
--------
The menu bar is accessed with the Menu key.  This will cause the menu bar to
be displayed at the top of the screen.  To make it disappear, press it again.
To navigate around the menu bar, press the left or right arrow keys.  To
select the highlighted item, press Enter.

Dropdown Menus
--------------
Most of the menu bar items are menus of their own.  When you select an item
on the menu bar that is itself a menu, it will appear as a dropdown menu.
Items ending with ... bring up yet another level of popup menu.

Function Keys
-------------
Each screen has various useful function keys associated with it displayed at
the bottom of the screen.  Every function key represents an item on one of
the dropdown menus.  For example, pressing F4 (Locale) from the status
screen it the same as going through the menu series Menu, then Options, then
Locale.

Menu Hot Keys
-------------
 o ENTER
The Enter key is used to edit an item such as a locale or mailhost.  Pressing
Enter on the menu item will take you to the items edit screen.  If you press
Enter on an item which cannot be edited, such as a mailbox, the Enter key
behaves like the Space key below.
 o SPACE
The Space key is use to select an item rather than edit it.  Pressing Space
on the menu item makes that item active.  For example, pressing Space on a
locale will cause that locale to be used when you go on-line.
 o DEL
The Del key is used to delete items from the menu.  Pressing Del on the menu
item will cause a verification to pop up on the screen.  For example,
pressing Del on an address book entry pops up a window verifying you want to
delete that address.
 o CAPITAL LETTERS
The capitalised letter of a menu item may be pressed in place of moving with
the arrow keys and pressing Enter.  This is similar to a graphical screen
where one of the letters is underlined.  Since underlining is not possible
on a text screen, the capital letter is used instead.

When naming locales and mailhosts, you have the opportunity to capitalise
whichever letter of the description you chose.  As the description is used
to build a dropdown menu, the letter you capitalise may be used as a hotkey.
Try to select unique letters to capitalise.  If the same letter is
capitalised on multiple items only the highest one in the menu will be used.

Notation
--------
Menu items described in this documentation will be shown in hierarchical
order.  If the documentation is describing the about box (which gives
information about the program) it will refer to Menu/Help/About.  What this
means is "Press Menu, select the Help menu bar item, then the About item in
the dropdown."  Using the capitalised letter shortcuts, this would involve
three keypresses; Menu-H-A.

Setup Screens
-------------
There are a number of setup screens with various fields to fill in.  You may
use the up and down arrow keys to move from field to field.  You may use the
left and right arrow keys to move within a field, and the backspace and del
keys to delete characters before and after the cursor.  Characters typed
will overwrite existing characters at the cursor.  To save changes made to a
setup screen, press F8 or use Menu/File/Save.  To discard changes, press F3
or use Menu/File/Toss.

SETUP
-----
Initial
The following steps need to be followed to configure Goin' Postal for the
first time.  If you have a more elaborate setup, first follow these steps
then read the next section.

Memory and Disk Requirements
----------------------------
You should allocate Goin' Postal as much DOS memory as possible.  Although
300K is currently the minimum, some editors and readers won't have enough
left over to load.  You might want to investigate using the MAXDOS utility
if you need to run Goin' Postal under the System Manager with an editor
requiring extra memory.

The required release files will take up about 115K of disk space.  You will
also need some room for your actual email.  Depending on the quantity and
size of mail you receive, assume at least 160k of disk space will be needed.
If you are very short on space, you can erase the help file GP.HLP, and use
a smaller editor such as Terse.

Set Up Your Time Zone
---------------------
Goin' Postal attempts to generate a proper time and date on outgoing mail
messages.  In addition, it also tries to display all incoming mail in a
directory listing relative to your local timezone rather than the senders
timezone.  To do this it needs to know the local timezone, the offset to
Co-ordinated Universal Time (UTC), and the name of the daylight saving
timezone if used in your area.  This is done using the SET TZ command from
DOS.  You may type it in prior to entering Goin' Postal, but you will likely
want to add it to your AUTOEXEC.BAT file.  This way you don't have to type
it every time you boot.

The format of the command is SET TZ=ZoneOffsetDst.  Zone is the normal
timezone abbreviation, PST for instance.  Offset is number of hours to
UTC (previously known as GMT), 8 for Pacific Time. If your area is ahead
of UTC, this value will be negative. Dst is the abbreviation for the
timezone when daylight saving time is supported in your area, PDT for
example. If your area does not use daylight saving time, leave this blank.
Here are some examples:

 o SET TZ=EST5EDT        East coast United States
 o SET TZ=PST8PDT        West coast United States
 o SET TZ=MST7           Arizona, no daylight saving time

A special format is recognized if you cannot determine the proper
abbreviation for your area.  This format uses the timezone abbreviation
UTC and the offset.  As an example of this format, to specify Malaysia
(which is 7 hours ahead of UTC) the proper command would be:  SET TZ=UTC-7

Special System Manager Requirements
-----------------------------------
If you are planning on running from System Manager, there are some special
configuration issues you need to address.  Do not run from the System Manager
DOS shell,  you must set up an icon with the following special attributes:
 o Place a bar and memory size following the path like this:
        C:\GP\GP.BAT|300
 o In the comment field, place an inverted question and inverted exclamation
   mark.  These are entered using Fn-3 and Fn-Filer.

Special Omnigo 700LX Requirements
---------------------------------
The 700LX has a built-in modem.  Though Goin' Postal runs perfectly on the
700LX, there is one manual step which must be performed first.  This only
applies to the 700LX!  Edit the GP.BAT file using RED, or an editor of your
choice.  Two lines must be added to this file.  Once added, the built-in
modem will be available on port COM1.
  1. Locate @echo off near the top of the file.  Add: serctl.com /p
     to a new line below it.
  2. Locate :finish near the end of the file.  Add: serctl.com /o
     to a new line below it.

Configure the Modem
-------------------
If you are using a PC Card modem, add the following line to AUTOEXEC.BAT if
it's missing:
   D:\BIN\CIC100 /GEN 1

Various pieces of information must be provided to access your modem.  Some of
this information includes the port number, the baud rate, and the dialing
command.  In addition, many modems need to have special configuration
performed using an initialization string.  Usually you will set the port
number to 1 for external, or 2 for PCMCIA modem.  Set the baud rate to
19200 and leave the dialing command blank.  Although you should identify
the proper initialization string for you brand of modem, the following
one works with most modems:
   ATE1Q0&C1&D2&K3

Configure a Service Provider
----------------------------
Service provider information is setup in Menu/Options/Locale.
Information about your primary service provider must be entered.  This
includes such items as their primary and backup telephone numbers, your
login name and password, the address of their nameservers (also known as
DNS servers), and the name of their SMTP server.  If you do not know this
information you will need to ask them.  In addition, you may need to write
a small login script.  Some providers do their login transparently at the
network layer.  Others require you to log in manually by answering a login
and password query.  If you have a provider which requires manual logins
you will need to build a script file.  This allows Goin' Postal to answer
the queries for you.  It contains simple instructions specifying what to
look for and what to send as a reply.  It is suggested that you use .SCR
as the extension for script files.

Writing a Script
----------------
The script takes the following commands:
 o EXPECT "goodtext" IN seconds UNLESS "badtext"

 This waits up to 'seconds' for the text in the first set of quotes.  The
 UNLESS parameter is optional and can be used to avoid waiting the whole
 timeout period.

 o SEND "text"
 o SEND LOGIN
 o SEND PASSWORD

 These send the quoted text, or the login or password for the selected
 Locale.  A carriage return is automatically sent also.  If you find the
 need to prepend or append text to your login, you can eliminate the
 carriage return by adding a semicolon ; to the end of any of the SEND
 lines.

 o TRACE
 This causes characters being read from the modem to be displayed on the \
 screen.  This can be handy when diagnosing a script failure.

 o DELAY x.x
 This causes the script to delay for "x.x" seconds.  The value "x.x" may
 be whole seconds (1, 2, etc) or tenths of seconds (.5, 1.5, etc).

The easiest way to build a login script is to connect to the provider using
a communication program.  You then write down a portion of what appears on
the screen, and what you type in response.  You will know that the provider
has entered network mode by the appearance of groups of characters
containing curly braces.

The following example might be used with a provider.  You'll notice not all
of the text is included.  This allows the script to work without worrying
if the first letter was capitalized or not.  Lines beginning with ; are
comments.

; Example of a login script - only an example!
DELAY 1.5
SEND ""
EXPECT "ogin" IN 15
SEND LOGIN
EXPECT "ssword" IN 15
SEND PASSWORD
EXPECT "elcome" IN 30 UNLESS "nvalid"
SEND "PPP"

Configure a Mailhost
--------------------
Mail accounts are setup in Menu/Options/Mailhosts.
Usually a mailhost (POP server) would be considered part of the service
provider information.  Goin' Postal keeps it in a different place to
facilitate the reading of multiple mailboxes independent of which provider
you are using to dial into.  Most of the information you will configure will
be personal preferences.  The information you will need from your provider
includes the name of the POP server, and the login and password for it.
Usually the POP server login will be the same as the provider login, however
there are exceptions.

When specifying a name for a mail account, do not imbed any spaces in it,
the name is used to create a mailbox file and won't work properly.

Filters take some knowledge of the header lines commonly found in a mail
message.  In Goin' Postal, they are used to automate headers-only mode.  Both
filters and headers-only mode are a bit involved.  You are encouraged to
register Goin' Postal and get the full manual before getting too involved
in with these.  If you really must, the filter language works like this:

A filter file contains one or more lines of tests to perform.  Each test
specifies a header name, a piece of text to look for, and an action to
perform.  The first test that passes determines the fate of the message.
If no tests pass, the message is indexed in the directory using the default
status.  The lines in the file are not case sensitive. The format of a test
line is:

  action IF header qualifier "text"

Action may be any of the following words:
 o GET           Get this messsage now
 o SKIP          Skip this message
 o TOSS          Discard this message now
 o MAYGET        Default this directory item to get.
 o MAYTOSS       Default this directory item to toss

Header may be any header field name.  The most commonly used are TO, FROM,
and SUBJECT.  Header may also be the word "SIZE"

Qualifier determines how to apply the search for "text" within the header
itself.  The following qualifiers are supported:
 o IS            Text after header name should match exactly
 o ISNT          Text after header name should not match
 o HAS           Text after header should contain specified text
 o HASNT         Text after header should not contain specified text
 o OVER          Used with SIZE, and followed by byte count (20000, etc)
 o UNDER         Same as above, but true if message is smaller than size

In general, the HAS and HASNT qualifiers are much better to use than IS and
ISNT.  This is because it allows for slight variations in the header line
you might not expect to handle.

The following ficticious example downloads mail from your boss, tosses mail
from an unwanted junk mailer, and sets your work mail to be retrieved
later.  If default is set to S, the remainder will be skipped:

   GET IF FROM HAS "boss@work.com"
   TOSS IF FROM HAS "spammer@4sale.com"
   MAYGET IF FROM HAS "@work.com"

The following example may be used to replace the "Maximum message size"
field, and will allow larger messages to still show on the menu and be
downloaded later (Headers Only mode must be enabled)

   GET IF SIZE UNDER 30000
   SKIP IF SIZE OVER 30000

Finding DNS In Windows 95
-------------------------
If you do not know your DNS addresses and typically connect using a Windows
95 system, here is how to find them:
 o Connect to your provider using the Windows system
 o Bring up the Run dialog using Start/Run, and type in WINIPCFG
 o On the window that pops up, click the More>> button.  DNS addresses are
   displayed near the top

