                    Dokumentation zu FSEARCH V6.2
                    -----------------------------
                    geschrieben von Stephan Gerle


Nutzungsbedingungen:
--------------------
Das Programm FSearch ist Public Domain und kann ohne Einschrnkung
benutzt werden. Ein kommerzieller Verkauf (dazu gehren auch
sogenannte Public Domain Versnde, die mehr als den Diskettenpreis
verlangen) ist verboten.
FSearch darf nur zusammen mit dieser Textdatei weitergegeben werden.

Wer das Programm nutzt, sollte mir als kleine Anerkennung eine schne
Postkarte von seinem Heimatort schicken (Adresse s.u.).
Auf der Postkarte knnen dann auch Fehlermeldungen oder nderungs-
wnsche angegeben werden. Dann sollte aber unbedingt die Versions-
nummer von FSearch auf der Karte notiert werden.

ber eine kleine Spende freue ich mich natrlich immer. Falls sich jemand
dazu berwinden sollte kann er mir das Geld auf folgendes Konto berweisen:

Stadtsparkasse Dortmund
BLZ 440 501 99
Konto Nr. 372 007 222

Falls jemand eine neue Version haben will, kann er mir eine Diskette mit
frankiertem Rckumschlag schicken. Die neueste Version werde ich dann auf
die Diskette draufkopieren und zurckschicken.
DFler knnen die neueste Version auch in der Maus DO (0231-174 674)
downloaden.


Neue Features:
--------------
Seit der letzten durch Mailboxen verteilten Versionen haben sich
einige nderungen ergeben.
Am besten den ganzen Text nochmal durchlesen.
Fr die ganz eiligen ist ganz am Schlu eine Kurzfassung der nderungen
aufgefhrt.

Allgemeines:
------------
FSearch steht fr Dateisucher.
Mit dem Namen steht dann auch schon die Funktion des Programms fest.
Der Dateisucher soll es mglichst komfortabel ermglichen Programme
zu finden. Sinnvoll ist dieses Programm aber sicherlich nur auf
einer Festplatte. Durch das Dateisystem einer Diskette wird wohl noch
jeder durchsteigen. Bei einer groen Festplatte ist das schon anders.
Da kann man schon mal leicht die bersicht verlieren.
Auerdem kann noch innerhalb der Dateien nach Textstellen gesucht werden.
Mit Hilfe der Textsuche kann man z.B. alle seine C-Sourcen suchen lassen,
wo eine bestimmte Include-Datei benutzt wird.

Das Programm luft sowohl als Accessorie als auch als normales Programm.
Dazu mu es nur von PRG nach ACC oder umgekehrt umbenannt werden.
Da das Programm grundstzlich im Hintergrund sucht, kann auch normal
weitergearbeitet werden, wenn Dateien gesucht werden.
Ist allerdings die Textsuche aktiviert, so wird die Arbeit doch extrem
verlangsamt.

Allgemeine Bedienung:
---------------------
Im obersten Textfeld mssen die Laufwerke, ein Anfangspfad sowie eine
Dateimaske angegeben werden. Die Angabe der Laufwerke sowie des
Anfangspfades sind optional.
Bei der Dateimaske knnen Regular Expression (bekannt aus Unix angegeben
werden.
Z.B. knnte man folgendes eingeben.
CD:\TC\*.[CH]
Dies wrde bewirken, das auf den Laufwerken C: und D: ab dem Ordner \TC
alle Dateien mit der Endung .C oder .H gesucht wrden.
Das genaue Format ist:
[Laufwerke][Pfad]Maske
Ist kein Pfad angegeben, so ist \ als Voreinstellung angenommen.
Sind keine Laufwerke angegeben, so werden alle Laufwerke durchsucht.

Mittels eines Doppelklicks auf die Zeile fr die Pfadangabe, kann eine
Fileselektorbox aufgerufen werden, mit dessen Hilfe man dann den Pfad
einstellen kann. Das Suchmuster wird in der Fileselektorbox hinter
dem Pfadnamen angegeben.
Diese Methode des Suchpfadeinstellens fhrt zu Informationsverlusten,
wenn mehrere Laufwerke oder ein regulrer Ausdruck angegeben wurden.

Falls man Textstellen innerhalb von Programmen sucht, so mu 'Grep'
selektiert sein.
In dem Textfeld daneben, mu dann eine Regular-Expression angegeben werden.
Dieser regulre Ausdruck dient nur dann als Suchmuster, wenn das
Feld 'RegExp' angekreuzt ist.
Ansonsten wird einfach nur nach einem bereinstimmenden String gesucht
(ohne Beachtung der Gro-/Kleinschreibung).

Rechts neben der Zeile fr den Pfad und das Suchmuster sind zwei Boxen, in
denen ein Pfeil nach oben zeigt. Klickt man auf diese Pfeile, so erscheint
ein Popup, in dem man einen aus 10 speicherbaren Pfaden bzw. Suchmustern
aussuchen kann. Das aktive Feld hat einen Haken vor dem Text.

Ist das Feld 'Rekursiv' an, so wird auch in den tiefer liegenden
Ordnern gesucht. Ansonsten wird nur in dem angegebenen Ordner gesucht.

Mit 'Suchen' beginnt die Suche. Ist das Programm fertig, so meldet
es sich mit der Anzahl der gefundenen Dateien.

Der Dateisucher nutzt die eingeschrnkten Multitaskingfhigkeiten des
AES. Whrend der Suche kann weitergearbeitet werden.

Die Suche kann durch Schlieen des Fensters abgebrochen werden.

Wurde FSearch als ACC gestartet, so erreicht man das Men ber
den Deskeintrag. Ist das Fenster von FSearch das Oberste, so kann
man das Men auch durch drcken von RETURN oder ENTER aufrufen.
Wurde FSearch als PRG gestartet, so erreicht man das Men ber den
Meneintrag "Men..." oder Ctrl-M.

Mit 'kleine Zeichengre' wird der Standardfont auf halbe Gre einge-
stellt. Bei GDOS-Zeichenstzen kann dies eventuell nicht mglich sein,
wenn eh die kleinste Gre schon eingestellt wurde.
FSearch geht bei der Zeichengre folgendermaen vor:
- Ist kein Programm mit AV-Protokoll geladen, so wird der Systemfont
  mit Zeichengre 16 Pixel als Standard angenommen.
- Ist ein Programm mit AV-Protokoll eingeladen (z.B. GEMINI 1.2), so
  fragt FSearch bei dem Hauptprogramm nach, welcher Font in welcher
  Gre eingestellt worden ist

Bei gefundenen Dateien wird im Window als erstes das Datum der letzten
nderung, dann die Gre und zum Schlu der Pfad mit dem Dateinamen der Datei.
Bei Textstellen, die in der Datei gefunden werden konnten, wird als erstes
die Zeile (Beginn bei 1; nchste Zeile nach jedem CR) und ein kleiner
Ausschnitt aus der gefundenen Zeile angezeigt.

Mittels Doppelklick auf eine gefundene Datei knnen verschiedene
Aktionen ausgefhrt werden.
1. Ohne Shift:   Die Datei wird mittels AV-Protokoll (z.B. in GEMINI
                 gestartet.
                 Damit kann z.B. TC aufgerufen werden, indem man
                 TC zustndig fr *.C anmeldet.
2. Shift-Links:  Der Ordner, in dem die Datei liegt wird in GEMINI
                 geffnet.
3. Shift-Rechts: Das Clipboard wird aufgerufen, damit es die Datei
                 anzeigt. Dazu mu das Clipboard geladen sein
                 und CLIPBRD.ACC heien.

Mit 'Optionen' wird eine neue Dialogbox aufgerufen.

Dialogbox 'Optionen':
---------------------
Mit 'Einstellungen speichern' knnen die Parameter von FSearch
abgespeichert werden.
Wurde FSearch als ACC gestartet, so wird immer in C:\FSEARCH.INF
gespeichert. Wurde FSearch als PRG gestartet, so werden die Parameter
im lokalen Pfad unter FSEARCH.INF abgelegt.
Es werden die Suchpfade, die Textmuster, der Status der Buttons 'Grep',
'Rekursiv', 'Hintergrundsuche an' und 'kleine Zeichengre' sowie die
Koordinaten der Men-Dialogbox sowie des Fensters abgespeichert.

Von Vx.xx nach V6.0 hat sich das Format der FSEARCH.INF Datei gendert.
Es mssen deshalb einmal smtliche Einstellungen nochmal vorgenommen
und abgespeichert werden.

Mit 'Lschen' werden - nach Rckfrage alle gefundenen Dateien gelscht.
Mit 'Touch' werden alle Dateien auf das aktuelle Datum gesetzt.
Mit 'Liste drucken' wird die Liste der gefundenen Dateien auf dem
Drucker ausgegeben. Dazu sollte wegen dem '\' der Drucker auf
amerikanischem Zeichensatz stehen.
Mit 'Liste ins Clipboard' wird die Liste der gefundenen Dateien
als Textdatei unter dem Namen SCRAP.TXT in das Clipboard geschrieben.


Dialogbox 'eXtended Mask':
--------------------------
In dieser Dialogbox knnen zustzliche Einschrnkungen fr die Suche vor-
genommen werden.
Die Suche kann anhand des Datei-Datums, der Gre der Datei sowie den Datei-
attributen eingeschrnkt werden.
Auf der linken Seite der Box sind 3 Kstchen, mit denen einzelne
Sucheinschrnkungen ein- und ausgestellt werden knnen.
Nur wenn das passende Kstchen angekreuzt ist, wird die Sucheinschrnkung auch
beachtet.
Bei der Datumseinschrnkung mu das Datum korrekt angegeben werden. Ein
falsches Datums wird durch ein Nulldatum ersetzt.
Bei den Attributen sind sogenannte TriState-Buttons vorhanden. Ist der Knopf
angekreuzt, mu das dazugehrige Attribut gesetzt sein. Ist der Knopf wei, so
darf das Attribut nicht gesetzt sein. Ist der Knopf grau, so ist der Zustand
des Attributes egal.

Ist irgendeine Sucheinschrnkung aktiv, so ist vor dem Knopf 'X-Mask' ein Haken.

Tastaturkommandos:
------------------
P bedeutet start von FSearch als Programm.
A bedeutet start von FSearch als Accessorie.

Taste  PA Beschreibung
----------------------
CTRL-M PA Aufruf des Men's
CTRL-I PA Anzeige der Info-Box
CTRL-Q P  Programm verlassen
        A Fenster schlieen, Suche abbrechen ohne Nachfrage
CTRL-D PA Suche abbrechen mit Nachfrage (Gemini like)
CTRL-U PA ebenso (TC like)
CTRL-W PA Bringt ein anderes als das FSearch-Fenster nach vorne
ENTER   A Aufruf des Men's
RETURN  A ebenso
Cursortasten PA Bedienung wie bei TC. Ohne Shift zeilen- bzw. spalten-
                weises Scrolling. Mit Shift immer mehrere Spalten bzw.
                Zeilen.

In den Dialogboxen knnen alle Felder mittels ALT+'dem unterstrichenen
Buchstaben' angewhlt bzw. aufgerufen werden.

Hier nun eine Bescheibung von Regular-Expressions:
--------------------------------------------------
Eine Regular Expression definiert das Muster, wonach gesucht werden soll.
Gro- und Kleinschreibung wird ignoriert.
x      Ein normales Zeichen, welches unten nicht aufgefhrt ist, pat
       zu genau diesem Zeichen.
'^'    Ein ^ am Anfang pat zum Anfang einer Zeile.
'$'    Ein $ am Ende pat zum Ende einer Zeile.
'?'    Ein Fragezeichen pat zu jedem beliebigen Zeichen auer dem Zeilenende.
':'    Ein Doppelpunkt definiert den Anfang einer Klasse.
':a'   Doppelpunkt a definiert die Klasse aller Zeichen von a-z.
':d'   Doppelpunkt d definiert die Klasse von 0-9.
':n'   Doppelpunkt n definiert die Klasse der alphanumerischen Zeichen.
': '   Doppelpunkt Leerzeichen definiert die Klasse der White Spaces wie
       Leerzeichen, Tab und Newline.
'*'    Der Stern pat zu einer beliebigen Anzahl von beliebigen Zeichen.
'+'    Plus steht hinter einem Ausdruck und pat zu einem oder mehreren
       Vorkomnissen dieses Ausdrucks.
'-'    Minus steht hinter einem Ausdruck und bedeutet, das dieser Ausdruck
       einmal oder keinmal vorkommen darf.
'[]'   Ein String in eckigen Klammern pat zu jedem Zeichen, das zwischen
       den eckigen Klammern vorkommt.
       Ist das erste Zeichen nach '[' ein '^', so pat dieser Ausdruck
       zu allen Zeichen, die *nicht* zwischen den eckigen Klammern
       vorkommen.
       Mit Hilfe von '-' kann ein Bereich definiert werden. '[a-z]' zu
       allen Zeichen von a bis z. '[z-a]' dagegen pat zu *keinem*
       Zeichen.
Die Aneinanderreihung von Regular Expressions ist eine Regular Expression.

Probleme, die auftreten knnen:
-------------------------------
- Bei Dateioperationen whrend der Suche knnen interessante Effekte
  auftreten, die aber garantiert nicht gewollt sind.

Adresse:
--------
Gelbe Post     Stephan Gerle
               Ruthstr. 8
               4600 Dortmund 1
Graue Post     Tel.: 0231 - 65 25 35

E-Mail (DF)   MausNet  Stephan Gerle @ DO
               Usenet   Stephan_Gerle @ do.maus.de
               Zerberus Stephan_Gerle % DO @ ZERMAUS.ZER
               Fido-Net Stephan Gerle % MAUS DO @ 2:242/2

PS.: Alle neuen Mglichkeiten lassen sich erst mit GEMINI V1.2 nutzen.

Neu in:
--------
* Version 6.2:21.8.92 Kleine Bugfixes
* Version 6.1:13.5.92 Support fr Verzeichnisfunktionen von MiNT.
* Version 6.0:12.2.91 Support fr multitasking fhiges AES eingebaut.
                      Scrolling Bug behoben.
                      Korrektes Scrolling, wenn Fenster nicht oberstes Fenster.
                      Popups fr speicherbare Pfade und Suchmuster.
                      Schnelleres Suchen durch setzen von absoluten Pfaden bei
                      Fsfirst()
                      Funktioniert bei Laufwerken grer P: jetzt korrekt.
* Version 5.3:18.8.91 Seitenweises Scrolling hoch/runter jetzt genau
                      gleich gro.
                      Fenster geht erst nach Beenden des Dialogs
                      auf.
* Version 5.2:23.3.91 Timeout im AV-Protokoll entfernt.
                      Fonthandling gendert
                      Status offen/zu wird in GEMINI abgespeichert
* Version 5.1:25.2.91 Die Hintergrundsuche kann abgestellt werden.
                      Bei Doppelklick auf eine gefundene Datei
                      passiert nun folgendes:
                      Ohne Shift: Programm oder Datei wird mittels
                                  AV-Protokoll gestartet.
                      Shift-Links:Ordner in GEMINI wird geffnet
                      Shift-Rechts:Clipboard zeigt Datei an.
* Version 5.0:4.2.91  AV-Protokoll in FSearch eingebaut.
                      Dadurch unter GEMINI selber Font wie im Dateifenster.
                      Dialoge neu entworfen.
                      10 seperate Strings fr Suchpfad und Suchestring.
                      Touch auf gefundene Dateien mglich.
                      Liste der gefundenen Dateien kann ins Clipboard
                      geschrieben werden.
                      Bugfixes.

* Version 4.66        Dient als Grundlage.
