

                        Der microTalk QWK-Reader
                        ========================

                          By Wolfgang Zweygart


                     V1.08 released on 05.April.1992






Jetzt ist es endlich soweit, Wolfgang gibt die neue Version des 
mT-QWK-Readers frei. Ich habe dabei die Aufgabe, das an sich 
selbstdokumentierende Programm so zu erlutern, da alle damit 
umgehen knnen. Nun denn!

Das Programm ist ein microTalk-Exklusiv, der Autor ist Wolfgang Zweygart

Erreichbar in microTalk I: 0711/813480       (Fnet 321)
ab 1.Mai.92   microTalk I: 0711/628456       (Fnet 321, Tnet 100:110/2)
              microTalk II: 07031/275698     (Fnet 484, Fido 2:248/401)
                                                        Tnet 100:110/1)

Das Programm ist PD, d.h., jeder kann es ausprobieren und benutzen, 
sollte aber fairerweise bei mehrfacher oder lnger andauernder Benutzung 
dem Verein microTalk e.V. einen Obulus in Hhe von 20.- DM zukommen 
lassen, am besten per V-Scheck oder berweisung auf das Vereinskonto 
microTalk bei der Deutschen Bank (BLZ 600 700 70) Konto-Nr. 1363225.

Genug der Vorredereien, schreiten wir zur Erklrung:



I. Sinn und Zweck
----------------

Das Programm dient dazu, neue Messages und File-Beschreibungen, die mit 
einem QMail Programm wie Maxidoor in komprimierter Form erstellt und 
heruntergeladen werden knnen, offline, d.h., nicht in der Box direkt 
sondern daheim am Rechner lesen und beantworten zu knnen. Maxidoor 
erstellt das Paket, man ldt es herunter, beendet den Anruf, ruft den 
mT-QWK-Reader auf, entpackt das Paket, liest in aller Ruhe die Neuheiten 
durch, beantwortet Messages oder gibt neue Messages ein (wie in der Box 
auch) und lt dann vom mT-QWK-Reader ein Antwort-Paket (Reply) erstellen, 
das man beim nchsten Anruf in der Box an das entsprechende Programm 
(Maxidoor) hochldt. Dieses sortiert nach dem Entpacken die Nachrichten 
in die entsprechenden Message-Bases ein. Der Effekt ist, da man sich 
mit viel mehr Ruhe auch grere Nachrichtenmengen durchschauen kann und 
ganz berlegt die eigenen Antworten oder neuen Messages eingeben kann, 
inklusive Zitaten von Originalmessages.



II. Installation
---------------

Man kopiere das Programm- und das Resourcefile in den gewnschten 
Ordner und starte das Programm. mT-QWK legt sich selber einen Ordner 
fr die Antworten und einen Ordner fr die entpackten Daten an.



III. Konfiguration
-----------------

Als erstes sollte man die Pfade fr die verschiedenen Archiv-Pro- 
gramme wie ARC, LHARC usw., sowie die Pfade fr die Daten und die 
Antworten einstellen und abspeichern. Unter dem Menpunkt 'CONFIG' 
finden Sie alles, was es zum Einstellen gibt. Zuerst sollten Sie 
die Pfade (path) zu den Archivprogrammen festlegen. Sie sollten 
ein ARC, ein LHARC und ein ZIP-Programm haben, um fr alle Flle 
gerstet zu sein. Wenn Sie diese Programme nicht haben, so knnen 
Sie diese jederzeit in microTalk I/II herunterladen.
In einer Dialogbox knnen Sie entweder die Pfade selbst eintragen 
oder direkt auf die jeweilige Eingabezeile mit der Maus klicken, 
dann erhalten Sie eine Fileselectorbox um den Pfad einzustellen.

Path to ARC:   Hiermit stellen Sie mit Hilfe der erscheinenden 
               File-Selector-Box den Pfad zu ARC ein.
Path to LHARC: Hier fr LHARC.
Path to STZIP: Hier fr ZIP.

Auerdem knnen sie ihren lieblings Archiver als 'Default' 
markieren.

REP Directory: Hier geben Sie den Pfad fr den Ordner an, in dem 
               mT-QWK die erstellten Antwort-Pakete ablegen soll,
               z.B. der Upload-Pfad Ihres Terminalprogrammes.
QWK Directory: Hier geben Sie den Pfad an, in dem sich die von der 
               Box heruntergeladenen Nachrichten-Pakete (*.QWK) 
               befinden (also Ihr Download-Pfad).

Zuruck zur Menueleiste, hier stehen noch weiter Einstellmglichkeiten 
unter 'Config' zur Verfgung.

Macro Editor:  Hier knnen Sie die Funktionstasten mit beliebigen oft 
               bentigten Texten belegen, die dann auf einen Tastendruck 
               zur Verfgung stehen. Vergessen Sie aber nicht, auch die 
               Returns mit anzugeben. Dies geschieht ber Control-M. Die 
               anderen Steuerzeichen erreichen Sie ebenfalls ber 
               Control-Kombinationen, falls das ntig sein sollte. Es 
               stehen insgesammt 20 Zeilen fuer Macros oder 'Taglines' 
               zur Verfgung.
Charset 7 Bit: Hiermit knnen Sie die Zeichen mit Codes ber 127 
               (also alle Umlaute und das ) von der Verwendung 
               ausschlieen. Es erscheint dann ein Hkchen vor 
               diesem Menpunkt. Es empfiehlt sich in Boxen immer, 
               auf die Verwendung der gertespezifischen Zeichen 
               (Umlaute, , Linien o..) zu verzichten und sie 
               anderweitig zu ersetzen, da nicht alle Leute diese 
               Zeichen auch wirklich als Zeichen empfangen knnen. 
               Bei manchen Rechnern gelten diese Codes als Befehle 
               und deren Besitzer erleben dann oftmals seltsame 
               Effekte. Die Umlaute und das  werden bei dieser 
               Funktion automatisch durch Buchstabenkombinationen 
               ersetzt (ae, ue, oe, ss).
Fonts:         Hier knnen Sie eine andere Buchstabengre einstellen. 
               Wenn Sie zustzlich den GDOS-Treiber in Ihrem System 
               geladen haben, knnen Sie hier weitere Zeichenstze 
               auswhlen. Proportionale Zeichenstze sind fr die 
               Darstellung im QWK-Reader nicht geeignet.
Save Config:   Damit speichern Sie alle Einstellungen ab, die beim 
               nchsten Programmstart automatisch wieder geladen 
               werden. Vergessen Sie dies, dann war die Arbeit bis 
               jetzt umsonst.



IV. Hilfe
--------

Sollten sie zum mT-QWK-Reader eine Hilfe bentigen, so knnen Sie eine 
Kurzfassung unter dem Menpunkt 'READER' in microTalk Reader mit dem 
Button HELP erhalten.



V. Wie arbeite ich nun mit dem mT-QWK? 
--------------------------------------

V.1 Menpunkt 'FILE'
====================

Find QWK:   Whlen Sie hiermit das *.QWK-File aus, welches Sie  
            bearbeiten wollen. Sollte noch ein altes QWK vorhanden 
            sein, so fhren Sie bitte erst ein 'TIDY UP' durch. 
            Dabei werden alle alten Daten gelscht. mT-QWK entpackt 
            dann automatisch das Nachrichten-Paket, und stellt fest 
            welcher Packer verwendet wurde. 
Create REP: Wenn Sie alle Nachrichten von Ihnen, Ihre Antworten 
            und Ihre neuen Messages fertiggestellt haben, die Sie 
            das nchste Mal an die Box abschicken mchten, dann 
            erstellen Sie das Paket mit diesem Menpunkt. Sie 
            finden dann das *.REP File in dem unter REP-Directory 
            angegebenen Pfad.
OPEN:       Mit diesem Punkt ffnen Sie die bersicht ber die 
            empfangenen Nachrichten und knnen die Message-Base 
            mit einem Klick aus der Liste auswhlen, die Sie als 
            nchstes bearbeiten mchten. Message-Bases, die neue 
            Nachrichten enthalten, sind mit einem * vor dem Namen 
            gekennzeichnet. Sie blttern durch die Liste mit den 
            Pfeilen, wie Sie es von anderen Fenstern auch gewhnt 
            sind. Mit 'Read all' knnen alle neuen Nachrichten in 
            allen vorhandenen Areas (Message Bases) gelesen 
            werden. Wenn Sie am Ende der Nachrichten einer Message 
            Base angelangt sind, wird automatisch in die Nchste 
            weitergeschaltet.
New Files:  Statt Nachrichten aus Message-Bases knnen Sie hier 
            die Kurzbeschreibungen von neuen Files aus dem File- 
            system anschauen. Mit dem Pfeil knnen Sie zur nch- 
            sten Seite weiterblttern.
Confmail:   Wenn in Ihrem Qmail-Paket ein Fmail/Confmail- File enthalten 
            war, so knnen Sie es unter diesem Menuepunkt in ein anderes 
            Directory verschieben oder kopieren.
Bulletins:  Hiermit knnen Sie andere Textfiles und Mitteilungen die von 
            der Mailbox Ihrer Wahl den Qmail-Packet mitgegeben wurden 
            lesen.
Tidy Up:    Wie schon erwhnt werden hiermit die entpackte Dateien 
            des zuletzt bearbeiteten QWK-Files gelscht.
TOS Shell:  Fr die Leute, die gerne mit Shells arbeiten. Hier ist 
            die Mglichkeit, den Commandointerpreter aufzurufen.
            Dazu mu eine Shell im System installiert sein (ist z.B. 
            unter Gemini der Fall). Damit ist es auch mglich fr 
            lngere Nachrichten einen externen Editor aufzurufen, 
            der Nachrichtentransfer luft dann ber das sogenannte 
            CLIPBOARD.
QUIT:       Damit verlassen Sie den mT-QWK-Reader. Alle Messages, auch
            die eigenen, bleiben erhalten.



V.2 Menpunkt 'MESSAGE'
=======================

Wenn Sie mit Open und nachfolgendem Klick auf eine Message-Base die 
Bearbeitung erffnet haben, knnen Sie verschiedene Dinge machen. Mit 
den Cursortasten links und rechts knnen Sie durch die Nachrichten 
blttern (vor und zurck), mit den Cursortasten rauf und runter knnen 
Sie innerhalb einer Nachricht bei lngeren Messages zeilenweise nach 
oben und unten scrollen. Durch klicken auf die Pfeilsysmbole, am unteren 
Rand des Fensters, knnen Sie (abweichend vom blichen GEM) durch die 
Nachrichten blttern.

List Msg's:   Damit knnen sie sich eine Kurzbersicht ber die 
              in einer Message-Base vorhandenen Nachrichten 
              erstellen lassen und dann auswhlen, welche Sie 
              lesen mchten. Sie erreichen das mit einem Klick 
              auf die entsprechende Zeile. Mit den Pfeilen des 
              Rollbalkens und dem Rollbalken knnen Sie durch die 
              Liste blttern.
Search Text:  Damit knnen Sie die Nachrichten nach einem be- 
              stimmten Text absuchen lassen und nur gezielt diese 
              Nachrichten lesen. Wenn Sie 'Ignore Case' anklicken, 
              dann ist die Unterscheidung zwischen Gro- und 
              Kleinschreibung ausgeschaltet. Wenn Sie 'Backward' 
              angeklickt haben, so geht die Suche rckwrts statt 
              vorwrts.
Enter Msg:    Damit knnen Sie eine neue Message in eine Base aus 
              der erscheinenden Liste eingeben. Whlen Sie die 
              entsprechende Base durch einen Klick aus (s. OPEN).
Reply Msg:    Damit knnen Sie eine direkte Antwort auf die gerade 
              gelesene Nachricht verfassen. Der Kopf der Antwort 
              wird automatisch richtig gesetzt. Diese Antwort wird 
              an den Absender gerichtet.
Quote Msg:    Hiermit knnen Sie Zitate aus der Originalnachricht 
              in Ihre Antwort mit einfgen. Diese Zitate werden 
              mit einem > am Zeilenanfang dargestellt. Sie knnen 
              diese Option anstelle von Reply verwenden. Das Zitat 
              wird dann sofort komplett dargestellt.
Edit Header:  Hiermit knnen die den Nachrichtenkopf (from, to, 
              subj) entsprechend abndern. Sie knnen damit auch 
              Messages als Privat markieren, sie knnen dann nur 
              vom Empfnger gelesen werden. MIt Msg to Sysop kn- 
              nen Sie die Nachricht als Private Mail an den Sysop 
              deklariert werden.
Close Window: Hiermit schlieen Sie das oberste Fenster. Beachten 
              Sie, da nicht abgespeicherte Nachrichten (siehe 
              Save Msg) mit dem Schlieen des entsprechenden Fen- 
              sters ebenfalls verlorengehen.
Cycle Window: Hiermit wird das oberste Fenster nicht geschlossen,  
              sondern das darunterliegende Fenster wird zum ober- 
              sten und das oberste wird zum untersten. Dieser 
              Vorgang kann beliebig wiederholt werden.
Save Msg:     Hiermit wird die Message, die Sie gerade eingegeben 
              haben bernommen und beim erstellen des Antwortpa- 
              ketes mit reingepackt. Alle Nachrichten, die Sie 
              erstellt haben und die nicht mit Save Msg beendet 
              wurden, werden nicht in das Antwortpaket bernommen.
Review own:   Mit dieser Funktion knnen die selbst geschriebenen 
              Antworten noch einmal durchgegangen und eventuell 
              gelscht oder nochmals in das Editorfenster gerufen 
              werden.

Im Editor fr die Antworten knnen mit Control-G zwei Zeilen 
miteinander verbunden werden. Mit Control-Y lschen Sie die Zeile, in 
der der Cursor steht, mit der Home-Taste kommen sie an den Textanfang, 
mit Shift-Home an das Textende.



V.3 Menpunkt 'BLOCK'
=====================

Wenn Sie Antworten oder neue Messages eingeben, dann knnen Sie 
auch einige Blockoperationen in Anspruch nehmen.

Begin Block:    Hiermit setzen Sie den Anfang des zu markierenden 
                Blocks auf die Cursorposition.
End Block:      Hiermit setzen Sie das Ende des zu markierenden 
                Blocks auf die Cursorposition.
Cut Block:      Wenn ein Block markiert ist, knnen Sie ihn mit 
                dieser Funktion ausschneiden (verschwindet aus der 
                aktuellen Textposition).
Copy Block:     Wenn ein Block markiert ist, knnen sie ihn mit 
                dieser Funktion an die Cursorposition kopieren. 
                Das Original bleibt erhalten.
Paste Block:    Wenn Sie einen Block ausgeschnitten haben, dann 
                knnen Sie ihn mit dieser Funktion wieder an die 
                aktuelle Cursorposition einkleben.
Um die beiden nachfolgenden Funktionen bentzen zu knnen, mu das 
Scrap-Directory, namentlich die Variable SCRAP im Environment ge- 
setzt sein.
To Clipboard:   Hiermit knnen Sie einen Block oder eine Nachricht in 
                dem GEM- Clipboard ablegen und spter wieder holen. Sie 
                knnen zwischenzeitlich andere Blocks bearbeiten, oder 
                diesen abgelegten Block in einem anderen Programm (via 
                'TOS Shell'- Kommando aufrufen) bearbeiten.
From Clipboard: Hiermit knnen Sie einem im Clipboard abgelegten Block 
                an der aktuellen Cursorposition einsetzen.

Text Import:    Hier kann ein Textblock (max. 400 Zeilen) mit einer 
                Fileselectorbox geholt und an die aktuelle Nachricht 
                angehngt werden.
Text Export:    Eine beliebige Nachricht kann als File abgelegt werden, 
                um sie zur spteren Verwendung aufbewahren zu knnen.
Print Text:     Eine Nachricht oder der Inhalt eines Fensters des QWK-
                Readers kann hiermit auch direkt ausgedruckt werden.


VI. Zusammenfassung der Tastaturkommandos
-----------------------------------------


'^' = Control-Taste
Alt = Alternate-Taste

         'FILE'                 'MESSAGE'                 'BLOCK'
          ----                   -------                   -----

    Alt F - Find QWK         ^ L - List msgs           ^ A - Begin block

      ^ R - Create REP       ^ F - Search msgs         ^ B - End block

    Alt L - Load REP         ^ E - Enter msg           ^ X - Cut block

      ^ O - Open             ^ R - Reply to msg        ^ C - Copy block

      ^ Z - TOS shell        ^ T - Quote msg           ^ V - Paste block

      ^ Q - Quit           Alt Q - Quote msg         Alt W - To clipboard

                             ^ U - Close window      Alt D - From clipbrd

      ( ^ = Control )        ^ W - Cycle window      Alt I - Text Import

                           Alt R - Review own        Alt E - Text Export

                                                     Alt P - Print Text


                             MESSAGE EDITOR
                             --------------

      ^ Y - Zeile lschen    ^ K - Kopf editieren      ^ G - Zwei Zeilen
                                                             verbinden
                             ^ S - Save msg.

      ^ ~ - Zeilen nach oben vertauschen
    Alt ~ - Zeilen nach unten vertauschen

 Clr Home - Top of text                   <Shift> Clr Home - End of text

 ^ Cursor - Zum Anfang bzw. Ende der Zeile


V. Schlubemerkungen
--------------------

Fr Anregungen zur Verbesserung und Erweiterung des mT-QWK-Readers 
ist Wolfgang natrlich immer dankbar, ebenso fr den Hinweis auf 
eventuelle Fehler.

Alle weiteren Features werden Sie im Laufe der Arbeit mit dem mT-QWK 
kennenlernen. Sie haben auf jeden Fall keinen direkten Einflu auf 
die Arbeit mit dem mT-QWK-Reader.

Stuttgart, den 11.01.92

Andreas Mann
microTalk I/II

Ergnzungen fr Version 1.08, Bblingen den 04.04.92

Nachtrag:
---------
In den microTalk Mailboxen (sowie in einigen Fnet Mailboxen) ist z.Z. 
eine englischsprachige 'Help' Konferenz (Area) eingerichtet.

Wolfgang Zweygart

