===========================================================================
===========================================================================
====                                                                   ====
====        DDDDD   IIII  SSSS  KKK   KK YY    YY    Ein Programm      ====
====         DD DD   II  SS  SS  KK  KK   YY  YY         von           ====
====         DD  DD  II   SS     KK KK     YYYY       Kai Bolay        ====
====         DD  DD  II    SS    KKKK       YY                         ====
====         DD  DD  II     SS   KK KK      YY      Dieses Programm    ====
====         DD DD   II  SS  SS  KK  KK     YY            ist          ====
====        DDDDD   IIII  SSSS  KKK   KK   YYYY      Public Domain     ====
====                                                                   ====
=========================== Version 1.30 ==================================
===========================================================================


Hallo Modula-II Freaks!
-----------------------

Nachdem ich feststellen mußte, daß die meisten Programme sehr schlechte
Möglichkeiten zur Fileauswahl anbieten, habe ich mich entschlossen, selbst
einen Filerequester zu programmieren. Den Anfang machte ein 'C' Programm.
Ich wollte eine 'disky.library' erstellen. Der Versuch scheiterte...
Mit dem Umstieg auf Modula wurde der Library-Gedanke fürs erste auf Eis
gelegt (Ich hoffe immer noch auf den 'Library Linker'). Trotzdem ist die
Prozedur re-entrant (Nötig für Library Benutzung).


Die Dateien:
- Disky.dok           Diese Datei
- TestDisky.mod       Demoprogramm zur Benutzung von Disky
- TestDisky.obj       Object-Datei des Demoprogramms
- TestDisky.ref       Referenz-Datei
- TestDisky           Ausführbares Demoprogramm
- FileRequest.def     Definition des Requesters
- FileRequest.mod     Seine Implementation
- FileRequest.sym     Symbol-Datei
- FileRequest.obj     Compiliertes FileRequest
- FileRequest.ref     Referenz-Datei


Nun zu Disky:
Das Programm soll die komfortable Auswahl von Files mit Hilfe der Maus er-
möglichen. Der Einbau in eigene Programme erfolgt wie im Beispielprogramm
'TestDisky.mod'. Weitere Möglichkeiten bieten sich durch das Setzen von
verschiedenen Flags, die im Definitions-Modul kurz erklärt werden. Die
Funktion der Flags erkennt man am besten durch ausprobieren.


Besonderheiten:
- alle angeschlossenen Geräte werden als Gadgets dargestellt
- das Directory-Gadget zeigt den Pfad immer ausgeschrieben
  (Anstatt 'SYS:' oder 'DF0:' z.B.: 'Workbench:')
- vielfältige Möglichkeiten Files nicht anzuzeigen
  ('.info', Suffix, fileTestProc)
- Files können durch Doppelklick gewählt werden
- Das Einlesen eines Directories kann jederzeit unterbrochen werden
- viele Flags um das Verhalten des Requesters zu ändern

Probleme:
- backFillPen wird (noch) nicht unterstützt
- das Flag 'ownFont' funktioniert nicht korrekt (CorrectFont-Prozedur)
  (wie bekomme ich die Adresse des RastPorts eines String-Gadgets um
   mit SetFont den Font ändern zu können / andere Möglichkeiten für
   korrektes 'ownFont' ??? Bitte schreiben!)
- viel zu langes Programm (liegts am Linker, an IntuiStruct, an mir?)
  'TestDisky' ist 32kB groß!


Zum Copyright:
Das Modul kann von jedem in nicht kommerziellen Programmen frei verwendet
werden. Wer genügend Geld hat, kann mir auch eine Sharewaregebühr zukommen
lassen. Mein ewiger Dank ist Ihm/Ihr dann gewiß !

Bevor ein Programm, das dieses Modul benutzt, kommerziell genutzt oder
vertrieben wird, muß sich der Autor mit mir in Verbindung setzten und eine
eventuelle Vergütung aushandeln.


Wer Probleme, Lösungsvorschläge für meine Probleme oder zu viel Geld hat,
wem mein Programm gefällt / nicht gefällt, oder, oder, oder, ...
der soll mir schreiben (Geldgeschenke willkommen) :

   Kai Bolay
   Hoffmannstraße 168
   7250 Leonberg

Nur in dringenden Fällen anrufen:

   07152/22135

Viel Spaß!!!
[kai]