******************************* * * * Text aus der Serie * * (c) GERMAN (Copyright) * * RHEIN-MAIN-SOFT * * Oberursel * * * ******************************* **************************************************************************** **************************************************************************** Aquarium (c) by B Lennart Olsson 1989 - Alle Rechte vorbehalten NewFish (c) by B Lennart Olsson 1988 - Alle Rechte vorbehalten **************************************************************************** **************************************************************************** Aquarium und Newfish dürfen ohne weitere Genehmigung kopiert und vertrieben werden, soweit für sie keine Benutzungsgebühr erhoben und diese Information mitgeliefert wird. Speziellen Dank an Niclas Persson, der oft eine Hilfe war. **************************************************************************** 0.Inhalt -------- 1. Einleitung 2. Installation 3. Suchmethoden 4. Such- und Programmier-Modus 5. Navigations-Felder 6. Project-Menue 7. Hardcopy-Menue 8. Break-Feld 9. Suchbegriffs-Philosophie 10. Dateien im Data-Verzeichnis 11. Zukünftige Ausgaben von Aquarium 12. Die Benutzung von NewFish 13. Anmerkungen zu den Versionen 1.Intro ------- Aquarium ist ein Programm, das eine spezielle Datenbank, welche die "Contents" (Inhaltsverzeichnis-)Dateien der Fred Fish AmigaLibDisks beinhaltet, nach Programmen mit zu spezifizierenden Merkmalen durchsucht. NewFish ist ein Programm, das die Contents-Dateien neuer Fred Fish Disketten in die Datenbank aufnimmt. --- WARNUNG! Lies diese Dokumentation, bevor Du versuchst, dieses Programm zu starten. Es könnte die ganze Datenbank unbenutzbar machen wenn es nicht mit Vorsicht angewand wird. Der nächste Update wird dieses Problem beseitigen. 2.Installation -------------- Hier gibt es nichts Spezielles zu sagen. Sei nur sicher, daß Aquarium und das Datenverzeichnis sich auf derselben Verzeichnisebene befinden. Falls vom CLI aus gestartet wird, müssen beide im selben Verzeichnis stehen. Siehe auch 10. über die Dateien in Data. 3.Such-Methoden --------------- Das Programm durchsucht die Datenbank auf drei Arten: -Suchbegriffe -Schlagworte oder -silben im Programmnamen -Schlagworte oder -silben im Beschreibungstext. a) Alle ausgewählten Suchbegriffe müssen für das untersuchte Programm definiert sein, sonst geht Aquarium zum nächsten über. b) Falls die Suchbegriffe alle zutreffen, sucht das Programm nach dem Schlagwort im Namem (nicht zwingend). Schlägt die Suche fehl, geht Aquarium zum nächsten Programm über. c) Das Schlagwort im "text"-Feld wird nach dem unter b) beschriebenen Verfahren im Begleittext gesucht. Eine spezielle Möglichkeit gibt es für das "Name"-Feld: Man kann jede Fish -Diskette direkt anwählen, indem man die Diskettennummer nach einem "/" eingibt. Beispiel: "/150" geht zur Fish-Disk 150. (Nicht gerade schön, aber es funktioniert.) Beachte, daß solange du dich im Programmier-Modus befindest, keine Such- operationen durchgeführt werden. 4. Such- und Programmier-Modus --------------------------- Im Such-Modus können die Suchbegriffe durch anklicken der entsprechenden Felder eingegeben werden. Die Suche wird durch den Druck auf ein Navi- gationsfeld gestartet. Im Programmier-Modus wird durch das Anklicken der Suchbegriffs-Felder direkt der Inhalt der Datenbank verändert. Programmier-Modus wird durch einen roten Bildschirm und ein verändertes Erscheinungsbild des Modus-Feldes angezeigt. 5.Navigations-Felder -------------------- Doppelpfeil links: Mit diesem Feld wird direkt zum Anfang der Datenbank gegangen. Linker und rechter Pfeil: Mit diesen Feldern wird die Datenbank Richtung Anfang oder Ende nach den Suchbegriffen etc. durchsucht. Im Programmier-Modus wird jeweils nur ein Schritt in die jeweilige Richtung durchgeführt. Drucker: Es wird eine Hardcopy des angezeigten Programmses mit den im Hardcopy-Menue festgelegten Einstellungen ausgedruckt. Rechtes Feld mit offenem Schloß: Durchsucht die Datenbank nach dem nächsten Programm, für das keine Suchbegriffe spezifiziert sind. Modus-Feld: Schaltet zwischen Such- und Programmier-Modus um. Im Programmier-Modus ist der Bildschirm rot, im Such-Modus grün-blau. 6.Project-Menue ------------- About: Über Aquarium und mich. Save: Abspeichern der Änderungen auf Diskette. Save & Quit: Abspeichern etwaiger Änderungen und beenden des Programmes. 7.Hardcopy-Menue ---------------- Optionen: Include text: Der Beschreibungstext wird immer mit ausgedruckt. Sorted list: Normalerwiese, wenn ein Listing über den Drucker läuft, wird jedes passende Programm sofort ausgedruckt. Wird dies Option angewählt, werden sie erst in einen Pufferspeicher geschrieben, am Ende der Datei sortiert und anschließend ausgedruckt. Formfeeds: Falls diese Option angewählt wurde, wird jedesmal ein Seitenvorschub an den Drucker übermittelet, sobald eine neue Seite beginnt. Ansonsten werden Zeilenvorschübe nach den Einstellungen in den Preferences über- sand. Count them: Durchsucht die Datenbank nach mit den Suchbegriffen übereinstimmenden Programmen , zählt sie, und druckt das Ergebnis schließlich im Textfenster an. New Page: Fängt eine neue Seite an. Print: Durchsucht die Datenbank und druckt die zutreffenden Programme aus. 8.Break-Feld ------------ Bei zeitraubenden Aktionen, wie dem suchen eines Schlagwortes im Text, erscheint im Textfenster ein Feld. Durch Anklicken in der Nähe dieses Feldes wird der Suchvorgang abgebrochen. 9.Suchbegriffs-Philosophie -------------------------- Wir haben versucht, die Suchbegriffe selbsterklärend zu machen, sowie die Zuordnungen logisch und konsequent, aber es gibt ein paar Sachen die Dir beim Verständnis der Philosopie, die dahintersteckt, helfen können: a) IFF-Bilder und ähnliches - Data & Graphics b) Sound Dateien - Data & Sound c) Fonts - Data, Text-processing & Graphics d) Unter Subroutines fallen librairies und generell alle nützlichen Routinen. Es gibt einige nichtbelegte Suchbegriffe, die man für eigene Einteilungen verwenden kann. Es müssen nur die entsprechenden Namen in die Datei "Keynames" im Daten-Verzeichnis eingetragen werden. 10.Dateien im Daten-Verzeichnis ------------------------------- Das Daten-Verzeichnis muß sich im selben Verzeichnis befinden wie Aquarium. Falls vom CLI aus gestartet wird, muß dieses Verzeichnis als das aktuelle Verzeichnis markiert werden. Es müssen keine Zuweisungen erfolgen. Data: Diese Datei enthält die Beschreibungen der Programme. Index: Enthält die Suchbegriffe und die Zuordnungen zur Data-Datei. Names: Enthält die einzelnen Programmnamen. KeyNames: Enthält die Begriffe, die in den Suchbegriffsfelder erscheinen. 11.Zukünftige Ausgaben von Aquarium ----------------------------------- Falls Ihr irgendwelche Vorschläge oder Gedanken zu diesem Programm habt, laßt es mich wissen. 12.Die Benutzung von NewFish ---------------------------- NewFish ist ein Programm, welches die "Contents"-Dateien der Fish-Disketten liest und in die Aquarium-Datenbank aufnimmt. WARNUNG: Du mußt unbedingt eine Kopie der Datenbank machen, bevor Du NewFish startest!! Dieses Programm ist nicht sehr intelligent, und falls es Fehler beim Einlesen der "Contents"-Dateien macht, und Du diese Fehler Akzepierst, gibt es keinen Weg, diese falschen Eintragungen wieder aus der Datenbank zu entfernen. Das Programm liest die "contents"-Datei und versucht, die verschiedenen Programme vom Text zu trennen. Für jedes Programm wird eine Abfrage ausgegeben, ob es so übernommen werden soll. Bei Zustimmung wird es direkt auf die Diskette geschrieben. Ein Problem tritt eventuell dann auf, wenn nicht der ganze Inhalt einer Diskette richtig eingelesen wird und das Programm daraufhin vom Benutzer abgebrochen wird. Dieses läßt dann eine nicht komplette Diskette im Data -Verzeichnis zurück. Um diese Situation zu bereinigen, muß die Version der "Contents"-Datei dahingehend editiert werden, daß die schon eingelesenen Programme gelöscht werden und die Datei neu eingelesen wird. Eine Datei ohne trennbare Programme wird als ein Programm eingelesen und wird Diskxxx gennant. Mache eine Hardcopy aller "Contents"-Dateien bevor Du versuchst, sie einzulesen. Prüfe sorgfältig, ob die folgenden Bedingungen erfüllt sind: a) Eine "Contents"-Datei mit verschiedenen Programmen darf einen mehrzeiligen Kommentar am Anfang haben, wenn alle Zeilen in der ersten Reihe anfangen. b) Die Programme müssen durch eine Leerzeile von einander getrennt sein. c) Die erste Zeile eines Programmes muß in der ersten Reihe anfangen, die folgenden müssen mit einem Tabulator- oder Leerzeichen beginnen. d) Eine "Contents"-Datei, die als nur ein Programm eingelesen werden soll, darf keine Leerzeichen am Zeilenanfang enthalten, wenn es korrekt inter- pretiert werden soll. Du kannst vorab versuchen, diese Datei mit NewFish einzulesen, um zu sehen ob es geht. Du wirst darüber informiert, ob das Programm als ein Gegenstand behandelt wird, oder nicht. Brich einfach ab, wenn es in mehrere Teile aufgegliedert wird. Irgendwie werde ich dieses Programm noch einfacher zu bedienen machen. Es ist einfach zu blöd wie es jetzt ist. 13.Anmerkungen zu den Versionen ------------------------------- Aquarium 1.11: Änderungen, die, durch die Verbindung zu einer speziellen Textdatei das Kompilieren für andere Sprache einfacher machen, Dies gilt auch für die Namen von Dateien. Das Programm benutzt die Namen die in der Textdatei festgelegt sind, wenn das nicht geht, die voreingestellten schwedischen Namen und danach die englischen Namen. Das Zentrieren der Suchbegriffe auf den Feldern funktionierte nicht, wenn die Zeile in der KeyName-Datei direkt nach dem Namen endete. Jetzt geht es. "Save" hatte das Programm veranlaßt, wieder neu am Anfang der Datenbank anzusetzen. Geändert. Die Diskettennummer-Option im Name-Feld funktierte nicht immer. Der Fehler ist jetzt behoben. Aquarium 1.12: Eine kleine interne Verbesserung. ------------------------------------------------------------------------------ Das wär´s. Falls du irgendwelche Vorschläge oder Gedanken zu diesem Programm hast, zögere nicht mich zu kontaktieren. B Lennart Olsson Brunnsgatan 8 223 60 LUND Schweden ############################################################################ ******************************* * * * Text aus der Serie * * (c) GERMAN (Copyright) * * RHEIN-MAIN-SOFT * * Oberursel * * * *******************************