This is Info file dfa.dok, produced by Makeinfo-1.48 from the input file dfa.texi. DFA(ddress), das Adress-Utility für den Amiga unter OS 2.0 Copyright (C) 1992 Dirk Federlein Die Graphische Benutzeroberfläche wurde mit Hilfe der Gadtoolsbox (C) 1992 Jan van den Baard generiert. Das AREXX Interface wurde mit Hilfe der Arexxbox (C) 1992 Michael Balzer generiert. Geschützte Warennamen (Warenzeichen) werden *nicht* besonders kenntlich gemacht. Aus dem Fehlen eines solchen Hinweises kann also nicht geschlossen werden, daß es sich um einen freien Warennamen handele. DFA **** Diese Anleitung beschreibt die Installation und die Bedienung von `DFA' Version1.1. Sie finden hier auch die Erläuterungen zu allen AREXX--Befehlen. Allgemeines ************ Copyright ========== Das Programm `DFAddress' (im Weiteren `DFA' genannt) ist *Shareware*; es darf beliebig kopiert und weitergegeben werden. Das Key--File, über das Sie nur als registrierter Benutzer verfügen, darf allerdings weder weitergegeben, noch (außer für den eigenen Bedarf) kopiert werden! Das Copyright bleibt in jedem Fall vollständig bei mir! Das Programm darf weiterhin nicht kommerziell verkauft werden; zur Deckung der Unkosten (die beim Kopieren entstehen) darf höchstens der Betrag verlangt werden, den Fred Fish für eine seiner "Library Disks" erhebt. Neben dem Programm unterliegt auch diese Anleitung dem Copyright! Für das Programm und die Anleitung gilt, daß sie nur vollständig und unverändert weitergegeben werden dürfen. Eine "Behandlung" mit sogenannten "Packern" ist jedoch gestattet. Garantie ========= Für Schäden, die direkt oder indirekt durch `DFA' angerichtet werden, übernehme ich keinerlei Haftung! Ich gebe keine Garantie für das fehlerfreie Arbeiten von `DFA'. Falls Sie Fehler (Bugs) in `DFA' finden sollten, bitte ich Sie, mir diese mitzuteilen, ich werde sie dann sobald wie möglich beheben. *Note Bugreports::. Was ist DFA? ============= `DFA' ist ein (weiteres) Programm zur Verwaltung von Adressen. Es ermöglicht ein schnelles "Nachschlagen" von Adressen und verfügt über eine Unterstützung von EMail-Adressen. Natürlich gibt es bereits einige andere Utilities, die *beinahe* das gleiche können -- nun -- *beinahe*! `DFA' wurde unter besonderer Berücksichtung von Kickstart/Workbench 2.0 (und höher) programmiert. Benutzer des (veralteten) OS 1.3 können es leider nicht verwenden; sollten sie es dennoch versuchen, werden sie außer einer entsprechenden Meldung (nämlich, daß die benötigten Libraries nicht geöffnet werden können) nichts sehen! Ich kann allen, die immer noch *AMIGA*OS 1.3 (und niedriger) benutzen nur raten, umgehend auf *AMIGA*OS 2.0 aufzurüsten! Da `DFA' *AMIGA*OS2.0 verwendet, kommen die Benutzer auch in den Genuß der neuen Features, die der *AMIGA* nun zur Verfügung stellt! `DFA' hat ein Application-Icon, den typischen "2.0-Look" und kann völlig über die Tastatur bedient werden! `DFA' wird als Commodity in das System eingebunden, auf diese Weise ist es auch über einen "Hotkey" erreichbar. `DFA' verfügt (seit Version 1.1) über einen AREXX--Port und kann so auch von anderen Programmen aus verwendet werden. Es bietet sich an, `DFA' in die `WBStartup'--Schublade zu kopieren, wodurch es gleich nach dem Einschalten des Rechners zur Verfügung steht! Wie es dazu kam ================ Anfang des Jahres 1992 suchte ich ein *gutes* Adress-Utility, das die Funktionen von OS2.0 ausnutzte, fand aber keines! Also begann ich, selbst eines zu programmieren. Die Fertigstellung von `DFA' zog sich etwas in die Länge, da ich in erster Linie Student bin und nicht Programmierer;-). Auch fielen mir immer wieder Verbesserungsmöglichkeiten ein, die teilweise dazu führten, daß Teile komplett neu geschrieben wurden. Dies war zum Beispiel der Fall, als ich mich davon überzeugen ließ (danke Kai!), daß das Programm unbedingt fontsensitiv sein müsse. Als ich das Programm dann soweit "fertig" hatte, daß es verwendbar schien, entschied ich mich dafür, es als Shareware herauszugeben und es nicht wie schon so *vieles* in der Schublade verschwinden zu lassen. Diese Entscheidung zog aber wiederum Arbeit nach sich, da der User auch irgendwie wissen möchte, wie er das Programm bedienen soll. Langer Rede kurzer Sinn: Eine Anleitung mußte geschrieben werden. Diese habe ich "der Einfachheit halber" in TeX gesetzt, die ASCII--Anleitung wurde mit DVI2TTY bearbeitet. Nach ein paar Bugfixes und einigen Registrierungen kam zutage, daß `DFA' zwar nicht schlecht, aber durchaus verbesserungswürdig war. Größere Veränderungen standen vor der Tür, z.B. zusätzliche Adressfelder, AREXX--Port,... Während der Programmierung des AREXX--Portes lernte ich das `TeXInfo'--Packet kennen und schätzen. So wurde die komplette Anleitung kurzerhand auf das `TeXInfo'-Format gebracht und aufgrund der Programmneuerungen auch erheblich erweitert. Die deutsche Anleitung wurde vollständig ins Englische übersetzt, wobei ebenfalls `TeXInfo' zur Anwendung kam. Der Vorteil, den der Anwender durch `TeXInfo' hat ist schnell erklärt: Aus `TeXInfo'--Dateien lassen sich neben einer `TeX'-Anleitung auch AMIGAGUIDE-- und ASCII--Dokumente generieren, und das (fast) *ohne* zusätzlichen Aufwand! Allerdings profitieren von der `TeX'-- und der AMIGAGUIDE--Anleitung nur die registrierten User;-) Als die AREXX--Implementierung fast abgeschlossen war, traf endlich der lang erwartete SAS-C 6.0 Compiler ein. Da ich zuvor den AZTEC-C--Compiler verwendet hatte, waren nicht unerhebliche Anpassungen nötig! Nach kurzer Zeit war aber auch das geschafft und so kann ich Ihnen nun `DFA' V1.1 präsentieren.... Installation ************* Wenn Sie `DFA' benutzen wollen, sind zuerst einige Files an die "richtige" Stelle zu kopieren: * *DFA, DFA.info* Diese beiden Files sollten Sie in eine Schublade innerhalb Ihres "Suchpfades" kopieren, z.B. `C:'. Wenn Sie `DFA' automatisch beim Booten starten wollen, kopieren Sie es einfach nach `SYS:WBStartup'. * *DFA.key* Dieses File kopieren Sie bitte in das `s:'--Verzeichnis. Es wird nur dort erkannt! Es "aktiviert" die Funktionen, die in der unregistrierten Version gesperrt sind. Natürlich verfügen nur registrierte Anwender über ein derartiges File, vgl. auch *Note Registrierung::. * *adr.file* Diese mitgeliferte Adressendatei können Sie in das selbe Directory kopieren, wie DFA und DFA.info und wird dann automatisch beim Start von `DFA' geladen. Es enthält die Adresse des Programmierers von `DFA';-) In den Preferences können Sie den Namen dieses Files (einschließlich Pfad) beliebig einstellen (*Note Einstellen von DFA::.) Wenn Sie am Anfang keine Adressdatei zur Verfügung stellen, ist die Adressliste leer. * *Arexx--Skripts* Im Unterverzeichnis `rexx' finden Sie einige kleine AREXX-Skripts. Die genaue Beschreibung zu jedem Skript finden Sie am Anfang der jeweiligen Skriptdatei. Die Skripts haben die Extension `.DFA', um zu kennzeichnen, daß es Skripts für `DFA' sind. All dieses Skripts kopieren Sie einfach nach `Rexx:', sie stehen dann sofort zur Verfügung. So, das war's auch schon. Jetzt können Sie `DFA' von der Shell aus starten, indem Sie `DFA' (oder `run DFA >NIL: ' vorangestellt. * *Blätter--Schalter (Cycle Gadgets)* Vor dem "Cycle Gadget" befindet sich ein kurzer Text mit der Funktionsbeschreibung des Schalters. Wiederum ist ein Buchstabe unterstrichen dargestellt. Hier ist es jedoch entscheidend, ob der Buchstabe "klein" oder "groß" eingegeben wird. Der Kleinbuchstabe "blättert" zum nächsten Eintrag, der Großbuchstabe zum vorherigen. Wenn man beim letzten Eintrag angekommen ist springt das Gadget wieder zum ersten und umgekehrt. * *Druckknopfschalter (Radio Buttons)* Von den zusammengehörenden Druckknopfschaltern kann jeweils nur einer gleichzeitig aktiviert sein. Sie können einen Eintrag wählen, indem Sie den zugehörigen "Shortcut" drücken. Groß- und Kleinschreibung sind hier gleichbedeutend. * *Auswahlfelder (Check Boxes)* Die Auswahlfelder können entweder selektiert sein, dann haben sie einen "Haken", oder sie sind deselektiert, dann ist der zugehörige "Kasten" leer. Sie können den aktuellen "Zustand" umschalten, indem Sie das entsprechende Tastaturkürzel verwenden. Groß- und Kleinschreibung unterscheiden sich in ihrer Bedeutung hier *nicht*. * *Texteingabefelder (String Gadgets)* Die Texteingabefelder entsprechen in ihren Funktionen weitgehend den "orginalen" String-Gadgets. Jedoch habe ich einige Erweiterungen eingebaut, die die Handhabung bequemer machen sollen: - Mit `RETURN' schließt man die Eingabe in das aktuelle Gadget ab und springt zum nächsten String-Gadget (oder Integer-Gadget). - Mit `SHIFT' `RETURN' schließt man die Eingabe in das aktuelle Gadget ab und springt zum vorherigen Gadget. - Mit `CURSOR UP' bzw. `CURSOR DOWN' kommt man in das vorherige bzw. nachfolgende String-Gadget. - Mit `ESCAPE' bricht man die Eingabe ab. Das Fenster, in dem sich das String-Gadget befindet wird geschlossen. Eventuelle Eingaben werden verworfen! - Befindet man sich in einem String-Gadget, erreicht man die Gadget-Shortcuts mit der Kombination `linke AMIGA Buchstabe'. Sollte sich ein Shortcut mit einer "orginalen" Gadgeteditierfunktion überschneiden (z.B. `Linke AMIGA Q' oder `Linke AMIGA X'), so erreichen Sie den Gadgetshortcut, indem Sie zusätzlich noch `SHIFT' drücken. Aktiviert werden die String-Gadgets mit dem entsprechenden Tastaturkürzel; auch hier gibt es keine Unterschiede zwischen einem Groß-- und einem Kleinbuchstaben. Einstellen von DFA ******************* Es gibt zwei Möglichkeiten, `DFA' nach den eigenen Vorstellungen zu konfigurieren: Über das Tool--Icon der Workbench und über die `DFA'-Preferences. Diese beiden Wege überschneiden sich *nicht*, sondern ergänzen sich. Einstellen der ToolTypes ========================= Dazu "klicken" Sie auf der Workbench das `DFA'-Icon *einmal* an und wählen im Workbench-Menü `Icons' das Information-Programm an. Es öffnet sich ein Fenster, in dem Sie folgende Tooltypes einstellen können * *`DONOTWAIT'* Das ist ein System--Tooltype, der veranlasst, daß die Workbench nach dem Starten von `DFA' nicht auf das Beenden von `DFA' wartet. Diesen Tooltype sollten Sie *nicht* entfernen. * *`CX_Priority'* Hiermit können Sie die Priorität von `DFA' bestimmen. Der voreingestellte Wert von `0' (`CX_Priority=0') muß in der Regel *nicht* verändert werden. * *`CX_Popup'* Mit `CX_Popup=YES' veranlassen Sie, daß `DFA' beim Starten sofort sein Hauptfenster öffnet, mit `CX_Popup=NO' wird dies unterbunden. `DFA' bleibt dann im Hintergrund, bis es per Hotkey oder Doppelklick auf das Application--Icon aktiviert wird. * *`CX_Popkey'* Voreingestellt ist hier `CX_Popkey=LCOMMAND F5', d.h. Sie können ein im Hintergrund laufendes `DFA' mit `Linke Amiga F5' aktivieren (vgl. auch `CX_Popup'). Mit den folgenden Kürzeln können Sie Ihren "eigenen" Hotkey definieren: LSHIFT linke SHIFT-Taste RSHIFT rechte SHIFT-Taste CAPSLOCK Caps-Lock-Taste CONTROL Control-Taste LALT linke ALT-Taste RALT rechte ALT-Taste LCOMMAND linke AMIGA-Taste RCOMMAND rechte AMIGA-TASTE NUMERICPAD 10er-Block MIDBUTTON mittlere Maustaste RBUTTON rechte Maustaste LEFTBUTTON linke Maustaste F1-F10 die entsprechenden Funktionstasten UP Cursor nach oben DOWN Cursor nach unten LEFT Cursor nach links RIGHT Cursor nach rechts HELP die Help-Taste DEL die Del-Taste RETURN die Return-Taste ENTER die Enter-Taste auf dem 10er-Block; allerings muß gleichzeitig "NUMERICPAD" gesetzt sein! BACKSPACE die Backspace-Taste (das ist die mit dem Pfeil nach links, über der Return-Taste) ESC die Escape-Taste SPACE die Space-Taste COMMA das Komma UPSTROKE die Tilde-Taste A..Z, a..z "normale" Tasten 0..9, etc. Diese Tasten können Sie untereinander kombinieren, "üblich" sind Ausdrücke wie zum Beispiel: - LSHIFT CONTROL F1 - LALT CONTROL D - CONTROL NUMERICPAD ENTER - RCOMMAND RSHIFT A - usw. * *`PORTNAME'* Normalerweise verwendet `DFA' als AREXX--Port--Namen `DFA'. Selbst wenn bereits ein Programm mit diesem Portnamen läuft, macht das nichts, denn `DFA' "merkt" das und achtet darauf das der Portname eindeutig wird, indem es `.1', `.2', `.3', etc. anhängt. Sollten Sie dennoch darauf Wert legen, daß `DFA' einen anderen Portnamen verwendet, so können Sie das über den Tooltype `PORTNAME' tun(z.B. `PORTNAME=DFAddress'. Bitte beachten Sie aber, daß Sie dann auch sämtliche Beispiel--AREXX--Skripts an den veränderten Portnamen anpassen müssen! Einstellen der DFA-Preferences =============================== Hierzu müssen Sie bei geöffnetem Hauptfenster den Menüpunkt `Preferences' anwählen (oder den Menü--Shortcut `Rechte AMIGA P' verwenden). Daraufhin öffnet sich ein weiteres Fenster, in dem Sie folgende Einstellungen verändern können: * *Address file* Hier können Sie den Namen (incl. des Suchpfades) des Files angeben, in dem die Adressen gespeichert werden sollten (Default: `adr.file'). * *Get* Betätigen Sie `Get', öffnet sich ein Filerequester, in dem Sie direkt das File auswählen können, das in `Address file' erscheinen soll. * *XPos* Hier können Sie die X--Koordinate des Application--Icons angeben, also den Abstand vom linken Bilschirmrand. * *YPos* Mit YPos können Sie die Y--Koordinate des Application--Icons angeben, also den Abstand vom oberen Bilschirmrand. * *Show Appicon* Hier können Sie entscheiden, ob Sie ein Application--Icon auf der Workbench haben wollen, oder nicht. * *Baud* Über dieses "Cycle Gadget" können Sie die Baudrate des seriellen Ports einstellen. Da über den seriellen Port ja nur gewählt wird, und keine Daten übertragen werden, ist die Übertragungsrate im wesentlichen nicht erheblich, Sie sollte nur nicht über der liegen, die Ihr Modem "verträgt" (Default: `1200'). * *Init String* Die Zeichenkette, die Sie in diesem Eingabefeld eintragen, wird zur Initialisierung an das Modem geschickt. Wenn Sie über ein Hayes--kompatibeles Modem verfügen, ist das in der Regel `ATZ' (Default: `ATZ') * *Predial String* Diese Zeichenkette wird vor der Telefonnummer an das Modem geschickt. Beispiele für Hayes--kompatibele Modems: ATDP Pulse-Dial (Default) ATDT Tone-Dial ATDP#W Auf diese Weise können Sie von einer Nebenstelle wählen lassen. Für `#' müssen Sie lediglich die Ziffer einsetzen, die Sie vorwählen müssen, um ein Freizeichen zu erhalten. * *Serial device* In dieses Feld können Sie das serielle Device eintragen, das beim Wählen angesprochen werden soll. Defaultmäßig ist hier das "orginal" `serial.device' von Commodore eingetragen. Falls sie aber z.B. eine zusätzliche Schnittstellenkarte besitzen, können Sie hier das entsprechende Device eintragen. * *Select device* Statt den Devicenamen in das oben erwähnte Textfeld einzutragen können Sie mit `Select device' das Device komfortabel in einem File--Requester auswählen. * *Device unit* Hier können Sie die Nummer des Gerätes eintragen. "Normalerweise" ist diese `0'. Wenn Sie aber z.B. 2 serielle Schnittstellen auf ihrer Schnittstellenkarte haben, so sind diese üblicherweise über `0' und `1' zu unterscheiden. * *Save* Mit `Save' speichern Sie die eingestellten Preferences ab. Beachten Sie bitte, daß neben den oben erwähnten Einstellungen auch die Fensterpositionen abgespeichert werden -- und zwar relativ zum Hauptfenster! Wenn Sie also z.B. das Preferencesfenster direkt unter die Titelleiste des Hauptfenster positionieren, dann das Preferencesfenster schließen, das Hauptfenster verschieben und das Preferencesfenster wieder öffnen, so erscheint es nicht an der selben Stelle, wie zuvor, sondern wiederum direkt unter der Titelleiste des Hauptfensters! * *Use* Sämtliche Einstellungen werden verwendet, jedoch *nicht* gespeichert. Das heißt, daß bei einem Neustart die zuletzt gespeicherten Einstellungen gelten. * *Cancel* Wenn Sie das Preferencesfenster mit `Cancel' verlassen, werden die gemachten Änderungen nicht übernommen. Nachdem Sie nun `DFA' Ihren Wünschen entsprechend eingestellt haben, lernen Sie im folgenden die weiteren Möglichkeiten von `DFA' kennen. DFA schrittweise ***************** Das Hauptfenster ================= Im Hauptfenster von `DFA' stehen Ihnen folgende Möglichkeiten zur Verfügung: * *Der Listview* Im Listview wird die Adressliste dargestellt, sobald Sie Adressen eingegeben haben (dazu später mehr). Sie können die Liste entweder wie gewohnt mit der Maus hoch und herunter rollen und Einträge anwählen, oder aber komplett über die Tastatur bedienen. Mit `a' wird der nächste Eintrag der aktuelle (die Liste rollt entsprechend mit), mit `A' können Sie den vorherigen Eintrag anwählen. Markieren können Sie den jeweils aktiven Eintrag mit `SPACE'. Mit der Maus werden die Einträge per "Doppelklick" selektiert. Drücken Sie `RETURN', so hat dies die gleiche Wirkung, als hätten Sie `Full' angewählt: Die aktuelle Adresse wird in einem extra Fenster detailliert dargestellt. *Note Full::. * *Die Textanzeigefelder* Unterhalb des Listviews sehen Sie vier Textanzeigefelder. Hier werden die Telefonnummer, sowie maximal drei EMail--Adressen der aktuellen Adresse angezeigt. * *Die Schalterleiste, rechts vom Listview* Rechts vom Listview befinden sich eine Reihe von Schaltern, deren Funktionen ich hier kurz erläutern mochte: - *Full* Zeigt den aktuellen Eintrag in einem weiteren Fenster an, hier werden auch weitere Daten, wie Straße, Ort, etc. angezeigt; siehe auch *Note Full::. - *Edit* Wählt man `Edit', kann man den aktuellen Eintrag (den, der unter dem Listview erscheint!) editieren. Falls es keinen aktuellen Eintrag gibt, so kann man natürlich keinen editieren;-). *Note Edit::. - *New* Wählt man `New', so kann man eine *neue* Adresse eingeben. Die Funktionen innerhalb des Windows sind exakt die gleichen, wie im `Edit'--Window; siehe auch *Note Edit::. - *Kill* Mit `Kill' wird der aktuelle Eintrag (falls einer existiert) gelöscht. Damit niemand "aus Versehen" wichtige Adressen löscht, gibt es hier eine Sicherheitsabfrage. - *Search* Es öffnet sich ein weiteres Fenster, in dem man umfangreiche Suchkriterien angeben kann. *Note Search::. - *Search Next* `Search Next' kann man nur anwählen, wenn zuvor über `Search' ein Suchkriterium eingegeben wurde. Ist dies der Fall wird der nächste Eintrag, der "paßt" gesucht und im Erfolgsfalle angezeigt (*nicht* markiert). - *Print* Nachdem man `Print' angewählt hat, erscheint ein weiteres Fenster, mit verschiedenen Möglichkeiten, die verwalteten Adressen zu Papier zu bringen. *Note Print::. - *Sort* Wählt man `Sort' an, so wird die komplette Liste nach Namen, Vornamen und Ort sortiert (in *dieser* Reihenfolge). - *Dial* Nur für Besitzer eines Modems! Haben Sie ein Modem an Ihrem Rechner angeschlossen, so ist es über `Dial' möglich, die eingetragene(n) Telefonnummer(n) wählen zu lassen. Da auch mehrere Telefonnummern eingetragen sein können, ist es *unbedingt* notwendig, diese mit `senkrechten Strich' (`|') zu trennen. Hat man das "Dialing" gestartet, erscheint ein Requester, der anzeigt, wer angerufen wird. Man kann das Wählen jederzeit abbrechen (`Abort') oder die aktuelle Nummer überspringen (`Skip'). Die Modemparameter können Sie in den `DFA'--Preferences einstellen; siehe auch *Note Einstellen von DFA::. Direkt unterhalb des Listviews befinden sich vier Schalter, mit denen man die Selektion von Adressen beeinflussen kann: - *All* Selektiert alle Adressen. - *By name* Es wird ein Window geöffnet. In diesem kann man ein Such--"Muster" eingeben (Groß-- und Kleinschreibung wird hierbei *nicht* beachtet!). Nach der Anwahl von `Ok' (oder `RETURN' drücken) in diesem Window werden alle Einträge der Adressliste selektiert, die den Suchausdruck enthalten. Der Unterschied zur `Search'--Funktion liegt darin, daß man 1. nicht wählen kann, ob Groß-- und Kleinschreibung beachtet werden soll und 2. nur die im Listview dargestellten Adressteile (also Name, Vorname und Ort) durchsucht werden. Weiterhin wird nicht die erste gefundene Adresse angesprungen, sondern *alle* passenden Einträge werden *markiert*. - *Clear* Es werden alle selektierten Einträge deselektiert. - *Jump to* Es wird zum nächsten selektierten Eintrag "gesprungen". Existiert kein weiterer Eintrag mehr, so wird der erste Eintrag in der Liste angezeigt. * Ganz unten im Haupt--Fenster von `DFAddress' befinden sich die Gadgets `Hide' und `Quit'. Mit `Hide' wird das Window geschlossen. Das Application--Icon bleibt jedoch auf der Workbench. `DFA' kann jederzeit schnell wieder in den Vordergrund gebracht werden und zwar entweder durch einen Doppelklick auf das Application--Icon, oder über den "Hotkey", der per Default auf `Linke Amiga F5' eingestellt ist. Wie Sie den Hotkey nach Ihren Wünschen ändern können, erfahren Sie weiter vorne im Text, im *Note Einstellen von DFA::. Wählt man `Quit', so werden eventuelle Änderungen der Adressen gespeichert und `DFA' wird vollständig beendet. Full ===== `Full' kann nur angewählt werden, wenn eine Adresse im Listview angewählt wurde. Ist dies geschehen, öffnet sich ein weiteres Fenster (Titel: `Full address...'), indem die gewählte Adresse in allen Einzelheiten dargestellt wird. Unterhalb der Adressfelder liegt eine Gadgetreihe , mit der es möglich ist, innerhalb der Liste zu "manövrieren": * *First* Die erste Adresse der Liste wird angezeigt. Als Tastaturkürzel können Sie neben dem unterstrichenen Buchstaben alternativ noch `Cursor Up' verwenden. * *Last* Die letzte Adresse der Liste wird angezeigt. Als Tastaturkürzel können Sie neben dem unterstrichenen Buchstaben alternativ noch `Cursor Down' verwenden. * *Prev. Sel.* Falls vor der aktuellen Adresse noch eine *markierte* existiert, wird diese angezeigt. * *Next Sel.* Falls nach der aktuellen Adresse noch eine *markierte* existiert, wird diese angezeigt. * *Prev.* Die vorherige Adresse wird angezeigt, falls vorhanden. Als Tastaturkürzel können Sie neben dem unterstrichenen Buchstaben alternativ noch `Cursor Left' verwenden. * *Next* Die nächste Adresse wird angezeigt, falls vorhanden. Als Tastaturkürzel können Sie neben dem unterstrichenen Buchstaben alternativ noch `Cursor Right' verwenden. Mit `Ok' kann man das Fenster schließen, mit `Edit' gelangt man in das `EDIT'--Window. Eine genauere Beschreibungen des `Edit'--Windows finden Sie in *Note Edit::. Edit ===== Insofern eine aktuelle Adresse existiert, vgl. auch *Note Full::, öffnet sich ein Fenster, in dem man sämtliche Teile der Adresse ändern kann. Die String-Gadgets haben gegenüber den "Orginal--String--Gadgets" zusätzliche Funktionen: Vgl. *Note Die Bedienung von DFA::. Mit `Ok' schließt man die Änderungen ab, betätigt man stattdessen `Cancel', werden die Änderungen nicht übernommen. New ==== Betätigt man New, so öffnet sich ein Fenster, welches dem `Edit'--Fenster exakt entspricht! Die "Templates" (vgl. hierzu auch *Note Edit Template (Shortcut T)::,) wurden zuvor bereits in die entsprechenden Felder kopiert. Man kann nun eine *neue* Adresse angeben. Sämtliche Funktionen sind mit denen des Edit-Fensters identisch (*Note Edit::.) Search ======= In diesem Fenster kann man die Suchkriterien einstellen. * *Search for* Hier trägt man die Suchzeichenkette ein. Hierbei kann man die üblichen *AMIGA*--Patterns verwenden. Es ist jedoch nicht notwendig, vor und nach dem Suchstring "Joker" zu setzen. Also nicht `#?Suchname#?', sondern `Suchname'. Unterstützte "Muster" und Ihre Bedeutung: ? entspricht einem beliebigen einzelnen Zeichen # der auf dieses Zeichen folgende Ausdruck darf beliebig oft (auch 0 mal) vorkommen (ab|cd) entspricht jedem der durch ein `|' getrennten Ausdrücke ~ verneint den folgenden Ausdruck `~(foo)' entspricht also allem *außer* der Zeichenkette `foo'. [abc] entspricht *einem* der in eckigen Klammern angegebenen Zeichen [~bc] enspricht jedem Zeichen, das *nicht* in den eckigen Klammern aufgeführt ist. [a-z] entspricht allen Zeichen zwischen `a' und `z' inklusive der "Grenzen" `a' und `z'. % entspricht einer "leeren" Zeichenkette. Nützlich ist dies z.B. in einem Ausdruck, wie `(foo|bar|%)'. * ist ein Abkürzung für `#?'. * *Ignore case* Je nachdem, ob man `Ignore Case' anwählt oder nicht, wird beim Suchen die Groß-- und Kleinschreibung beachtet oder nicht. * *Fields to search* Hier kann man wählen, welche Felder durchsucht werden sollen. Man kann zwischen allen Feldern (`All fields') und den einzelnen Teilen der Adresse wählen. * *Search* Mit Search startet man die Suche. Wenn ein passender Eintrag gefunden wird, rollt die Adressliste an die entsprechende Stelle und der Eintrag wird aktiviert (*nicht* markiert). * *Cancel* Betätigt man `Cancel', so wird die Suche abgebrochen. Der Listview wird aktualisiert, das heißt in diesem Fall lediglich, daß die zuvor angewählte akuelle Adresse in die erste Zeile der Liste "gerollt" wird. Print ====== In diesem Fenster sind die Funktionen zusammengefaßt, mit denen man die eingegebenen Adressen ausdrucken kann. * *Print* Man kann zwischen allen (`All'), den selektierten (`Selected') und der aktiven Adresse (`Active') wählen. Wenn eine aktuelle ("aktive") Adresse existiert, so wird sie bei `Active Item' angezeigt. * *Print to* Man kann entweder auf dem Drucker (`PRT:') ausdrucken, oder aber die Adressen in ein File "drucken" lassen. Läßt man die Adresse(n) in ein File schreiben, so haben die folgenden Druckparameter keinen Einfluß. * *Print style* Man kann hier angeben, ob man die Adressen in `NLQ' (d.h. Near letter quality) oder "eng" (`Condensed') ausdrucken will. Wenn Sie `Formfeed' aktivieren, wird nach der letzten gedruckten Adresse ein Seitenvorschub an den Drucker geschickt. Das Ausschalten dieses Seitenvorschubs kann zum Beispiel sinnvoll sein, wenn man nur wenige Adressetiketten bedruckt und nicht jedesmal eine komplette Seite "verschwenden" will. Beachten Sie bitte, daß der gleichnamige AREXX--Befehl nicht beachtet, ob hier `Formfeed' gesetzt ist! * *Print form* Für den Ausdruck existieren fünf verschiedene Druckformen, unter denen man wählen kann: Short address list kurze Adressenliste Full address list ausführliche Adressenliste Phonelist Telefonliste Mailing labels Adressenaufkleber (für Briefe) Address cards Karteikartendruck * *Print* Hat man als Ausgabemedium `File' gewählt, öffnet sich nun ein Filerequester, in dem man den Filenamen auswählen kann. Achtung! Diese Ausgabe ist nicht kompatibel zum internen Adressfile (Default: `adr.file'), sondern lediglich dazu gedacht, die Adressen z.B. in andere Programme übernehmen zu können. Wenn die Ausgabe an den Drucker (`PRT:') gesendet wird, öffnet sich ein Fenster, in dem man das "Fortschreiten" des Druckens verfolgen kann. Ein Abbruch ist hiebei nur nach jeder "vollen" Adresse möglich. Druckt man nur die aktive Adresse, erscheint kein "Progress Indikator"! * *Cancel* Mit Cancel bricht man den ganzen Druckvorgang ab Die Menus von DFA ****************** Einen Menüpunkt haben Sie schon beim Einstellen der `DFA'--Preferences kennengelernt, nun folgen die restlichen: About ====== Im `About'--Fenster finden Sie einige nützliche Informationen über das Programm und den Autor: * die Versionsnummer , sowie eine entsprechende Anmerkung, falls Sie eine registrierte Version besitzen, * den Copyright-Vermerk , sowie die Adresse des Autors (incl. EMail-Adresse(n)), * Ihren Namen und Adresse, sowie die Seriennummer des Programms, insofern sie registrierter Anwender sind, * die Anmerkung, daß die graphische Benutzeroberfläche (GUI) mit der GadToolsBox von Jan van den Baard erstellt wurde. Info (Shortcut I) ================== In dem Fenster, das sich öffnet, sobald Sie das `Info'--Menü anwählen, sind einige nützliche Informationen (daher auch der Name;-)) enthalten: *Arexx--Port* Hier ist der Name des AREXX--Ports eingetragen. Dieser lautet normalerweise `DFA'. Sie können jedoch den Portnamen über einen entsprechenden `Tooltype' ändern; vergleichen Sie bitte hierzu *Note Einstellen der ToolTypes::. Sollten Sie schon ein Programm gestartet haben, das ebenfalls den Portnamen `DFA' besitzt, so "merkt" `DFA' dies und passt den Portnamen entsprechend an, indem es solange Ziffern "anhängt", bis ein *eindeutiger* Name zustande kommt, also `DFA.1', `DFA.2', `DFA.3',... *Addresses* Hier wird die Anzahl der gerade geladenen Adressen angezeigt. *Memory Condition* Hier können Sie sich über die Speichersituation auf Ihrem Rechner informieren. Load (Shortcut L) ================== Mit `Load' ist es möglich, ein anderes Adress-File zu laden. Die momentan vorhandenen Adressen werden hierbei verworfen! Nachdem Sie `Load' angewählt haben, erscheint ein FileRequester, in dem Sie das gewünschte File auswählen können. Beachten Sie bitte, daß nur Files mit dem "richtigen" Format geladen werden können, also solche, die auch von `DFA' erzeugt wurden! Ist dies nicht der Fall, weigert sich `DFA', das gewählte File zu laden! Dennoch werden eventuell schon vorhandene Adressen gelöscht. Append (Shortcut A) ==================== Mit `Append' können Sie weitere Adressen an die bereits vorhandenen "anhängen", das heißt, die vorhandenen Adressen werden nicht gelöscht. Auch hierbei ist allerdings etwas Vorsicht angesagt! Lädt man nämlich die gleichen Adressen zweimal, so hat man auch zweimal die gleichen Adressen in der Liste, was normalerweise wohl nicht erwünscht ist. Save (Shortcut S) ================== Mit `Save' speichern Sie die eingegebenen Adressen unter dem aktuellen Namen ab. Der aktuelle Name ist entweder der in den Preferences angegebene Name (Default: `adr.file'), oder, falls Sie zuvor mit `Load' ein anderes File geladen haben, dieser Name. Save as... =========== `Save as' speichert ebenfalls die Adressen ab, jedoch können Sie hier den Filename in einem Filerequester angeben. Dies ist z.B. nützlich, wenn Sie verschiedene Adressdateien besitzen (z.B. eine für private Adressen und eine für die geschäftlichen). Save as default ================ Die Adressen werden mit `Save as default' in jedem Fall mit dem in den Preferences angegebenen Namen (Default: `adr.file') abgespeichert. Preferences (Shortcut P) ========================= Die Preferences wurden bereits unter *Note Einstellen von DFA::, ausführlich besprochen. Edit Template (Shortcut T) =========================== Hier erwartet Sie ein Fenster, das Sie wahrscheinlich schon von `Edit' und `New' her kennen. Sie können hier *Vorgaben* eintragen, die automatisch in die entsprechenden Felder kopiert werden, wenn Sie eine *neue* Adresse anlegen. Gespeichert werden diese Vorgaben zusammen mit den anderen Adress--Daten (also nicht mit den Preferences), wodurch es möglich ist, für jede Adressdatei andere Vorgaben zu verwenden! Quit (Shortcut Q) ================== Mit `Quit' beenden Sie `DFA' (endgültig). Falls zuvor Änderungen an den Adressen vorgenommen wurden, werden diese abgespeichert (vgl. `Save'). Die Arexx Schnittstelle ************************ Seit der Version 1.1 besitzt `DFA' einen AREXX--Port. Da in *AMIGA*OS 2.0 AREXX automatisch enthalten ist, besitzen Sie somit die Möglichkeit, `DFA' vollständig "fernzusteuern". Das kann zum Beispiel sinnvoll sein, wenn man *automatisch* von einem *anderen* Programm aus bestimmte Adressen von `DFA' importieren möchte. Grundlagen =========== `DFA' akzeptiert sowohl dann AREXX--Kommandos, wenn das *Hauptwindow* geöffnet ist, als auch, wenn `DFA' "schläft", d.h. nur das Application Icon bzw. gar nichts von `DFA' auf der Workbench zu sehen ist. Befinden Sie sich gerade in einem anderen `DFA'--Fenster (z.B. `Edit'), kann `DFA' *keine* AREXX-Befehle ausführen. Das ist sicherlich sinnvoll, denn was für ein Durcheinander könnte entstehen, wenn sie z.B. gerade eine Adresse editieren und *gleichzeitig* diese Adresse über ein AREXX-Skript gelöscht wird! Sobald Sie in das Hauptfenster von `DFA' zurückkehren, kann die Abarbeitung der AREXX--Befehle beginnen. Wenn ich hier von AREXX--Befehlen spreche, die ausgeführt werden, meine ich damit, das ein *AREXX-Skript* ausgeführt wird, in dem `DFA'-AREXX-Befehe enthalten sind. Die Grundlagen der AREXX--Programmierung können Sie z.B im Handbuch zum *AMIGA* OS 2.0 oder im "AREXX User's Reference Manual"(1) nachlesen. Der AREXX--Port, über den Sie `DFA' ansprechen können heißt `DFA', solange Sie nicht den Portnamen über den Tooltype `PORTNAME' ändern, vgl. *Note Einstellen von DFA::. Dies sollten Sie *nur dann* tun, wenn Sie bereits ein anderes Programm mit AREXX--Port laufen haben, das den *selben* Portname verwendet und Sie nicht von der Möglichkeit Gebrauch machen wollen, daß `DFA' automatisch einen *eindeutigen* Portnamen wählt. Wenn unter Rückgabewert `ADDRESS/M' steht, heißt das, daß bei erfolgreicher Auführung des Befehls die gewünschte Adresse in der angegebenen Variablen (oder `RESULTS') zurückgeliefert wird. Zu diesem Zweck unterstützt `DFA' die beiden AREXX--Schlüsselworte `STEM' und `VAR'. Beispiel: /* Ausgabe der ersten Adresse */ ADDRESS "DFA" OPTION RESULTS FIRST STEM TEST. SAY TEST.ADDRESS.1 EXIT Dieses kurze Beispiel gibt den Namen des ersten Eintrags in der Liste aus. Das `STEM' Schlüsselwort bewirkt die Rückgabe der Adresse in *Listenform*, d.h. die einzelnen Adresselemente erscheinen in `TEST.ADDRESS.0' bis `TEST.ADDRESS.13'. In `TEST.ADDRESS.COUNT' finden Sie die Anzahl der Variablen-Elemente. Das `VAR' Schlüsselwort bewirkt *ebenfalls* eine Rückgabe der kompletten Adresse in die übergebene Variable, allerdings mit dem Unterschied, daß die ganze Adresse durch Leerzeichen getrennt in *eine* Variable geschrieben wird! Genaueres entnehmen Sie bitte Ihrem AREXX-Handbuch! Eine Anmerkung zu den `Load'-- `Append'-- und `Save as'-- Befehlen: Bei der Angabe des Filenamens sollte immer der komplette Pfad mit angegeben werden, da sonst die Wahrscheinlichkeit *sehr* hoch ist, dass das File nicht gefunden wird, bzw. an eine Stelle geschrieben wird, wo man es eigentlich nicht haben möchte! Ein Bezug auf das Homedirectory von `DFA' ist auch sinnlos, da 1. `DFA' wohl oft in einem anderen Directory steht, als die Adressdateien und 2. sich `DFA' den zuletzt angegebenen Filenamen (inkl. Pfad) "merkt" bzw. den in den Preferences angegebenen verwendet. Unter der Angabe der Syntax sind jeweils die möglichen Parameter aufgeführt. Die Parameterbeschreibung richtet sich nach den von Commodore vorgegebenden Richtlinien, so ist z.B. `FORM/K' als `FORM=ALL', `FORM=SELECTED' oder `FORM=ACTIVE' zu verwenden. Alternativ könnte hier das `=' weggelassen werden. Die genaue Syntax zu jedem Befehl finden Sie weiter unten unter *Note Die Arexx Befehle::. Das AREXX--Interface von DFA gibt Ihnen ein mächtiges Werkzeug in die Hand um Ihre Adressen zu manipulieren. Ein großer Funktionsumfang und weitgehende Freiheiten führen jedoch immer dazu, daß die Gefahr Daten zu verlieren größer wird! Dafür muß nicht unbedingt eine Fehlfunktion von `DFA' verantwortlich sein; schon ein falsch eingesetzter AREXX--Befehl oder auch nur ein versehentlich verwendeter Parameter kann dazu führen, daß mehr oder weniger große Datenbestände verloren gehen. Um den möglichen Schaden daher so gering wie möglich zu halten, rate ich Ihnen, regelmäßig Kopien Ihrer Adressdateien anzulegen. ---------- Fußnoten ----------- (1) AREXX User's Reference Manual, William S. Hawes, P.O. Box 308, Maynard, MA 01754 Die Arexx Befehle ================== Es folgen nun in alphabetischer Reihenfolge die AREXX--Befehle, die `DFA' "versteht". ABOUT ------ Syntax: ABOUT Rückgabewert: Fehlercode in RC Funktion: Das `About'--Fenster von `DFA' wird geöffnet APPEND ------- Syntax: APPEND FILENAME/A, FORCE/S Rückgabewert: Fehlercode in RC Funktion: An die bereits existierenden Adressen werden weitere "angehängt". Wurden an den existierenden Adressen änderungen vorgenommen, wird die Adressliste nicht angehängt, es sei denn, man gibt zusätzlich das Schlüsselwort `FORCE' an, dann wird das Laden der neuen Liste in *jedem* Fall erzwungen! CLEARALL --------- Syntax: CLEARALL Rückgabewert: Fehlercode in RC Funktion: Alle Einträge der Adressliste werden deselektiert DESELECT --------- Syntax: DESELECT Rückgabewert: Fehlercode in RC Funktion: Der aktuelle Eintrag (falls vorhanden) wird deselektiert DIAL ----- Syntax: DIAL Rückgabewert: Fehlercode in RC Funktion: Die aktuelle Adresse (falls eine existiert!) wird angerufen EDIT ----- Syntax: EDIT ADDRESS/K, FIRST/K, NAME/K, STREET/K, ZIP/K, CITY/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, EMAIL1/K, EMAIL2/K, EMAIL3/K, FAX/K, COMMENT/K, SELECT/S ADDRESS Anrede FIRST Vorname NAME Nachname STREET Straße und Hausnummer ZIP Postleitzahl CITY Ort COUNTRY Land BIRTHDAY Geburtstag PHONE Telefonnummer EMAIL1 EMail-Adresse Nr.1 EMAIL2 EMail-Adresse Nr.2 EMAIL3 EMail-Adresse Nr.3 FAX Fax-Nummer COMMENT Kommentar SELECT Eintrag selektiert (oder nicht) Rückgabewert: Fehlercode in RC Funktion: Die aktuelle Adresse (falls eine existiert) wird in den übergebenen Feldern geändert. Der zuvor vorhandene Inhalt wird gelöscht! Felder, die nicht angegeben werden behalten ihren ursprünglichen Inhalt. Bitte beachten Sie, dass Sie Parameter, die Leerstellen enthalten, doppelt in Anführungszeichen setzen müssen, wie z.B. EDIT 'COMMENT="Ein Test mit Leerzeichen"' Denken Sie auch daran, das `'' als "äußere" Anführungszeichen und das `"' als innere Anführungszeichen zu verwenden! FIRST ------ Syntax: FIRST Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Die erste Adresse der Liste wird zur aktuellen. Diese Adresse wird in `ADDRESS' zurückgegeben. GETCURRENT ----------- Syntax: GETCURRENT Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Der aktuelle Eintrag (falls einer existiert) wird in `ADDRESS' zurückgegeben. ICONIFY -------- Syntax: ICONIFY Rückgabewert: Fehlercode in RC Funktion: Falls das Hauptwindow von `DFA' geöffnet ist, wird es geschlossen. `DFA' wird *nicht* beendent! KILL ----- Syntax: KILL Rückgabewert: Fehlercode in RC Funktion: Der aktuelle Eintrag wird (falls vorhanden) gelöscht! Achtung! Es wird keinerlei Sicherheitsabfrage gemacht. Die Adresse wird auch dann gelöscht, wenn die Adressen zuvor verändert wurden! LAST ----- Syntax: LAST Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Die letzte Adresse der Liste wird zur aktuellen. Diese Adresse wird in `ADDRESS' zurückgegeben. LOAD ----- Syntax: LOAD FILENAME/A,FORCE/S Rückgabewert: Fehlercode in RC Funktion: Die angegebene Adressliste wird geladen, insofern die bestehende zuvor nicht verändert wurde. Mit `FORCE' kann man ein Laden erzwingen! NEW ---- Syntax: NEW ADDRESS/K, FIRST/K, NAME/K, STREET/K, ZIP/K, CITY/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, EMAIL1/K, EMAIL2/K, EMAIL3/K, FAX/K, COMMENT/K, SELECT/S ADDRESS Anrede FIRST Vorname NAME Nachname STREET Straße und Hausnummer ZIP Postleitzahl CITY Ort COUNTRY Land BIRTHDAY Geburtstag PHONE Telefonnummer EMAIL1 EMail-Adresse Nr.1 EMAIL2 EMail-Adresse Nr.2 EMAIL3 EMail-Adresse Nr.3 FAX Fax-Nummer COMMENT Kommentar SELECT Eintrag selektiert (oder nicht) Rückgabewert: Fehlercode in RC Funktion: Es wird eine neue Adresse mit den übergebenen Angaben angelegt. NEXT ----- Syntax: NEXT Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Die nächste Adresse der Liste wird angewählt und in `ADDRESS' zurückgegeben NEXTSEL -------- Syntax: NEXTSEL Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Die nächste selektierte Adresse wird angewählt und in `ADDRESS' zurückgegeben POPUP ------ Syntax: POPUP Rückgabewert: Fehlercode in RC Funktion: Wenn `DFA' sich im "iconifizierten" Zustand befindet, wird das Hauptfenster geöffnet, ansonsten wird ein Fehlercode (`10') zurückgegeben. PREV ----- Syntax: PREV Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Die vorherige Adresse wird angewählt und in `ADDRESS' zurückgegeben PREVSEL -------- Syntax: PREVSEL Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Die vorherige Adresse, die sich im selektierten Zustand befindet, wird angewählt und in `ADDRESS' zurückgegeben PRINT ------ Syntax: PRINT WHICH/K, FILE/K, NLQ/S, CONDENSED/S, FORMFEED/S, FORM/N WHICH `WHICH' kann folgende Zuweisungen bekommen: ALL Alle Adressen werden gedruckt SELECTED Nur die selektierten Adressen werden gedruckt ACTIVE Nur der aktive Eintrag (falls einer existiert) wird gedruckt FILE Wird `FILE' im Zusammenhang mit einem Filenamen angegeben, wird statt auf dem Drucker in ein File ausgegeben. NLQ Wird dieses Schlüsselwort angegeben, wird in `NLQ' gedruckt. CONDENSED Es wird "eng" gedruckt FORMFEED Nach der letzten Adresse wird ein Seitenvorschub durchgeführt, wenn `FORMFEED' gesetzt ist. Es wird hier also nicht die Einstellung aus dem Print-Fenster übernommen! FORM Form kann die Ziffern `0' bis `4' annehmen. Diese Ziffern entsprechen im Wesentichen denen aus dem Druck--Fenster, mit dem Unterschied, dass *hier* mit `0' statt mit `1' begonnen wird, also 0: Kurze Adressliste 1: Lange Adressliste 2: Telefonliste 3: Adressetiketten 4: Adress-Karten Rückgabewert: Fehlercode in RC Funktion: Die gewünschten Adressen werden ausgedruckt SAVE ----- Syntax: SAVE Rückgabewert: Fehlercode in RC Funktion: Die Adressliste wird unter dem aktuellen Namen abgespeichert. SAVEAS ------- Syntax: SAVEAS FILENAME/A,FORCE/S Rückgabewert: Fehlercode in RC Funktion: Die Adressliste wird unter dem angegebenen Namen abgespeichert. SAVEASDEFAULT -------------- Syntax: SAVEASDEFAULT Rückgabewert: Fehlercode in RC Funktion: Die Adressliste wird unter dem "Default"--Namen, der in den `DFA'--Preferences eingestellt werden kann, abgespeichert. SEARCH ------- Syntax: SEARCH PATTERN/A, IGNORECASE/S, FIELDS/K PATTERN Hier kann ein Such-Pattern eingegeben werden. IGNORECASE `IGNORECASE' wählt die Suche *ohne* Berücksichtigung der Groß- und Kleinschreibung. FIELDS Dem `FIELDS'-Schlüsselwort können Folgende Werte zugewiesen werden: ALL Alle Felder der Adresse werden durchsucht FIRST Es wird nur nach dem Vornamen gesucht NAME Es wird nur nach dem Nachnamen gesucht ZIP Es wird nur nach der Postleitzahl gesucht CITY Es wird nur nach der Stadt gesucht COUNTRY Es wird nur nach dem Land gesucht BIRTHDAY Es wird nur nach dem Geburtstag gesucht PHONE Es wird nur nach der Telephonnummer gesucht EMAIL Es wird nur nach der Email--Adresse gesucht (aber alle 3 Felder werden berücksichtigt!). COMMENT Es wird nur nach dem Kommentar gesucht Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Es wird nach dem angegebenen Suchstring gesucht. Wir ein passender Eintrag gefunden, so wird dieser in `ADDRESS' zurückgegeben. Ist das Hauptfenster von `DFA' geöffnet, so wird die Adressliste entsprechend aktualisiert. SEARCHNEXT ----------- Syntax: SEARCHNEXT Rückgabewert: * Fehlercode in RC * ADDRESS/M Funktion: Es wird nach dem nächsten Vorkommen des in `Search' angegebenen Strings gesucht. Wird ein entsprechender Eintrag gefunden, so wird dieser in `ADDRESS' zurückgegeben. Ist das Hauptfenster von `DFA' geöffnet, so wird die Adressliste entsprechend aktualisiert. SELALL ------- Syntax: SELALL Rückgabewert: Fehlercode in RC Funktion: Alle Einträge der Adressliste werden selektiert. SELBYNAME ---------- Syntax: SELBYNAME PATTERN/A Rückgabewert: Fehlercode in RC Funktion: Alle Einträge der Adressliste, die den übergebenen String enthalten, werden selektiert SELECT ------- Syntax: SELECT QUERY/S Rückgabewert: * Fehlercode in RC * SELECTED/N Funktion: Der aktuelle Eintrag (falls vorhanden) wird selektiert. Gibt man `QUERY' an, so wird die aktuelle Adresse *nicht* selektiert, sondern der "Selektions--Status" (`0' oder `1') zurückgegeben. SORT ----- Syntax: SORT Rückgabewert: Fehlercode in RC Funktion: Die Adressliste wird nach Namen, Vornamen und Ort (in dieser Reihenfolge) sortiert. Die Fehler Codes ================= Die Fehler--Codes entsprechen denen, die das AREXX--Handbuch vorgibt: 0: Kein Fehler 5: Warnung 10: Fehler 20: Schwerwiegender Fehler Falls beim Abarbeiten eines Befehls etwas schiefgeht, gibt `DFA' die Fehlernummer `10' (`RC_ERROR') zurück (in RC)! Sollte der AREXX--Befehls--Parser einen Syntaxfehler finden, so gibt er `20' zurück. Verschiedenes ************** * *`DFA' ist fontsensitiv* `DFA' verwendet die Fonts, die Sie in den Font--Preferences der Workbench eingestellt haben! Nur wenn die Bildschirmauflösung zu klein für den gewünschten Font ist, "fällt" `DFA' wieder auf den Topaz--8--Font zurück. * *Mehrere `DFA's auf einmal?* Es ist nicht möglich, mehrere `DFA'--Programme gleichzeitig laufen zu haben. Sollten Sie es dennoch probieren, beendet sich das neugestartete `DFA' und das zuerst gestartete `DFA' öffnet sein Fenster und kommt in den Vordergrund. Es gibt mehrere Gründe, warum man nur ein einziges `DFA' starten kann. Da ist zum Beispiel die Frage, welchen Hotkey man zusätzlich gestarteten `DFA's geben sollte -- der im Tool-Icon eingestellte ist ja bereits vergeben. Auch das Abspeichern der Adressen und der `DFA'-Preferences würde zu Überschneidungen führen, die wohl eher den User verwirren würden, als daß es *entscheidende* Vorteile mit sich brächte. * *Die Sache mit den Window-Positionen* `DFA' "merkt" sich sämtliche Windowpositionen. Das heißt, das sich die Windows immer dort wieder öffnen, wo Sie sie zuletzt "hingeschoben" haben. Abgespeichert werden die Windowpositionen, wenn Sie die Preferences sichern (was nur registrierten Anwendern möglich ist)! Die Fensterpositionen werden relativ zum Hauptfenster abgespeichert! Das heißt, wenn Sie das Hauptwindow von `DFA' verschieben, öffnen sich die anderen Fenster dann ebenfalls "verschoben". * *Das Application Icon* Das Application Icon kann nur geöffnet werden, wenn ein entsprechedes `.info'--File existiert! Sie sollten es also nicht löschen, selbst wenn Sie `DFA' nur von dem CLI (bzw. der Shell) aus aufrufen! * *Das Key-File* Auf der Diskette, die Sie *nach der Registrierung* von mir erhalten, befindet sich ein sogenanntes Keyfile. Dieses sollten Sie auf *keinen Fall* verändern, da es sonst nicht mehr als "korrektes" Keyfile erkannt wird! Tips und Tricks **************** * *Übernahme der Adressen in andere Programme* Die Übernahme der Adressen in andere Programme kann seit der Version V1.1 bequem über das AREXX--Interface erledigt werden. Falls das andere Programm keinen AREXX--Port haben sollte, kann man die Adressen von `DFA' so zumindest in ein Format bringen lassen, daß das andere Programm "versteht". * *Import von bereits vorhandenen Adressen in `DFA'* Die Importierung kann ebenfalls über die AREXX--Schnittstelle geschehen (Befehl: `NEW'). * *Der Aufbau eines `DFA'--Files* Das Adressfile ist *zeilenweise* organisiert. Die erste Zeile enthält die *Kennung* von `DFA', wodurch sichergestellt wird, daß nur die "richtigen" Dateien geladen werden können. Die Kennung lautet "DFAddress1.1". Nach dieser Kennung folgen die Adressen; Eine einzelne Adresse hat folgendes Aussehen: - Nachname - Vorname - Straße - PLZ - Ort - Land - Geburtstag - Telefonnummer - EMail-Adresse Nr.1 - EMail-Adresse Nr.2 - EMail-Adresse Nr.3 - Kommentar - [ Status-Flag ] - Anrede - Fax-Nummer Diese Darstellung bedarf wohl kaum einer weiteren Erläuterung. Bis auf das Status-Flag vielleicht. Dieses Flag ist gesetzt (hat also den Wert `1'), wenn die entsprechende Adresse selektiert wurde (also in der ersten Spalte das `>' erscheint). Wird hier eine `0' eingetragen, ist der Eintrag nicht selektiert. Die Hausnummer wird zusammen mit der Straße eingetragen, es wird also dafür keine extra Zeile verwendet! `Anrede' und `Fax' stehen deshalb am Ende, weil sie in `DFA' V1.0 noch nicht existierten und auf diese Weise die Abwärtskompatibilität gewahrt werden kann. Registrierung ************** Diejenigen, die bereits registrierte Anwender von `DFA' sind, können diesen Abschnitt übergehen, alle anderen mögen ihn bitte *aufmerksam* lesen! Bevor Sie sich registrieren lassen, haben Sie die Möglichkeit, zu testen, ob `DFA' Ihren Ansprüchen entspricht. Jedoch ist es in der unregistrierten Version nicht möglich, die `DFA'--Preferences einzustellen; man muß mit den Defaults vorlieb nehmen. Die Tooltypes lassen sich jedoch verändern! Solange Sie sich also nicht registrieren lassen, müssen Sie als Adress-File immer `adr.file' im aktuellen Verzeichnis verwenden, Sie haben immer ein Application Icon auf der Workbench, das sich obendrein auch noch immer an der gleichen Stelle befindet! Auch auf eine individuelle Einstellung der Modem-Parameter müssen Sie verzichten. Die Position der Fenster wird NICHT gespeichert. Dennoch sollte es möglich sein, auch in dieser eingeschränkten Version `DFA' ausgiebig zu testen. Sobald Sie das Programm dann regelmäßig verwenden, bitte ich Sie, sich registrieren lassen: Die Sharewaregebühr beträgt DM 15,- (US$ 10,-). Wenn Sie außerhalb der EG leben, muß ich Sie bitten mir zur Deckung der zusätzlichen Kosten etwas mehr zu schicken (vgl. `Registration.txt'). Sie erhalten dafür Ihr persönliches Keyfile, das die oben erwähnten Funktionen aktiviert und eine in TeX gesetzte (deutsche und englische) Anleitung als DVI--File auf Diskette. Die Anleitung liegt zusätzlich als ASCII-- und als AMIGAGUIDE--File bei (jeweils deutsch und englisch). Diejenigen, die TeX und einen Drucker besitzen, können somit die Dokumentation selbst ausdrucken! Auch die aktuelle Version von `DFA' wird auf der Diskette enthalten sein. Für weitere 5,- DM (bzw. US$ 5,-) erhalten Sie zusätzlich die gedruckte TeX-Anleitung in einem Schnellhefter. Bitte markieren Sie den entsprechenden Punkt auf dem Registrations--Formular. Ich bitte darum, mir ca. 2 Wochen Zeit für die Zusendung der registrierten `DFA'-Version zu geben; natürlich werde ich versuchen, die Registrierung schneller zu bearbeiten. Meine Adresse finden Sie weiter unten, im *Note Bugreports::. Bugreports *********** `DFA' hat bereits eine relativ lange Entwicklungsphase hinter sich. An dieser Stelle möchte ich auch Kai Iske danken, der von mir mit einer wahren Flut von Alpha- und Beta-Versionen überschüttet wurde, die er dann testen "durfte". Er ist (durch permanentes "Drängeln") u.a. auch dafür verantworlich , daß die Commodity--Einbindung und die EditHooks (Spezialfunktionen in den String-- und Integergadgets) schon in der Version 1.0 eingebaut wurden... Seit ich die Version 1.0 veröffentlich habe, hat es zahlreiche Verbesserungen und Bugfixes gegeben (eine genaue Auflistung kann im History--File nachgelesen werden). Allen, die mich auf Fehler aufmerksam und/oder Verbesserungsvorschläge machten, möchte ich ganz besonders danken. Trotz allem soll daß nicht heißen, daß `DFA' fehlerfrei ist (leider). Sicherlich hat sich noch der eine oder andere Bug irgendwo versteckt. Ich bitte daher darum, mir mitzuteilen, wenn Sie Fehler in `DFA' entdecken. Auch für Verbesserungsvorschläge bin ich jederzeit offen. Bug-Reports können mir entweder per "Sackpost" oder per EMail zugesendet werden: Meine Adresse für Fehlerberichte *und Registrierung*: Heimatanschrift: Dirk Federlein Brunnengasse 11a 8750 Aschaffenburg EMail: FIDO 2:249/40.12 Semesteranschrift: Dirk Federlein Am Sonnenberg 34 8700 Würzburg EMail: FIDO 2:242/14.26 Wenn Sie die Shareware--Gebühr überweisen wollen, so benutzen Sie bitte die untenstehende Bankverbindung. Beachten Sie aber, daß Überweisungen aus dem Ausland nach Deutschland sehr teuer werden können! Bank address: Bayerische Vereinsbank Aschaffenburg Deutschland BLZ: 795 200 75 Knr.: 160 6 140 Email erreicht mich immer unter *beiden* Adressen, da Netmail automatisch entsprechend umgeleitet wird. Falls Sie mir "normale" Post *während der Semesterferien* nach Würzburg schicken, kann es unter Umständen sehr lange dauern, bis Sie Antwort erhalten, da ich während der Semesterferien *oft* nicht in Würzburg bin. Wer nicht genau weiß, wo er die Registrierung hinschicken soll, kann sie *immer* nach Aschaffenburg schicken, sie erreicht mich dann *sicher*. Index ****** Funktionsindex =============== * Menu: * ABOUT: Arexx-Funktion ABOUT. * AMIGA-Muster: Search. * AMIGA-Pattern: Search. * APPEND: Arexx-Funktion APPEND. * About: About. * Address file: Einstellen der DFA--Preferences. * Addresses: Info (Shortcut I). * Adresse: Bugreports. * Adresse des Autors: About. * All: Das Hauptfenster. * Angabe des Filenamens: Grundlagen. * Append: Append (Shortcut A). * Application Icon: Verschiedenes. * Arexx: Die Arexx Schnittstelle. * Arexx Fehler-Codes: Die Fehler Codes. * Arexx-Adressrückgabe: Grundlagen. * Arexx-Befehle empfangen: Grundlagen. * Arexx-Funktion About: Arexx-Funktion ABOUT. * Arexx-Funktion Append: Arexx-Funktion APPEND. * Arexx-Funktion Clearall: Arexx-Funktion CLEARALL. * Arexx-Funktion Deselect: Arexx-Funktion Deselect. * Arexx-Funktion Dial: Arexx-Funktion DIAL. * Arexx-Funktion Edit: Arexx-Funktion Edit. * Arexx-Funktion First: Arexx-Funktion FIRST. * Arexx-Funktion Getcurrent: Arexx-Funktion Getcurrent. * Arexx-Funktion Iconify: Arexx-Funktion ICONIFY. * Arexx-Funktion Kill: Arexx-Funktion KILL. * Arexx-Funktion Last: Arexx-Funktion LAST. * Arexx-Funktion Load: Arexx-Funktion LOAD. * Arexx-Funktion New: Arexx-Funktion New. * Arexx-Funktion Next: Arexx-Funktion NEXT. * Arexx-Funktion Nextsel: Arexx-Funktion NEXTSEL. * Arexx-Funktion Popup: Arexx-Funktion POPUP. * Arexx-Funktion Prev: Arexx-Funktion PREV. * Arexx-Funktion Prevsel: Arexx-Funktion PREVSEL. * Arexx-Funktion Print: Arexx-Funktion PRINT. * Arexx-Funktion Save: Arexx-Funktion SAVE. * Arexx-Funktion Saveas: Arexx-Funktion SAVEAS. * Arexx-Funktion Saveasdefault: Arexx-Funktion SAVEASDEFAULT. * Arexx-Funktion Search: Arexx-Funktion SEARCH. * Arexx-Funktion Searchnext: Arexx-Funktion SEARCHNEXT. * Arexx-Funktion Selall: Arexx-Funktion SELALL. * Arexx-Funktion Selbyname: Arexx-Funktion SELBYNAME. * Arexx-Funktion Select: Arexx-Funktion SELECT. * Arexx-Funktion Sort: Arexx-Funktion SORT. * Arexx-Grundlagen: Grundlagen. * Arexx-Literatur: Grundlagen. * Arexx-Port: Info (Shortcut I). * Arexx-Portname: Grundlagen. * Arexx-Skripts: Installation. * Aufbau eines Adress-Files: Tips und Tricks. * Auswahlfelder: Die Bedienung von DFA. * Bankverbindung: Bugreports. * Baud: Einstellen der DFA--Preferences. * Blätter-Schalter: Die Bedienung von DFA. * Bugreports: Bugreports. * By name: Das Hauptfenster. * CLEARALL: Arexx-Funktion CLEARALL. * CX_Popkey: Einstellen der ToolTypes. * CX_Popup: Einstellen der ToolTypes. * CX_Priority: Einstellen der ToolTypes. * Cancel (Edit): Edit. * Cancel (Preferences): Einstellen der DFA--Preferences. * Cancel (Print): Print. * Cancel (Search): Search. * Check Box: Die Bedienung von DFA. * Clear: Das Hauptfenster. * Condensed: Print. * Copyright: About. * Cycle Gadget: Die Bedienung von DFA. * DESELECT: Arexx-Funktion Deselect. * DIAL: Arexx-Funktion DIAL. * DONOTWAIT: Einstellen der ToolTypes. * Dateiformat: Load (Shortcut L). * Device unit: Einstellen der DFA--Preferences. * Dial: Das Hauptfenster. * Dialing: Einstellen der DFA--Preferences. * Druckknopfschalter: Die Bedienung von DFA. * EDIT: Arexx-Funktion Edit. * Edit: Edit. * Edit: Full. * Edit: Das Hauptfenster. * Edit Template: Edit Template (Shortcut T). * Empfangsbereitschaft für Arexx-Befehle: Grundlagen. * Export von Adressen: Tips und Tricks. * FIRST: Arexx-Funktion FIRST. * Fehler-Berichte: Bugreports. * Fehler-Codes: Die Fehler Codes. * Fensterpositionen: Einstellen der DFA--Preferences. * Fields to search: Search. * Filename: Grundlagen. * First: Full. * Fonts: Verschiedenes. * Format der Adressdatei: Load (Shortcut L). * Format der Adressdatei: Tips und Tricks. * Formfeed: Print. * Full: Full. * Full: Das Hauptfenster. * GETCURRENT: Arexx-Funktion Getcurrent. * GadToolsBox: About. * Gedruckte Anleitung: Registrierung. * Get: Einstellen der DFA--Preferences. * Grundlagen zu Arexx: Grundlagen. * Hayes kompatibel: Einstellen der DFA--Preferences. * Hide (Hauptfenster): Das Hauptfenster. * Hotkey: Einstellen der ToolTypes. * ICONIFY: Arexx-Funktion ICONIFY. * Icon: Einstellen der ToolTypes. * Ignore case: Search. * Import von Adressen: Tips und Tricks. * Info: Info (Shortcut I). * Init String: Einstellen der DFA--Preferences. * Jump to: Das Hauptfenster. * KILL: Arexx-Funktion KILL. * Key-File: Verschiedenes. * Key-File: Copyright. * Kill: Das Hauptfenster. * LAST: Arexx-Funktion LAST. * LOAD: Arexx-Funktion LOAD. * Last: Full. * Listview: Die Bedienung von DFA. * Listview (Hauptfenster): Das Hauptfenster. * Literatur zu Arexx: Grundlagen. * Load: Load (Shortcut L). * Mehrere DFAs: Verschiedenes. * Memory Condition: Info (Shortcut I). * Menus: Die Menus von DFA. * Muster: Search. * NEW: Arexx-Funktion New. * NEXT: Arexx-Funktion NEXT. * NEXTSEL: Arexx-Funktion NEXTSEL. * NLQ: Print. * New: Das Hauptfenster. * New: New. * Next: Full. * Next Sel.: Full. * Ok (Edit): Edit. * Ok (Full): Full. * POPUP: Arexx-Funktion POPUP. * PORTNAME: Einstellen der ToolTypes. * PREV: Arexx-Funktion PREV. * PREVSEL: Arexx-Funktion PREVSEL. * PRINT: Arexx-Funktion PRINT. * Parametersyntax: Grundlagen. * Pattern: Search. * Portname: Grundlagen. * Portname von Arexx: Info (Shortcut I). * Portname von Arexx: Grundlagen. * Predial String: Einstellen der DFA--Preferences. * Preferences: Einstellen der DFA--Preferences. * Preferences: Preferences (Shortcut P). * Prev.: Full. * Prev. Sel.: Full. * Print: Print. * Print: Print. * Print: Print. * Print: Das Hauptfenster. * Print form: Print. * Print style: Print. * Print to: Print. * Quit: Quit (Shortcut Q). * Quit (Hauptfenster): Das Hauptfenster. * Rückgabe von Adressen in Arexx: Grundlagen. * Radio Button: Die Bedienung von DFA. * Registrierung: Registrierung. * Rexx: Verzeichnis: Installation. * Roll-Liste: Die Bedienung von DFA. * Roll-Liste (Hauptfenster): Das Hauptfenster. * SAVE: Arexx-Funktion SAVE. * SAVEAS: Arexx-Funktion SAVEAS. * SAVEASDEFAULT: Arexx-Funktion SAVEASDEFAULT. * SEARCH: Arexx-Funktion SEARCH. * SEARCHNEXT: Arexx-Funktion SEARCHNEXT. * SELALL: Arexx-Funktion SELALL. * SELBYNAME: Arexx-Funktion SELBYNAME. * SELECT: Arexx-Funktion SELECT. * SORT: Arexx-Funktion SORT. * Save: Save (Shortcut S). * Save (Preferences): Einstellen der DFA--Preferences. * Save as default: Save as default. * Save as...: Save as.... * Schalterleiste (Hauptfenster): Das Hauptfenster. * Schnittstellenkarte: Einstellen der DFA--Preferences. * Schnittstellenkarte: Einstellen der DFA--Preferences. * Search: Das Hauptfenster. * Search: Search. * Search: Search. * Search Next: Das Hauptfenster. * Search for: Search. * Select device: Einstellen der DFA--Preferences. * Selektion: Das Hauptfenster. * Serial device: Einstellen der DFA--Preferences. * Serielles Gerät: Einstellen der DFA--Preferences. * Seriennummer: About. * Sharewaregebühr: Registrierung. * Shortcut: Die Bedienung von DFA. * Show Appicon: Einstellen der DFA--Preferences. * Sort: Das Hauptfenster. * String Gadget: Die Bedienung von DFA. * Suchkriterien: Das Hauptfenster. * Tastaturbedienung: Die Bedienung von DFA. * Tastaturkürzel: Die Bedienung von DFA. * Templates: New. * Templates editieren: Edit Template (Shortcut T). * Textanzeigefelder (Hauptfenster): Das Hauptfenster. * Texteingabefeld: Die Bedienung von DFA. * Tool-Icon: Einstellen von DFA. * Use (Preferences): Einstellen der DFA--Preferences. * User Interface Style Guide: Erste Schritte. * Versionsnummer: About. * Verzeichnis Rexx:: Installation. * Verzeichnis WBStartup: Installation. * Verzeichnis s:: Installation. * WBStartup: Installation. * WBStartup: Installation. * Window-Positionen: Einstellen der DFA--Preferences. * Window-Positionen: Verschiedenes. * Wählen lassen: Das Hauptfenster. * Wählen lassen: Einstellen der DFA--Preferences. * X-Koordinate: Einstellen der DFA--Preferences. * XPos: Einstellen der DFA--Preferences. * Y-Koordinate: Einstellen der DFA--Preferences. * YPos: Einstellen der DFA--Preferences. * Zeichensatz: Verschiedenes. * s: Verzeichnis: Installation. Konzeptindex ============= * Menu: * About: About. * Allgemeines: Allgemeines. * Append (Shortcut A): Append (Shortcut A). * Bugreports: Bugreports. * Copyright: Copyright. * DFA schrittweise: DFA schrittweise. * Das Hauptfenster: Das Hauptfenster. * Die Arexx Befehle: Die Arexx Befehle. * Die Arexx Schnittstelle: Die Arexx Schnittstelle. * Die Bedienung von DFA: Die Bedienung von DFA. * Die Fehler Codes: Die Fehler Codes. * Die Menus von DFA: Die Menus von DFA. * Edit: Edit. * Edit Template (Shortcut T): Edit Template (Shortcut T). * Einstellen der DFA-Preferences: Einstellen der DFA--Preferences. * Einstellen der ToolTypes: Einstellen der ToolTypes. * Einstellen von DFA: Einstellen von DFA. * Erste Schritte: Erste Schritte. * Full: Full. * Garantie: Garantie. * Grundlagen: Grundlagen. * Info (Shortcut I): Info (Shortcut I). * Installation: Installation. * Load (Shortcut L): Load (Shortcut L). * New: New. * Preferences (Shortcut P): Preferences (Shortcut P). * Print: Print. * Quit (Shortcut Q): Quit (Shortcut Q). * Registrierung: Registrierung. * Save (Shortcut S): Save (Shortcut S). * Save as default: Save as default. * Save as...: Save as.... * Search: Search. * Tips und Tricks: Tips und Tricks. * Verschiedenes: Verschiedenes. * Was ist DFA?: Was ist DFA?. * Wie es dazu kam: Wie es dazu kam.