-----------------------------------------------------------------------------
   ParaFin ....... ein Hintergrund-Dateisucher          HzN v1.23, 19.12.1994
-----------------------------------------------------------------------------
         Dateien Suchen leichtgemacht. Besonders in GEMINI.

                 ParaFin ist Shareware! (10,-DM)
               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Nach ettlichen durchprogrammierten Nchten war er erstmal fertig, der
  PARAllelen FINder von Dateien, ParaFin.
  Derzeit sitze ich noch jedesmal mit einer 'digitalen Fliegenklatsche' vor
  den Monitor, um diversen Bugs den Gar aus zu machen :-]
  Auerdem gehen hier so viele gute Vorschlge ein, da ich fast tglich
  eine neue Version herausbringen knnte! Dank an alle Interessenten!


Was macht ParaFin?
~~~~~~~~~~~~~~~~~~
  ParaFin ist ein GEM Programm/Accessory, das ein/mehrere Laufwerke oder
  einen Pfad rekursiv nach Dateien durchsucht, die bestimmten anzugebenden
  Kriterien gengen. Schon whrend der Suche kann in anderen Programmen
  weitergearbeitet und in ParaFin bereits gefundene Dateien verarbeitet
  werden.


Der Registrierungsschlssel
~~~~~~~~~~~~~~~~~~~~~~~~~~~
  ParaFin ist ShareWare! Die unregistrierte Version von ParaFin mchte jedes
  mal beim ffnen des Fensters Namen und Schlssel fr die Registrierung
  erfahren. Wurde dieser einmal korrekt eingegeben und mit ^S abgespeichert,
  so ist ParaFin zu einer uneingeschrnkten Vollversion 'mutiert'.
  Nur in der Vollversion lassen sich die Einstellungen mit ^S speichern und
  natrlich entfllt in der Vollversion auch die Schlsselabfrage. Weitere
  Einschrnkungen gibt es nicht, ParaFin ist sonst voll funktionstchtig.


Kommen wir nun zur Bedienung
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  Das ParaFin-Fenster ist in zwei Bereiche unterteilt. Im unteren
  erscheinen die Namen und Pfade der gefundenen Dateien, im oberen werden
  die Einstellungen fr die Suche gettigt.
  Dieser obere Bereich ist wiederum mit <CONTROL>-<Cursor-Left/Right> bzw.
  F1,F2,F3 oder aber durch anklicken der Buttons "Pfad", "Attribute" und
  "Inhalt" umgeschaltet werden. Wie diese Bereiche bedient werden wird nun
  erklrt:


  "Pfad"-Bereich:
  ---------------
            Dies ist der Bereich, in dem die zu durchsuchenden Laufwerke und
            der Dateiname nebst einigen Flags eingegeben werden kann.
  ---------------
  - mit <ALT>-<Buchstabe> kann ein Laufwerk (de)selektiert werden. Bis zu
    16 Laufwerke werden gleichzeitig dargestellt. Laufwerk 'P' kann
    allerdings wegen der Belegung fr den Suchpfad nicht ber die Tastatur
    selektiert werden. Besitzer von MultiTOS bzw. MagiC 3.0 sollten
    corsichtig mit dem Durchsuchen von Laufwerk 'U' umgehen. Immerhin
    werden darber _alle_anderen_ Laufwerke auch mit durchsucht!
    Mit <SHIFT><ALT>-<Buchstabe> knnen alle Laufwerke ab dem angewhlten
    gleichzeitig (de)selektiert werden. <SHIFT>-Klick bewirkt dasselbe.

  - mit <ALT>-P erscheint die Fileselector zwecks Eingabe eines Suchpfades.
    Gelscht wird dieser Pfad, indem im Fileselector 'Abbruch'/'Cancel'
    angeklickt wird.

  - mit <SHIFT><CNTRL>-P,H,S,A,D knnen die Flags (de)selektiert werden,
    die bei den zu suchenden Dateien gesetzt sein sollen.
    Die Buttons haben drei Stati:
          gerastert    =   ignorieren des Flags
          selektiert   =   das Flag _mu_ gesetzt sein
          deselektiert =   das Flag darf _nicht_ gesetzt sein
    Die Buchstaben bedeuten:
          P - protected    Die Datei ist schreibgeschtzt
          H - hidden       Die Datei ist nicht sichtbar, aber vorhanden
          S - system       Dies ist eine Systemdatei
          A - archive      Das File ist noch nicht archiviert worden
          D - directory    Es handelt sich hierbei um ein Unterverzeichnis


  "Attribute"-Bereich:
  --------------------
            In diesem Bereich lassen sich weitere Suchkriterien angeben.
            So ist es z.B. mglich, alle Dateien zu suchen, die
   'seit'   einer bestimmten Tageszeit erzeugt wurden (nur 1. Feld)
   'bis'    zu einer Tageszeit         erzeugt wurden (nur 2. Feld) oder
   'in einem Zeitraum'                 erzeugt wurden (1. und 2. Zeit-Feld).
            Die gleichen Einstellungsmglichkeiten bestehen ebenso fr das
            Erstellungsdatum der Datei.
  --------------------
  - Mit Klick auf 'Zeitraum:' bzw Alt-Z wird dieses Suchkriterium ange-
    schaltet.

  - Mit Klick auf 'Gre:' bzw Alt-G kann auch die Suche nach Dateien mit
    bestimmter Lnge durchgefhrt werden.

  - <TAB> wirkt in diesem und dem "Inhalt"-Bereich nicht auf die Dateiinfo
    sondern wird verwendet, um zwischen den Eingabefeldern zu springen. Im
    Gegensatz zur normalen Bedienung in Editfeldern wandert der Cursor in
    ParaFin zyklisch die Felder ab.


   "Inhalt"-Bereich:
   -----------------
            Hier knnen bis zu 4 verschiedene Zeichenfolgen angegeben
            werden, die in den Dateien gesucht werden, auf die alle vorheri-
            gen Kriterien zutrafen. Mit dem "AND/OR"-Button kann angegeben
            werden, ob nur irgendein (OR) oder jeder (AND) Suchbegriff in
            der Datei zu finden sein mu.
   -----------------
   - Mit Alt-D oder Klick auf "Datei soll beinhalten" wird die Suche
     innerhalb der Dateien eingeschaltet. Gesucht wird nur mit den Feldern,
     in die etwas eingetragen wurde.

   - Alt-A/O oder Klick auf "AND","OR" schaltet zwischen den beiden
     Verknpfungen fr die Suche hin und her.

   - Alt-G schaltet zwischen case-sensitiver und nicht case-sensitiver
     Suche um.

   - Wie im "Attribute"-Bereich wirkt hier <TAB> ebenfalls nur auf die
     Eingabefelder.


  Allgemeine Bedienung:
  ---------------------
            Hier geht es um die Bedienung des unteren Bereichs des Fensters
            und den Mglichkeiten, die ParaFin zur Weiterverarbeitung der
            gefundenen Dateien bietet.
  ---------------------
  - <RETURN/ENTER> startet/stoppt den Suchvorgang. Zusammen mit <SHIFT>
    wird dabei die Liste der bereits gefundenen Dateien nicht gelscht
    sondern um die neuen erweitert.

  - ^Q verlt das Programm ohne Abfrage bzw. schliet das Fenster, wenn
    ParaFin als ACC luft.
    Bemerkung: Als ACC mu ein Programm allen Speicher freigeben, wenn es
    sein Fenster schliet. Deshalb wird die Liste gefundener Dateien gelscht,
    wenn das ACC-Fenster geschlossen wird/werden mu.

  - mit den CURSOR-TASTEN kann eine entstandene Liste durchwandert werden.
    Mit <SHIFT> wird seitenweise geblttert.

  - <HOME> springt an den Anfang, <SHIFT><HOME> an's Ende der Liste.

  - ^F bringt das Fenster auf Maximale Gre und wieder zurck.

  - ^O oder Doppelklick auf einen Pfad startet bzw. ffnet die Datei unter
    GEMINI, als ob es ein GEMINI-Fenster wre. AV_STARTPROG sei Dank ;-)

  - Wie auch in den GEMINI Dateifenstern ffnet ^O oder Doppelklick
    zusammen mit <ALT> ein Fenster, in dem der Eintrag steht, auf dem der
    Cursor plaziert ist.
    MERKE: Der Eintrag, auf dem der Cursor steht wird geffnet, nicht der,
           der selektiert ist!

  - <TAB> oder ^I ruft einen Info-Dialog ber die Datei unter dem Cursor
    auf. Den Informationsdialog erhlt man auch, wenn man bei einem
    Doppelklick auf eine Datei die <CNTRL>-Taste gedrckt hlt.

  - ^A selektiert alle (bis dahin) eingelesenen Eintrge. Waren schon alle
    selektiert, so werden alle deselektiert.

  - <INSERT> invertiert die Zustnde eines Eintrags. <SHIFT>-<INSERT>
    dagegen wirkt wie das Anklicken mit der Maus.

  - Am Rand des Fensters kann man auch einen Rahmen ber zu selektierende
    Pfade aufziehen. Bei zustzlich <SHIFT> werden die Selektionen im
    Bereich des Rahmens invertiert.

  - ^C schreibt alle selektierten Eintrge auf das Clipboard. Zusammen mit
    <SHIFT> werden die Eintrge an das Clipboard angehngt.
    War nur ein einzelner Eintrag selektiert, wird kein CR/LF an die Zeile
    angehngt, um den Clip z.B. in der Mupfel verwenden zu knnen.
    War dagegen _kein_ Eintrag selektiert, so wird der String aus dem Edit-
    Feld auf das Clipboard geschrieben.

  - ^V liest das Clipboard und versucht, es in ein Edit-Feld einzutragen.

  - ^S sichert alle Einstellungen (auer der Dateiliste) in einer INF-
    Datei. Darin wird auch der eingegebene Registrierungsschlssel
    gesichert.

  - Ein in den oberen Bereich des ParaFin-Fensters gezogener Eintrag wird
    als Suchpfad eingetragen. Selbiges geschieht auch, wenn man eine Datei
    von GEMINI aus auf das Fenster zieht.
    Wird diese Datei in den oberen Bereich gezogen, so wird der Pfad einge-
    tragen. In den unteren Bereich gezogen wird die Datei mit in die Liste
    aufgenommen.

  - .... weiteres folgt wie immer und auf Wunsch in den nchsten Versionen...


Technisches und Wissenswertes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  Bis auf die Edit-Felder und die Laufwerksbuttons ist ParaFin auch whrend
  der Suche zu bedienen. Bei der Inhaltssuche kann die Bedienung allerdings
  ab und zu etwas hngen, wenn lange Plattenzugriffe zum Laden der Dateien
  ntig sind. Bedenken Sie dabei, da ungeduldige Tastendrcke im
  Tastaturbuffer landen und bei der nchsten Event-Abfrage 'en Block'
  abgearbeitet werden!

  ParaFin untersttzt das VA/AV_Protokoll von GEMINI. Sie knnen per
  Doppelklick oder mit ^O eine gefundene Datei in GEMINI ffnen bzw. ein
  Programm starten lassen. Zusammen mit <ALT> wird das Fenster geffnet, in
  dem die Datei steht.

  Seit der GEMINI Version 1.999a knnen auch mit Mausklick bzw. <INSERT>
  einzelne gefundene Dateien selektiert werden. Zusammen mit <SHIFT> lassen
  sich auch mehrere Dateien anwhlen. Diese kann man einfach irgendwo hin
  ziehen (z.B. auf ein Editor-Icon auf dem Desktop) und die vom Desktop
  gewohnte Aktion wird ausgelst (der Editor wird also mit der bergebenen
  Datei gestartet).

-----------------------------------------------------------------------------
  ANMERKUNG ZU GEMINI 1.999a:
      Leider ist die GEMINI-Version 1.999a vom 15.8.94 fehlerhaft im Bezug
      auf die Meldung AV_DRAG_ON_WINDOW, von der ParaFin regen Gebrauch
      macht, wenn ein Eintrag auerhalb seines Fensters gezogen wird.
      Dieser Fehler uert sich in harmlosen aber unsinnigen Alertboxen
      ber die Bearbeitung nur eines bergebenen Pfades bis zum
      irreparablen Systemabsturz! Diese Fehler sind aber schon gefunden und
      beseitigt und in Versionen jenseits von 1.999a nicht mehr vorhanden.
-----------------------------------------------------------------------------

  Das Fenster kann whrend der Suche irgendwo nach Hinten gelegt werden, wo
  es nicht strt. Wenn die Suche beendet ist - egal, ob erfolgreich oder
  nicht -, kommt das Fenster automatisch nach oben.

  Die Liste der gefundenen Dateien darf den gesamten Speicher fllen, der
  Hppchenweise in 8K-Blcken alloziert wird. Ich benutze ParaFin z.B. ab
  und zu dafr, durchzuzhlen, wieviele Ordner auf der Platte sind.

  Naja, und ich habe mich mal wieder bemht, das Programm klein zu halten:
      Dateigre               ca. 28 KB
      Im Betrieb (ohne Liste)  ca. 34 KB

  Selbstverstndlich luft ParaFin sowohl als PRG als auch als ACC und
  unter smtlichen TOS-Versionen.



Jetzt noch Rechtliches:
~~~~~~~~~~~~~~~~~~~~~~~
  ParaFin ist ein ShareWare-Programm. Das Programm darf immer nur komplett
  weitergegeben werden mit:
     PARAFIN.PRG         - Das Programm, umbenennbar in PARAFIN.ACC
     PARAFIN.TXT         - Dieser Text hier
     PARAFIN.UPL         - kurze Beschreibung fr Mailboxen
  Die kommerzielle Verbreitung ist nicht erlaubt (alle Rechte liegen beim
  Programmautor).

  Wenn das Programm nach einer gewissen Testzeit (einige Wochen) weiterhin
  genutzt werden soll, so mu der einmalige Sharewarebeitrag von 10,- DM an
  den Autor gezahlt werden, ansonsten ist das Programm genauso eine
  Raubkopie, wie illegale Kopien von nicht frei erhltlicher, kommerziell
  vertriebener Software.

  Fr Schden, die durch die Benutzung des Programmes entstehen, bernehme
  ich keine Haftung.

  Gezahlt werden kann Bar, per Scheck oder auf das Konto

      BLZ:   268 514 10,  KSK Clausthal-Zellerfeld
      Konto: 100 230 622
      Stichwort: ParaFin

  Bei der Registrierung bitte Adresse und Versionsnummer und vor allem
  irgendwo den *Namen fr den Schlssel* angeben!!!

  Ich nehme an, ParaFin ist trotz meiner intensiven Bemhungen - ich
  benutze es ja schlielich selbst ;-) - nicht Fehlerfrei. Anregungen und
  Verbesserungsvorschlge nehme ich deshalb gern entgegen und werde mich
  bemhen, die Fehler schnellstmglich zu beheben.

  Die neuste Programmversion wird immer im MAUS-Net zu finden sein. Die
  'Heimatbox' von ParaFin ist die MAUS G (Gttingen 0551-7704464), fr
  FTPler werde ich ParaFin ab und zu auf ftp.tu-clausthal.de schieben.


  Frhliches Suchen wnscht,

    Hartwig zur Nieden
    Neue Strae 2
    38678 Clausthal-Zellerfeld
    Tel:   (05323)1318
    MAUS:  Hartwig-zur Nieden @ G
    eMail: nieden@imw.tu-clausthal.de
           mwhzn@rz.tu-clausthal.de


-----------------------------------------------------------------------------
HISTORY:
~~~~~~~~
v0.0  Es funktioniert!!
v0.1  Verbessertes Scrolling.
v0.2  Commandline, VA_START, VA_DRAGACCWIND werden ausgewertet.
v0.3  AV_DRAG_ON_WINDOW und Mehrfachselektionen.
v0.31 Fehler bei Redraw behoben.
v0.32 "Division by Zero" gibt's nicht mehr.
v0.4  Dreifache Logik bei den Flags, Info-Dialog, Liste erweiterbar.
v1.0  Wir gehen in die ffentlichkeit!
v1.01 ^A;^C; Pfad aus eigenem Fenster bernehmen.
v1.02 Im Suchstring nun ALLE Zeichen erlaubt, auer Kleinbuchstaben.
      ^O und Doppelklick starten nun die Datei, Fenster mit ALT.
v1.03 Besserte Hintergrundbedienbarkeit, kein 'klemmen' mehr. Unter
      SingleTOS Bug nach AC_CLOSE entfernt. Pfad und Maske bleiben.
v1.04 Selektions-Status-Reihenfolge der Attribute gendert. Ein einzelner
      Pfad wird bei ^C ohne CR/LF gesichert. Nun bis zu 16 nicht
      hintereinander stehende Laufwerke mglich. AV_STARTED implementiert.
v1.05 Gleichzeitiges (de)selektieren der Laufwerke bei <SHIFT>.
v1.06 Redraw-Optimierung (WinCom macht's ntig!), bei den ersten Eintrgen
      kein Flimmern mehr. ^F eingebaut. Es werden nun mit SHIFT alle Lauf-
      werke _nach_ dem Angewhlten umgesetzt, nicht mehr alle.
      Auerdem 'n bisserl an MTOS angepasst: WF_ICONIFY und WF_BOTTOM.
v1.07 Selektion der Pfade durch aufziehen eines Rahmens am Rand.
v1.10 AV_XWIND fr die neue GEMINI eingebaut. Nun auch AVSERVER ausgewer-
      tet (peinlich, vergessen :-}). ParaFin ist Teil des GEMINI-Pakets.
v1.11 AVSERVER-Variable nun auch auf 8 Zeichen verlngert!
v1.12 Bei ParaFin als ACC konnte beim Drag das System hngen, weil der
      Mausklick auf den Desktop 'durchfiel'.
v1.20 Fehler bei DTA-Benutzung als ACC unter SingleTOS behoben.
      Neue Optionen: Suchen nach Zeit/Datum[s-Intervallen] und Dateigre.
v1.21 Nun haben wir auch ein kleines grep eingebaut :-)
v1.22 [<Shift>]<HOME> eingebaut; ^C,^V in Editfeldern, wenn nichts in der
      Liste selektiert ist; ^A deselektiert, wenn schon alles selektiert
      war; Grep auch bei berlangen Dateien; NonCaseSensitive-Grep mglich;
      GEMINI-Datei in die Liste gedragged wird dort aufgenommen.
v1.23 Nun doch _Schlssel-Registrierung_ (kein Parametersichern mglich);
      ^S sichert alle gemachten Einstellungen; Grep funktioniert nun endlich
      so wie es soll; eindraggen von GEMINI-Dateien nun korrekt; Grep-Buffer
      hat einstellbare Gre.
