home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / disk / jetfd133 / jetfind.man < prev    next >
Text File  |  1991-04-16  |  14KB  |  275 lines
  1. JetFind 1.33                                                     17.4.1991
  2. ============
  3.  
  4. (c) 1990,1991 Dirk Steins
  5.  
  6.  
  7. DIE IDEE
  8. ========
  9.  
  10. Die Idee zu JetFind stammt von dem Accessory 'Dateien finden' vom Apple
  11. Macintosh. Zwar gibt es auf dem ST auch schon eine ganze Reihe Programme, die
  12. in der Lage sind, Dateien auf der Harddisk zu lokalisieren, aber alle geben
  13. auf einen TOS-Bildschirm aus und man kann auch nicht in der Ausgabe blättern.
  14. Deshalb habe ich JetFind geschrieben, um diesem Mißstand abzuhelfen. Außerdem
  15. ist JetFind auch noch extrem schnell beim Suchen der Dateien, da es direkt auf
  16. der Platte sucht und nicht die langsamen Funktionen des Betriebssystems
  17. benutzt.
  18.  
  19.  
  20. DIE FEATURES
  21. ============
  22.  
  23. JetFind hat eine komplette GEM-Oberfläche, die gefundenen Dateien werden in
  24. einer Liste angezeigt, in der man Blättern kann, zu den gefundenen Dateien
  25. kann man sich weitere Informationen anzeigen lassen (Größe, Datum und Uhrzeit
  26. der letzten Änderung, Dateiattribute).
  27. Sämtliche Dialoge sind tastaturbedienbar, auch die Popup-Menus (Cursor-Tasten
  28. und Return, Abbruch mit Undo)!
  29. Es werden erweiterte Wildcards unterstützt.
  30. JetFind ist schnell. Genauer: JetFind ist schneller als jedes andere mir
  31. bekannte Programm zum Dateien suchen.
  32. Außerdem kann man auch noch eine Liste der gefundenen Dateien auf das Clipboard
  33. ausgeben lassen. Wahlweise kann man diese Ausgabe auch an eine schon vorhandene
  34. Liste anhängen.
  35. JetFind arbeitet jetzt auch mit GEMINI zusammen, d.h. man kann
  36. unter GEMINI Dateien mittels JetFind suchen und dann von JetFind das Fenster
  37. mit dem Pfad einer gefundenen Datei öffnen oder auch die Datei direkt öffnen,
  38. also Ansehen, Drucken oder, im Falle eines Programmes, auch starten.
  39.  
  40.  
  41. Die Bedienung
  42. =============
  43.  
  44. JetFind läuft sowohl als Accessory als auch als eingeständiges Programm.
  45. Die Umschaltung erledigen Sie einfach durch Umbennen von JETFIND.ACC in
  46. JETFIND.PRG. Sie geben den Namen der zu suchenden Datei in dem editierbaren
  47. qeld 'Suchen nach:' ein, wobei Sie auch Joker wie '*' und '?' benutzen können.
  48. Sie können auch wie in GEMINI nur Teilbereiche von Zeichenfolgen angeben, so
  49. z.B. findet 'JET[FR]*' nur Dateien, die z.B. JETFIND oder JETRSC heißen, nicht
  50. jedoch JETSTRM. Genaueres dazu steht unter WILDCARDS.
  51. Durch einen Klick auf 'Start' oder einen Druck auf die 'Return'-Taste wird
  52. die Suche begonnen. Die ersten sechs gefundenen Dateien werden direkt angezeigt,
  53. sobald sie gefunden wurden. Das Suchen können Sie durch das Drücken der
  54. 'ESC'-Taste jederzeit abbrechen (die Reaktion kann ein kleines bißchen dauern).
  55. Über den seitlichen Scrollbalken können Sie in der Liste beliebig vorwärts
  56. und rückwärts blättern. Die Dateien werden unsortiert angezeigt, also in
  57. der Reihenfolge, in der Sie gefunden wurden.
  58.  
  59. Wenn Sie auf einen Eintrag in der Liste klicken, erscheint normalerweise ein
  60. Dialog mit Informationen über das angeklickte File. Wenn Sie jedoch gerade in
  61. GEMINI sind, erscheint stattdessen ein Popup-Menu, in dem Sie drei Möglich-
  62. keiten zur Auswahl haben:
  63.    1) Info:    Es erscheint der Informations-Dialog
  64.    2) Fenster: Es wird an GEMINI der Befehl gesendet, das Fenster mit dem
  65.                Pfad der Datei und der gewählten Auswahlmaske zu öffnen.
  66.    3) öffnen:  Es wird an GEMINI der Befehl gesendet, die Datei zu öffnen.
  67.                Falls die Datei in GEMINI als ausführbare Datei angemeldet ist,
  68.                wird versucht, die Datei auszuführen, ansonsten wird die Datei
  69.                angezeigt.
  70.    
  71.    Anm.: Bei Auswahl der Punkte 2) und 3) wird JetFind beendet, da es ja
  72.          nicht in einem Fenster läuft (später vielleicht).
  73.  
  74. Dadurch können Sie auch über JetFind Programme starten oder Dateien ansehen.
  75.  
  76. Die übrigen Buttons:
  77.  
  78. Driveselect:
  79. Es erscheint ein Dialog, in dem Sie die Laufwerke aussuchen können, auf
  80. denen JetFind nach Dateien suchen soll. Beim Start sucht JetFind immer
  81. nur auf dem Default-Laufwerk. Mit dem Knopf 'All' werden alle Festplatten-
  82. laufwerke auf einmal (alles größer und gleich C:) angewählt, mit dem
  83. Knopf 'None' werden alle gewählten Laufwerke deselektiert.
  84.  
  85. Clipbrd:
  86. Bei einem Klick auf diesen Knopf erscheint ein Popup-Menu, in dem
  87. Sie die Listausgabe auf das Clipboard kontrollieren können.
  88. Mit 'Liste ausgeben' wird die aktuelle File-Liste als Scrap.TXT im
  89. sogenannten 'Clipboard' gespeichert. Falls kein Clipboard-Verzeichnis
  90. existiert, wird eines angelegt.
  91. Mit 'Liste anhängen' wird ebenfalls die aktuelle File-Liste
  92. ausgegeben, nur wird diese an die Datei SCRAP.TXT im Clipboard-Verzeichnis
  93. angehängt. Falls eine solche nicht existiert, wird eine neue angelegt.
  94. Über 'Ausgabeformat' können Sie festlegen, wie die Zeilen in der Datei
  95. SCRAP.TXT aussehen sollen. Es wird immer ein Beispiel angezeigt, wie die
  96. Ausgabe aussehen wird. Sie können dort als Ausgabeelemente den Namen, den Pfad,
  97. das Datum und die Uhrzeit der letzten Änderung sowie die Dateigröße ausgeben
  98. lassen. Außerdem können Sie auch noch festlegen, ob der Pfad vor dem
  99. Dateinamen ausgegeben werden soll oder hinter dem Dateinamen (Hallo, Andreas!).
  100.  
  101. Info:
  102. Es erscheint ein Dialog mit Informationen über JetStream, ShareWare und
  103. eine sehr wichtige Kontonummer.
  104.       
  105. Quit: JetFind wird beendet, was soll da denn sonst kommen.
  106.  
  107. Löschen:
  108. Durch diesen Knopf können Sie ALLE gefundenen Dateien von JetFind löschen
  109. lassen. Vorher kommt noch eine Sicherheitsabfrage, ob Sie wirklich alle
  110. gefundenen Dateien löschen wollen. Wenn das Löschen einmal gestartet wurde,
  111. läßt es sich nicht mehr abbrechen. Seien sie also vorsichtig damit, wenn Sie
  112. diesen Knopf benutzen. Für verlorengegange Quelltexte oder sonstige Daten
  113. kann ich natürlich keine Haftung übernehmen! Eingebaut habe ich das auch
  114. nur, weil mehrere Personen das gewünscht haben.
  115.  
  116.  
  117. EX-TIP
  118. ======
  119. Hier stand einmal die Empfehlung, JetFind mit dem Accessory 'The Chameleon'
  120. von Karsten Isakovic zu benutzen. Da es jedoch in der Zusammenarbeit von
  121. JetFind, The Chameleon und GEMINI Probleme gibt (die leider am Chameleon
  122. liegen), kann ich das im Moment nicht mehr empfehlen. Ich hoffe aber, daß
  123. in einer zukünftigen Version vom Chameleon diese Probleme beseitigt sind.
  124.  
  125.  
  126. WILDCARDS
  127. =========
  128.  
  129. Kommen wir nun zu den Wildcards, die in JetFind ab der Version 1.25 neu
  130. implementiert wurden. Die Auswertung der Wildcards erfolgt nun genauso wie
  131. in GEMINI, was ja auch kein Wunder ist, da es die gleiche Routine ist (Danke,
  132. Gereon). Folgende Regeln gelten: '*' steht für beliebig viele, beliebige Z
  133. Zeichen, ein '?' steht für ein beliebiges Zeichen. Im Gegensatz zum GEMDOS
  134. findet man alle Dateien über die Eingabe von '*', mit '*.*' werden nur noch
  135. die Dateien gefunden, die auch eine Extension haben. Weiterhin kann man auch
  136. Bereiche von Zeichen definieren, so z.B. [AFH], das steht dann für eines der
  137. Zeichen in den eckigen Klammern. Man kann auch direkt schreiben [A-H] anstelle
  138. alle Zeichen aufzuführen. Durch Angabe eines '^' direkt hinter der ersten
  139. eckigen Klammer wird der Ausdruck in den Klammern negiert, also [^A-F] steht für
  140. alle Zeichen außer 'A' bis 'F'.
  141. So, mehr kann ich dazu auch nicht erklären, am besten ist es, das einfach mal
  142. auszuprobieren.
  143.  
  144.  
  145. SONSTIGES
  146. =========
  147.  
  148. JetFind ist Shareware. Dies heißt, sie können JetFind ausgiebig testen, wenn
  149. es Ihnen jedoch gefällt und Sie JetFind regelmäßig benutzen, müssen Sie den
  150. Shareware-Beitrag von DM 20,-- bezahlen. Wer will, kann natürlich auch mehr
  151. bezahlen, worüber ich mich natürlich besonders freuen würde. Wohlgemerkt,
  152. 3 Zeilen weiter oben steht MÜSSEN. Falls Sie JetFind regelmäßig benutzen
  153. und nicht bezahlen, arbeiten Sie mit einer Raubkopie!
  154.  
  155. Dieses Geld überweisen Sie am besten auf folgendes Konto:
  156.  
  157.     Kreissparkasse Siegburg, BLZ 386 500 00, Konto-Nummer 104020516
  158.     
  159. Geben Sie auch bitte Ihren Namen im Verwendungszweck an, damit ich die
  160. Überweisung auch zuordnen kann.
  161.     
  162. Und noch ein Hinweis: Inzwischen stecken in JetFind auch schon recht viele
  163. Stunden Arbeit, die mir sonst keiner bezahlt. Und ich rechne auch nicht damit,
  164. jemals irgendwie diese Stunden voll bezahlt zu bekommen. Aber ich freue mich
  165. über jede Anerkennung in Form des Shareware-Beitrages.
  166.  
  167. Sie können JetFind zusammen mit allen dazugehörigen Dateien weitergeben, auch
  168. über Mailbox-Systeme. Die Verbreitung über PD-Vertriebe oder ähnliche
  169. kommerzielle Betriebe ist untersagt. Ebenfalls untersagt ist die Weitergabe
  170. von JetFind mit kommerziellen Produkten. Falls Sie dieses machen wollen, setzen
  171. Sie sich doch am besten mit mir in Verbindung, sicher läßt sich dann eine
  172. Vereinbarung aushandeln.
  173.  
  174. Meine Adresse:      Dirk Steins
  175.                     Auf dem Feldchen 48
  176.                     5216 Niederkassel-6
  177.                     DFÜ: über die Maus Bonn (0228/213230) oder als
  178.                     Dirk Steins @ BN über jede andere Box im Mausnet
  179.                     Dirk Steins % MAUS BN @ Fido 2:242/2 über Fido
  180.                     Dirk_Steins@bn.maus.de
  181.  
  182. Auch wenn Sie noch Verbesserungsvorschläge haben, können Sie diesen an diese
  183. Adresse schicken (am liebsten E-Mail!). Falls Ihnen also noch ein Feature
  184. einfällt, das Sie gerne in JetFind sehen würden, schreiben Sie es mir, ich
  185. werde sehen, was ich tun kann!
  186.  
  187. JetFind wurde komplett mit dem Megamax Modula-2 Entwicklungssystem von
  188. Application Systems Heidelberg entwickelt.
  189. Die MagicDials sind von Peter Hellinger.
  190.  
  191. Ich kann keine Haftung für irgendwelche direkten oder indirekten Schäden -
  192. einschliesslich aber nicht beschränkt auf materielle oder finanzielle -
  193. übernehmen, die durch die Benutzung von JetFind oder die Untauglichkeit
  194. von JetFind für einen bestimmten Zweck entstehen.
  195.  
  196.  
  197. DANKSAGUNG
  198. ==========
  199.  
  200. Ich danke hier an erster Stelle den 6 Leuten, die bisher den Shareware-Beitrag
  201. gezahlt haben. Ich würde mich freuen, wenn möglichst viele diesen nacheifern
  202. würden.
  203. Dann danke ich noch Peter Hellinger für die MagicLibrary, Thomas Tempelmann
  204. und Manuel Chakravarty für die schöne Entwicklungsumgebung, allen Leuten,
  205. die Verbesserungsvorschläge gemacht haben und letztendlich auch noch Atari
  206. für die Entwicklung des ST's.
  207.  
  208.  
  209. THE FUTURE
  210. ==========
  211.  
  212. Je nachdem, wie hoch die Zahlungsmoral der Leute noch wird, baue ich auch noch
  213. ein paar Verbesserungen ein. Ich denke im Moment an weitere Optionen bei der
  214. Listenausgabe auf das Clipboard (variableres Format), eventuell werfe ich auch
  215. die ganze Listenausgabe in ein Fenster, so daß man unter GEMINI immer zwischen
  216. den Fenstern umschalten kann und nicht neu suchen muß.
  217. Vielleicht baue ich auch noch das Abspeichern der Parameter ein, das ist im
  218. Moment auch noch nicht drin.
  219. Außerdem stört mich im Moment die Größe von JetFind doch erheblich, ich wollte
  220. eigentlich ein kleines Programm schreiben. Eventuell werde ich dann halt Teile
  221. davon in Assembler neu programmieren, so daß das ganze dann hoffentlich ein
  222. paar kB kleiner wird.
  223.  
  224.  
  225. CHANGES
  226. =======
  227.  
  228. 1.0     Erste öffentliche Version
  229.  
  230. 1.01    Directorys haben jetzt einen '\' am Ende des Dateinamens.
  231.         JetFind sollte jetzt auch ohne Probleme mit 'The Chameleon' laufen.
  232.         Der Mauszeiger sollte auch nicht mehr verschwinden und auch beim
  233.         Scrollen in verschiedenen OverScan-Auflösungen sollte kein Pixelmüll
  234.         mehr erscheinen.
  235.  
  236. 1.1     Zusätzlich Ausgabe der erstellten Liste auf das Clipboard.
  237.         Jetzt wird auch auf Platten mit 12 Bit FAT's gesucht (und das natürlich
  238.         immer noch ultraschnell), kein Absturz mehr dabei.
  239.         Bei Devices, die keinen vernünftigen Biosparameterblock liefern,
  240.         wird jetzt über das GEMDOS gesucht. Damit müßten auch Devices
  241.         wie DOS-Partitionen und CD-ROM's ansprechbar und durchsuchbar
  242.         sein.
  243.  
  244. 1.2 ß   Redesign der Oberfläche, da das ganze zu unübersichtlich war.
  245.         Jetzt mehr Dialogboxen. Zusätzlich die MagicDials implementiert,
  246.         d.h. alle Dialoge sind jetzt tastenbedienbar. Außerdem wurde noch
  247.         die Zusammenarbeit mit GEMINI eingebaut. Als Folge daraus unter-
  248.         stützt JetFind jetzt auch das xAcc-Protokoll der Stufe 0.
  249.         Das Löschen der gefundenen Dateien wurde auch noch eingebaut.
  250.         Fehler bei Speicherüberlauf behoben.
  251.  
  252. 1.25 ß  Neue Wildcard-Routine, jetzt werden Wildcards, wie sie in GEMINI
  253.         verwendet werden, zum Suchen benutzt. Die Auswahl der Laufwerke ist
  254.         jetzt auch Tastaturbedienbar, dafür wurden 'All' und 'None' umbenannt.
  255.         Wer dafür etwas bessere Bezeichnungen als 'Every' und 'Clear' hat,
  256.         möchte sich doch bitte bei mir melden.
  257.         Die Speicherverwaltung wurde komplett umgestellt und ist jetzt auch
  258.         noch als Nebeneffekt teilweise deutlich schneller geworden.
  259.         
  260. 1.3     Dialogboxen optisch besser gestaltet, Anzeige des Laufwerks, auf dem
  261.         gerade gesucht wird, eingebaut und noch einen Fehler bei zu wenig
  262.         Speicher am Start behoben.
  263.  
  264. 1.31    Huch, wie peinlich. JetFind installierte sich nicht immer in der
  265.         Menuzeile bei normalen ST's. Das sollte jetzt aber immer klappen,
  266.         ansonsten bitte bei mir melden. Die Popups kann man jetzt auch
  267.         durch einen Klick mit der linken Taste außerhalb des Popups verlassen.
  268.         
  269. 1.32    Jetzt wird vor jedem ersten Zugriff auf ein Laufwerk doch noch ein
  270.         SearchFirst gemacht, damit kein Medienwechsel dem GEMDOS verlorengeht.
  271.  
  272. 1.33    Suchen kann jetzt durch Drücken der ESC-Taste abgebrochen werden.
  273.         Die ersten 6 gefundenen Dateien werden direkt angezeigt.
  274.         Außerdem wurde testweise ein Test entfernt, so daß hoffentlich der
  275.         Michael Heng jetzt auch alle seine Dateien findet.