############################################################
# @(#) 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. Darüber hinaus können
weitere Programme wie Editoren, Hypertextcompiler und/oder Anzeigeprogramme
für jedes Zielformat angemeldet und direkt aus der GEM-Version gestartet
werden.

Die GEM-Version unterstützt das VA-Protokoll, Iconification und Drag & Drop.
Sie läuft unter jedem AES, sprich unter TOS, MultiTOS, Geneva, MagiC
(Mac/PC) sowie STonX.

Während 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 läuft als die TTP-Version. Bei großen
Dokumentationen sollte man den Quelltext daher mit der TTP-Version
übersetzen.

Die Bedienung der GEM-Version ist in weiten Teilen selbst erklärend.

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

Im Hauptdialog sehen Sie ein paar Buttons und eine Menüzeile. Im
Hauptdialog wählen Sie die Quelldatei und Zieldatei aus, Sie bestimmen
hier das Zielformat und Sie können hier die Umwandlung der Quelldatei
starten.

!image (!PICPATH)/main

Die Einträge der Menüzeile rufen weitere Dialoge auf bzw. sind
größtenteils selbsterklärend. Lediglich zwei Menüeinträge sollten hier
erklärt werden:

!begin_tlist [Ziel/Programm starten:]

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

!item	[Ziel/ST-Guide:] Wird dieser Menüeintrag aufgerufen, so ruft
UDO den ST-Guide auf und teilt diesem mit, er möge 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 Menüeintrags ""Optionen, Einstellungen"" öffnet sich
dieser Dialog. Die Bedeutung der in diesem Dialog enthaltenen Buttons
wird hier erklärt.

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

!begin_itemize

!item	Zieldatei:

	!begin_itemize
	
	!item	Anpassen: Ist dieser Button selektiert, so paßt
	die GEM-Version den Namen der Zieldatei bei einem Wechsel des
	Zielformats im Hauptdialog an. Die Anpassung ist abhängig davon,
	welche der folgenden Buttons Sie selektieren:
	
		!begin_itemize
		
		!item	Komplett: UDO paßt übernimmt den kompletten Dateinamen
		der Quelldatei und paßt nur die Endung an.
	
		!item	Name und Endung: UDO übernimmt den Namen der
		Quelldatei und paßt die Endung an das ausgewählte
		Ausgabeformat an. Der Pfad der Zieldatei wird nicht verändert.

		!item	Nur Endung: UDO paßt lediglich die Endung der
		Zieldatei an das jeweilige Ausgabeformat an. Pfad und Name der
		Zieldatei werden nicht verändert.

		!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 Trennvorschläge 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 können
	(identisch mit der Kommandozeilen-Option (!V)(--)treefile(!v))?

	!item	Statusmeldungen: Soll UDO während der Konvertierung laufen
	Statusmeldungen ausgeben (vergleichbar mit der
	Kommandozeilen-Option (!V)(--)verbose(!v))?
	
	!item	Warnungen unterdrücken: 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 ermöglicht 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
zugehörigen 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 müßte.

In diesem Dialog können Sie festlegen, mit welchen Programmen Sie die
Quell- und Zieldateien bearbeiten und sich ansehen möchten. Außerdem
können Sie für jedes Zielformat ein spezielles Programm angeben,
welches die Zieldatei weiterverarbeiten soll.

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

Im oberen Teil wählen Sie das Zielformat aus.

Im unteren Teil können 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. Schließlich können Sie die
Parameter angeben, die dem jeweiligen Programm übergeben werden
sollen. Für den Namen der Quell- und Zieldatei können Sie Platzhalter
benutzen. Wie diese lauten, daß erfahren Sie ncoh einem Klick auf den
Button ""Hinweise"".

!subsubsubheading So startet UDO Programme

!begin_itemize

!item	Zunächst schaut UDO, ob ein AV-Server läuft. 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	Läuft das Programm als Accessory, so werden die Parameter
	immer per (!V)VA_START(!v) übermittelt.
	
	!item	Läuft 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

