FORM READER Version 2.1 for Windows 3.1
 Shareware - freely distributable

A decoder and formatting program for processing HTML form generated 
e-mail resulting from the mailto method.  Does NOT require cgi 
capabilities. Runs independently from HTML form generators or HTML 
editors. Provides an MS-Access database interface and HTML guestbook 
interface capabilities.

Keywords: mailto, form, web, email, decode, parse, format, reader, 
  	  homepage, webpage, guestbook, internet

By Ridgeley House Software.
===========================================+
Copyright (c) 1996, 1997 by Curtis K. Aasen
All Rights Reserved.
===========================================+

TABLE OF CONTENTS

1.0  Minimum Requirements
2.0  Overview
3.0  Installation
4.0  HTML Overview
5.0  Additional Support
6.0  Registration
7.0  Support for registered users of previous versions
8.0  Version Changes
9.0  Disclaimer of Warranty

====================================+
1.0 MINIMUM REQUIREMENTS

In order to use Form Reader v2.1 for Windows 3.1 on your computer, 
the following minimum requirements must be met:

- minimum 80386 processor 
- Microsoft Windows 3.1 or higher 
- 5.0 MB of hard disk space 
- The file VB40016.DLL in the Windows\System directory

====================================+
2.0 OVERVIEW

Form Reader is designed to interpret and format e-mail that is 
generated from a Hyper Text Mark-up Language (HTML) form and sent 
via a world wide web (WWW) browser.  HTML forms that use the MAILTO 
action method to post can arrive as a single text string that is 
imbedded with various symbols and ascii hex codes making it very 
difficult to read.  Form Reader will interpret these e-mail 
responses, format them, and provide the user the option to add in 
delimiters, save the result as a text file, append it to an MS-Access 
database, insert it into an HTML file, copy and paste the result 
to another application, or print the result.

Form Reader will handle any HTML form e-mail response and HTML forms 
can be generated and changed independently from Form Reader.  For 
webmasters who do not have Common Gateway Interface (cgi) capabilities 
on their web server, this program will allow them greater access to the 
use of forms on their web pages.

MS-Access database support is intended for creating and 
appending to an MS-Access.  Some simple tools such as Find and Field 
Edit have been added in for useability, however, for full 
database manipulation it is recommended that the user import their 
database into their own fully featured database program.

Form Reader for Windows 3.1 v2.1 is shareware and may be used free of 
charge for a 30 day trial period. EACH copy in use must then be 
registered.  

=====================================+
3.0  INSTALLATION

Copy the file FRRD21W.ZIP into a temporary directory. Use PKZIP 
or a compatible unzip program to unzip FRRD21W.ZIP in this 
directory.

In the Program Manager choose Run from the File menu. Select the 
executable file SETUP.EXE that is in the temporary directory. Press 
Enter and follow the setup instructions. 

You will be asked to select a default directory to place your 
Form Reader program files. The default directory is C:\FORMRD21. 
You may change this to any drive and directory of your choice.

You should have the following files in your default directory 
after the installation is complete:

frhelp21.hlp
frrd21w.exe
read_me.txt
sampfrm.htm
samppost
sampgst.htm
register.exe
register.hlp

NOTE: You must have the file VB40016.DLL in your Windows\System 
directory.

=====================================+
4.0 HTML OVERVIEW

The HTML FORM tag defines a fill out form in an HTML document.
The ACTION attribute may be used to direct form responses to be 
sent to an e-mail address. This attribute uses the MAILTO command.

<FORM ACTION="mailto:your@e-mail.address" METHOD="post">

An example HTML form has been included. The file SAMPFRM.HTM is a 
complete HTML coded file that is ready to be read by a web browser 
that supports forms such as Netscape 1.1N and Netscape 2.0.  Also 
included is a sample e-mail response from this form.  This file 
name is SAMPPOST and may be opened by Form Reader.

Form Reader may have some interpretation problems if a form 
response includes the symbols "&" and "=". If a response 
includes these symbols, they may have to be removed manually with 
a text editor such as Windows Notepad.

It is recommended that if you use comment boxes that you enable 
virtual wordwrap.

Form Reader's guestbook and MS-Access interface occasionally make 
special use of any HTML form input keyword that begins with the 
six letters "comment".  In these cases it will attempt to make every 
effort to include longer input fields.  Examples of various comment 
field names are: comment, comment2, comment_3, comment_explain, etc.

When using Form Reader to create an MS-Access database all field names 
must be unique. Also, if radio buttons are used on the form then the 
form response that is used to create the database must have had all of 
the radio buttons selected (true.)

===================================+==+
5.0 ADDITIONAL SUPPORT

You can obtain help by e-mailing any questions or comments to: 

ridgely@infi.net

or

ridgely@kagi.com

Please indicate the program name, version number, serial number, 
any error codes, and any other windows programs you are working 
with such as e-mail and/or web browsers.  Any comments on possible 
future improvements or capabilities is greatly appreciated.

You may also visit the Ridgeley House Software web site for any 
updates and additional information at:

http://www.pilot.infi.net/~ridgely/ridgely/

NOTE: This program requires VB40016.DLL to run. You probably 
already have this file on your harddrive. If not you must 
obtain this file and place it in you WINDOWS\SYSTEM directory.
You can obtain this file from most freeware and shareware 
program download providers.

===================================+=+
6.0 REGISTRATION

Registration cost options:

 $9.95 per copy for e-mail registation
 $185.00 per site for Site License
 $725.00 per organization for World-wide License

This is shareware. You may use it on a trial basis for 30 days. You 
are not under any financial obligation for the trial period.  However, 
if you continue to use Form Reader after the trial period has expired 
you must register. Please refer to the registration instructions which 
can be found using the Registration command under the Help menu.

Users should register Form Reader through the author, Curtis Aasen, or 
Kagi.  Kagi is the only authorized registration service, other than the 
author, for Form Reader by Ridgeley House Software.

Those registering through Kagi will receive two e-mails. The first will 
confirm receipt of payment and the second e-mail will include the 
required registration code. Please allow up to ten days after receiving 
the first e-mail notification. If you do not receive your first e-mail 
please write to sales@kagi.com; for inquiries about the second e-mail 
please write to ridgely@kagi.com.

Form Reader is sold "as is". Please read section 9.0 DISCLAIMER OF 
WARRANTY.

Registered users of Form Reader for Windows 3.1 version 2.1 will be 
eligible for any new upgrade versions of Form Reader. To receive your 
upgrade, e-mail your name, registration reference, and the new product 
serial number to ridgely@kagi.com or ridgely@infi.net.

IMPORTANT: If you are a registered user and you must re-install Form 
Reader, then you may obtain a new registration number by e-mailing 
your name, registration reference, and the product serial number to 
ridgely@kagi.com or ridgely@infi.net.

====================================
7.0  SUPPORT FOR REGISTERED USERS OF PREVIOUS VERSIONS

Registered users of previous Form Reader products are eligible for any 
new upgrade versions of Form Reader. To receive your upgrade, e-mail 
your name, Registration Reference, and the new product serial number to 
ridgely@kagi.com or ridgely@infi.net.

If you do not know your Registration Reference or you never received one, 
please e-mail your name, e-mail address (used to register), your new 
e-mail address (if appropriate), and the new serial number. Your 
registration will be verified and you will receive a new Registration 
Reference along with your new registration code.

For a limited time previously registered users can access an on-line 
registration upgrade service located at the Ridgeley House Software web 
site.

====================================+
8.0 VERSION CHANGES

Version 2.1 replaces version 2.0. This new version includes an MS-Access 
2.0 interface and the Windows 95 version includes an MS-Access 7.0 
interface as well. Database functions such as Field Edit and Record 
Delete have been added. A third database can now be saved. Please note 
that this version requires the file VB40016.DLL rather than VBRUN300.DLL. 

Version 2.0 replaces version 1.2. Version 2.0 greatly increases the 
number of input fields that it can process. The number of input fields 
is a function of the size of the data elements and the amount of memory 
the host computer has. Version 2.0 also improves the conversion routine 
and improves the converted file display characteristics. An Add-to-
Existing file (append) function is included along with an MS-Access 1.1 
database interface and an HTML file interface for guestbook use. The 
user can now add in any delimiter of their choice. Font and window 
position changes are now remembered by the program. And finally (other 
than an Easter Egg or two) users can now register with a credit card 
through Kagi (see registration.)

Version 1.2 replaces version 1.1 which was limited to less than 30 
input fields. Version 1.2 has increased this limit to 100 input 
fields. There is now a file preference option so that default file 
Open and file Save directories may be set. A comma delimiter option 
has been added here. I'll let you figure out what you can do with a 
comma delimiter option. Also, a file View command has been added. 
In addition, the printer, save, and button bar features have been 
enhanced.

Version 1.1 replaces version 1.0 which had an initialization file bug 
that prevented non-United States users from running Form Reader. This 
problem has been fixed with version 1.1.  In addition, version 1.1 
fixes a failure of the font name, font style, and font size 
characteristics from applying to the printer object.

=====================================+
9.0 DISCLAIMER OF WARRANTY

FORM READER IS SOLD "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE 
OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR 
IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS 
INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A 
PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING PROCEDURE 
DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NON-CRITICAL DATA 
BEFORE RELYING ON IT.  THE USER MUST ASSUME THE ENTIRE RISK OF USING 
THE FORM READER PROGRAM.  ANY LIABILITY OF THE SELLER WILL BE LIMITED 
EXCLUSIVELY TO FORM READER PRODUCT REPLACEMENT OR REFUND OF PURCHASE 
PRICE. THIS DISCLAIMER MAY NOT BE VALID IN SOME STATES. CHECK YOUR 
LOCAL LAW FOR MORE INFORMATION.

=====================================+
Curtis K. Aasen
Norfolk, Virginia
06/01/1997 