Migrating heitml 1 applications

Here you can find useful information on how to migrate your heitml 1 application to heitml 2. See here for compatibility issues of the heitml 2 programming language.

Windows Platforms

To use your heitml 1 application (installed in c:\heitml1.23\htdocs\myapp) with heitml 2.1 (installed in c:\heitml2.1) perform the following steps:

1. Add a section to the global heitml configuration file:

   [c:\heitml1.23\htdocs\myapp]
   compat=1
   include=c:\heitml2.0\htdocs\heitml2.0\lib1.2
   lib=off
   

2. You might also want to add

   debugwindow=t
   

   if you want heitml error messages to be put in a separate browser window.
3. Save the global configuration.

UNIX platforms (Apache)

To use your heitml 1 application (installed in /usr/local/apache/htdocs/myapp) with heitml 2.1 (installed in /usr/local/apache/htdocs/heitml2.1) perform the following steps:

1. Add a directory configuration directive to the global heitml configuration file of your Apache Web server:

   <directory /usr/local/apache/htdocs/myapp>
   heitmlcompat 1
   heitmlinclude /usr/local/apache/htdocs/heitml2.0/lib1.2
   heitmllib off
   </directory>
   

2. You might also want to add

   heitmldebugwindow on

   if you want heitml error messages to be put in a separate browser window.
3. Save the configuration file.

UNIX Platforms (CGI)

To use your heitml 1 application (installed in /usr/local/heitml/htdocs/myapp) with heitml 2.1 (installed in /usr/local/heitml/htdocs/heitml2.1) perform the following steps:

1. Add a section to the global heitml configuration file:

   [/usr/local/heitml/htdocs/myapp]
   compat=1
   include=/usr/local/heitml/htdocs/heitml2.0/lib1.2
   lib=off
   

2. You might also want to add

   debugwindow=t
   

   if you want heitml error messages to be put in a separate browser window.
3. Save the global configuration.

All Platforms

1. Whereever you are using defbody in your own tags there must be a > or ; (surrounded by white space) afterwards. This is another main incompatibility to heitml 1, but already has been resolved in the lib shipped with heitml 1.23.
2. Don't use variables/functions in your code that are private/internal to heitml or a library. In heitml 2.1 these variables/functions start with an underscore _.
3. Delete all session files created by heitml 1 or use a different directory for your sessiondir.
4. In heitml pages that are using dynamic includes, the include files must be preprocessed manually.