H2D.TXT                          Copyright (c) 1996-97 xTech Ltd
----------------------------------------------------------------

                          H2D v1.30
                          ---------
                         OS/2 Edition

                        Read Me First!


H2D is a translator of C header files into Modula-2 definition
modules. It is intended to be used with XDS family of Modula-2 /
Oberon-2 development systems, but can be adopted to other
Modula-2 compilers. We provide H2D to the public on a freeware 
basis in order to encourage more people to use Modula-2 and
Oberon-2.

NOTE:

This software is provided "as is". xTech Ltd. makes no warranty 
or representation, either express or implied, with respect to the 
software and documentation included with H2D. In no event will
xTech Ltd. be liable for direct, indirect, special, incidental or
consequential damages resulting from any defect in the software or
documentation included with this product. In particular, xTech Ltd.
shall have no liability for any programs or data used with this
product, including the cost of recovering programs or data.


1. Installation 
---------------


1.1. Non-XDS installation 

If you plan to use H2D with a third-party (non-XDS) compiler,
create a new directory (e.g. C:\H2D) and unzip the archive into it. 

NOTE: if you are using PKUNZIP*, specify the -d option, to have
      files unzipped into directories.

Example

    c:
    mkdir \H2D
    cd \H2D
    unzip c:\h2d130_os2.zip

In  the  following text we assume that you have chosen the C:\H2D
directory for installation. If another directory was used, please
use the name of that directory instead.

Now, edit the CONFIG.SYS file:

  - add the directory C:\H2D\BIN to executables search PATH
  - add the directory C:\H2D\DOC to the BOOKSHELF environment variable

Shutdown and reboot your system to make the changes work.


1.2. Upgrading an existing XDS installation

If you are upgrading H2D which came with your XDS compiler, unzip
the archive to the root XDS directory, say C:\XDS: 

NOTE: if you are using PKUNZIP*, specify the -d option, to have
      files unzipped into directories.

    c:
    cd \xds
    unzip c:\download\h2d130_os2.zip

No additional setup or reboot is required.


2. How to start
---------------

To invoke H2D, type

    h2d <header file>
or
    h2d =p <project file>    

at the OS/2 command prompt and press Enter.
 
To view the H2D on-line documentation, type
    
    view h2d


3.Contacts
----------

WWW:    http://www.xds.ru/xds/
        http://www.dct.com/~johnm/xds.html
	http://ourworld.compuserve.com/homepages/modulaware/xds.htm

FTP:    ftp://ftp.xds.ru/pub/xds
        ftp://ftp.dct.com/pub/pmi

E-mail: support@xds.ru
