JetFind 1.33                                                     17.4.1991
============

(c) 1990,1991 Dirk Steins


DIE IDEE
========

Die Idee zu JetFind stammt von dem Accessory 'Dateien finden' vom Apple
Macintosh. Zwar gibt es auf dem ST auch schon eine ganze Reihe Programme, die
in der Lage sind, Dateien auf der Harddisk zu lokalisieren, aber alle geben
auf einen TOS-Bildschirm aus und man kann auch nicht in der Ausgabe bl„ttern.
Deshalb habe ich JetFind geschrieben, um diesem Mižstand abzuhelfen. Aužerdem
ist JetFind auch noch extrem schnell beim Suchen der Dateien, da es direkt auf
der Platte sucht und nicht die langsamen Funktionen des Betriebssystems
benutzt.


DIE FEATURES
============

JetFind hat eine komplette GEM-Oberfl„che, die gefundenen Dateien werden in
einer Liste angezeigt, in der man Bl„ttern kann, zu den gefundenen Dateien
kann man sich weitere Informationen anzeigen lassen (Gr”že, Datum und Uhrzeit
der letzten Žnderung, Dateiattribute).
S„mtliche Dialoge sind tastaturbedienbar, auch die Popup-Menus (Cursor-Tasten
und Return, Abbruch mit Undo)!
Es werden erweiterte Wildcards untersttzt.
JetFind ist schnell. Genauer: JetFind ist schneller als jedes andere mir
bekannte Programm zum Dateien suchen.
Aužerdem kann man auch noch eine Liste der gefundenen Dateien auf das Clipboard
ausgeben lassen. Wahlweise kann man diese Ausgabe auch an eine schon vorhandene
Liste anh„ngen.
JetFind arbeitet jetzt auch mit GEMINI zusammen, d.h. man kann
unter GEMINI Dateien mittels JetFind suchen und dann von JetFind das Fenster
mit dem Pfad einer gefundenen Datei ”ffnen oder auch die Datei direkt ”ffnen,
also Ansehen, Drucken oder, im Falle eines Programmes, auch starten.


Die Bedienung
=============

JetFind l„uft sowohl als Accessory als auch als eingest„ndiges Programm.
Die Umschaltung erledigen Sie einfach durch Umbennen von JETFIND.ACC in
JETFIND.PRG. Sie geben den Namen der zu suchenden Datei in dem editierbaren
qeld 'Suchen nach:' ein, wobei Sie auch Joker wie '*' und '?' benutzen k”nnen.
Sie k”nnen auch wie in GEMINI nur Teilbereiche von Zeichenfolgen angeben, so
z.B. findet 'JET[FR]*' nur Dateien, die z.B. JETFIND oder JETRSC heižen, nicht
jedoch JETSTRM. Genaueres dazu steht unter WILDCARDS.
Durch einen Klick auf 'Start' oder einen Druck auf die 'Return'-Taste wird
die Suche begonnen. Die ersten sechs gefundenen Dateien werden direkt angezeigt,
sobald sie gefunden wurden. Das Suchen k”nnen Sie durch das Drcken der
'ESC'-Taste jederzeit abbrechen (die Reaktion kann ein kleines bižchen dauern).
šber den seitlichen Scrollbalken k”nnen Sie in der Liste beliebig vorw„rts
und rckw„rts bl„ttern. Die Dateien werden unsortiert angezeigt, also in
der Reihenfolge, in der Sie gefunden wurden.

Wenn Sie auf einen Eintrag in der Liste klicken, erscheint normalerweise ein
Dialog mit Informationen ber das angeklickte File. Wenn Sie jedoch gerade in
GEMINI sind, erscheint stattdessen ein Popup-Menu, in dem Sie drei M”glich-
keiten zur Auswahl haben:
   1) Info:    Es erscheint der Informations-Dialog
   2) Fenster: Es wird an GEMINI der Befehl gesendet, das Fenster mit dem
               Pfad der Datei und der gew„hlten Auswahlmaske zu ”ffnen.
   3) ”ffnen:  Es wird an GEMINI der Befehl gesendet, die Datei zu ”ffnen.
               Falls die Datei in GEMINI als ausfhrbare Datei angemeldet ist,
               wird versucht, die Datei auszufhren, ansonsten wird die Datei
               angezeigt.
   
   Anm.: Bei Auswahl der Punkte 2) und 3) wird JetFind beendet, da es ja
         nicht in einem Fenster l„uft (sp„ter vielleicht).

Dadurch k”nnen Sie auch ber JetFind Programme starten oder Dateien ansehen.

Die brigen Buttons:

Driveselect:
Es erscheint ein Dialog, in dem Sie die Laufwerke aussuchen k”nnen, auf
denen JetFind nach Dateien suchen soll. Beim Start sucht JetFind immer
nur auf dem Default-Laufwerk. Mit dem Knopf 'All' werden alle Festplatten-
laufwerke auf einmal (alles gr”žer und gleich C:) angew„hlt, mit dem
Knopf 'None' werden alle gew„hlten Laufwerke deselektiert.

Clipbrd:
Bei einem Klick auf diesen Knopf erscheint ein Popup-Menu, in dem
Sie die Listausgabe auf das Clipboard kontrollieren k”nnen.
Mit 'Liste ausgeben' wird die aktuelle File-Liste als Scrap.TXT im
sogenannten 'Clipboard' gespeichert. Falls kein Clipboard-Verzeichnis
existiert, wird eines angelegt.
Mit 'Liste anh„ngen' wird ebenfalls die aktuelle File-Liste
ausgegeben, nur wird diese an die Datei SCRAP.TXT im Clipboard-Verzeichnis
angeh„ngt. Falls eine solche nicht existiert, wird eine neue angelegt.
šber 'Ausgabeformat' k”nnen Sie festlegen, wie die Zeilen in der Datei
SCRAP.TXT aussehen sollen. Es wird immer ein Beispiel angezeigt, wie die
Ausgabe aussehen wird. Sie k”nnen dort als Ausgabeelemente den Namen, den Pfad,
das Datum und die Uhrzeit der letzten Žnderung sowie die Dateigr”že ausgeben
lassen. Aužerdem k”nnen Sie auch noch festlegen, ob der Pfad vor dem
Dateinamen ausgegeben werden soll oder hinter dem Dateinamen (Hallo, Andreas!).

Info:
Es erscheint ein Dialog mit Informationen ber JetStream, ShareWare und
eine sehr wichtige Kontonummer.
      
Quit: JetFind wird beendet, was soll da denn sonst kommen.

L”schen:
Durch diesen Knopf k”nnen Sie ALLE gefundenen Dateien von JetFind l”schen
lassen. Vorher kommt noch eine Sicherheitsabfrage, ob Sie wirklich alle
gefundenen Dateien l”schen wollen. Wenn das L”schen einmal gestartet wurde,
l„žt es sich nicht mehr abbrechen. Seien sie also vorsichtig damit, wenn Sie
diesen Knopf benutzen. Fr verlorengegange Quelltexte oder sonstige Daten
kann ich natrlich keine Haftung bernehmen! Eingebaut habe ich das auch
nur, weil mehrere Personen das gewnscht haben.


EX-TIP
======
Hier stand einmal die Empfehlung, JetFind mit dem Accessory 'The Chameleon'
von Karsten Isakovic zu benutzen. Da es jedoch in der Zusammenarbeit von
JetFind, The Chameleon und GEMINI Probleme gibt (die leider am Chameleon
liegen), kann ich das im Moment nicht mehr empfehlen. Ich hoffe aber, daž
in einer zuknftigen Version vom Chameleon diese Probleme beseitigt sind.


WILDCARDS
=========

Kommen wir nun zu den Wildcards, die in JetFind ab der Version 1.25 neu
implementiert wurden. Die Auswertung der Wildcards erfolgt nun genauso wie
in GEMINI, was ja auch kein Wunder ist, da es die gleiche Routine ist (Danke,
Gereon). Folgende Regeln gelten: '*' steht fr beliebig viele, beliebige Z
Zeichen, ein '?' steht fr ein beliebiges Zeichen. Im Gegensatz zum GEMDOS
findet man alle Dateien ber die Eingabe von '*', mit '*.*' werden nur noch
die Dateien gefunden, die auch eine Extension haben. Weiterhin kann man auch
Bereiche von Zeichen definieren, so z.B. [AFH], das steht dann fr eines der
Zeichen in den eckigen Klammern. Man kann auch direkt schreiben [A-H] anstelle
alle Zeichen aufzufhren. Durch Angabe eines '^' direkt hinter der ersten
eckigen Klammer wird der Ausdruck in den Klammern negiert, also [^A-F] steht fr
alle Zeichen aužer 'A' bis 'F'.
So, mehr kann ich dazu auch nicht erkl„ren, am besten ist es, das einfach mal
auszuprobieren.


SONSTIGES
=========

JetFind ist Shareware. Dies heižt, sie k”nnen JetFind ausgiebig testen, wenn
es Ihnen jedoch gef„llt und Sie JetFind regelm„žig benutzen, mssen Sie den
Shareware-Beitrag von DM 20,-- bezahlen. Wer will, kann natrlich auch mehr
bezahlen, worber ich mich natrlich besonders freuen wrde. Wohlgemerkt,
3 Zeilen weiter oben steht MšSSEN. Falls Sie JetFind regelm„žig benutzen
und nicht bezahlen, arbeiten Sie mit einer Raubkopie!

Dieses Geld berweisen Sie am besten auf folgendes Konto:

    Kreissparkasse Siegburg, BLZ 386 500 00, Konto-Nummer 104020516
    
Geben Sie auch bitte Ihren Namen im Verwendungszweck an, damit ich die
šberweisung auch zuordnen kann.
    
Und noch ein Hinweis: Inzwischen stecken in JetFind auch schon recht viele
Stunden Arbeit, die mir sonst keiner bezahlt. Und ich rechne auch nicht damit,
jemals irgendwie diese Stunden voll bezahlt zu bekommen. Aber ich freue mich
ber jede Anerkennung in Form des Shareware-Beitrages.

Sie k”nnen JetFind zusammen mit allen dazugeh”rigen Dateien weitergeben, auch
ber Mailbox-Systeme. Die Verbreitung ber PD-Vertriebe oder „hnliche
kommerzielle Betriebe ist untersagt. Ebenfalls untersagt ist die Weitergabe
von JetFind mit kommerziellen Produkten. Falls Sie dieses machen wollen, setzen
Sie sich doch am besten mit mir in Verbindung, sicher l„žt sich dann eine
Vereinbarung aushandeln.

Meine Adresse:      Dirk Steins
                    Auf dem Feldchen 48
                    5216 Niederkassel-6
                    DFš: ber die Maus Bonn (0228/213230) oder als
                    Dirk Steins @ BN ber jede andere Box im Mausnet
                    Dirk Steins % MAUS BN @ Fido 2:242/2 ber Fido
                    Dirk_Steins@bn.maus.de

Auch wenn Sie noch Verbesserungsvorschl„ge haben, k”nnen Sie diesen an diese
Adresse schicken (am liebsten E-Mail!). Falls Ihnen also noch ein Feature
einf„llt, das Sie gerne in JetFind sehen wrden, schreiben Sie es mir, ich
werde sehen, was ich tun kann!

JetFind wurde komplett mit dem Megamax Modula-2 Entwicklungssystem von
Application Systems Heidelberg entwickelt.
Die MagicDials sind von Peter Hellinger.

Ich kann keine Haftung fr irgendwelche direkten oder indirekten Sch„den -
einschliesslich aber nicht beschr„nkt auf materielle oder finanzielle -
bernehmen, die durch die Benutzung von JetFind oder die Untauglichkeit
von JetFind fr einen bestimmten Zweck entstehen.


DANKSAGUNG
==========

Ich danke hier an erster Stelle den 6 Leuten, die bisher den Shareware-Beitrag
gezahlt haben. Ich wrde mich freuen, wenn m”glichst viele diesen nacheifern
wrden.
Dann danke ich noch Peter Hellinger fr die MagicLibrary, Thomas Tempelmann
und Manuel Chakravarty fr die sch”ne Entwicklungsumgebung, allen Leuten,
die Verbesserungsvorschl„ge gemacht haben und letztendlich auch noch Atari
fr die Entwicklung des ST's.


THE FUTURE
==========

Je nachdem, wie hoch die Zahlungsmoral der Leute noch wird, baue ich auch noch
ein paar Verbesserungen ein. Ich denke im Moment an weitere Optionen bei der
Listenausgabe auf das Clipboard (variableres Format), eventuell werfe ich auch
die ganze Listenausgabe in ein Fenster, so daž man unter GEMINI immer zwischen
den Fenstern umschalten kann und nicht neu suchen muž.
Vielleicht baue ich auch noch das Abspeichern der Parameter ein, das ist im
Moment auch noch nicht drin.
Aužerdem st”rt mich im Moment die Gr”že von JetFind doch erheblich, ich wollte
eigentlich ein kleines Programm schreiben. Eventuell werde ich dann halt Teile
davon in Assembler neu programmieren, so daž das ganze dann hoffentlich ein
paar kB kleiner wird.


CHANGES
=======

1.0     Erste ”ffentliche Version

1.01    Directorys haben jetzt einen '\' am Ende des Dateinamens.
        JetFind sollte jetzt auch ohne Probleme mit 'The Chameleon' laufen.
        Der Mauszeiger sollte auch nicht mehr verschwinden und auch beim
        Scrollen in verschiedenen OverScan-Aufl”sungen sollte kein Pixelmll
        mehr erscheinen.

1.1     Zus„tzlich Ausgabe der erstellten Liste auf das Clipboard.
        Jetzt wird auch auf Platten mit 12 Bit FAT's gesucht (und das natrlich
        immer noch ultraschnell), kein Absturz mehr dabei.
        Bei Devices, die keinen vernnftigen Biosparameterblock liefern,
        wird jetzt ber das GEMDOS gesucht. Damit mžten auch Devices
        wie DOS-Partitionen und CD-ROM's ansprechbar und durchsuchbar
        sein.

1.2 ž   Redesign der Oberfl„che, da das ganze zu unbersichtlich war.
        Jetzt mehr Dialogboxen. Zus„tzlich die MagicDials implementiert,
        d.h. alle Dialoge sind jetzt tastenbedienbar. Aužerdem wurde noch
        die Zusammenarbeit mit GEMINI eingebaut. Als Folge daraus unter-
        sttzt JetFind jetzt auch das xAcc-Protokoll der Stufe 0.
        Das L”schen der gefundenen Dateien wurde auch noch eingebaut.
        Fehler bei Speicherberlauf behoben.

1.25 ž  Neue Wildcard-Routine, jetzt werden Wildcards, wie sie in GEMINI
        verwendet werden, zum Suchen benutzt. Die Auswahl der Laufwerke ist
        jetzt auch Tastaturbedienbar, dafr wurden 'All' und 'None' umbenannt.
        Wer dafr etwas bessere Bezeichnungen als 'Every' und 'Clear' hat,
        m”chte sich doch bitte bei mir melden.
        Die Speicherverwaltung wurde komplett umgestellt und ist jetzt auch
        noch als Nebeneffekt teilweise deutlich schneller geworden.
        
1.3     Dialogboxen optisch besser gestaltet, Anzeige des Laufwerks, auf dem
        gerade gesucht wird, eingebaut und noch einen Fehler bei zu wenig
        Speicher am Start behoben.

1.31    Huch, wie peinlich. JetFind installierte sich nicht immer in der
        Menuzeile bei normalen ST's. Das sollte jetzt aber immer klappen,
        ansonsten bitte bei mir melden. Die Popups kann man jetzt auch
        durch einen Klick mit der linken Taste aužerhalb des Popups verlassen.
        
1.32    Jetzt wird vor jedem ersten Zugriff auf ein Laufwerk doch noch ein
        SearchFirst gemacht, damit kein Medienwechsel dem GEMDOS verlorengeht.

1.33    Suchen kann jetzt durch Drcken der ESC-Taste abgebrochen werden.
        Die ersten 6 gefundenen Dateien werden direkt angezeigt.
        Aužerdem wurde testweise ein Test entfernt, so daž hoffentlich der
        Michael Heng jetzt auch alle seine Dateien findet.