==============================================================================
               English and German documentation for H2Unit
==============================================================================

------------------------------------------------------------------------------
H2Unit  Version 1.10  Copyright (c) 1997-2001 by ws it-service, Wolfram Schmid
------------------------------------------------------------------------------

What is H2Unit?

  H2Unit reads preprocessor #DEFINE definitions out of C header file (.H)
  and creates a Pascal interface Unit (.PAS) with corresponding constants
  (CONST).

  The assortment of the Pascal constants in the created unit can optional
  be carried out by name or by the value of the constants.

  As version information for your projects, constants (with counter,
  date and time) are being set out in the created Pascal unit.
  (refer to 'Usage and options')

  H2Unit is available for OS/2 and for Windows 95/NT (Win32).
  The OS/2 Version runs with OS/2 2.x, OS/2 Warp 3 and OS/2 Warp 4.

  H2Unit was developed with Virtual Pascal/2 v1.1 and Virtual Pascal 2.0
  from fPrint UK Ltd (http://www.fprint.co.uk).


For whome is H2Unit:

  H2Unit is for software developers, who develope under OS2 with Pascal
  (eg. with Virtual Pascal/2 or Speed Pascal/2) and who want to use the
  #define constants out of .H files in their Pascal programs.

  Thus you are able to use in your Pascal project the .H file, witch is
  created by the URE (Universal Resource Editor, Prominare Inc) automaticaly.


Contents:

  The following files are contained in H2Unit.Zip:

  H2Unit.exe  The OS/2 program
  H2Unit.txt  This documentation


Usage and options:

  Usage:    h2unit Source[.h] [Dest[.pas]] [Options]

  Source:   The name of the C source file. If no extension is given, then .H is
            assumed as default.

  Dest:     The name of the C destination file. If no destination name is
            given, the name will be taken from the soure file. If no extension
            is given, then .PAS is assumed as default.


  Optionen: /sn   The generated constants are sorted by the name.

            /sv   The generated constants are sorted by the value
                  of the constants.

            /o    Overwrite an existng destination file without prompting.

  If you use H2Unit without any arguments, than a short helptext will be shown.


Version Information:

  H2Unit creates in the produced Pascal Unit additional constants which you
  can use as version information in your project.

  Following constants are created:

    xxxBuild            A counter which is increased at each use of H2Unit
                        for a certain destination file.

    xxxBuildDate        Date and Time, when the destination file was created.
    xxxBuildTime

    xxxBuildDateStr     Date and Time, when the destination file was created
    xxxBuildTimeStr     as Pascal String.

    xxxBuildDateFirst   Date and Time, when the destination file was created
    xxxBuildTimeFirst   for the first time.

    xxx stands for the Pascal destination file name.

  In order to create this data, H2Unit creates a data file with the extension
  .H2U on the first use for every destination file. There, the counter as well
  as date and time are stored of the first use.
  For example if you create out of ABC.H the unit ABC.PAS, then the file
  ABC.H2U is created on the first use, the counter is initialized to 1 and
  date and time are stored.


Restrictions:

  At the moment only #define instructions with constant values
  are read (eg. #define xyz 0815).
  Calculated expressions as #define xyz abc+10 are not processd.
  Maximum 4096 #defines are processed.


Freeware:

   H2Unit is free of charge and may be distributed freely under the following
   conditions: Copyright notices must not be removed, all files contained in
   the file inventory below must be distributed together (you may not remove
   any files), and you may not charge for the program.

   If you find the program useful then send an email to: w.schmid@swol.de.

   Of course, no liability is taken for eventual damages which come from
   H2Unit.


Ideas, requests and errors:

  In case you need a function urgently, or if you have suggestions
  for improvements or changes or you found a mistake, please contact
  me by e-mail: w.schmid@elo-soft.com.

  Please also send an e-mail if you are using this program.


Wolfram Schmid


* All registered trademarks mentioned on these document are registered 
  trademarks or trademarks of their respective holders.


------------------------------------------------------------------------------
H2Unit  Version 1.10  Copyright (c) 1997-2001 by ws it-service, Wolfram Schmid
------------------------------------------------------------------------------

Was ist H2Unit?

  H2Unit liest Prprozessor #DEFINE Anweisungen aus einer C Headerdatei (.H)
  ein und erzeugt eine Pascal Interface Unit (.PAS) mit entsprechenden Pascal
  Konstanten (CONST).

  Die Ausgabe der Pascal Konstanten in der erzeugten Unit kann optional
  aufsteigend nach Namen oder nach dem Wert der Konstanten sortiert werden.

  Als Versionsinformationen fr Ihre Projekte werden in der erzeugten
  Pascal Unit Konstanten mit Zhler, Datum und Uhrzeit angelegt
  (Siehe: Aufruf und Optionen).

  H2Unit ist verfgbar fr OS/2 und fr Windows 95/NT (Win32).
  Die OS/2 Version luft mit OS/2 2.x, OS/2 Warp 3 und OS/2 Warp 4.

  H2Unit wurde mit Virtual Pascal/2 v1.1 und Virtual Pascal 2.0 von 
  fPrint UK Ltd entwickelt (http://www.fprint.co.uk/vpascal).


Fr wen ist H2Unit:

  H2Unit ist fr Programmierer die unter OS2 mit Pascal programmieren
  (z. B. mit Virtual Pascal/2 oder Speed Pascal/2) und die #define Konstanten
  aus .H Dateien in ihrem Pascal Programm verwenden mchten.

  Sie knnen so z. B. die vom URE (Universal Resource Editor, Prominare Inc.)
  automatisch erzeugte .H Datei in Ihrem Pascal Projekt nutzen.


Inhalt:

  The following files are contained in H2Unit.Zip:

  H2Unit.exe  OS/2 Programmdatei
  H2Unit.txt  Diese Datei


Aufruf und Optionen:

  Aufruf:   h2unit Source[.h] [Dest[.pas]] [Options]

  Source:   Der Name der C Quelldatei. Wird keine Erweiterung angegeben, so
            wird standardmig .H angenommen.

  Dest:     Der Name der Pascal Zieldatei. Wird keine Datei angegeben, wird
            der Namen aus der Quelldatei bernommen. Wird keine Erweiterung
            angegeben, wird .PAS angenommen.

  Optionen: /sn   Sortiert die erzeugten Konstanten aufsteigend nach dem Namen.

            /sv   Sortiert die erzeugten Konstanten aufsteigend nach dem Wert
                  der Konstan.

            /o    berschreiben einer schon vorhandenen Zieldatei ohne
                  vorherige Abfrage.

  Rufen sie H2Unit ohne Argumente auf, dann wird ein kurzer Hilfetext
  ausgegeben.


Versionsinformationen:

  H2Unit legt in der erzeugten Pascal Unit zustzlich Konstanten an, die Sie
  als Versioninformationen in Ihrem Projekt benutzen knnen.
  Folgende Konstanten werden angelegt:

    xxxBuild            Ein Zhler, der bei jedem Aufruf von H2Unit erhht
                        wird (fr eine bestimmte Zieldatei).

    xxxBuildDate        Datum und Uhrzeit, wann die Zeildatei erzeigt wurde.
    xxxBuildTime

    xxxBuildDateStr     Datum und Uhrzeit, wann die Zeildatei erzeigt wurde
    xxxBuildTimeStr     als Pascal String

    xxxBuildDateFirst   Datum und Uhrzeit, wann die Zieldatei das erste mal
    xxxBuildTimeFirst   erzeugt wurde.

    xxx Steht fr den Namen der Zieldatei (Dest).

  Um diese Daten generieren zu knnen, legt H2Unit beim ersten Aufruf fr
  jede Zieldatei .PAS eine Datendatei mit der Endung .H2U an. Darin wird der
  Zhler sowie Datum und Uhrzeit des ersten Aufrufs gespeichert.
  Erzeugen Sie beispielsweise aus ABC.H die Datei ABC.PAS, wird beim ersten
  Aufruf die Datei ABC.H2U angelegt.


Beschrnkungen:

  Im Augenblick werden nur #define Anweisungen mit konstanten Werten
  (z. B in der Form #define xyz 0815) eingelesen.
  Berechnete Ausdrcke wie (z. B. #define xyz abc+10) werden nicht verarbeitet.
  Es werden maximal 4096 Konstanten verarbeitet.


Freeware:

  H2Unit ist kostenlos und darf an dritte unter folgenden Bedingungen
  weitergegeben werden: Copyright Texte drfen nicht entfernt werden.
  Alle oben aufgefhrten Dateien mssen unverndert und vollstndig
  weitergegeben werden und sie drfen das Programm nicht verkaufen.

  Hier genannte eingetragenen Wahrenzeichen sind Eigentum des jeweiligen
  Herstellers.

  Fr durch H2Unit eventuell entstandene Schden oder Folgeschden wird
  natrlich keinerlei Haftung bernommen.


Anregungen, Wnsche und Fehler:

  Bentigen Sie dringend eine Funktion, haben Sie Verbesserungs- oder
  nderungswnsche - oder haben sie einen Fehler entdeckt, dann wenden
  Sie sich bitte per e-mail an w.schmid@elo-soft.com.

  Wenn Sie das Programm brauchbar finden senden Sie doch bitte ebenfalls
  eine e-mail.


Wolfram Schmid

=============================================================================

* Alle, in diesem Text genannten eingetragenen Warenzeichen sind alleiniges
  Eigentum der jeweiligen Hersteller.
