Anleitung zu Tel-Update V0.20 6. Juli '95 von Christoph Spengler Stephanstr. 11 42859 Remscheid MausNet: Christoph Spengler @ RS Inhaltsverzeichnis ================== 1 Vorwort 2 Die Features 3 Rechtliches 3.1 Postcard-Ware 3.2 Haftungsausschluž 4 Installation 5 Der Haupt-Dialog 6 Das Anzeige-Fenster 7 Bekannte Fehler 8 Online-Hilfe Anhang A Vorschl„ge B Bezugsquellen C Dank D Weitere Programme 1 Vorwort ========= Die Idee zu Tel-Update kam mir, als ich mir INKTOTEL ansah. An diesem Programm „rgerte mich erstens, daž ich es ber eine ASCII-Datei konfigurieren mužte und zweitens, daž ich keinen Einfluž auf die Sortierung hatte und jedesmal mhsam alles neu sortieren mužte. Aužerdem ist es nicht gerade wahnwitzig schnell. Damit ist jetzt Schluž, das und einiges mehr kann Tel-Update. 2 Die Features ============== Die ganz besonderen Features von Tel-Update: ù Erstellt aus der ITB-Datei der Maus und der RUFUS.RTL oder der CONNECT.CTL aktuelle Versionen dieser Dateien. ù Automatische Erzeugung eines Backups der alten Datei ù Sortierung nach Name oder Nummer ù Angabe einer beliebigen Anzahl verbleibender Zeilen der alten RUFUS.RTL/CONNECT.CTL, die nicht berschrieben und auch nicht umsortiert werden ù Alles in einem bersichtlichen Dialog eingebettet ù Wandlung von "MAUS" nach "M" und "Quark" nach "Q" (optional), was wesentlich zur šbersicht beitr„gt. ù Umsortieren der RTL/CTL-Datei in Tel-Update. ù Untersttzung von Iconify unter ICFS und MTOS 3 Rechtliches ============= 3.1 Postcard-Ware ----------------- Tel-Update ist eingeschr„nkte Postcard-Ware. Was das ist? Ganz einfach. Da ich wissen m”chte, wieviele Leute mein Programm benutzen, muž man mir, um das Programm vernnftig einsetzen zu k”nnen, eine Postkarte schicken. Ich schicke dann sofort per E-Mail den (kostenlosen) Key zu. In der unregistrierten Version wird die Baudrate auf 2400 Baud gesetzt. Meine Adresse: Christoph Spengler Stephanstr. 11 42859 Remscheid MausNet: Christoph Spengler @ RS Registrierungen sind auch zu erhalten bei: Rainer Wiesenfeller Beckmannstr. 81 42659 Solingen MausNet: Rainer Wiesenfeller @ RS Auf der Postkarte bitte auch den Namen und die E-Mail-Adresse angeben, damit ich weiž, von wem's kommt... 3.2 Haftungsausschluž --------------------- Ich habe mir natrlich gr”žte Mhe gegeben, Tel-Update fehlerfrei zu programmieren. Natrlich kann ich nicht garantieren, daž mir das auch in allen Punkten gelungen ist. Sollten durch Benutzung dieses Programmes irgendwelche Sch„den entstehen oder Sch„den im Zusammenhang mit diesem Programm zu stehen scheinen, so kann ich dafr nicht haftbar gemacht werden. 4 Installation ============== Es gibt zwei unterschiedliche M”glichkeiten, Tel-Update zu verwenden. Zun„chst einmal k”nnen Sie Tel-Update ganz einfach als GEM-Programm starten und ber Dialog und Fenster konfigurieren. Sie k”nnen Tel- Update aber auch in CAT als Filter installieren. Dazu gehen Sie folgendermažen vor. ù Starten Sie CAT. Im Men 'Optionen' w„hlen Sie jetzt bitte den Punkt 'I/O-Filter...'. Es erscheint ein Dialog. ù Es kann durchaus sein, daž Sie bereits andere Filter (z.B. Katzenklo) installiert haben, daher mssen Sie zun„chst einen freien Slot w„hlen. Klicken Sie dazu auf den Eintrag hinter 'Filter:' - es ”ffnet sich eine Listbox. W„hlen Sie nun einen der Eintr„ge 'nicht installiert'. ù Wenn Sie nun auf den Button hinter 'Programm' klicken, erscheint eine Fileselect-Box, in der Sie bitte Tel-Update ausw„hlen und dann best„tigen. ù Hinter 'Name' k”nnen Sie jetzt dem Filter auch einen Namen geben (z.B. 'Tel-Update'). Die Box 'aktiv' sollten Sie anklicken, damit Tel-Update berhaupt etwas tut. ù Klicken Sie jetzt auf den Eintrag hinter 'Wofr:', wieder erscheint eine Listbox, in der Sie bitte 'nach Einsortieren' anw„hlen. ù Nun mssen Soe noch bei 'Kommandozeile bei Einsortieren:' die Zeile '-straight' eingeben. Wenn Tel-Update ber diese Zeile gestartet wird, weiž es, daž es nicht in seinen Dialog gehen soll und beginnt direkt mit der Umwandlung. Wichtig: Bevor Sie Tel-Update als Filter einsetzen, mssen Sie es erst einmal als Programm gestartet und im Haupt-Dialog alle erforderlichen Parameter eingegeben haben! Wenn Sie nun ein Outfile einfgen (also nach dem Maustausch), passiert folgendes: Tel-Update wird mit der Kommando-Zeile '- straight' gestartet. Es liest daraufhin seine Inf-Datei und sucht die Datei ITB.TXT in dem von Ihnen angegebenen Pfad. Dann wird das Erstellungsdatum der Datei berprft. Ist dieses Datum nicht mit dem aktuellen identisch, bricht Tel-Update sofort mit einer entsprechenden Meldung ab. Sie k”nnen so recht einfach bestimmen, wie oft Tel-Update Ihre CTL/RTL-Datei bearbeiten soll, dies h„ngt n„mlich davon ab, wie oft Sie die ITB-Datei bei der Maus "bestellen" (einstellbar in CAT unter 'Tausch->Infodateien'). Ist die ITB aktuell, beginnt Tel-Update unter Bercksichtigung der eingegebenen Parameter sofort mit der Umwandlung und beendet sich danach direkt, so daž Sie anschliežend Ihre Nachrichten lesen k”nnen. 5 Der Haupt-Dialog ================== Im Haupt-Dialog (der einzige seiner Art in diesem Programm) k”nnen Sie alle n”tigen Einstellungen fr die Konvertierung t„tigen. Das w„ren (von oben nach unten gesehen): ù CAT-Database-Pfad - hier geben Sie bitte den Pfad der Cat- Database an, in dem sich die Datei ITB.TXT befinden sollte (sonst macht die ganze Sache wenig Sinn). Ein Klick auf den Button aktiviert eine Fileselect-Box, in der Sie den Pfad einstellen k”nnen. ù Zu „ndernde RTL/CTL-Datei - hier geben Sie die RTL/CTL-Datei (in der Regel wohl RUFUS.RTL/CONNECT.CTL) an, die ge„ndert werden soll. Tel-Update erkennt an der Dateiendung, ob es sich um eine Rufus- oder Connect-Datei handelt und disabled die entsprechenden Felder im Dialog. Keine Sorge, es wird bei der Bearbeitung ein Backup der alten Datei erstellt (es tr„gt den Namen BACKUP.RTL/CTL). Ein Klick auf den Button aktiviert eine Fileselect-Box, in der Sie die Datei ausw„hlen k”nnen. ù Modemreset - hier geben Sie den Reset-String fr Ihr Modem ein (in der Regel wohl ATZ), das Zeichen '|' steht fr Return, Tilde fr eine kurze Wartezeit. ù Modem-Init - hier k”nnen Sie einen Modem-Init-String eingeben. Dieser String ist nur fr Connect von Bedeutung. ù Anwahl String - hier geben Sie Ihren Standard-Anwahl-String ein. Dabei steht '#' fr die Position, an der die Nummer eingefgt wird. ù Baudrate - geben Sie hier Ihre Baudrate ein. ù Datenbits - wird wohl in der Regel '8N1' sein. Diese Eingabe ist nur fr Rufus von Bedeutung. ù Vorwahl der Heim-Maus - geben Sie hier die Vorwahl Ihrer Maus ein, sie wird dann beim Einsortieren gefiltert (bei der Maus RS wird z.B. aus '02191-40828' '40828'. ù L„nder-Vorwahl - hier geben Sie bitte die Vorwahl Ihres Landes ein (z.B. 0049 fr Deutschland), damit Tel-Update diese aus der ITB-Datei filtern kann. Bei Boxen aus anderen L„ndern wird sie beibehalten. Leider gibt es in der ITB immer noch Boxen, bei denen keine L„nder-Vorwahl angegeben ist. Da tr„gt Tel-Update natrlich dann keine Vorwahl ein, weil das Programm nicht weiž, in welchem Land die St„dte liegen. ù "MAUS"->"M" und "QUARK"->"Q" - da die L„nge des Namens der Maus in Rufus nur 20 Zeichen betragen darf, nehmen die Worte "QUARK" und "MAUS" da schon einigen Platz weg. Diese Option wandelt die beiden Worte in Einzelbuchstaben, so daž aus "MAUS Remscheid" "M Remscheid" wird. Am besten mal ausprobieren, es ist wirklich bersichtlicher. ù Nummern mit gleichen Namen updaten - wenn eine Namensgleichheit zwischen einem der in der RTL/CTL-Datei verbleibenden Eintr„ge und einem Eintrag der ITB-Datei festgestellt wird, wird die (eventuell ver„nderte) Nummer eingetragen. ù Die ersten __ Zeilen bleiben unver„ndert - eines der wichtigsten Features von Tel-Update, denn hier k”nnen Sie angeben, wieviele Zeilen (von vorne an gez„hlt) Tel-Update in der RTL/CTL-Datei unangetastet lassen soll. Alle restlichen Zeilen werden gel”scht (also bei 0 alle!) und durch die Eintr„ge aus der ITB-Datei ersetzt. ù Standard-Batch - wenn Sie hier klicken, erscheint ein Fileselector, in dem Sie eine Connect/Rufus-Batch-Datei ausw„hlen k”nnen. Diese Batch-Datei wird dann bei allen Nummern eingetragen, die von Tel-Update berschrieben werden. Wollen Sie diese Zuweisung wieder l”schen, mssen Sie in dem Fileselector nur 'Abbrcuh' klicken. ù Sortieren nach... - hier k”nnen Sie eingeben, wonach die Eintr„ge hinter den unver„nderten Zeilen sortiert werden sollen, nach Nummer oder Name (in der Regel wohl letzteres, aber wer's braucht...). Unten im Dialog haben wir dann noch vier Buttons, die folgende Bedeutung haben: ù Abbruch - beendet Tel-Update, ohne etwas zu tun, Sie drfen noch entscheiden, ob Sie Ihre Einstellungen abspeichern wollen, bevor das Programm verlassen wird. ù Einst. sichern - sichert alle im Haupt-Dialog get„tigte Einstellungen. ù RTL/CTL-Datei zeigen - ”ffnet das Anzeige-Fenster, in dem die im Dialog oben angegebene RTL/CTL-Datei mit Zeilennummern angezeigt wird. Dies soll helfen zu entscheiden, wieviele Zeilen Sie aus dieser Datei behalten m”chten. ù Umwandeln - startet die Umwandlung. Die ITB-Datei wird gelesen und unter Benutzung der eingestellten Optionen in die RTL/CTL- Datei einsortiert. Anschliežend wird das Anzeige-Fenster ge”ffnet, in dem Sie die erstellte Datei sehen k”nnen. 6 Das Anzeige-Fenster ===================== Im Anzeige-Fenster wird die RTL/CTL-Datei, die Sie im Haupt-Dialog ausgew„hlt haben, mit Zeilnennummern angezeigt. In diesem Fenster k”nnen Sie sich mit den Cursor-Tasten zeilenweise, mit Shift-Cursor seitenweise bewegen. Home bringt Sie an den Anfang zurck, Shift-Home an das Ende der Datei. Ctrl-U schliežt das Fenster, mit Ctrl-W wechseln Sie zurck in den Haupt-Dialog. Mit einem einfachen Mausklick k”nnen Sie eine Zeile fr die weitere Bearbeitung anklicken, sie wird dann fett dargestellt. Per Rechts- oder Doppelklick ins Anzeige-Fenster erhalten Sie einen kleinen Dialog, in dem Sie die Anzahl der Zeilen editieren k”nnen, die von Tel-Update nicht berschrieben werden sollen. Oben im Fenster sehen Sie eine Button-Leiste mit vier Buttons (alle Buttons k”nnen auch per Tastatur bedient werden, sie sind entsprechend beschriftet): ù Der Top-Button bringt die selektierte Zeile (fett dargestellt) an erste Position der Datei, also ganz nach oben, alle anderen Zeilen rcken dementsprechend nach. Alternativ k”nnen Sie auch Ctrl-Home drcken. ù Die beiden anderen Pfeil-Buttons bewegen die selektierte Zeile in einzelnen Schritten rauf oder runter. Alternativ k”nnen Sie auch Ctrl-Cursor up/down drcken. ù Der Umwandlungs-Button startet die Umwandlung der RTL/CTL-Datei. Alternativ k”nnen Sie Alt-U drcken. Auf diese Weise k”nnen Sie _vor_ der Umwandlung die fr Sie wichtigen Nummern nach oben bringen. Wichtig ist jetzt noch, daž Sie im Haupt- Dialog die Anzahl der unver„nderten Zeilen anpassen, dann k”nnen Sie die Umwandlung starten. Bitte beachten Sie, daž durch das reine Verschieben der Zeilen zun„chst einmal nichts an der Datei ge„ndert wird, das geschieht erst beim Umwandeln. In der Button-Leiste wird aužerdem der Pfad der RTL/CTL-Datei und das Erstellungsdatum angezeigt. 7 Bekannte Fehler ================= Tel-Update wurde mit der Gem-Library SysGem von Andreas Pietsch @ WI2 programmiert. Diese Library vereinfacht ganz ungemein das Schreiben von Gem-Programmen, und ohne sie h„tte ich mich wahrscheinlich nie daran gewagt, ein Programm mit Fenstern und Dialogen zu schreiben... Leider gibt es in SysGem ein paar bekannte Fehler, die sich in Tel- Update an einigen Stellen bemerkbar machen. Eine neue Version von SysGem ist in der Mache, und sobald sie erscheint, werden, wenn man dem Autor glauben darf (und davon gehe ich aus) diese Fehler der Vergangenheit angeh”ren. ù SysGem kommt momentan nur bedingt mit kleineren System- Zeichens„tzen zurecht. Der Haupt-Dialog ist nach wie vor bedienbar, aber die Button-Leiste im Anzeige-Fenster ist nicht ganz zu sehen. ù Wenn man im Anzeige-Fenster in den Rollbalken klickt, um seitenweise zu scrollen, wird etwas mehr als eine Seite gescrollt. Das passiert aber nicht, wenn man Shift-Cursor up/down drckt, da konnte ich diesen Fehler umgehen. ù Im Anzeige-Fenster bleibt gegebenenfalls unten eine Pixelzeile stehen. ù Unter MagiC 3.0 funktioniert das Iconify leider nicht. Es tut mir leid, daž Sie momentan mit diesen Fehlern leben mssen, ich werde sie sofort verbessern, wenn die neue SysGem-Version kommt. 8 Online-Hilfe ============== Tel-Update verfgt ber eine kleine Online-Hilfe, die mit Hilfe von Holger Weets' ST-Guide realisiert wurde. Um sie nutzen zu k”nnen, mssen Sie lediglich ST-Guide (liegt Tel-Update bei) installieren und den Tel-Update-Hypertext (das sind die Dateien TELUPD.HYP und TELUPD.REF) in Ihren GUIDES-Ordner kopieren. Wenn Sie jetzt im Haupt- Dialog oder im Anzeige-Fenster die Help-Taste drcken, gibt es eine kleine šbersicht der wesentlichen Funktionen. ST-Guide ist Freeware mit Bitte um eine Spende. Ich kann Sie hier nur dringend bitten, dieser Bitte nachzukommen, wenn Sie ST-Guide wirklich nutzen. ST-Guide geh”rt zu den meistgenutzten Programmen auf Atari-Rechnern, trotzdem ist laut Holger Weets die Spendenmoral der Benutzer alles andere als ausgewachsen. Es w„re schade, wenn Holger Weets sich irgendwann entschl”sse, ST-Guide nicht mehr weiter zu entwickeln. Tragen Sie also zur Weiterentwicklung mit bei und spenden Sie. A Vorschl„ge ============ Sollten Sie irgendwelche Vorschl„ge fr Verbesserungen oder gar Fehler an Tel-Update bemerkt haben, freue ich mich natrlich sehr, wenn Sie mir diese mitteilen. Die Benutzer meiner Programme wissen, daž ich zwar oft sage "Das kann ich nicht machen, das ist zu viel Arbeit", mich dann aber nach etwas Nachdenken doch daransetze, das Gewnschte zu programmieren. B Bezugsquellen =============== Die aktuelle Version von Tel-Update kann man auf jeden Fall in den folgenden Boxen erhalten: ù Maus OL (0441) 9699081 ù Maus RS (02191)348616 ù Maus W (0202) 7387524 Das Archiv hat den Namen TELUPDXX.LZH. XX ist hierbei die Release- Nummer. C Dank ====== Da meine Dankes-Hymnen sicher nicht berm„žig interessant sind, will ich mich hier kurz fassen (zu jedem nur ein Satz): ù Rainer Wiesenfeller @ RS fr die Auswahl der Grafik, die Icons und Bearbeitung des Haupt-Dialoges. ù Andreas Pietsch @ WI2 fr seine Lib SysGem, ohne die dieses und praktisch jedes andere Programm von mir nicht entstanden w„re. D Weitere Programme =================== Falls es jemanden interessieren sollte, ich habe noch mehr programmiert. Alle Programme sind ber die Bezugsquellen zu erhalten, Informationen erhalten Sie bei Christoph Spengler @ RS oder Rainer Wiesenfeller @ RS. Hier in loser Reihenfolge die verschiedenen Projekte: ù Gewicht V2.01, ein Programm zur Di„t-Untersttzung. T„gliche Gewichtseingabe, grafische Ausgaben auf Bildschirm und Drucker, Statistik, Idealgewicht, Lebensmitteldatenbank mit ber 1600 Eintr„gen. (Shareware, 20,- DM) ù Dialler V2.25 - w„hlen Sie richtig, ein Anwahlprogramm, das sich auch als kleine Adreždatenbank verwenden l„žt, einstellbare Wahlwiederholung, Gebhrenanzeige, Vormerkliste, umfangreiche Suchfunktion. (Shareware, 10,- DM) ù SaveDesk V0.9 - hiermit k”nnen Single-TOS-Benutzer ihre DESKTOP.INF bzw. NEWDESK.INF auf einen beliebigen Pfad schreiben und einlesen, mit Backup-M”glichkeit und optionalem Schreibschutz. (Freeware) ù Font-Print - zum Erstellen von Font-Listen, druckt alle installierten Fonts unter Benutzung des jeweiligen Fonts zweispaltig aus, Voraussetzung ist NVDI oder GDOS. (E-Mail-Ware) ù DomesTOS - die GEM-Shell fr Katzenklo. Einlesen bestehender KATZKLO.DATs, Bearbeitung im Makro- und Expert-Modus, Abfangen diverser Konfigurationsfehler, Preview der erstellten Datei im Fenster, Teststart von Katzenklo aus dem Programm heraus und vieles mehr. (Shareware, 10,- DM) ù Remarker - Notizen in ST-Guide. Mit Remarker k”nnen Sie („hnlich wie bei der Windows-Hilfe) zu Hypertext-Seiten Notizen machen. Das Programm steht in st„ndiger Verbindung mit ST-Guide und kann von da aus per Hotkey aufgerufen werden. Suchen in Bemerkungen zu einem Hypertext und vieles mehr... (Freeware mit Spendenbitte)