============================================================================== 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 Pr„prozessor #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 Z„hler, Datum und Uhrzeit angelegt (Siehe: Aufruf und Optionen). H2Unit ist verfgbar fr OS/2 und fr Windows 95/NT (Win32). Die OS/2 Version l„uft 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 m”chten. Sie k”nnen 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 standardm„áig .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 zus„tzlich Konstanten an, die Sie als Versioninformationen in Ihrem Projekt benutzen k”nnen. Folgende Konstanten werden angelegt: xxxBuild Ein Z„hler, der bei jedem Aufruf von H2Unit erh”ht 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 k”nnen, legt H2Unit beim ersten Aufruf fr jede Zieldatei .PAS eine Datendatei mit der Endung .H2U an. Darin wird der Z„hler 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. Beschr„nkungen: 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 unver„ndert und vollst„ndig weitergegeben werden und sie drfen das Programm nicht verkaufen. Hier genannte eingetragenen Wahrenzeichen sind Eigentum des jeweiligen Herstellers. Fr durch H2Unit eventuell entstandene Sch„den oder Folgesch„den wird natrlich keinerlei Haftung bernommen. Anregungen, Wnsche und Fehler: Ben”tigen 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.