  Hilfe-Compiler fr das Hilfe-System des OMIKRON.Basic Interpreters
  ==================================================================

Das  vorliegende  Programm "MAKEHELP.PRG" kann eine Hilfe-Datei, wie sie 
mit  dem  OMIKRON.Basic Interpreter ab Version 3.5 mitgeliefert wird, in 
eine normale Text-Datei umwandeln.

Auch  der  umgekehrte  Weg ist mglich: Eine Text-Datei eines bestimmten 
Formats (siehe unten) wird in eine Hilfe-Datei verwandelt.

Fr  beide  Funktionen  existiert  jeweils ein Men-Eintrag, der Sie zur 
Eingabe eines Quell- und Ziel-Dateinamens auffordert. Fr die Text-Datei 
wird  die  Namenserweiterung  "TXT"  angenommen, die Hilfe-Datei hat die 
Erweiterung "HLP".

WICHTIG:  Wenn  Sie  als  Ziel-Datei  den  Namen  "OM-BASIC.HLP" angeben 
berschreiben  Sie  die  originale Hilfe-Datei des Interpreters. Stellen 
Sie   zuvor  immer  sicher,  da  Sie  noch  eine  Sicherheitskopie  der 
ursprnglichen Datei haben.

Nachdem  Sie  mit  dem  Menpunkt "Help to Text" die Hilfe-Datei in eine 
Textdatei  umgewandelt  haben,  knnen  Sie  diese Datei mit einem Text-
Editor laden und verndern. Dadurch haben Sie die Mglichkeit das Hilfe-
System des OMIKRON.Basic Editors NACH BELIEBEN zu erweitern.

Sie  knnen  z.B.  besonders hufig benutzte Library-Kommandos (etwa aus 
der   EasyGem-Library)   ins   Hilfe-System  intergrieren  oder  einfach 
besonders  hufig  nachzuschlagende  Informationen z.B. zum GEM oder dem 
Betriebssystem  mit  in  das  Hilfe-System aufzunehmen. Das Hilfe-System 
lt sich mit diesem Programm ganz nach ihren Wnschen zusammenstellen.

Wenn  Sie  Ihr Hilfe-System um Funktionen erweitert haben, von denen Sie 
glauben,  da  sie von allgemeinem Interesse sind, schicken Sie uns doch 
bitte  Ihre  erweiterte  Hilfe-Datei zu. Auf diese Weise knnen wir auch 
anderen  zustzliche  Untersttzung  zukommen lassen und den Komfort der 
Basic  Entwicklungsumgebung weiter erhhen. Fr Ihre Bemhungen schon an 
dieser Stelle vielen Dank.

BEARBEITEN DER TEXT-DATEI:

Zum  bearbeiten  der  Text-Datei  bentigen  Sie  einen beliebigen Text-
Editor,  der  allerdings in der Lage sein mu auch ASCII Zeichen kleiner 
32  darzustellen. Ebenso sollte die Mglichkeit bestehen Zeichen kleiner 
32 einzutippen. Ein Editor, der solche Voraussetzungen ideal erfllt ist 
der   Editor  des  Multi-Utilities  "MORTIMER",  welches  ebenfalls  bei 
OMIKRON.Soft  &  Hardware  erhltlich  ist.  Es  gibt jedoch auch andere 
Editoren,  die  Sie  verwenden knnen. Der weit verbreitete "Tempus" der 
Firma  CCD eignet sich genauso gut. Die Textverarbeitung "1st Word+" ist 
dagegen ungeeignet, da Zeichen kleiner 32 grundstzlich nicht akzeptiert 
werden.
Um die Text-Datei zu bearbeiten fhren Sie folgende Schritte aus:
1. Starten Sie MAKEHELP
2. Whlen Sie "Help to Text" im Datei-Men
3. Whlen Sie als Quell-Datei "OM-BASIC.HLP"
4. Whlen Sie als Ziel-Datei einen neuen Namen z.B. "HILFE.TXT"
Jetzt wird die Datei konvertiert und unter "HILFE.TXT" abgespeichert.
5. Verlassen Sie MAKEHELP
6. Starten Sie Ihren Text-Editor und laden Sie "HILFE.TXT"

FORMAT DER TEXT-DATEI:

Um  die  Hilfe Datei erfolgreich zu verndern ist es wichtig, da die zu 
Grunde liegende Text-Datei das richtige Format besitzt.
Wenn Sie oben aufgefhrte Schritte durchgefhrt haben und also die Text-
Datei  bereits  vor  sich  sehen,  sind einige Formatkennzeichen auf den 
ersten Blick erkennbar:
Die  Datei  ist  wie  ein Karteikasten aufgebaut, der viele Karteikarten 
enthlt.  Jede  Karte  trgt  eine  oder  mehrere berschriften, die als 
Suchbegriffe  dienen.  Auf  der  Karte  findet man die Erluterungen zum 
betreffenden Begriff(e). Diese Erluterungen knnen selbst wieder andere 
Suchbegriffe enthalten zu denen verzweigt werden kann. Beispiel:

WIDTH
LINE WIDTH
Typ: Befehl
Syntax:
LINE WIDTH = <num.Ausdruck>
LINE WIDTH = <Linienbreite in Pixeln>
Erklrung:
Stellt  die  Linienstrke  in Pixeln ein fr alle 
DRAW-Befehle und fr alle  umrahmten  gefllten  
Flchen  ein (siehe PBOX, BOX usw.). Die 
aktuelle VDI-Version untersttzt nur ungerade 
Linienstrken.

Diese  Karteikarte  trgt  zwei  berschriften nmlich "WIDTH" und "LINE 
WIDTH".  Eine  berschrift  ist  also durch ein Zeichen "" (ASCII 1) am 
Beginn der Zeile gekennzeichnet. Die berschrift geht immer bis zum Ende 
der  Zeile.  Wenn  mehrere  berschriften  fr  eine  Karteikarte gelten 
sollen,  so  befinden  sich  diese  unmittelbar  in  den darauffolgenden 
Zeilen.
Ein  Suchbegriff, zu dem verzweigt werden kann, ist von zwei Zeichen "" 
(ASCII  2)  eingerahmt.  Suchbegriffe aus dem oberen Beispiel wren also 
"<num.Ausdruck>",  "PBOX"  und  "BOX".  WICHTIG:  Ein  Suchbegriff  darf 
niemals  ber  das  Zeilenende  umgebrochen  werden.  Es  ist also nicht 
zulssig,  da  der  Suchbegriff  in einer Zeile startet und erst in der 
nchsten  beendet  wird.  Wenn  Sie  ein Wort als Suchbegriff markieren, 
sollte  dieser  Suchbegriff  auch  in der Text-Datei vorhanden sein. Ein 
Anklicken  wird  sonst  mit  der  Fehlermeldung "Help-Keyword not found" 
quittiert.
Die  nchste  Karteikarte  beginnt  an  der  Stelle,  an der die nchste 
berschrift   steht.  Die  Karteikarten  sind  also  einfach  aneinander 
gereiht.
Nach  der  letzen  Karteikarte sind als Ende-Markierung zwei Zeichen "" 
(ASCII   1)   und  das  "End  of  File"-Zeichen  (ASCII  26)  vorgesehen 
(Letzteres darf jedoch auch fehlen).

ERZEUGEN DER NEUEN HILFE-DATEI:

Fhren Sie folgende Schritte aus:
1. Speichern Sie die genderte Text-Datei ab.
2. Verlassen Sie den Text-Editor
3. Starten Sie MAKEHELP
4. Whlen Sie "Text to Help" im Datei-Men
5. Whlen Sie als Quell-Datei Ihre bearbeitete Text-Datei
6. Whlen Sie als Ziel-Datei "OM-BASIC.HLP"
     Vorsicht:  Sie  berschreiben  die  alte Hilfe-Datei. Erstellen Sie 
     also zuvor eine Sicherheitskopie.

Nocheinmal  sei  darauf hingewiesen, da wir uns freuen wrden von Ihnen 
erweiterte  Hilfe-Systeme zu erhalten, damit wir sie auch anderen Kunden 
zugnglich   machen  knnen.  Wenn  Sie  also  glauben  etwas  allgemein 
ntzliches  ins  Hilfe-System  intergriert  zu  haben, senden Sie die so 
erweiterte Hilfe-Datei an:
                OMIKRON. Soft & Hardware GmbH
                Sponheimstrae 12

                W-7530 Pforzheim

Vielen Dank Ihr OMIKRON. Team                    Pforzheim, den 04.11.91
