                          Freedom V1.10
                          --------------
               ("Hey, das Popup ist mir neu..." ;-))

                            07.02.1995
                
         (c) 1995 by Christian Krger und Kolja Koischwitz
        ("...die Jger des verlorenen Bedienungskomforts...")
         
   EnhancedGEM 2.20 (c) 1995 by Christian 'appl_getinfo' Grunenberg

                 XIMG-Decoder (c) by Dirk Haun


0. Einleitung
=============

Alle Software rstet sich frs Multitasking. Jeder halbwegs versierte
Programmierer hat inzwischen seine Dialoge ins Fenster verfrachtet,
die Zeit der Fluchecken ist vorbei! brig bleiben letzlich nur noch zwei 
Relikte aus der Singel-Zeit: Der Fileselektor und die Alertbox. Bisher gab 
es keine Rettung vor diesen Systemblockierern, doch damit ist jetzt 
Schlu: Freedom ist da!!!!

Die unglaublichen Features:
---------------------------
- mindestens 8 Nonmodale Fileselektoren gleichzeitig!
- Alertboxen optional im Fenster
- Programme, die VA_START untersttzen, mssen zT nichtmal
  blockiert werden!
- Untersttzung von langen Dateinamen
- Font und Gre des Fileselektors sind variabel
- Mehrfachfileselektion (natrlich auch Selectric-kompatibel)
- Bis zu 40 voreinstellbare Dateinamen, Pfade und Extensions
- Maximal intuitive Bedienung, kurze Wege, wenig Klicks
- Popups noch und ncher... (o:
- Linkshnder-Mode (!!!!)
- Unix-Patterns (*,?,[]) sowie Extensionlisten ("*.TOS,*.PRG")
- Dateien/Ordnern knnen Ikonen zugeordnet werden
- Drag&Drop-Untersttzung (Pfade & Files knnen auf den Fileselektor
  gezogen werden (AV- bzw MTOS-D&D) und umgekehrt
- Nachrichen, die nderungen in Verzeichnissen bekanntgeben, werden
  ausgewertet (SH_WDRAW, AV_PATH_UPDATE, SC_CHANGED) und versendet!
- Fuzzy-Namenserkennung! Freedom tut alles, um der aufrufenden
  Applikation (auch unter SingelTOS) einen aussagekrftigen Namen 
  zu geben (Menzeile, Xacc, AV-Protokoll...)
- Dateien lschen, Neue Ordner/Dateien erzeugen und Datei/Ordner-Info
- Dateien nach Maske suchen
- Aktuell selektierte Files knnen ins Clipboard exportiert werden
- Volle Kommunikation mit einem vorhandenen AV-Server (zB Thing)
- Dateien lschen, kopieren, verschieben per D&D, sofern ein AV-Server 
  (zB Thing/Gemini) vorhanden ist oder Kobold_2 parallel luft bzw. die
  Environment-Variable KOBOLD_PATH unter Multitasking den Pfad zum 
  Kobold weist..


1. Brauche ich Freedom? (Eine Checkliste)
=========================================

- Die Feature-Liste hat spontane Begeisterung bei ihnen ausgelst.. ;-)
- Sie arbeiten vorzugsweise unter einem Multitasking-OS
- Sie benutzen kaum noch Programme, die nicht GEM-konform sind
- Und schlielich: Ihnen sind mglicherweise einige der folgenden Punkte 
  schonmal aufgefallen oder Sie haben sich sogar darber schwarzgergert:

  Wenn ich einen Flydial, Fileselektor oder Alert offen hab, ..

  - .. hrt mein Terminalprogramm auf, anzuwhlen
  - .. kriege ich bertragungs-Fehler beim Up-/Download mit meinem 
       Terminalprogramm
  - .. hrt mein GEM-konformer Raytracer auf zu tracen
  - .. hrt mein GEM-konformer Morpher auf zu morfen
  - .. hrt mein GEM-konformer Packer auf zu packen
       (es sei denn, er ist von Christian Grunenberg...)
  - .. bleibt die Zeit in meiner Fenster-Uhr stehen
  - .. kommt beim Druck auf F1 nicht mehr mein heigeliebter Kobold
  - .. komm ich nicht mehr an das MagX-Popup
  - .. komm ich nicht mehr an die Menzeile
  - .. kann ich mit meinem Screenshot-Programm keine 'Shot's' mehr machen
  - .. usw usw

Hngen die Probleme mit Flydials zusammen, benutzen Sie mglicherweise das 
falsche Programm (oder Gemini), und sorgen damit mglicherweise dafr, das 
diese steinzeitliche Form des Dialoges sich am Leben erhlt. So, wie 
moderne Programme lange Dateinamen untersttzen sollten, sollten Sie auch 
darauf verzichten, systemmodale Dialoge ("Flydials") zu verwenden, auch 
nicht fr Alertboxen!

Damit Sie gleich probieren knnen, was Freedom ihnen bringt, hier die


2. Installation
===============

- FFSEL.PRG in den Auto-Ordner
- FREEDOM.APP in FREEDOM.ACC umbennen und als Accessory installieren
  (unter MagX/MiNT kann FREEDOM.APP auch spter nachgestartet werden
   bzw unter MagX auch in den APPS Ordner oder unter MiNT ins GEM.CNF)

Fr die Benutzer mit Speichermangel, die eine ausreichend schnelle Platte 
(und einen ausreichend schnellen Rechner) haben, gibt es noch eine weitere 
Mglichkeit: Zustzlich zu FFSEL.PRG packt man eine Datei FFSEL.INF in den 
Auto-Ordner, in der Pfad zu FREEDOM.APP (incl.des Filenamens) drinsteht, 
etwa so:

C:\FREEDOM\FREEDOM.APP

Befindet sich Freedom dann nicht im Speicher, versucht der residente Teil,
es nachzuladen. Ein so nachgeladenes FREEDOM.APP hat zustzlich die
Mglichkeit, sich nach einer bestimmten Zeit der Nichtbenutzung wieder aus
dem Speicher zu entfernen. Diese Zeit ist (minimal 5s) in der 
Konfigurationsdatei FREEDOM.CNF (siehe spteres Kapitel) einstellbar.

Das Nachladen unter einem Multitasking-OS ist unproblematisch, unter
SingelTOS ist es nur mit Hilfe des Accessorys Chameleon (von Karsten 
Isakovic) mglich. Da die Chameleon-Untersttzung  aber zur Zeit noch 
problematsich ist, raten wir, unter SingelTOS Freedom besser fest zu 
installieren.


3. Funktionsweise
=================

Freedom besteht aus zwei Teilen:

- Einem Fileselektor/Alertboxen-'Server' (FREEDOM.APP), der als parallele 
  Applikation bzw. Accessory luft, und darauf wartet, ber eine 
  definierte Schnittstelle (bestehend aus einem Satz AES-Messages) 
  aktiviert zu werden. Er kann (nur vom Speicherplatz und den verfgbaren 
  Fenster-handles begrenzt) beliebig viele Nonmodale Alertboxen und 
  Fileselektoren ffnen

- Einem residenten Teil (FFSEL.PRG), der Applikationen, die einen 
  Fileselektor bzw. eine Alertbox ausgeben wollen, den Programmfaden 
  "abnimmt", einen entsprechenden Request an den Server sendet, den er 
  ggf. vorher selbst parallel startet, und in einer Eventloop auf die 
  Antwort- Nachricht des Servers wartet. Innerhalb dieser Eventloop wird 
  gleichzeitig noch die Behandlung einiger anderer Messages 
  (Fenster-Redraw, Moven, Sizen, Toppen, Lowern,..) fr die Zeit des 
  aktiven Alerts/Fileselektors durchgefhrt, sowie die Menzeile des 
  aufrufenden Programms dis- und wieder enabled. Durch ausgeklgelte 
  Programmierung ist dieser Teil bis zu 8 mal reentrant, dh es knnen bis 
  zu 8 verschiedene Applikationen einen Alert bzw. einen Fileselektor 
  offen haben, bevor der Traphandler den Aufruf eines Fileselektors 
  ignoriert bzw. einen Alert zum System durchreicht.
  Dieser Teil bernimmt nebenbei ggf. noch das Umsetzen der 
  Freedom-Antwort in eines der 3 Selectric- Protokolle. Das dabei 
  entstehende Problem, da es nur einen Selectric-Cookie gibt, aber 
  mglicherweise mehrere Applikationen gleichzeitig ber ihn 
  kommunizieren, wurde auf ein minimum reduziert...


4. Bedienung
============

Freedom verfgt extra fr die Freunde der Mausbedienung ber eine schier 
unendliche Zahl von Popups. Die Meisten davon sind bei Freedom durch Klick 
auf die Box erreichbar, in der der aktuelle Pfad zu sehen ist.

Wechsel des Laufwerks - per Maus                 - via Tastatur
-------------------------------------------------------------------------
Klick auf Laufwerksbuchstabenbestandteil des     F1 oder Control-L ffnet 
Pfades ffnet ein Popup mit den vorhandenen      das Popup ebenfalls
Laufwerkskennungen.
                                                 Alternativ:
                                                 Alt-Laufwerksbuchstabe
                                                 schaltet sofort um

Vernderung der Anzeigemaske - per Maus          - via Tastatur
-------------------------------------------------------------------------
Klick auf die Anzeigemaske des Pfades
zeigt bei einem ..
.. Linksklick:  die gerade sinnvollen Masken     F6 oder Control-Y
.. Rechtsklick: die benutzerdefinierten Masken   F3 oder Control-X
.. Doppelklick: einen Dialog zur Maskeneingabe   F7 oder Control-E

                                                 Alternativ:
                                                 Control-Tastenblock-1..9
                                                 schaltet zwischen den
                                                 ersten 9 benutzerdefin-
                                                 ierten Masken um,
                                                 Control-Tastenblock-0
                                                 whlt die geklemmte Maske
                                                 
Verzeichnisebene wechseln - per Maus             - via Tastatur
-------------------------------------------------------------------------
Klick mitten in den Pfad mit der linken
Maustaste auf ..
.. Verzeichnis: Popup mit alternativen Ver-
                zeichnissen ffnet sich
.. Trenner (\): Der Pfad wird an dieser Stelle   Control-1..0 geht 1..10
                "abgeschnitten", was ein Ersatz  Ebenen zurck
                fr das schnelle zurcksetzen
                mittels "Mac-Path" darstellt
.. letzten \:   Die Verzeichnisse in der
                aktuellen Ebene kommen in einem
                Popup

Klick in den Closer (links neben dem Pfad)       Control-Backspace oder
geht eine Ebene zurck, mit einem Doppel-/       Control-Undo
Rechtsklick gehts ins Wurzelverzeichnis          Shift-Control-Backspace
                                                 o. Shift-Cobtrol-Undo

Direkter Einfach- oder Doppelklick (je nach      Ordner mit den Pfeil-
Einstellung) auf einen Ordner im Filefenster     tasten anfahren und auf
wechselt in diesen Ordner                        Return/Enter hauen

Durch Doppel- bzw. Rechtsklick auf das Pfad-     F5 oder Control-P
Objekt irgendwo vor dem letzen Trenner (\)
erreicht man das Popup mit den benutzerde-       Alternativ:
finierten Pfaden.                                Alternate-1..0
                                                 schaltet zwischen den
                                                 ersten 10 benutzerdefin-
                                                 ierten Pfaden um,
                                                 Alternate-Esc whlt den
                                                 geklemmten Pfad

Dateien (de-)selektieren - per Maus            - via Tastatur
-------------------------------------------------------------------------
Eine einzelne Datei kann durch einfachen       
Linksklick selektiert werden.
Sollen mehrere Dateien selektiert werden, muss
die Maustaste gedrcktgehalten werden.
Dabei ist zu beachten, das die Aktion nach
einer gewissen Ruhephase zu Beginn als
'Greifen' zwecks Drag&Drop interpretiert wird.
Dieser Zeitraum ist jedoch konfigurierbar.
Das Fenster wird automatisch gescrollt, wenn
der Mauszeiger whrend des Selektierens an den
oberen bzw. unteren Rand stt.
Mchten Sie mehrere Dateien selektieren, die
nicht nicht direkt aufeinander folgen, so
klicken Sie sie einzeln an und halten dabei
die Shift-Taste fest. Sie verhindert, das die
schon selektierten Dateien wieder deselektiert
werden.
Alle Dateien knnen durch einfachen Links-      Control-A 
klick auf den 'Alles selektieren'-Knopf rechts
vom Pfad-Objekt (de-)selektiert werden.
Durch einen Rechtsklick auf diesen Knopf wird   Shift-Control-A
die aktuelle Selektion invertiert.

Dateien selelektieren nach Maske.               F8 oder Control-S
Ein Doppelklick auf den 'Alles selektieren'-
Knopf ffnet einen Dialog, in dem Sie eine
Maske eingeben knnen. Bei Bettigen von 'Ok'
werden die auf die Maske passenden Dateien im
aktuellen Fileselektor zustzlich selektiert.

Dateien deselektieren nach Maske.               F9 oder Shift-Control-S
Ein Shift-Doppelclick auf denselben Knopf
ffnet den Dialog zum deselektieren.

Das Popup mit den voreingestellten Files lt   F2 oder Control-M oder
sich durch Klick auf das Wort "Datei:" vor dem  Control-<
Editfeld erreichen.

                                                Mit den Pfeiltasten kann
                                                die aktuell selektierte
                                                Datei wie ein Cursor ver-
                                                ndert werden.
                                                
                                                Wird dabei Shift festge-
                                                halten, so gehts seiten-
                                                weise weiter, mit Control
                                                und auch mit ClrHome kann
                                                zum Anfang/Ende der Liste
                                                gesprungen werden, womit
                                                auch ein Scrollen per
                                                Tastatur ermglicht ist
                                                (s. folgender Abschnitt)

In den Dateien scrollen - per Maus               - via Tastatur
--------------------------------------------------------------------------
Die einfachste Mglichkeit: Sie nehmen den      (s.o.)
Slider durch einen einfachen Linksklick in die
Hand. Das Dateifenster wird beim Scrollen in
Echtzeit aktualisiert. Alle anderen Bedienele-
mente des Sliders entsprechen denen von GEM-
Fenstern.

Wenn Sie Freedom so konfiguriert haben, knnen
Sie auch durch einen Rechtsklick direkt in das
Filefenster scrollen (hnlich wie beim Desktop
'Thing', allerdings mit dynam. Scrollweite)

Vernderung der Sortierung - per Maus            - via Tastatur
--------------------------------------------------------------------------
Rechts- oder Doppelklick auf den Slider          F4 oder Control-J
ffnet das Sortierungspopup (Sehr praktisch,
denn wenn man eine Datei sucht und sich deshalb  Alternativ:
fr eine andere Sortierung entscheidet, hat man  Control-H: nach Namen
meist eh grad den Slider "in der Hand"           Control-Z: nach Datum
                                                 Control-G: nach Gre
                                                 Control-T: nach Typ
                                                 Control-K: Keine Sort.
                                                 
                                                 Control-R: Sort. revers

Drag & Drop - per Maus                           - via Tastatur
--------------------------------------------------------------------------
Wird ber selektierten Dateien die linke Maus-   Alt-Taste festhalten,
taste festgehalten, erscheint nach kurzer Zeit   mit den Pfeiltasten den
ein Geisterrahmen mit den Umrissen der selek-    Mauszeiger ber die Da-
tieren Objekte. Wird die Maustaste losgelassen,  teien manvrieren, und
werden die Dateien an die Position unter dem     mit Alt-Insert 'greifen'.
Mauszeiger 'abgeworfen'. Freedom zeigt whrend   Dann knnen Sie mit den
der Drag&Drop Aktion unten im Infoobjekt an,     Pfeiltasten berall hin-
was fr eine Aktion durch das Drag&Drop ausge-   transportiert werden.
lst wird. Werden die Dateien auf eine fremde
Applikationen gezogen, kann Freedom die Aus-
wirkungen nicht voraussehen ("tun Sie nichts
unberlegtes" ;-)). Oft wird garnix passieren,
es sei denn, die Fenster eines AV-Servers (wie
'Thing' oder 'Gemini'), oder eines Programms,
das sich beim AV-Server angemeldet hat, sind
das Ziel.

Wenn Sie einen AV-Server oder den Kobold
installiert haben, kann Freedom auch mittels
Drag&Drop kopieren bzw. verschieben, wenn Sie
Dateien aus oder auf Fenster des AV-Servers
ziehen, oder ein weiterer offener Freedom-
Fileselektor das Ziel ist. Ein weiterer          auch mit Control-Help
(nicht an eine Applikation gebundener) Freedom-  oder Shift-Help
Fileselektor lt sich mit einem Doppel- bzw.
Rechtsklick auf das Freedom-Logo rechts oben
ffnen.


Freedoms Funktionen - per Maus                   - via Tastatur
--------------------------------------------------------------------------
Lschen: Selektieren Sie die zu lschenden       Control-D
Objekte und klicken Sie auf den Mlleimer
unten links. Alternativ knnen Sie die Objekte
auch auf den Eimer ziehen.

Neues Objekt: Klicken Sie auf das Ordner-        Control-N
Symbol unten links (das 2.). Ein Dialog
erscheint, ber den Sie einen Ordner oder
eine (leere) Datei in dem aktuellen Verzeich-
nis anlegen knnen.

Objekt-Information: Selektieren Sie ein oder     Control-I (Tab)
mehrere Objekte, deren Namen und/oder Attribute
Sie verndern mchten und klicken Sie auf das
Info-Symbol unten links (das 3.). Alternativ
knnen Sie die Objekte auch aufs Icon ziehen.

Dateiliste ins Klemmbrett exportieren: Dateien   Control-C
selektieren und auf das Klemmbrett ziehen oder
das Klemmbrett anklicken.

Dateien suchen: Lupe unten links anwhlen.       Control-F
Ein Dialog erscheint, in dem Sie eine Such-
Maske eintippen knnen, und angeben drfen,
wo gesucht werden soll. Mit 'Ok' wird die Suche
gestartet. Ein Tastendruck whrend der Suche
bricht ab. Wurde eine Datei gefunden, erscheint
ihr Name in dem breiten Knopf unter der
Suchmaske. In diesem Fall haben Sie 4 Auswahl-
mglichkeiten:
breiter Knopf: Datei wird im darunterliegenden
Fileselektor selektiert und an die Applikation
ausgeliefert.
Ok: Datei wird im darunterliegenden Selektor
selektiert. Bei einem Rechts-/Doppelklick die-
selbe Wirkung der 'breite Knopf'..
Weiter: Es wird eine Weitere auf die Maske
passende Datei gesucht.
Abbruch: Suchdialog ohne Aktion schlieen.

Objekt ffnen: Ist vor allem fr Benutzer von    Datei(en) selektieren
Multitasking-Betriebssystemen wie MagiC oder      und Control-O drcken
MultiTOS interessant: Ein Doppel-/Rechts-
klick mit gedrckter Alt- oder Control-Taste     Alternativ bei einer
auf ein Objekt bewirkt das 'ffnen' des          einzigen Datei auch
Objektes, d.h.: Handelt es sich um ein Pro-      Control-Return
gramm, so wird es gestartet, ansonsten wird
ggf. einem konfigurierbaren Viewer eine 
Nachricht mit der selektierten Datei gesendet.
Freedom startet den Viewer auch parallel nach,
wenn er ihn nicht im Speicher antrifft. Da 
dies insgesamt nicht sehr flexibel ist,
berlt Freedom das ffnen dem AV-Server,
sofern ein solcher vorhanden ist. Der beachtet
dabei dann die angemeldeten Applikationen usw.
Ausserdem lassen sich dann auch Verzeichnisse
'ffnen'.

Der Autolocator - eine Wissenschaft fr sich..
----------------------------------------------
Der Autolocator eines gewissen anderen Fileselektors war noch einfach, 
doch mit Freedom wird auch das anders (o: Jetzt endlich kommen auch 
eingeschworene Feinde des Autolocators in den Genuss seiner 
Funktionalitt. Mit Freedom kommt der 'Einmal-Autolocator', wie man ihn 
schon von diversen Commandline-Shells als 'Completion' kennt: Ist der 
stndige Autolocator abgeschaltet, kann mit Tab ein einmaliger Autolocator 
ausgelst werden. Da hier ein offensichtlicher Konflikt mit der 
Funktionalitt 'Objekt-Info' (auch Tab) vorhanden ist, und wir es (wie 
auch sonst) allen recht machen wollen, ist die Tab-Taste auf eine der 
beiden Funktionalitten konfigurierbar. Objekt-Info ist ja zustzlich mit 
Control-I erreichbar, der einmalige Autolocator liegt zustzlich (fest) 
auf Control-Tab.
Freedoms Autolocator sucht standardmig nach Ordnern und Dateien. Wird 
zustzlich die Shift-Taste gedrckthalten, wird nur auf Dateien gematcht.
Eine nochmalige Beschleunigung des Autolocatens bringt das 'Cycle'-Feature 
des einmaligen Autolocators. Wird derselbe nmlich mehrfach hintereinander 
ausgelst, geht er auch hintereinander alle Dateien durch, auf die das 
schon Eingetippte passt.


Drei kleine Helferlein - die vom Benutzer konfigurierbare Popups
----------------------------------------------------------------
- Das Filepopup: Mal ehrlich: Wie oft arbeiten sie tage- oder sogar 
                 wochenlang immer nur mit den gleichen 4 Dateien, und 
                 suchen sie aber tagtglich wieder mit ihrem Fileselektor. 
                 Das mu nicht sein! (o: In der Freedom-Konfigurations- 
                 datei knnen Sie bis zu 40 Dateien mit ihrem vollen Pfad 
                 eintragen, die sie dann in Freedom durch einen einfachen 
                 Klick aus einem Popup holen. Ihr Fileselektor nimmt ihnen 
                 dann alles ab: Wechsel in das Verzeichnis, Datei 
                 selektieren und 'Ok' drcken.
- Das Masken- &
- das Pfadpopup: Hatte beides auch schon der Fileselektor, den Sie vor 
                 Freedom benutzt haben. Auch mit Freedom knnen Sie 
                 Eintrge in diesen Popups 'ersetzen', indem Sie einen 
                 Doppel- oder Shift-Klick machen. So wird die aktuelle 
                 Auswahlmaske bzw. der komplette aktuelle Pfad in das 
                 jeweilige Popup bernommen. Das hat allerdings nur 
                 temporren Charakter, da es sich (noch) nicht abspeichern 
                 lt. Mchten Sie also einen festen Eintrag in eines der 
                 Popups neu aufnehmen, fhrt zZt kein Weg an der 
                 Konfigurationsdatei vorbei.


Einige letzte Bemerkungen zur Bedienung
---------------------------------------

- Das kleine Dreieck unten rechts im Fileselektor dient dazu, Freedom in 
  der Gre zu verndern. Dabei wird online die resultierende Gre des 
  Filefensters in Spalten/Zeilen angezeigt.

- Freedom lt zwar immer zu, da Sie mehrere Dateien auswhlen, drcken 
  Sie jedoch 'Ok', werden nur soviele an die aufrufende Applikation 
  zurckgegeben, wie diese zulsst (und das ist im Normalfall nur eine).

- Freedom ist an vielen Stellen so ausgelegt, das es 'zwei-Wege'-bedienbar 
  ist, will sagen: Die einen halten lieber whrend einer Aktion die ganze 
  Zeit die Maustaste fest, die anderen klicken lieber am Anfang und am Ende
  einmal kurz. Freedom kann beides, und zwar fast berall: Bei allen Popups, 
  beim Slider, bei der Fluchecke (falls Freedom mal modal kommen muss),
  beim Aufziehen ('Sizen') des Fileselektors und schlielich sogar beim 
  Drag&Drop (Ctrl o. Alt beim 'Greifen' festhalten).

- Das die Funktionstasten (zT Selectric-kompatiblel) von Freedom belegt 
  werden, lt sich in der Konfigurationsdatei abschalten (#NOFKTKEYS),
  dann werden die Tastendrcke an den AV-Server durchgereicht.

- Der 'Weiter'-Knopf im Such-Dialog hat noch einige Besonderheiten: Fr 
  Mausbenutzer ist er so gestaltet, das man die Maustaste auf ihm auch 
  gedrckt halten kann, um so quasi schnell 'vorzuspulen', wenn viele 
  Dateien gefunden werden, die einen eigentlich gar nicht interessieren. 
  Dies lt sich auch per Tastatur (Alt-W) erreichen, wobei dabei der 
  'Nachlauf' von Tastatur-Events unterdrckt wird!

- Wenn angeschaltet, knnen Freedom und seine Alertboxen vollstndig im 
  Hintergrund bedient werden, ohne das die rechte Maustaste dabei 
  gedrcktgehalten werden muss. Wollen Sie trotzdem einmal ein Fenster von 
  Freedom in den Vordergrund holen, brauchen Sie nicht unbedingt auf die 
  Fenstertitelzeile klicken: Ein kurzer Klick auf irgendeine 
  "funktionslose" Stelle im Dialog hat dieselbe Wirkung!

So, und fr alle, die jetzt schon keine Features mehr hren knnen, sei 
gesagt: Nicht verzweifeln, wir versprechen: In sptestens 3 Tagen habe Sie 
Ihren alten Fileselektor vergessen. ;-)
Die Bedienung von Freedom macht zwar nicht den Eindruck, aber sie *ist* 
definitiv intuitiv, vor allem fr Leute, die regelmig damit arbeiten.


5. Kurzberblick ber alle Tastenkombinationen von Freedom
==========================================================

^ bedeutet "zusammen mit Control"
+ bedeutet "zusammen mit Shift"

Alt A-Z: Laufwerk umschalten
^BS,
^Undo:   Eine Direktory-Ebene zurck
^A:      Alles Selektieren
+^A:     Selektion Invertieren
^D:      Selektierte Dateien lschen
^N:      Neues Objekt
^I:      Objekt-Information
^B:      Fileselektor ein Zeichen breiter
+^B:     Fileselektor ein Zeichen schmaler
Tab:     Objekt-Information ODER Autolocator (Wenn '#SHELLTAB' gesetzt)
^Tab:    einmaliger Autolocator (zyklisch, Ordner und Files)
+^Tab:   einmaliger Autolocator (zyklisch, nur Files)
^F:      Objekt suchen (F wie finde)
^C:      Selektierte Dateien als Text ins Clipboard exportieren
^H,      Sortierung nach Namen  (H wie Selectric ;-))             
^Z,          "       "   Datum  (Z wie Zeit)
^G,          "       "   Gre
^T,          "       "   Endung (T wie Typ) 
^K,      unsortiert             (K wie Keine)
^R:      Sortierrichtung umkehren  (R wie Richtung)
+^S,F9:  Dateien deselektieren nach Maske
^S,F8:   Dateien selektieren nach Maske
^E,F7:   Neue Maske eingeben (E wie Extension)
^Y,F6:   Popup der vorhandenen Ext. ffnen (Y wie schn nah an Control ;-))
^P,F5:   Pfad-Popup ffnen
^J,F4:   Sortierungs-Popup ffnen (J wie keine andere Taste mehr brig)
^X,F3:   Popup der User-Extensions ffnen (X wie eXtension)
^M,^<,F2: File-Popup ffnen (M wie Meine Files..)
^L,F1:   Drive-Popup ffnen (L wie Laufwerk)
^W:      Fenster wechseln
+^W:     Fenster rckwrts wechseln
^Return,
^O:      Selektiertes Objekt ffnen
^1-0:    1 bis 10 Verzeichnisebenen zurckgehen
Alt Esc: Den geklemmten Pfad auswhlen
Alt 1-0: Einen der ersten 10 Pfade auswahlen
^TB 0:   Die geklemmte Extension auswhlen
^TB 1-9: Eine der ersten 10 Extensions whlen
^TB *:   Aktuellen Fensterfuller bedienen
+Esc,
^Esc:    Verzeichnis neu einlesen
Esc:     Editfeld lschen
Return,
 Enter:  Bedient "Ok" (Wenn ein Ordner selektiert ist, wird er geffnet)
^Q,^U,
 Undo:   Bedient "Abbruch"
Help:    Freedom-Info
+Help,
^Help:   Neuen (nicht applikationsgebundenen) Fileselektor aufmachen
^Space:  aktuellen Fileselektor/Alert (de-)iconifizieren


6. Drag n' Drop
===============

Freedom kann nicht nur per Drag&Drop Dateien an andere Applikationen 
weitergeben, sondern auch selbst welche Empfangen (MTOS und AV-D&D).

Allgemein bedeutet dabei:

- Ein Drag mit Shift, das der Ziel-Fileselektor sich schlieen und die 
  'abgeworfenen' Dateien der aufrufenden Applikation weitergeben soll
  (Wer die Shift-Taste nicht drcken will, mu die Dateien direkt auf das 
  Eingabefeld ("Datei:") des entsprechenden Fileselektors ziehen.)
  
- Ein Drag ohne Umschalttasten: Kopieren (wenn mglich).

- Ein Drag mit Control-Taste: Verschieben (wenn mglich).

- Eine zustzlich gedrcktes Alt-Taste beim Kopieren/Verschieben:
  Objekte vorher umbennen

Die Vorgehensweise

Wann immer mglich, wird der Drag dem AV-Server (Thing, Gemini) 
berlassen, der im Normalfall die Dateien kopiert bzw. verschiebt (wenn 
Control gedrckt) Ist kein AV-Server da, versucht Freedom selbst, die 
bergebenen Dateien zu kopieren bzw. zu verschieben. Da Freedom dies nicht 
selbst beherscht, geht das nur, wenn Sie einen Kobold besitzen, und 
derselbe im Speicher oder auf Platte vorhanden ist.
Ziehen Sie Dateien auf eine andere, nicht blockierte Applikation, so
fragt Freedom zuallererst beim AV-Server nach, ob dem die Applikation 
bekannt ist, und bergibt dann die Dateien ggf. ber den Umweg 
AV-Server. Ist kein AV-Server da oder dem die Appl. unbekannt, wird (als 
letzter Versuch) ein VA_START an den Besitzer des Fensters (wenn nicht 
ermittelbar, an die Appl. 0) versendet. Freedom knnte die Daten auch 
mittels MTOS-Drag&Drop versenden, nur leider hrt keiner zu! ;-| Normal 
verstehen Applikationen nunmal allerhchstens VA_START. Alternativ 
knnte Freedom immer erst MTOS-Drag&Drag (via Pipes) versuchen, was aber 
immer mit einer gewissen Wartezeit verbunden ist. Sobald sich die Anzahl 
der Applikationen, die das Pipe-Drag&Drop verstehen, enscheidend 
verndert, werden wir auch Freedom in diese Richtung modifizieren.


7. Konfiguration
================

Freedom lt sich in weiten Grenzen konfigurieren.
Beeinflussen knnen Sie neben vielen Unwichtigkeiten folgendes:

- Font, Gre und Zeilenabstand im Fileselektor
- Position des Scrollbars (links/rechts) im Fileselektor
- diverse Verzgerungszeiten
- Je einen Formatstring fr 8.3- und lange Dateinamen
- Ob Gro- oder Kleinbuchstaben verwendet werden sollen
- Ob der Autolocator aktiv ist und ob er auch Ordner matcht
- Ob in Alertboxen alle Knpfe gleich breit sein sollen
- Wo der Kobold liegt (Environment-Var wird auch gecheckt)
- Wie der Viewer heit
- Welche Dateien als Programmdateien interpretiert werden
- Ob Ordner erst auf Doppelklick ffnen
- Ob der Rechtsklick ins Filefenster scrollt (wie bei Thing)
  oder (wie berall sonst) einem Doppelklick entspricht
- Ob Hintergrundbedienung von Fensterdialogen aktiv ist
- Ob der Fileselektor in Mausnhe geffnet wird 
- Anzahl der Zeilen/Spalten des Fileselektors
- Bis zu 40 voreinstellbare Files
- Bis zu 40 voreinstellbare Pfade
- Bis zu 40 voreinstellbare Extensions
- Der Pfad, wo die Images (FREEDMxx.IMG) gesucht wird
- Gltigkeitsmasken fr die Images
- Applikationen, bei denen Freedom modal kommen soll
- Max. 8 Applikationen, bei denen Freedom garnich kommen soll
- Max. 24 Applikationen, bei denen Freedom den VA_START-Trick anwenden soll
- Ob Freedom die Alertboxen in Fenster legt

Diese Parameter knnen (immer noch) nur direkt in der Konfigurations-
datei unter Zuhilfename eines Texteditors verndert werden. Diese Datei ist 
aber ausfhrlich kommentiert, also keine Panik. In einer nchsten Version 
wird es ein Setup-Programm geben, mit dem diese Datei komfortabel 
modifiziert werden kann. Bestimmte Parameter werden sich auch zur Laufzeit 
von Freedom noch vernderen lassen.

Freedom sucht beim Start die Konfigurationsdatei zuerst unter einem Namen, 
den er aus der aktuellen Auflsung zusammensetzt (genau, wie die Shell 
Gemini) bei 640x400 zB '06400400.CNF', bei 1280x960 dann '12800960.CNF'. 
Wird eine solche Datei nicht gefunden, wird noch 'FREEDOM.CNF' versucht, 
ansonsten werden die Standardeinstellungen verwendet. Freedom sucht die 
Konfigurationsdateien mit shel_find(), was schlicht und einfach bedeutet, 
das es die Suche den AES berlt. Letzteres sucht in der aktuellen 
Direktory und allen Direktorys, die in der Environmentvariable $PATH 
stehen.
Mittels des Imagepfades ('#IMAGEPATH') in der Konfigurationsdatei kann man 
auch fr jede Auflsung und Farbtiefe unterschiedliche Imagedateien laden 
bzw. mittels der Fonteinstellung via #FONTID etc. verschiedene 
Zeichenstze fr unterschiedliche Auflsungen bestimmen.


Ein Beispiel:
-------------
akt. Ordner in dem sich auch Freedom befindet:

03200200.CNF
            hat Eintrag mit: #IMAGEPATH ./FDIMG/SMALL/ 
06400400.CNF
            hat Eintrag mit: #IMAGEPATH ./FDIMG/NORMAL/
            

Dann werden die Icons bei 320x200 Pixel in "./FDIMG/SMALL/" gesucht.
Abhngig von der aktuellen Farbtiefe wird dann dort bei 16 Farben
die Imagedatei 'FREEDM04.IMG' geladen (siehe auch unten).
Bei 640x400 Pixeln in 256 Farben wrde aus "./FDIMG/NORMAL" die Datei 
'FREEDM08.IMG' als Icon-Satz geladen werden. 
 

Einige allgemeine Anmerkungen zum Aufbau der Konfigurationsdatei:
Freedom liet die Konfigurationsdatei zeilenweise. Zeilen, die mit einem 
Semikolon (;) beginnen, werden ignoriert. In allen anderen Zeilen wird 
versucht, eines der Schlsselwrter (z.B. '#AUTOLOCATE') zu erkennen, die 
alle mit einem Doppelkreuz (#) beginnen. Wird kein Schlsselwort erkannt, 
wird die Zeile als zum letzen eingelesenen Schlsselwort zugehrig 
angenommen. Bei einigen Optionen wird davon auch Gebrauch gemacht, etwa 
bei '#PATHS', wo bis zu 40 Zeilen mit weiteren Pfaden folgen knnen. 
Genauere Informationen zu den einzelnen Optionen finden sich in der 
mitgelieferten Beispiel-Konfigurations-Datei, mit der Sie jetzt gleich mal 
ihrem Lieblings-Texteditor fttern sollten (Vorher eine Sicherheitskopie 
machen!)

7.0 Die Imagedateien und die zugehrigen Masken

Freedom versucht, nachdem es die Konfigurationsdatei eingelesen hat, auf 
dem in der Datei angegeben Pfad eine Datei 'FREEDMxx.IMG' wobei fr xx die 
aktuelle Anzahl von Planes des Screens eingesetzt wird, also bei einer 
monochromen Auflsung FREEDM01.IMG, bei 4 Farben 02, bei 16 Farben 04 usw. 
Wurde diese Datei gefunden und handelt es sich um ein XIMG mit genau der 
angegebenen Anzahl Planes, wird die Datei eingelesen. Anschlieend wird 
das Image in der Breite durch durch die Zahl der in der Konfigurations- 
datei vorgefundenen Masken ('#IMAGEMASKS') geteilt, und erhlt so zu jeder 
Maske ein Bildchen. Ist beispielsweise das Images 64 pixel breit und 16 
hoch, und findet Freedom 4 Masken, so wird es in vier Teile, je 16x16 
Pixel gross, aufgeteilt.


7.1 Der Format-String
Freedom erlaubt Ihnen, die Daten in dem Fileselektor-Fenster auf fast 
beliebige Weise zu formatieren. Ausserdem kann jeweils fr normale 
8.3-Filesysteme und Filesysteme mit langen Dateinamen ein verschiedener 
Formatstring angegeben werden. Es handelt es sich dabei einfach nur um 
eine Aneinanderreihung von Zeichen, wobei dem '%' (Prozent) eine 
Spezialbedeutung zukommt. Am einfachsten geht's mit einem Beispiel:

Sie mchen, das die Dateien in einer Zeile wie folgt formatiert werden:

:
EVEREST  PRG  154.510  29.10.94  09:41
EVEREST  INF      840  09.01.95  11:36
:

Also erst der Name, dann die Endung, dann die Gre (mit max. 9 Ziffern), 
dann das Datum und schlielich die Uhrzeit ohne Sekunden. Der Formatstring 
dafr knnte etwa wie folgt aussehen:

#FORMAT %-F %-E%9P  %2D.%2M.%2Y %T%h:%m

Die Stellen, an denen ein '%' steht, weisen Freedom an, eine ganz 
bestimmtes Attribut (Name, Gre, Stunde, Minute usw.) der gerade 
formatierten Datei an genau dieser Stelle einzusetzen. Welches Attribut 
das ist, bestimmt Freedom aus den auf das '%'-Zeichen folgenden Zeichen.
Zur Auswahl stehen dabei:

'F': Dateiname bis zum letzen Punkt (also ohne Endung)
'E': Dateiname ab dem letzten Punkt (also die Endung)
'N': Voller Dateiname (unformatiert)
'D': Tag (1..31)
'M': Monat (1..12)
'Y': Jahreszahl (ohne Jahrhundert, 00..99)
'h': Stunden
'm': Minuten
's': Sekunden
'S': Gre (in Bytes) der Datei ("1345678"), bei Ordnern nichts
'P': 'Punktierte' Gre der Datei ("1.345.678"), bei Ordnern nichts
'K': Gre (in Bytes) der Datei ("1345678"), bei Ordnern '<Ordner>'
'T': Das Uhrensymbol, wenn die Datei tagesaktuell ist, sonst nichts
'A': Ein Zeichen fr Dateiattribute ('.' fr schreibgeschtzt usw.)
'%': Das Prozentzeichen

(Liste ist fr Erweiterungsvorschlge offen)

Das jeweilige Attribut wird von Freedom auf eine Defaultbreite formatiert. 
Mchten Sie das Attribut lieber breiter oder schmaler, knnen Sie die 
gewnschte Breite als Wert zwischen dem '%' und dem Attributbuchstaben 
eintragen. Freedom formatiert Attribute, die schmaler als die angegebene 
Breite sind, rechtsbndig. Mchten Sie ein Attribut lieber linksbndig 
formatiert haben, dann platzieren Sie ein '-' (Minus) direkt hinter das 
'%' Symbol des Attributes (siehe auch die noch folgenden Beispiele).

Auf einem Filesystem mit langen Dateinamen ist die Aufsplittung eines 
Dateinamens in Prefix und Endung nicht mehr so sinnvoll, hier bietet sich 
etwa folgender Formatstring an:

#LONGFORMAT %-20N%9P %2D.%2M.%2Y

der als Ergebnis die folgende Ausgabe liefert:
:
EVEREST.PRG           154.510 29.10.94
EVEREST.INF               840 09.01.95
:

welche etwas mehr Platz auch fr lngere Dateinamen lt.

7.2 Der VA_START Trick
Einige Programme, vor allem solche, die Dateien nur anzeigen, knnen von 
Freedom ausgetrickst werden, und whrend der Fileselektion sogar 
weiterlaufen! Die Idee ist sehr einfach: Dem Programm wird beim Aufruf des 
Fileselektors vorgegaukelt, der Benutzter htte sofort 'Abbruch' gedrckt 
(das Programm luft also gleich weiter), in Wirklichkeit ist der 
Fileselektor aber noch da, und wenn der Benutzer dann Dateien auswhlt, 
werden diese dem Programm einfach per VA_START 'nachgereicht'. Einige 
Programme, mit denen das klappt, stehen sogar schon in Freedoms 
Konfigurationsdatei. Viele Programme machen allerdings Probleme, wenn sie 
ber VA_START Dateien geliefert bekommen, die nicht existieren, etwa 
solche, die der Benutzer gerade neu erzeugen will.. Eine rhmliche 
Ausnahme ist der Texteditor Evererst, dem so gut wie alles per VA_START 
senden kann. (o: Ein Nebeneffekt der VA_START-Methode ist, das man 
beliebig viele Fileselektoren zu einem Programm ffnen kann, der Benutzer 
wird von Freedom nicht daran gehindert (Sorry, Reiner... (o:)

Zur Konfigurationsdatei noch eine Anmerkung: Alle Pfade und Masken, die 
Freedom einliest, werden sofort (je nach Einstellung durch '#LOWERCASE') 
(aus optischen Grnden) in Gro- bzw. Kleinbuchstaben gewandelt. (Ist das 
nicht gewnscht, bspw. weil ein Pfad auf ein casesensitives Filesystem 
weist), kann dem Pfad oder der Maske ein Ausrufezeichen ('!') vorange- 
stellt werden. Freedoms Expressionmatch-Routine unterscheidet allerdings 
nie zwischen Gro- und Kleinschreibung, auch nicht auf case-sensitiven 
Filesystemen.


8. Programmierer-Kapitel
========================

Freedom kann direkt untersttzt werden:

Freedom-Erkennung:
------------------
Selectric-Keks mit Version >= 2.00 installiert

Freedom-Untersttzung:
---------------------
Aufruf von fsel_[ex]input mit fs_insel _auf folgende Struktur zeigend_:

typedef struct
{
	long magic;   /* '?Fdm' */
	int id;       /* Beliebige Id */
	int maxsel;   /* Maximale Anzahl von zu selektierenden Files */
	struct
	{
        unsigned fullpaths : 1; /* volle Pfadnamen in der Antwort */
        unsigned doquote   : 1; /* Freedom darf quoten */
        unsigned noname    : 1; /* keinen Appl.-Namen vor Titel */
        unsigned sysmodal  : 1; /* System-Modal ffnen (rgs..) */
        unsigned resvd     : 28; /* reserviert (auf 0 setzen) */

	} flags;
	int handle;  /* Enthlt nach Erfolg das Fensterhandle des 
	                Fileselektors (bzw. 0 bei einem fliegenden 
	                Dialog). Sinn: Das aufrufende Programm kann den 
	                Fileselektor kontrollieren, indem es etwa eine 
	                WM_CLOSED-Nachricht dafr an Freedom sendet, oder 
	                das Fenster in sein Window-Cycle mit einbezieht.
	              */
    int server;  /* Enthlt nach Erfolg die Appl.-Id des 
	                Fileselektor-Servers. An ihn knnen Nachrichten
	                bzgl. des Fensters 'handle' gesendet werden.
	              */
	char path[0]; /* jetzt kommt der der Pfad.. */

} Fdm_Str;

kehrt fsel_input zurck, und in der Struktur steht im 'magic'
dann ein '!Fdm', war der Aufruf erfolgreich, anderenfalls wurde
der Aufruf an das OS weitergeleitet, und die Rckgabewerte 
(fs_iinpath, fs_iinsel, fs_iexbutton) sind gltig!

Bei erfolgreichem Aufruf kann die Applikation sich einer Antwort 
in Form einer AES-Message sicher sein. Ob die Applikation weiterluft
oder in einer Sub-Eventloop auf die Antwort wartet, in der Sie sonst
und nur WM_REDRAW und Co. bearbeitet, bleibt ihr berlassen. Am schnsten 
wre natrlich, wenn ein Weiterarbeiten ermglicht wird.

Das Format der AES-Antwort-Nachricht ist

#define FILE_SELECTED	0x4560
/* FILE_SELECTED: Ein Fileselektor wurde geschlossen:
 * Word 3:   Id des Fileselektors (wie bei fsel_[ex]input angegeben)
 * Word 4/5: Zeiger auf Pfad und Extension zum Zeitpunkt
 *           des Schlieens
 * Word 6/7: Zeiger auf die ausgewhlten Files, oder NULL, falls
 *           der Benutzer Abbruch bettigt hat
 *           Die Files sind durch Spaces getrennt, und enthalten
 *           je nach den Angaben beim Aufruf volle Pfade bzw.
 *           auch Quotes ('Chrisker''s Briefbeschwerer')
 */


Ein kleines Programm, das dieses Protokoll einsetzt, finden Sie in 
BEISPIEL.C.


9. Still to come
================

- Ein Setup-Programm, mit dem die Freedom-Konfigurationsdatei komfortabel 
  editiert werden kann
- Ein ST-Guide Hypertext
- Optional statt dem Redraw der Fenster von blockierten Applikationen auch 
  das iconifizieren derselben, wenn die AES dazu fhig sind, sowie Iconify 
  aller Fenster der gerade blockierten Applikation bei Iconify des 
  Fileselektors/Alerts
- Scrollbare Editfelder fr superlange Dateinamen (>32 Zeichen)
- Signal- und AP_TERM-Auswertung unter MTOS


10. Bekannte Einschrnkungen
============================

- Kein Aufruf aus TOS-Programmen. Prinzipiell geht das zwar, wenn 
  dieselben im VT52/TOSWIN-Fenster laufen), dazu mte allerdings das 
  TOS-Programm vom residenten Teil kurzzeitig bei den AES (per appl_init) 
  angemeldet werden, damit der Datenaustausch mit dem Fileselektor-Server, 
  der ja ber AES-Messages abluft, funktioniert

- Das Zusammenwirken mit vielen "Schweineprogrammen" wurde noch nicht sehr 
  intensiv getestet
  
- Der Server verbraucht ber 120kB Speicherplatz. Es gibt aus unserer Sicht
  jedoch keine Alternative zur Benutzung von EnhancedGEM. Der Verlust 
  vieler Features und eine um vieles lngere Entwicklungsdauer wren die 
  Folge...

- Im MagX-Singel-Mode wird der Freedom-Server gefreezed, was zur Folge 
  hat, da der residente Teil ihn nicht erreicht (Systemselektor kommt), 
  bzw. einen zweiten nachstartet, wenn ihm ein Pfad in FFSEL.INF gegeben 
  wurde. Aber wir arbeiten dran...

- Signale unter MiNT werden vom residenten Teil nicht ausgewertet => 
  mit jedem Prozess, den Sie mit offenem Fileselektor/Alert terminieren, 
  (KILL/TERM) geht ihnen einer der 8 'Slots' im Traphandler verloren.


11. Problemkinder
=================

- STZip (2.6) fhrt keine Redraws aus, wenn sein Fenster im Hintergrund 
  liegt

- Einige Programme rechnen nicht damit, das ihre Fenster whrend der 
  Fileselektion/eines Alerts ihre Positionen ndern knnen (ua Paula, 
  XControl, Maxidat, NotePad), schmieren unter Misachtung von 
  Rechtecklisten auf dem Screen rum bzw. ignorieren die versendeten 
  WM_MOVED Nachrichten. Abhilfe: Fenster nicht verschieben, Autor 
  benachrichtigen.

- 525 2.0 zeigt bis zum nchsten Toppen keine Reaktion, nachdem Freedom 
  weg ist

- Triple_D und Kandinsky <= V1.74 produzieren unter SingelTOS Abstrze. 
  Ab V1.78 in Kandinsky behoben.

- Fr das Menzeilen-Disablen wird das Men kurz ab- und wieder 
  angemeldet, im Zusammenhang mit Let' em Fly's Nicelines gibt mit einigen 
  Programmen das Problem, das sich Menintrge verschieben (Bse!!). 
  Daran ist Freedom nicht schuld, Letemfly eigentlich auch nicht. 
  beltter: Pixart (1.2), "Rastaman". Abhilfe: Nicelines abschalten oder 
  Programme nicht benutzen..

- XXEd reserviert nur 30 Zeichen fr den gesamten Dateinamen


12. Fragen ber Fragen
======================

F: Warum bei CPXen der Systemfileselektor?

A: Das ist erstmal eine Sicherheitsmaname, theoretisch knnte
   Freedom auch hier funktionieren, mte dafr aber deutlich tiefer
   ins System einsteigen... Bis auf das das blde NVDI3 Font-CPX
   gibt es ja auch keinen Grund, sich diese Arbeit zu machen, zumal
   CPXe normalerweise keinen Fileselector aufrufen, sowieso zu klein, 
   unhandlich und multitaskingfeindlich sind, ausserdem XControl unsauber 
   programmiert ist, und... (Aber das wrde jetzt zu weit fhren.. ;-))


F: Warum kommt bei bestimmten Programmen ohne ersichtlichen Grund
   der Systemfileselektor?

A: 1. Das Programm macht AES-Aufrufe vor dem appl_init bzw. macht gar kein
      appl_init (Fachbegriff: "Schweineprogramm"..)
   2. Bestimmte Programme machen AES-Aufrufe auf unsaubere Weise (Es wird
      bei einigen Aufrufen nicht dasselbe global-Feld im AES-Parameter-Block
      bergeben, das appl_init initialisiert hat)


F: Freedom kommt ohne ersichtlichen Grund als modaler Dialog?!

A: Freedom benutzt die MCTRL-Semaphore der AES zur Erkennung von 
   fliegenden Dialogen, da es in dieseme Fall natrlich nicht als Fenster 
   kommen darf .. Einige wenige Programme klammern auch den Fileselektor 
   mit MCTRL (zB Gemini), so da Freedom annehmen mu, der Fileselektor 
   wurde aus einem fliegenden Dialog aufgerufen. Wenn dies bei einem 
   Programm nie der Fall ist, knnen Sie es in die Ausnahmenliste 
   ('#IGNOREMCTRL') in der Konfigurationsdatei eintragen, Kandidaten dafr 
   sind zB Gemview, Imploid und Gemini, NICHT jedoch zB CAT und Maxidat, 
   die beide den Fileselektor auch aus fliegenden Dialogen aufrufen.
   Fr Programmierer folgende Richtlinie:
   Ist der FSEL-Cookie installiert und die Versionsnummer >= 2.00, sollte 
   der fsel_[ex]input Aufruf NICHT mit MCTRL geklammert werden, ansonsten 
   IMMER! Mit UPDATE sollte sowieso IMMER geklammert werden!


F: Wenn Freedom aktiv ist, lassen sich manche Fenster nicht mehr toppen?

A: Dann handelte es sich um ein Fenster einer Applikation, die gerade 
   durch Freedom blockiert ist. Das soll der Erinnerung dienen:
   Die Window-Topped-Nachricht wird stattdessen an den Server 
   weitergereicht und so der zugehrige Fileselector/Alert getoppt. 
   Nebenbei: In der Zeit, wo eine Applikation einen Fileselector/Alert 
   offen hat, untersttzt sie auch Backdropping. Wenn sie es im 
   Normalbetrieb nicht tut, ist das kein Fehler von Freedom..


F: bersteht Freedom eigentlich einen Aulsungswechsel?

A: Eigentlich ja. Wenn sie ganz sicher gehen wollen, schlieen Sie auf 
   jeden Fall alle Fileselektoren/Alerts von Freedom!!!


F: Warum kommt unter MiNT bei "Load ...." der Systemalert + Fileselektor?

A: Dieser Alert/Fileselektor wird vom AESSYS aufgerufen, und diesem Prozess
   sollte man tunlichst NICHT den Faden abnehmen...


F: Warum kommt beim MagX-Popup "Programm starten.." der Systemfileselektor,
   obwohl Selectric da funktioniert?

A: Wir hatten noch keine Zeit, uns mit der Fileselektor-Schnittstelle 
   von MagX zu beschaeftigen...

F: Wenn ich mit Freedom kopiere und Gemini <= 1.a installiert habe, 
   updatet Freedom seine Fenster nicht nach, sondern vor dem kopieren, 
   _wenn_ Gemini mit dem Kobold_2 kopiert.

A: Ein Fehler in Gemini (Die entsprechende Nachricht wird absendet, bevor 
   Gemini die Antwort des Kobold erhlt, ob berhaupt etwas kopiert wurde)


F: Ab und zu mal strzt Gemini 1.a ab, wenn ich in Freedom Tasten drcke, 
   die Freedom nicht belegt hat!

A: Freedom gibt die Tasten an den AV-Server weiter, wenn er sie nicht 
   kennt. In Gemini 1.a scheint sich ein Fehler eingeschlichen zu haben, 
   der es beim Emfang von AV_SENDKEY abstrzen lt.


F: Es gab einen Systemdeadlock/Absturz, whrend ich Freedom testete...

A: Wir selbst haben Freedom jetzt schon einige Wochen bei uns im Einsatz 
   und keine Schwierigkeiten festgestellt. Allerdings haben wir natrlich 
   nur mit den Programmen testen knnen, die wir selbst besitzen. Wenn Sie 
   also einen "beltter" (1-2-3-STZip?! Rempel, Kick, Tret.. ;-)) 
   ausmachen knnen, der unbedingt noch in Problemkind-Liste oben 
   reinmuss: Programmname, Version und Effekte an uns schicken 
   (email-Addressen am Ende dieses Textes)


F: Das mit STZip hab ich eben nicht verstanden

A: STZip war whrend der Entwicklung von Freedom unser Wolpers-Ersatz... 
   .-)

   
F: Muss es sein, das Freedom unter SingelTOS einen ACC-Slot belegt?

A: Ja. Es gehrt zum Konzept von Freedom, das die eigentliche 
   Funktionalitt des Fileselectors/Alerts in einer parallel laufenden 
   Applikation realisiert ist und unter SingelTOS geht dies eben leider 
   nur ber Accessories.


F: Warum sind die drei Imagestze (FREDOMxx.IMG) so hlich?

A: Weil Chrisker sie entworfen hat.


F: Warum sind die Funktions-Icons unten links in Freedom so hlich?

A: Weil Kolja sie entworfen hat.


13. Fast vergessen
==================

Wir bernehmen keine Haftung oder Verantworung fr direkte oder indirekte 
Schden jedweder Art, seien sie finanzieller, materieller oder sonstiger 
Art, die aus dem Gebrauch, Nichtgebrauch oder Mibrauch von Freedom ent- 
stehen.

 
Jetzt ist aber endgltig Schlu:


14. Hau to register:
====================

1. Moeglichkeit:
----------------
DM 30,- und ein frankierter Rckumschlag in einen Brief und ab an:

  Kolja Koischwitz
  Sandhauser Strae 21
  13505 Berlin


2. Moeglichkeit:
----------------
30,- berweisen/einzahlen auf das folgende Konto:

Kolja Koischwitz, Konto-Nr. 705 92-100, bei PGiroamt Berlin, BLZ 10010010.

mit einem _eindeutigen_ Vermerk, wer der berweiser ist!!
Parallel sollten Sie mit uns ber Email/Sackpost Kontakt aufnehmen.
Zur Errechnung eines Schlssels brauchen wir folgende Daten von Ihnen:

Name:    ........................
Strae:  ........................
PLZ/Ort: ........................


In beiden Faellen erhalten Sie schnellstmglich einen Schlssel, mit dem 
Sie aus dem Archiv freedm11.lzh mittels des Registrierungsprogramms die 
uneingeschraenkten Programmdateien auspacken kann! 
                                   

Falls Sie eine Email-Addresse haben, bevorzugt per Email, ansonsten muss 
ein frankierter Rckumschlag in ihrem Brief beiliegen.


Nachfragen knnen per Email gerichtet werden an:

Kolja:     joust@cs.tu-berlin.de

Chrisker:  chrisker@cs.tu-berlin.de

Criss:     Christian_Grunenberg@lb.maus.de


Das wars, Kolja & Chrisker
