############################################################
# @(#) Anleitung zur GEM-Version, 22.09.1995, Dirk Hagedorn
############################################################
!subnode GEM-Version

Die GEM-Version erlaubt es, bequem mit der Maus Zielformat, Quell- und
Zieldatei sowie einige Umwandlungsoptionen zu setzen. Darber hinaus knnen
weitere Programme wie Editoren, Hypertextcompiler und/oder Anzeigeprogramme
fr jedes Zielformat angemeldet und direkt aus der GEM-Version gestartet
werden.

Die GEM-Version untersttzt das VA-Protokoll, Iconification und Drag & Drop.
Sie luft unter jedem AES, sprich unter TOS, MultiTOS, Geneva, MagiC
(Mac/PC) sowie STonX.

Whrend der Umwandlung kann man im Hauptdialog den Umwandlungsvorgang
verfolgen. Dies ist jedoch aufgrund der vielen AES-Aufrufe eine
zeitaufwendige Angelegenheit. Generell kann ich sagen, da UDO in der
GEM-Version wesentlich langsamer luft als die TTP-Version. Bei groen
Dokumentationen sollte man den Quelltext daher mit der TTP-Version
bersetzen.

Die Bedienung der GEM-Version ist in weiten Teilen selbst erklrend.

##################################################
!subsubnode GEM-Hauptdialog
!ignore_links

Im Hauptdialog sehen Sie ein paar Buttons und eine Menzeile. Im
Hauptdialog whlen Sie die Quelldatei und Zieldatei aus, Sie bestimmen
hier das Zielformat und Sie knnen hier die Umwandlung der Quelldatei
starten.

!image (!PICPATH)/main

Die Eintrge der Menzeile rufen weitere Dialoge auf bzw. sind
grtenteils selbsterklrend. Lediglich zwei Meneintrge sollten hier
erklrt werden:

!begin_tlist [Ziel/Programm starten:]

!item	[Ziel/Programm starten:] In der GEM-Version knnen Sie fr
jedes Format ein Programm anmelden, welches die Zieldatei
weiterverarbeitet. So knnen ST-Guide-Quelltexte direkt aus der
GEM-Version in einen Hypertext umgewandelt werden, es knnen
(!LaTeX)-Quellen in ein DVI-File bersetzt werden, oder Sie knnen
sich die erzeugten HTML-Dateien gleich mit CAB ansehen. Der Phantasie
sind wenig Grenzen gesetzt.

!item	[Ziel/ST-Guide:] Wird dieser Meneintrag aufgerufen, so ruft
UDO den ST-Guide auf und teilt diesem mit, er mge doch bitte den
soeben erzeugten Hypertext (Name der Zieldatei mit der Endung
''(!V).hyp(!v))'' anzeigen.

!end_tlist

##################################################
!subsubnode GEM-Dialog ''Einstellungen''
!ignore_links

Nach Auswahl des Meneintrags ""Optionen, Einstellungen"" ffnet sich
dieser Dialog. Die Bedeutung der in diesem Dialog enthaltenen Buttons
wird hier erklrt.

!begin_center
!image (!PICPATH)/settings
!end_center

!begin_itemize

!item	Zieldatei:

	!begin_itemize
	
	!item	Anpassen: Ist dieser Button selektiert, so pat
	die GEM-Version den Namen der Zieldatei bei einem Wechsel des
	Zielformats im Hauptdialog an. Die Anpassung ist abhngig davon,
	welche der folgenden Buttons Sie selektieren:
	
		!begin_itemize
		
		!item	Komplett: UDO pat bernimmt den kompletten Dateinamen
		der Quelldatei und pat nur die Endung an.
	
		!item	Name und Endung: UDO bernimmt den Namen der
		Quelldatei und pat die Endung an das ausgewhlte
		Ausgabeformat an. Der Pfad der Zieldatei wird nicht verndert.

		!item	Nur Endung: UDO pat lediglich die Endung der
		Zieldatei an das jeweilige Ausgabeformat an. Pfad und Name der
		Zieldatei werden nicht verndert.

		!end_itemize
	
	!item	Anzeigen: Ist dieser Buttons selektiert, so wird die
	nach erfolgter Konvertierung der Zieldatei-Viewer automatisch
	damit beauftragt, die Zieldatei anzuzeigen.
	
	!end_itemize

!item	Nachfrage vor:

	!begin_itemize
	
	!item	Programmende: Ist dieser Button selektiert, so fragt UDO
	vor dem Programmende noch einmal mittels einer Alertbox nach, ob
	Sie sich denn nun auch wirklich sicher sind, dieses wunderbare
	Programm zu verlassen. (!grin)
	
	!item	berschreiben: Falls die Zieldatei bereits existiert, so
	werden Sie noch einmal gefragt, ob die Datei berschrieben werden
	soll, falls dieser Button selektiert ist.
	
	!end_itemize

!item	Optionen:

	!begin_itemize
	
	!item	Logfile anlegen: Soll eine Datei erzeugt werden, in der
	alle Fehlermeldungen protokolliert werden (vergleichbar mit der
	Kommandozeilen-Option (!V)(--)no-logfile(!v))? 
	
	!item	Hyphenfile anlegen: Soll eine Datei erzeugt werden, in der
	UDO Trennvorschlge sichert (vergleichbar mit der
	Kommandozeilen-Option (!V)(--)no-hypfile(!v))?
	
	!item	Treefile anlegen: Soll eine Datei angelegt werden, in der
	Sie den logischen Aufbau aus Include-Dateien erkennen knnen
	(identisch mit der Kommandozeilen-Option (!V)(--)treefile(!v))?

	!item	Statusmeldungen: Soll UDO whrend der Konvertierung laufen
	Statusmeldungen ausgeben (vergleichbar mit der
	Kommandozeilen-Option (!V)(--)verbose(!v))?
	
	!item	Warnungen unterdrcken: Soll UDO im Logfile keine
	Warnungen ausgeben, sondern nur Fehlermeldungen (identisch mit der
	Kommandozeilen-Option (!V)(--)no-warnings(!v))?
	
	!end_itemize

!end_itemize


##################################################
!subsubnode GEM-Dialog ''Symbole''
!ignore_links

Die GEM-Version ermglicht es Ihnen genau wie die
Kommandozeilen-Version, bereits vor der eigentlichen Konvertierung
Symbole zu setzen. Was bei der Kommandozeilen-Version mit der Option
(!V)-D(!v) erledigt wird, kann hier durch Eingabe und Selektion der
zugehrigen Buttons erreicht werden.

!begin_center
!image (!PICPATH)/symbols
!end_center

Ist ein Eintrag selektiert, so wird er als vordefiniertes Symbol
behandelt, sonst nicht.

##################################################
!subsubnode GEM-Dialog ''Externe Programme''
!ignore_links

Dieser Dialog sieht ziemlich verwirrend aus und ich mu gestehen, da
er bald ein wenig berarbeitet werden mte.

In diesem Dialog knnen Sie festlegen, mit welchen Programmen Sie die
Quell- und Zieldateien bearbeiten und sich ansehen mchten. Auerdem
knnen Sie fr jedes Zielformat ein spezielles Programm angeben,
welches die Zieldatei weiterverarbeiten soll.

!begin_center
!image (!PICPATH)/extern
!end_center

Im oberen Teil whlen Sie das Zielformat aus.

Im unteren Teil knnen Sie den Pfad des Programms angeben. Falls
dieses Programm keine GEM-Applikation ist, sondern ein TOS-Programm,
so sollten Sie den entsprechenden Button selektieren. Ist das Programm
eine GEM-Applikation, und dieses Programm versteht (!V)VA_START(!v),
so sollten Sie ebenfalls den entsprechenden Button selektieren. Die
letzten beiden Einstellungen sind brigens nur von Bedeutung, falls
UDO das Starten der Programme bernimmt. Schlielich knnen Sie die
Parameter angeben, die dem jeweiligen Programm bergeben werden
sollen. Fr den Namen der Quell- und Zieldatei knnen Sie Platzhalter
benutzen. Wie diese lauten, da erfahren Sie ncoh einem Klick auf den
Button ""Hinweise"".

!subsubsubheading So startet UDO Programme

!begin_itemize

!item	Zunchst schaut UDO, ob ein AV-Server luft. Ist
(!V)AVSERVER(!v) im Environment angegeben oder laufen Gemini oder
Thing, so werden diese mittels (!V)AV_PROGSTART(!v) damit beauftragt, das
jeweilige Programm zu starten.

!item	Ist kein AV-Server vorhanden, so start UDO Programme auf
eigene Faust.

	!begin_itemize
	
	!item	Luft das Programm als Accessory, so werden die Parameter
	immer per (!V)VA_START(!v) bermittelt.
	
	!item	Luft das Programm bereits und versteht es
	(!V)VA_START(!v), so verschickt UDO eine (!V)VA_START(!v)-Meldung
	an eben dieses Programm.
	
	!item	Andernfalls werden GEM-Programme per (!V)shel_write()(!v),
	TOS-Programme per (!V)Pexec()(!v) gestartet.
	
	!end_itemize

!end_itemize