________________________________________________________________________

RADpage Developer with heitml 2.01b 
README FILE
(C) Copyright 1998-2000. H.E.I. GmbH Mannheim, Germany and its suppliers
All rights reserved.
________________________________________________________________________

Thank you for your interest in RADpage Developer with heitml.

This file includes information on
   - where to find an introduction and documentation,
   - how to install and register,
   - how to setup the samples,
   - how to contact H.E.I. and
   - the license conditions.

Please read either Evallic.txt for evaluation license conditions and License.txt
for commercial license conditions or BetaLicense.txt if this is a beta version or
a preview.

What is RADpage ?
-----------------

RADpage is a Rapid Application Development tool directly working 
in your Web browser. Using RADpage you can compose dynamic Web applications
from ready to use components and directly customize applications in
your browser.

RADpages Key Features are
 * WYSIWYG component editing directly in the Web browser
 * Editing of fully functional running applications (no edit view required)
 * Library of more than 150 ready to use components
 

RADpage is also a full programming tool based on the heitml (pronounced as 
HTML but Hi-TML) language. heitml is a Server side extension of HTML with 
full-featured programming language constructs that allow easy access to databases.

heitml's Key Features are
 *  extended, interactive HTML 
 *  object orientation
 *  control structures
 *  user defined tags (components)
 *  complex expression evaluation and
 *  database access via ODBC(32-bit)
 *  session data 

What is RADpage Developer with heitml?
--------------------------------------
RADpage Developer with heitml is a single-threaded Web server with built-in support 
for RADpage and heitml.
It was designed for developing and testing Web applications locally before they
are installed in an Intranet or on a Web site at some Internet provider.
It was not designed to function as a Web server in production mode.

What do you need ?
------------------
You need the TCP/IP network protocol, a winsock and
an ODBC compliant database system.

You need the most recent ODBC 32-bit Drivers.
The file READMEodbc.txt tells you where you can download ODBC 32-bit Drivers.

We tested RADpage with heitml together with MS SQL Server (TM), MS Access (TM),
and the MS text database driver, but any other ODBC compliant database system
should work as well.

Where is more information ?
------------------------------
An introduction to RADpage and heitml and the complete documentation
can be found online at "http://www.h-e-i.de/devheitml", "http://www.heitml.com"
or "http://www.radpage.com" and offline (after installation) through the
following URL: "http://localhost/heitml2.0/tutor/index.hei".

Installation
---------------

0. a. Verify that the TCP/IP protocol is installed on your computer by
      opening a Command Prompt and try 'ping localhost'. If you get a reply
      from IP address 127.0.0.1 continue with step b, otherwise try
      'ping 127.0.0.1'. If you still get no reply, install the TCP/IP protocol
      through 'Control Panel/Network', otherwise perform the following steps:
        i. Rename the file 'Hosts.sam', located in the Windows directory to
           'Hosts' (no extension). 
       ii. Open the 'Hosts' file in a text editor. Add or uncomment the entry 
      
            127.0.0.1       localhost
      
           then save your changes. 
      iii. Retry 'ping localhost' from the Command Prompt.
         
   b. Check whether your browser automatically dials an Internet connection
      on http://localhost. Though it should not do that, you have to disable
      the auto-dial feature in order to use a Web server on your computer.
      For example, with Microsoft Internet Explorer, use to the 'Connection'
      tab on the 'Properties' page to disable dialing a connection.
      
   Your computer should now be configured to use a local Web server.
   
1. Make sure that the ODBC 32-bit drivers are installed.
   There should be an 'ODBC' icon in the Control Panel.
   RADpage with heitml will NOT work with ODBC 2.10 16-bit drivers!

2. Run the Setup.exe program to install heitml.
   By default heitml will be installed into "C:\heitml2.0radpdev", but
   you can choose your own installation directory.

3. This step is normally done by the RADpage with heitml Setup program,
   which creates an ODBC System data source called heitml2.0radpdev based on
   the Microsoft Access (TM) ODBC Driver.
   However, if the Microsoft Access (TM) ODBC Driver was not installed or
   installed after running the RADpage with heitml Setup program, or if you
   need or want to configure the ODBC System data source heitml2.0radpdev with
   the ODBC driver of another database system, you must perform this step
   manually as described in READMEODBC.txt.

4. Start RADpage Developer by double-clicking the 'RADpage Web Server' icon
   in the 'RADpage Developer' program group.

5. If you use a proxy server, configure your browser so that no
   proxy server is used for localhost.

6. From the 'Help' menu of the RADpage Developer program choose 'Documentation'.
   The heitml pages will tell you how to proceed.

   If you want to use a database other than MS Access (TM) for the RADpage/heitml
   examples, you should have performed step 3 manually and you should now use the
   User Guide/Maintenance page to create the necessary database tables.


Getting Started
------------------
We recommend to start reading the Getting Started pages of the documentation.
Choose Documentation from the 'Help' menu.

Then we recommend to go to read the RADpage tutorial 
(Choose Tutorial from the 'Help' menu).

How to develop RADpage / heitml applications
--------------------------------------------
To develop your own heitml applications, you should create your
own directories and connect them to the RADpage Developer by setting the
docroot accordingly using the 'Server/Options' menu.

To access other databases, first create another ODBC data source as described
in READMEodbc.txt. Then start the heitml Configuration Assistant
by clicking the 'admin' icon in the 'RADpage Developer' program group,
go to the directory where you want to develop your RADpage / heitml application, 
click the 'New configuration' button, click on the link
'view contents' and click on the link 'Database'. Edit the 
datasource name, and possibly the username and password 
(in case the database system requires this).
By clicking the link 'Programming', you can also give the include path
where heitml looks for its include files.

How to publish your pages
-------------------------
There are 3 ways to publish heitml pages:
1. Contact your Internet Provider and ask him for Leased heitml Web
   Space. After that, everything else should work just like
   publishing HTML pages. You can upload them by ftp (or another
   tool) to your Provider's Web Server.
2. Contact H.E.I. and ask for heitml Web Space on one of our Servers.
3. Build your own RADpage / heitml Web Server on Windows NT or Unix.
   Please consult http://www.heitml.com for server versions of
   RADpage and heitml.

In case of problems
-------------------

-  The RADpage Developer program starts and the message 'Cannot bind socket'
   comes up. Check that no other service is running on the port.

-  Images do not show up.
   The RADpage Developer program reads the content type for non-hei files from
   the registry. Open the registry editor and check whether there is a value
   'Content Type' for the key with the name of image file extension
   under HKEY_CLASSES_ROOT.

-  I would like to access another ODBC data source
   You must create another directory for your Web pages,
   start the heitml Configuration Assistant, navigate
   to the directory you just created, select the appropriate ODBC
   data source for the datasource option in the 'Database' menu
   and write the configuration.

-  I would like to execute an ODBC SQL statement returning
   multiple relations.
   Sorry, this is not supported by heitml version 2.01b.

-  heitml no longer finds the include files after I created
   my own directory.
   With the heitml Configuration Assistant verify that the include path
   option is set correctly for your directory.
   If the include paths are relative paths and your directory is located
   somewhere else, you need to modify this accordingly.

-  If all fails: Contact H.E.I. For a limited time we will
   provide email support, also to non-registered users during the
   30-day evaluation period.


Registration
-----------------
You must register heitml if you want to use it after the 30-day
evaluation period.

1. Register at "http://www.radpage.com/heitml2.0/register/".

2. You will then receive from us one serial key for your Web Server
   and, if necessary, additional keys for any Virtual Servers you
   are operating. These serial keys must be entered into the following
   file on your local hard disk: "C:\heitml2.0radpdev\program\serial.key"
   where "C:\heitml2.0radpdev" is the directory where you installed 
   RADpage Developer with heitml 2.01b.


HOW TO CONTACT H.E.I.
-------------------------------------
H.E.I. Representative...

Phone: +49/621/795141
Fax:   +49/621/795161
Internet: heitml@h-e-i.de


Acknowledgements
----------------

The heitml built-in function strptime has been incorporated with modifications
from the following source:
/*
 * Copyright (c) 1994 Powerdog Industries.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer
 *    in the documentation and/or other materials provided with the
 *    distribution.
 * 3. All advertising materials mentioning features or use of this
 *    software must display the following acknowledgement:
 *      This product includes software developed by Powerdog Industries.
 * 4. The name of Powerdog Industries may not be used to endorse or
 *    promote products derived from this software without specific prior
 *    written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY POWERDOG INDUSTRIES ``AS IS'' AND ANY
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE POWERDOG INDUSTRIES BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
