@DATABASE Felix.api
@WORDWRAP
@SMARTWRAP
@INDEX "Index"
@$VER: Felix.api-Anleitung 1.0 (4. April 1998)
/*S*/ Main
@NODE "Main" "Felix V39.2"
@{CODE}@{jcenter}Albstadt-Ebingen, den 4. April 1998
****************************************************************************
@{FG HIGHLIGHT}@{b}@{apen 14}@{bpen 3} Felix.api Version 39.2 @{apen 1}@{bpen 0}@{ub}@{FG TEXT}

Geschrieben von
@{i}Christian Taulien@{ui}

von Strange Intelligence / Softwareentwicklung
****************************************************************************

@{" Kurzbeschreibung  " LINK Kurzbeschreibung}
@{"   Installation    " LINK Installation}

@{"  Voraussetzungen  " LINK Voraussetzungen}
@{"   Beschreibung    " LINK Beschreibung}
@{"  Bekannte Fehler  " LINK BekannteFehler}
@{"   Danksagungen    " LINK Danksagungen}
@{"    Rechtliches    " LINK Rechtliches}
@{"  Unsere Adresse   " LINK Adresse}

@ENDNODE
/*E*/
/*S*/ Kurzbeschreibung
@NODE "Kurzbeschreibung" "Felix-Anleitung / Kurzbeschreibung"
@{bpen 4}@{FG HIGHLIGHT}@{b}1. Kurz-Beschreibung @{ub}@{FG TEXT}@{bpen 0}

@{par}@{FG FILL}@{apen 11}@{b}Felix.api ist ein PlugIn für den Editor "GoldED".@{ub}@{apen 1}@{FG TEXT}

@{par}@{u}Eigenschaften@{uu}:
@{par}· Freeware
@{par}· Kontrolliert, ob Dateien im Hintergrund verändert wurden, und lädt diese
auf Wunsch neu ein.
@{par}· Bietet einen ARexx-Befehl, der eine Liste der vorhandenen Fenster anzeigt.
@{par}· Unterstützt die locale.library
@{par}· Fontsensitiv
@{par}
@{par}Der komplette Source-Code (für StormC 3.0) wird mitgeliefert.
@{par}
@{par}Der Name Felix ist ein Wortspiel aus "Fensterliste".
@ENDNODE
/*E*/
/*S*/ Installation
@node "Installation" "Felix-Anleitung / Installation"
@{bpen 4}@{FG HIGHLIGHT}@{b}2. Installation@{ub}@{FG TEXT}@{bpen 0}

@{par}Die Installation des PlugIns ist so simpel, daß kein Skript dafür
geschrieben wurde. Klicken sie einfach hier auf @{"Install" SYSTEM "execute /install/install.german.bat"}.

@endnode
/*E*/
/*S*/ Requirements
@NODE "Voraussetzungen" "Felix-Anleitung / Voraussetzungen"
@{bpen 4}@{FG HIGHLIGHT}@{b}3. Voraussetzungen für Benutzung des Felix.api.@{ub}@{FG TEXT}@{bpen 0}

@{par}Um das Felix.api nutzen zu können, wird natürlich GoldED vorausgesetzt.
@{par}Desweiteren ist mindestens OS 3.0 erforderlich.

@{par}Die mitgelieferten Quelltexte lassen sich nur mit dem StormC-Compiler
übersetzen.

@{par}@{b}Wichtige Bemerkung zu den Quelltexten:@{ub}
@{par}In einigen Quelltextdateien wird die Datei "GOLDED:developer/api/include/api.h"
(@{b}Release 7@{ub}) includiert. Diese Include-Datei includiert wiederum einige Dateien, darunter auch
unnötiger Weise zweimal "exec/lists.h". Ich nehme an, daß eins von den beiden
eigentlich "exec/libraries.h" heißen sollte, denn beim Übersetzen meckert
der Compiler an verschiedenen Stellen rum, daß er "struct Library" nicht kennt.
Beheben sie diesen Fehler bitte, in dem sie die api.h editieren - natürlich mit
GoldED :-) und dort eben "exec/library.h" eintragen. Danach müßte alles übersetzbar
sein.

@ENDNODE
/*E*/
/*S*/ Beschreibung
@NODE "Beschreibung" "Felix-Anleitung / Beschreibung"
@{bpen 4}@{FG HIGHLIGHT}@{b}4. Beschreibung@{ub}@{FG TEXT}@{bpen 0}

@{par}Nachdem das Felix.api installiert wurde, kann man es im GoldED-Einsteller für
die APIs (Die Seite mit dem Stecker-Symbol) aktivieren.

@{par}Danach hat sich äußerlich erstmal nichts geändert. Wenn aber nun eine Datei, die
in GoldED geöffnet ist, im Hintergrund überschrieben wird und man im entsprechenden
Textfenster eine Taste drückt, so wird ein Requester geöffnet, in dem man auf diesen
Umstand hingewiesen wird. Das Überprüfen der Zugriffe, muß nicht unbedingt durch
das Drücken einer Taste erzwungen werden, man kann auch den ARexx-Befehl "@{u}CHECKACCESSES@{uu}"
verwenden. Ein entsprechendes ARexx-Skript, das alle 5 Sekunden die Zugriffe auswertet,
könnte in etwa so aussehen:

@{par}@{FG HIGHLIGHT}/* felixdemo.rexx - Überprüft Dateizugriffe alle 5 Sekunden */
@{par}do forever
@{par}    ADDRESS "GOLDED.1"
@{par}    CHECKACCESSES
@{par}    ADDRESS COMMAND
@{par}    WAIT 5
@{par}end@{FG TEXT}

@{par}Der ARexx-Befehl "@{u}FELIX@{uu}" stellt lediglich eine "About"-Funktion dar, mit der
ein Requester geöffnet wird, und eine Erklärung abgibt, was Felix.api ist.

@{par}Die wohl wichtigste Funktion ist der ARexx-Befehl "@{u}WINDOWLIST@{uu}". Mit ihm kann
ein Fenster mit einer Lister der vorhandenen Fenster angezeigt werden.
Der Befehl hat den Folgenden Aufbau:

@{par}WINDOWLIST X/N Y/N ENTRIES/N KEEPPOSITION/S OFF/S

@{par}Die beiden Parameter X und Y sind, wie Sie sicher bereits vermuten die Position des
Fensters. Gibt man -1 an, so wird die Position in der entspechenden Richtung zentriert.

@{par}ENTRIES gibt die Anzahl der Einträge an, die in der Liste auf einmal angezeigt
werden können. Sind mehr Fenster vorhanden, kann ja gescrollt werden. Mit diesem
Parameter kann man also ein wenig die Höhe des Fensters bestimmen.

@{par}KEEPPOSITION gibt man an, damit Felix.api sich die Fensterposition vor dem Schließen
des Fensters merkt, um diese dann beim nächsten Öffnen zu verwenden.

@{par}OFF ist für das Schließen des Fensters über ARexx da.

@{par}@{b}Bedienung des Fensters:@{ub}
@{par}Das Fenster beinhaltet die Fensterliste selbst und die drei Gadgets "Weiter",
"Schließen" und "Abbrechen".
Die Liste enthält die Namen der GoldED-Text-Fenster (der darin geöffneten Dateien) und das aktuelle Fenster
ist selektiert.

@{par}Mit dem "@{u}Weiter@{uu}"-Gadget wird das Fenster nach vorn geholt, daß in der Liste
angewählt ist. Das Felix-Fenster wird geschlossen

@{par}Durch das "@{u}Schließen@{uu}"-Gadget wird das in der Liste angewählte Fenster geschlossen,
als ob sie das Schließ-Symbol im entsprechenden Text-Fenster gedrückt hätten.

@{par}Und das "@{u}Abbrechen@{uu}"-Gadget schließt einfach das Felix-Fenster.

@{par}Ein Doppelklick auf einen Eintrag in der Liste läßt das entsprechende Fenster
nach vorn kommen, die Fensterliste bleibt aber offen.

@{par}Die @{u}Return-Taste@{uu} wirkt wie das "Weiter"-Gadget
@{par}Die @{u}ESC-Taste@{uu} hat die gleiche Wirkung wie das "Abbrechen"-Gadget.
@{par}Die @{u}Leertaste@{uu} wirkt wie ein Doppelklick auf den angewählten Listeneintrag..


@ENDNODE
/*E*/
/*S*/ Bekannte Fehler
@NODE "BekannteFehler" "Felix-Anleitung / Bekannte Fehler"
@{bpen 4}@{FG HIGHLIGHT}@{b}4. Bekannte Fehler@{ub}@{FG TEXT}@{bpen 0}

@{par}Während des Testens haben wir auf einem Amiga 1200 festgestellt, daß das
automatische Akualisieren des Textes nicht funktioniert. Der Rechner stürzt
nicht ab, aber es wird einfach nicht die Änderung im Hintergrund erkannt.
Da der Quelltext mitgeliefert ist, kann ja jemand sich die Mühe machen und
mal nachsehen. Wäre nett, wenn ich benachrichtigt werden würde, an was es
gelegen hat.

@ENDNODE
/*E*/
/*S*/ Thanks
@NODE "Danksagungen" "Felix-Anleitung / Danksagungen"
@{bpen 4}@{FG HIGHLIGHT}@{b}5. Danksagungen@{ub}@{FG TEXT}@{bpen 0}

@{apen 11}@{par}@{i}An dieser Stelle möchte ich allen danken, die mich bei der Entwicklung
@{par}der Software unterstützt haben.@{ui}@{apen 1}

@{par}· @{b}Jens Gelhar@{ub}
@{par}Für die Idee, für's Betatesting und ganz besonders für seinen Compiler.

@{par}· @{b}Andre' Taulien@{ub}
@{par}Für seine Anregungen und Betatesting auf seinen Amigas.

@ENDNODE
/*E*/
/*S*/ Lawful
@NODE "Rechtliches" "Felix-Anleitung / Rechtliches"
@{bpen 4}@{FG HIGHLIGHT}@{b}6. Rechtlicher Status dieses Paketes@{ub}@{FG TEXT}@{bpen 0}

@{par}@{apen 11}Dieses Paket ist Freeware. Das heißt, es kann frei kopiert werden,
@{par}wenn die folgenden Bedingungen eingehalten werden:@{apen 1}

@{par}1. Das Paket darf nur als Original-Paket  weitergegeben  werden.
@{par}   daß  heißt:  keine  Datei  darf geändert werden  bzw. fehlen.

@{par}   Privat  (also auf dem eigenem Rechner) kann jeder Anpassungen
@{par}   an den Dateien nach eigenem Geschmack vornehmen.

@{par}2. Das Paket  darf auf  allen  Massenmedien  vertrieben  werden,
@{par}   wobei der Preis  für diese  Medien  nur geringfügig (bis 20%)
@{par}   die für den  Herausgeber anfallenden Selbstkosten übersteigen
@{par}   darf.

3. Disclaimer
@{apen 8}@{par}     Für Schäden jeglicher Art die sich aus der Benutzung dieses
@{par}     Softwarepaktes ergeben, übernehme ich keinerlei Haftung.@{apen 1}

@{par}GoldED is ©1997 by Dietmar Eilert
@{CODE}@{par}AMIGA is a registered trademark of Gateway 2000 (naja 1998 jedenfalls)
@ENDNODE
/*E*/
/*S*/ Anschrift
@NODE "Adresse" "Felix-Anleitung / Adresse"
@{bpen 4}@{FG HIGHLIGHT}@{b}7. Unsere Anschrift@{ub}@{FG TEXT}@{bpen 0}

@{par}       Ihre Verbesserungsvorschläge und Bugreports (sofern vorhanden)
@{par}       oder auch Geld können Sie an folgende Adressen schicken:

@{par}       Christian Taulien                       Andre' Taulien
@{par}       Distelweg 11                   oder     Mühlesteigstraße 40\\1
@{par}       89079 Ulm                               72458 Albstadt
@{par}       Bundesrepublik Deutschland              Bundesrepublik Deutschland

@{par}                                               Tel: 07431/2745
@{par}                                               EMail: AndreTaulien@swol.de@{apen 14}
@{par}                            ________     ___
@{par}                           /  _____/\\   /  /\\
@{par}                          /  /\\____\\/  /  / /
@{par}                         /   \\/_      /  / /
@{par}                         \\____  \\    /  / /
@{par}                          \\__/  /\\  /  / /
@{par}                      ______/  / / /  / /
@{par}                     /________/ / /__/ /
@{par}                     \\________\\/  \\__\\/  © 1998

@{par}           @{APEN 8}------------------------------------------------@{APEN 1}
@{par}               http://www.ba-stuttgart.de/~ctaulien/SI/
@ENDNODE
/*E*/
/*S*/ Index
@NODE "index" "Felix.api-Anleitung / Index"
@{bpen 5}@{apen 14}@{b} Felix.api - Anleitungsindex @{ub}@{bpen 0}@{apen1}
@{par}
@{par}@{bpen 3}@{apen 2} A @{apen 1}@{bpen 0}
@{par}@{"Anschrift" LINK "Adresse"}

@{par}@{bpen 3}@{apen 2} B @{apen 1}@{bpen 0}
@{par}@{"Bekannte Fehler" LINK "BekannteFehler"}
@{par}@{"Beschreibung" LINK "Beschreibung"}

@{par}@{bpen 3}@{apen 2} D @{apen 1}@{bpen 0}
@{par}@{"Danksagungen" LINK "Danksagungen"}

@{par}@{bpen 3}@{apen 2} I @{apen 1}@{bpen 0}
@{par}@{"Installation" LINK "Installation"}

@{par}@{bpen 3}@{apen 2} K @{apen 1}@{bpen 0}
@{par}@{"Kurzbeschreibung" LINK "Kurzbeschreibung"}

@{par}@{bpen 3}@{apen 2} M @{apen 1}@{bpen 0}
@{par}@{"Hauptseite" LINK "Main"}

@{par}@{bpen 3}@{apen 2} R @{apen 1}@{bpen 0}
@{par}@{"Rechtliches" LINK "Rechtliches"}

@{par}@{bpen 3}@{apen 2} V @{apen 1}@{bpen 0}
@{par}@{"Voraussetzungen" LINK "Voraussetzungen"}

@ENDNODE
/*E*/