*********************************************************** TREE-DOKUMENTATION VERSION 1.0 von A. Zierdt und V. Brauckhoff (c) Januar 1991 by Seneca Soft SHAREWARE *********************************************************** 1. DAS PROGRAMM Das Programm TREE endstand aus der Vorstellung heraus, die Parameter, die beim Abspeichern eines Files angelegt werden, zu nutzen. Dies sind : - Kommentar - Datum - Zeit - Größe - Protectionflags Der hauptsächliche Unterschied zu anderen Programmen dieser Art liegt darin, das die oben angesprochenen Parameter permanent angezeigt und verändert werden können. Hierdurch läßt sich z.B. das durchsehen von Directories durch vorheriges versehen mit Kommentaren oder das beeinflussen der Flags durch übersichtliche Anzeige wesentlich verein- fachen. Festplattenbesitzer können die Übersichtlichkeit auf ihrer Platte steigern. Weiter Features sind unter anderem : -Eine umfangreiche eigenständige Fehlerbehandlung -Erkennen und umschalten zwischen NTSC und PAL -Belegen der F-Tasten mit Pfadnamen -Abspeichern dieser 10 Pfadnamen in einer externen Datei -------------------------------------------------------------------------- 2. GRUNDLEGENDER AUFBAU In der Titelleiste wird die aktuelle Fehlernummer ausgegeben, steht dort eine 0, so ist bei der aktuellen Operation kein Fehler aufgetreten (siehe auch FEHLER bzw. letz. Fehler unter DIE MENUPUNKTE). Direkt darunter ist die Statuszeile, hier wird angegeben wieviel Bytes auf dem aktuellen Device noch frei sind und ob es schreibgeschützt ist oder nicht. Ist das Copy- bzw. Movefenster geöfnet, so beziehen sich die Angaben auf das dort gewählte Device. Darunter befindet sich der Ausgabebereich. Klicken auf einen Filenamen führt im Normalfall zu dessen Selektion. Klicken in der rechten Hälfte führt dazu, das: a) wenn der Menupunkt "Protect Date Size" aktiv ist, ein Requester geöfnet wird in dem die folgenden Protectionflags gesetzt werden können: löschen (delete) -> File gegen löschen schützen starten (execute) -> File als ausführbar kennzeichnen schreiben (write) -> File gegen schreiben schützen lesen (read) -> File gegen lesen schützen resident -> File als resident machbar kennzeichnen batch (pure) -> File als Batchdatei kennzeichnen. Das File wird nun unter Kickkstart 1.3 als Batchfile erkannt und auch ohne vorstehendes execute ausgeführt listen (hide) -> File wird bei Dir oder List nicht angezeigt Unter KICKSTART 1.3 werden nur die Flags delete und pure unterstüzt, allerdings gibt einige Programme, die auch andere Flags nutzen (, dies Programm unterstüzt z.B. das h(ide)-Flag). Das a(rchiv)-Flag wird hier nur angezeigt und läßt sich nicht ändern, da es nur dazu dient um darüber Auskunft zu erteilen,ob das File z.B. durch ein Backup gesichert worden ist. b) wenn der Menupunkt "Comment" aktiv ist, wird ein Requester geöfnet, in dem ein neuer Kommentar eingegeben, bzw. ein schon Exestierender geändert werden kann. -------------------------------------------------------------------------- 3. DIE MENUPUNKTE 3.1 Das Programmenu Info ... ==> liefert einen InfoRequester mit allgemeinen Angaben. F-Help ==> liefert einen Requester der über die momentane Belegung der zehn F-Tasten Auskunft gibt. Schirm Hinten ==> bringt den Schirm hinter alle anderen. Quit ==> beendet das Programm. 3.2 Das Optionenmenu Anzeige --> Protect Date Size - Anzeige der Protectionflags, des Erstellungsdatums und der Größe des Files - bei Dierectories erscheint bei der Größe das Wort 'dir'. --> Comment - anzeige des zu diesem File existierenden Kommentars. INFO ==> Umschalter(voreingestellt ON) - ist hier ON eingestelt, so werden beim Copy bzw. beim Move auch die Protectionflags und der Kommentar für das File mitkopiert. FLAGS ==> Umschalter(voreingestellt ON) - im ON- Modus werden die Protectionflags beachtet, im OFF-Modus ist es z.B. egal ob das delete-Flag gesetzt ist oder nicht, das File wird auf jeden Fall gelöscht, außer bei einer Operation über mehrere Directories. FEHLER ==> Umschalter(voreingestellt ON) - ist hier ON gesetzt wird nicht nur in der Titelleiste die Fehlernummer gezeigt, sondern auch ein Requester geöfnet, der eine Fehlermeldung ausgibt. Weiterhin kann man in diesem Requester bei manchen Fehlern entscheiden, ob der laufende Vorgang abgebrochen oder fortgesetzt werden soll(z. B. bei Mehrfachselektion). SELECT ==> Umschalter(voreingestellt OFF) - Im OFF- Modus wird die für einen Vorgang gemacht Selektion wieder rück gängig gemacht, andernfals bleibt diese erhalten. Sichern ==> Sichert die aktuell F-Tastenbelegung in das aktuelle 'S:' Directory. Laden ==> Lädt die F-Tastenbelgung aus dem aktuellen 'S:' Dir. In beiden Fällen wird das Datenfile 'tree.dat' im 'S:' Directory erwartet! 3.3 Das Spezialmenu Show Picture ==> Zeigt alle selektierten IFF-Bilder. Drucken ==> gibt einen belibigen Text auf dem Drucker aus. Es wird ein Requester geöfnet ,in dem der Name und die Größe des Files angezeigt wird und die gewünschte Schriftart zum Drucken gewählt werden kann. Während des Druckvorgangs, kann mit dem Programm weitergearbeitet werden, es kann allerdings nicht verlassen werden. Sound ==> spielt alle selektierten Sounds ab. (Format IFF-8SVX) letz. Fehler ==> zeigt den letzten aufgetretenen Fehler per Requester an, auch dann wenn im Optionenmenu FEHLER auf OFF gesetzt ist. -------------------------------------------------------------------------- 4. DIE GADGETS 4.1 Funktionen All ==> Alle Files werden Selektiert. Clear ==> Alle Selektionen werden rückgängig gemacht. F-Taste ==> Es wird ein Requester geöfnet in dem gewählt werden kann, welche F-Taste mit dem aktuellen Pfad belegt werden soll. Type ==> Alle selektierten Files werden angezeigt, dabei wird untersucht,ob das selektierte File ein ASCII-File ist, dann erfolgt eine Textausgabe, ansonsten erfolgt die Ausgabe als Hex-Dump. Unset ==> Ist ein Pfad mit der SET-Funktion gesetzt, die Copy und Move zur Verfügung stellen (Gadget leuchtet rot), so läßt sich dies hier wieder rückgängig machen. Stop ==> Läuft gerade ein Druckprozess, so kann hier ein Stopkommando zum Drucker gesendet werden. ACHTUNG! Es wird nur die Übermittlung zum Drucker gestoppt, der Druckerbuffer läßt sich meist nur durch Ausschalten desselbigen leeren. MakeDir ==> Es erscheint ein Requester,in dem der Name eines neuen Dierectories angegeben werden kann. Delete ==> Löschen aller selektierten Files. Move ==> siehe Copy. Copy ==> Es wird ein Fenster geöfnet, in dem das Zieldirectory ausgewählt werden muß, (nur einmal anklicken!). Hier werden nur die Dierectories des angewählten Devices aufgelistet, ist kein weiters Dierectory vorhanden, so wird einen entsprechende Meldung in der Fenstertitelleiste ausgegeben. Wird das SET-Gadget angeklickt, so verfärbt sich das oben schon erwähnte UnSet-Gadget rot und der momentan gewählte Pfad bleibt solange als aktueller gesetzt, bis er durch Anwahl von UnSet rückgängig gemacht wird. Dies erleichter das Kopieren von mehreren Quelldierectories in ein Zieldierectory ohne das der Pfad jedesmal neu gewählt werden muß. Ist das Move-Gadget angewählt, wird das File nach dem kopieren gleich gelöscht, ansonsten besteht keine Änderung gegenüber dem Copy-Befehl. Rename ==> (Umschalter) Wird dieses Gadget angeklickt, so wird bei jedem Klick auf ein File ein Requester geöfnet in dem der momentane Name des Files erscheint und nun geändert werden kann. ProtAll ==> Wird dieses Gadget gewählt so erscheint der selbe Requester wie unter GRUNDLEGENDER AUFBAU beschrieben, in dem die Protection- Flags gesetzt werden können. Im Unterschied dazu können hier aber mehrere Files selektiert werden, die nach anklicken des OK-Gadgets, die in dem Requester gewählte Einstellung gesetzt bekommen. Dabei solte man bedenken, das eventuell vorher vorkennommene Einstellungen der Flags hier nicht beachtet werden. 4.2 Anmerkung Im PAL-Modus stehen nur 200 Zeilen in der Höhe zur Verfügung, daher ist dort alles ein bischen gedränkter geraten. Wir wolten dabei auf möglichst wenig verzichten, mußten aber trotzdem zwei Gadgets weglassen. Dies sind das Stop- und das ProtAllgadget, die zwar die Arbeit mit dem Programm vereinfachen, aber ohne diese beiden wird auch die volle Leistung erzielt. -------------------------------------------------------------------------- 5. TASTATURBELEGUNG 5.1 Die F-Tasten Durch Drücken einer F-Taste wird ein in einem Buffer abgelegter Pfadname als aktueller Pfad eingesetzt und das Dierectory wird eingelesen. Dies funktioniert auch im Copy- bzw. Movefenster, sodas ein kopieren durch Pfadfestlegung schnell möglich ist. 5.2 Spezielle Tasten Beim Type-Befehl läßt sich durch drücken der "h"-Taste zwischen dem Text-, und dem Hex-Modus umschalten. VORSICHT! Bei Programmen die im Hex- Modus angezeigt werden, führt das drücken der "h"-Taste zum selben Ärger, wie beim type im CLI. Durch drücken der "f"-Taste kann im Textmodus nach einem String gesucht werden. Wird der eingegebene String gsfunden, so wird die erste Seite ausgegeben auf der der String vorkommt. Der Suchpuffer behält den String so lange, bis ein neuer eingegeben wird. Dadurch kann man durch mehrmaliges Drücken bequem mehrmals nach dem selben String suchen. Wird die ESC-Taste gedrückt wird der Type-Befehl beendet. -------------------------------------------------------------------------- 6. ALLGEMEINE ANMERKUNGEN Mit dem Programm TREE lassen sich einfach weitreichenden Änderungen an Dateien durchführen, dies führt aber auch dazu das man einiges bedenken solte. Benutzt man das h(ide)-Flag um nicht alle Dateien angezeigt zu bekommen, so existieren diese Dateien nur auf der Anzeige nicht(, zumindest solange wie im Optionenmenu FLAGS auf ON gesetzt ist). Wird nun das All-Gadget betätigt um alle Files in einem Directory zu selektieren, werden auch die Files selektiert, die durch hide nicht zu sehen sind. Ein weiterer Punkt den man bedenken solte, ist das durch das setzen des d(elete)-Flags nicht nur vor löschen geschützt wird! Bei gesetztem Flag kann man ein Textfile zwar in einen Editor laden und dort bearbeiten, versucht man es aber nun wieder abzuspeichern, kommt es zu einer Fehlermeldung des Editors. Dies kommt dadurch, das der Editor beim abspeichern erst das alte File löscht und dann das bearbeitete wieder anlegt. Beim schützen von .info Dateien sieht es ähnlich aus. Ist solch eine Datei gegen löschen geschützt und man setzt das Icon auf der WB um, will man dies auch durch anwählen von Snapshot fixieren. Anstelle eines Diskettenzugriffs erscheint aber nur eine DOS-Fehlernummer in der Titelzeile des WB-Screens, was auf das gesetzte d-Flag zurückzuführen ist. Bedenkt man die angesprochenen Punkte dürfte es aber nicht zu Problemen kommen. ========================================================================== 7. FEHLERREFERENZEN Solten andere Fehler auftreten der im Programm nicht behandelt wird, kommt es zur Fehlermeldung NR.: 20 - interner Fehler. In diesem Fall oder wenn das Programm unter bestimmten Hardwarezusammensetzungen nicht laufen solte, würden wir uns freuen, wenn uns dies unter einer der untenstehenden Adressen mitgeteilt würde. Außerdem interessiert uns natürlich auch die Meinung zur Benutzer- führung, -oberfläche, etc. Die Ansprechadressen sind : Volkmar Brauckhoff Andreas Zierdt Vor dem Tore 15 Thiestraße 11 3414 Hardegsen 3406 Bovenden 1 ========================================================================== 8. SHAREWARE **************************************************************** * * * Dies Programm ist SHAREWARE, solte also nach eingehender * * Prüfung desselbigen, eine dauerhafte Benutzung vorliegen * * möchte wir darum bitten eine Sharegebühr von 10 DM an eine * * der oberen Adressen zu senden. Als registriert Benutzer * * wird man automatisch auf das nächste Update hingewiesen und * * erhält dies (nach zuschicken einer Disk und des Rückportos) * * Wir wünschen viel Spaß bei der Anwendung und hoffen das, * * das Progamm von nutzen ist. * * * * DIE AUTOREN * * * ****************************************************************