Dokumentation zu FSEARCH V6.2 ----------------------------- geschrieben von Stephan Gerle Nutzungsbedingungen: -------------------- Das Programm FSearch ist Public Domain und kann ohne Einschr„nkung benutzt werden. Ein kommerzieller Verkauf (dazu geh”ren auch sogenannte Public Domain Vers„nde, 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 sch”ne Postkarte von seinem Heimatort schicken (Adresse s.u.). Auf der Postkarte k”nnen 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. DFšler k”nnen 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 m”glichst komfortabel erm”glichen 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 grožen Festplatte ist das schon anders. Da kann man schon mal leicht die šbersicht verlieren. Aužerdem 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 l„uft sowohl als Accessorie als auch als normales Programm. Dazu muž es nur von PRG nach ACC oder umgekehrt umbenannt werden. Da das Programm grunds„tzlich 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 k”nnen Regular Expression (bekannt aus Unix angegeben werden. Z.B. k”nnte 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 regul„rer 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 regul„re 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 eingeschr„nkten Multitaskingf„higkeiten des AES. W„hrend der Suche kann weitergearbeitet werden. Die Suche kann durch Schliežen 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 Zeichengr”že' wird der Standardfont auf halbe Gr”že einge- stellt. Bei GDOS-Zeichens„tzen kann dies eventuell nicht m”glich sein, wenn eh die kleinste Gr”že schon eingestellt wurde. FSearch geht bei der Zeichengr”že folgendermažen vor: - Ist kein Programm mit AV-Protokoll geladen, so wird der Systemfont mit Zeichengr”že 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 Gr”že eingestellt worden ist Bei gefundenen Dateien wird im Window als erstes das Datum der letzten Žnderung, dann die Gr”že 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; n„chste Zeile nach jedem CR) und ein kleiner Ausschnitt aus der gefundenen Zeile angezeigt. Mittels Doppelklick auf eine gefundene Datei k”nnen 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 zust„ndig fr *.C anmeldet. 2. Shift-Links: Der Ordner, in dem die Datei liegt wird in GEMINI ge”ffnet. 3. Shift-Rechts: Das Clipboard wird aufgerufen, damit es die Datei anzeigt. Dazu muž das Clipboard geladen sein und CLIPBRD.ACC heižen. Mit 'Optionen' wird eine neue Dialogbox aufgerufen. Dialogbox 'Optionen': --------------------- Mit 'Einstellungen speichern' k”nnen 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 Zeichengr”že' sowie die Koordinaten der Men-Dialogbox sowie des Fensters abgespeichert. Von Vx.xx nach V6.0 hat sich das Format der FSEARCH.INF Datei ge„ndert. Es mssen deshalb einmal s„mtliche Einstellungen nochmal vorgenommen und abgespeichert werden. Mit 'L”schen' werden - nach Rckfrage alle gefundenen Dateien gel”scht. 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 k”nnen zus„tzliche Einschr„nkungen fr die Suche vor- genommen werden. Die Suche kann anhand des Datei-Datums, der Gr”že der Datei sowie den Datei- attributen eingeschr„nkt werden. Auf der linken Seite der Box sind 3 K„stchen, mit denen einzelne Sucheinschr„nkungen ein- und ausgestellt werden k”nnen. Nur wenn das passende K„stchen angekreuzt ist, wird die Sucheinschr„nkung auch beachtet. Bei der Datumseinschr„nkung 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 dazugeh”rige 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 Sucheinschr„nkung 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 schliežen, 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 k”nnen alle Felder mittels ALT+'dem unterstrichenen Buchstaben' angew„hlt 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, pažt zu genau diesem Zeichen. '^' Ein ^ am Anfang pažt zum Anfang einer Zeile. '$' Ein $ am Ende pažt zum Ende einer Zeile. '?' Ein Fragezeichen pažt zu jedem beliebigen Zeichen aužer 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 pažt zu einer beliebigen Anzahl von beliebigen Zeichen. '+' Plus steht hinter einem Ausdruck und pažt 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 pažt zu jedem Zeichen, das zwischen den eckigen Klammern vorkommt. Ist das erste Zeichen nach '[' ein '^', so pažt 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 pažt zu *keinem* Zeichen. Die Aneinanderreihung von Regular Expressions ist eine Regular Expression. Probleme, die auftreten k”nnen: ------------------------------- - Bei Dateioperationen w„hrend der Suche k”nnen 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 M”glichkeiten 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 f„higes 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 gr”žer 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 ge„ndert 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 ge”ffnet 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 m”glich. Liste der gefundenen Dateien kann ins Clipboard geschrieben werden. Bugfixes. * Version 4.66 Dient als Grundlage.