@database T.H.E. @$VER: THE.guide 1.2 (19.12.99) © by Nils Görs @node main "T.H.E. Handbuch" Workbench Hilfmittel-& Tastenbefehl-Voreinsteller @{" Was ist T.H.E.? " link Overview} @{" Copyright und Gewährleistung " link Copyright} @{" Systemvoraussetzungen " link Requirements} @{" Installation " link Installation} @{" bekannte Fehler " link knownErrors} @{" Nutzung " link usage} @{" Arexx Befehle " link arexx} @{" Dank " link thanks} @{" Entwicklung " link History 9999} @{" FAQ " link FAQ} Nils Görs Kaiserstr.97a 42329 Wuppertal Germany EMail: nils\@goers.line.org T.H.E. is MAILWARE and copyrighted © 1999 by Nils Görs. No commercial use without perimission of the author. Read the @{"copyright" link Copyright} ! @endnode @node Overview "Was ist T.H.E." T.H.E. ist ein Voreinsteller für zwei neue Funktionen die von der neuen workbench.library zur Verfügung gestellt werden. Hierbei handelt es sich zum einen um die Möglichkeit das Hilfsmittelmenü (Tools-Menu) zu gestalten und zum anderen Tastenbefehle (Hotkeys) zu erstellen. @endnode @node Requirements "Systemvoraussetzungen" Um T.H.E. nutzen zu können benötigen Sie: - OS3.5 `-> CD-ROM-Laufwerk Festplatte 68020 oder besserer Prozessor Amiga 3.1 ROMs 4 MB FastRAM-Speicher - AWNPipe 2.22 oder höher (liegt dem Archiv bei!) @endnode @node Installation Klicken Sie einfach auf das Installer-Piktogramm. @endnode @node knownErrors "known Bugs" Mir sind einige Fehler bekannt, die aber auf die ClassAction/ReAction Klassen zurückzuführen sind. Eine Funktion musste ich leider ganz entfernen, da diese unter gewissen Umständen zum Abstürz des Systems geführt hat. Nun zu den bekannten Fehlern, die nicht auf T.H.E. zurückzuführen sind: - Wählt man aus der Hilfsmittelmenü-Liste einen Eintrag, der auch einen Tastaturkurzbefehl besitzt, dann wird dieser Tastaturkurzbefehl nicht in das Texteingabefeld übernommen! * AWNPipe-Handler besitzt seit Version 2.22 einen "Workaround" um diesen Fehler zu beheben. Danke Bill! - Wird ein neuer Eintrag hinzugefügt, gibt es keine automatische Aktivierung des Texteingabefeldes (=> system-crash!) @endnode @node Copyright This License applies to the computer programs known as "T.H.E.". The "Program", below, refers to such program. The programs and files in this distribution are freely distributable under the restrictions stated below, but are also Copyright (c) Nils Görs. Distribution of the Program by a commercial organization without written permission from the author to any third party is prohibited if any payment is made in connection with such distribution, whether directly (as in payment for a copy of the Program) or indirectly (as in payment for some service related to the Program, or payment for some product or service that includes a copy of the Program "without charge"; these are only examples, and not an exhaustive enumeration of prohibited activities). However, the following methods of distribution involving payment shall not in and of themselves be a violation of this restriction: (i) Posting the Program on a public access information storage and retrieval service for which a fee is received for retrieving information (such as an on-line service), provided that the fee is not content-dependent (i.e., the fee would be the same for retrieving the same volume of information consisting of random data). (ii) Distributing the Program on a CD-ROM, provided that the files containing the Program are reproduced entirely and verbatim on such CD-ROM, and provided further that all information on such CD-ROM be redistributable for non-commercial purposes without charge. Everything in this distribution must be kept together, in original and unmodified form. THE PROGRAM IS PROVIDED TO YOU "AS IS," WITHOUT WARRANTY. THERE IS NO WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE ALL FILES CONTAINED IN THIS ARCHIVE. @endnode @node usage "Nutzung" Die Oberfläche -------------- Mit dem Reiter-Gadget können Sie auswählen welche Einstellungen verändert werden sollen. Sie können mittels [TAB] zwischen den beiden Listview-Fenstern hin- und herschalten. Im Listview-Fenster werden die Einträge des Hilfsmittelmenü (Tools-Menu) bzw. der Tastaturkurzbefehle (Hotkeys) angezeigt. Sie können mittels den Richtungstasten nach oben und nach unten die Einträge auswählen. Um den ersten Eintrag anzuspringen, drücken Sie bitte die [Home] Taste. Um das Ende der Liste zu erreichen drücken Sie bitte die [End] Taste. Hinzufügen - fügt einen neuen Eintrag zu den bisher vorhandenen hinzu. Sollten Sie einen Eintrag ausgewählt haben wird der neue Eintrag direkt darunter plaziert. Entfernen - entfernt den ausgewählten Eintrag aus der Liste. Duplizieren - von dem ausgewählten Eintrag wird ein weiterer, identischer, Eintrag erstellt. Rauf - den selektierten Eintrag um eine Position nach oben verschieben. Runter - den selektierten Eintrag um eine Position nach unten verschieben. Um eine Trennlinie für das Hilfsmittelmenü zu erstellen wählen Sie einen Namen ihrer Wahl, in dem Texteingabefeld "Titel" geben Sie bitte eines der folgenden Zeichen (ohne "") ein: "-", "~" oder "_". Es ist anzuraten im Verzeichnis- und Dateinamen keine Leerzeichen zu verwenden. Denn ich habe lediglich eine einfache Erkennung für die Trennung des Befehls und der Argumente, erstellt. Die Konfigurationsdatei ----------------------- T.H.E. erstellt ein ARexx-Skript, welches standardmäßig im WBStartup Verzeichnis gespeichert wird. Beim Hochfahren des Rechners wird nun dieses Skript ausgeführt wodurch die Tastaturkurzbefehle und/oder das Hilfsmittelmenü eingerichtet werden. @endnode @node arexx T.H.E. besitzt seit v1.1 einen ARexx-Host mit Namen "T.H.E.". Es werden zur Zeit folgende ARexx-Kommandos unterstützt: 1. UNICONFIFY Falls das T.H.E. Fenster ikonifiziert ist, wird es durch diesen Befehl wieder geöffnet. 2. ICONIFY Ikonifiziert das T.H.E. Fenster. 3. QUIT beendet T.H.E. @{b}ohne@{ub} Sicherheitsabfrage. 4. ACTIVATE aktiviert das T.H.E. Fenster. @endnode @node thanks "Danke" Mein Dank geht an: William Parker - für die Unterstützung und die Hilfe mit AWNPipe. Oliver Tacke - für die schnelle Erstellung der wirklich tollen Ikons. Kurt Berghaus - er hatte die Idee zur Lokalisierung, als er einen Snapshot mit englischer Oberfläche gesehen hat. @{"Ynot7" link /ynot7.jpg/MAIN} - für sehr gute thailändische Rock Musik die ich während der T.H.E. Entwicklung gehört habe ("rUang kii mah"). und an alle Übersetzer (nach Ländern alphabetisch sortiert): - Vit Sindlar - Jacob Laursen - Alfredo Soro - Hervé Dupont - Andrea Monni & Marco De Vitis - Guno Heitman - Mario Gonzalez - Alfredo Martins - Jari Komulainen @endnode @node FAQ "häufig gestellte Fragen" F: Wie kann ich ein externes (Shell) Programm ohne das Zusatzskript, startexe.rexx, starten? A: startexe.rexx habe ich erstellt um es dem Anwender einfacher zu machen. Sie können natürlich auf diese Erleichterung verzichten und Programme wie folgt einbinden. Löschen Sie bitte zuerst die Befehlzeile und tragen Sie unter Argumente folgendes ein: 'address command ''''' Beispiel: 'address command ''WBRun StackSnoop''' F: Wie sende ich einen ARexx-Befehl an einen anderen Port? A: Löschen Sie die Befehlzeile und geben Sie unter Argumente bitte folgendes ein: 'address ''hostname'' ' Beispiel: 'address ''ZPoint'' BOARDMENU' F: Wie kann ich den Workbench-ARexx-Port ansprechen? A: Das ist ganz einfach, Sie löschen die Befehlzeile und geben unter Argumente ein: '' Beispiel: 'MENU INVOKE WORKBENCH.ABOUT' F: Ist es möglich, z.B. den Befehl "fixieren - alles" aus dem Workbench-Menü "Fenster" mit einem Tastaturkürzel zu versehen? A: Nein, das ist nicht möglich. Die API der workbench.library läßt nur Veränderungen am Hilfmittelmenü zu. Sie können aber jede Funktion der Workbench auf einen Kurzbefehl legen oder zusätzlich im Hilfmittelmenü installieren, für obiges Beispiel würde der Befehl wie folgt lauten: 'options results; GETATTR OBJECT WINDOWS.ACTIVE; MENU WINDOW result INVOKE WINDOW.SNAPSHOT.ALL' @endnode @node History "Entwicklung" v0.1 - v0.10 : - interne Versionen - v1.0 : - erste öffentliche Version - v1.1 : - @{"Arexx-Port" link arexx} hinzugefügt. - Fehler beim Argumentparsing, der zum Abbruch des Skripts führen konnte, behoben. - Fehler beim Entfernen von Einträgen die Leerzeichen beeinhalt haben behoben. - Beim Hinzufügen von Einträgen wird der neue Eintrag nun unter dem Auswahlbalken plaziert. - Neues Button (Duplizieren) hinzugefügt. - Das Listenfenster läßt sich nun mittels Richtungstasten bedienen. - [TAB], [Home] und [End] Tasten werden nun unterstützt. - Das Verhalten der Buttons wurde verändert. - Die Oberfläche wird nun bei diversen Optionen blockiert. - verbessertes Argumentparsing. - kleinere Optimierungen. - Standardsprache wird nun intern verwaltet, THE.strings wird deshalb nicht mehr benötigt. - noch mehr vordefinierte Tastenbefehle (F-Tasten). v1.2 - Der Katalog wurde nicht geschlossen! (herve dupont) - Der Katalog wird nun auch in PROGDIR: gesucht (herve dupont) - Die horizontalen Linien, im Listview, können ausgeschaltet werden. (herve dupont) - kleine interne Veränderung. @endnode