


                                  NNTP-SHOW
                                 ===========

                      written by Jochen Sarrazin, DG6VJ
                                 Version 1.51




NNTP-Show ist ein Programm, mit dem man Mails aus dem NNTP-Forward angucken
und verschicken kann. NNTP-Followup's und SMTP-Replys knnen ebenfalls 
versendet werden.
Dieses Manual erhebt keinen Anspruch auf Vollstndigkeit. Sollte jemand Lust
haben, ein besseres zu schreiben: NUR ZU!



1. Nutzungsbedingungen:
-----------------------
   Das Programm ist Ham-Soft. Kommerzielle Nutzung ist nicht gestattet!
   Es darf NUR vollstndig mit ALLEN Files weitergegeben werden!
   Fr eventuelle Schden bernehme ich keinerlei Haftung. (Mein Rechner
   funktioniert trotzdem noch, hi)
   Es drfen keinerlei Kosten verlangt werden!!!
   nderungen am Programm sind ohne meine ausdrckliche Erlaubnis NICHT(!)
   gestattet! Individuelle Parameterisierung ist hiervon natrlich aus-
   genommen.


2. Dateien:
-----------
  HISTORY.TXT     berblick ber die Geschichte des Programms
  NNTPSHOW.EXE    Das eigentliche Programm
  NNTPSHOW.CFG    Das Konfigurations-File (Siehe auch Punkt 2)
  NNTPSHOW.TXT    Dieses Textfile, noch nicht sehr gro, wird kontinuierlich
                  erweitert
  NNTPSHOW.LST #  Hier wird eine Liste von Stationen gespeichert, zu denen
                  beim SMTP-Forward schnell zugegriffen werden kann. (ohne
                  mhsames Eintragen per Hand jedesmal)
  NNTPLIST.DAT #  Hier kann fr jede Newsgroup eine Lifetime angegeben werden.
                  Nach Ablauf dieser Lifetime wird die Mail automatisch als
                  gelscht markiert.
  NNTPSHOW.LES *  Mit diesen Files kontrolliert, ob Posts als gelesen markiert
                  sind oder nicht.
  NNTPSHOW.TMP *  Beides temporre Files, die bei jedem Gebrauch berschrieben
  NNTPSHOW.$$$ *  werden.

  * = Files werden vom Programm selbst angelegt
  # = Fr den Betrieb nicht unbedingt ntig


3. Features:
------------
   - Kleine Oberflche mit Rhmchen etc, hi
   - Umlautwandler bei eigenen Posts
   - SMTP-Reply auf eine NNTP-Mail (PCElm mu nicht vorhanden sein)
   - Post der selben Mail in mehrere Newsgroups
   - Follow-Ups
   - nur wirklich vorhandene Posts werden angezeigt
   - Quoting-Zeichen knnen selbst gesetzt werden
   - Crossposts in eine/mehrere Newsgroups
   - Abspeichern von Posts in einem File mit eigenem Namen
   - Mails physikalisch von der Platte lschen
   - 7plus-Dump in ein eigenes Verzeichnis oder in das aktuelle
   - Sortieren der Mails nach dem Sendedatum oder der Empfangs-Reihenfolge
   - Weitersenden von NNTP-Mails zu anderen Stationen per SMTP
   - Automatisches Lschen der Mails nach Ablauf einer, fr jede Newsgroup
     unterschiedlich einstellbaren, Zeit.
   - Farbiges Darstellen von Zeilen, die gequotet wurden ('>' oder ':' am
     Anfang
   - Statistik-Mglichkeit
   - Batch-Posting
   - Such-Funktion
   - etc etc etc...


4. Konfiguration:
-----------------
  Zuerst mu NNTPSHOW.CFG editiert werden. Meine eigenen Angaben mssen
  in Deine umgeschrieben werden. Dieses File ist selbsterklrend (mte es
  eigentlich sein, hi). Die Reihenfolge der Zeilen ist egal, Kommentare
  sollten mit '#' eingeleitet werden.

  Des weiteren kann ein Verzeichnis angegeben werden, in dem temporre
  Files gespeichert werden. Diese Information wird aus der Umgebungsvariable
  TEMP gewonnen. Dafr am Besten in AUTOEXEC.BAT   SET TEMP=C:\TEMP   oder
  ein anderes Verzeichnis angeben.
  
  NNTP-Show kann noch aus 2 weiteren Files Informationen bekommen:

  - NNTPLIST.DAT     Hier kann fr jede Newsgroup eine eigene Lifetime
                     definiert werden. Syntax: <newsgroup> <lifetime>
  - NNTPSHOW.LST     In diesem File knnen bis zu 50 SMTP-Pfade angegeben
                     werden, an die oft NNTP-Mails weitergeleitet werden.
                     Sie drfen bis zu 50 Zeichen lang sein. Hierdurch
                     mssen oft benutzte Stationen nicht jedesmal komplett
                     neu eingetragen werden.


5. Betrieb:
-----------
  Das Programm wird mit dem Befehl NNTPSHOW gestartet. Wenn das Programm
  jetzt meckert, das Files fehlen knnen diese auch einfach leer angelegt
  werden. POINTER, HISTORY und ACTIVE mte NOS selbst anlegen. Im File
  NEWSGROU knnen kurze Beschreibungen zu den Newsgroups abgelegt werden.
  Ein Beispiel-File liegt NNTP-Show bei. (Diese Texte werden regelmig
  in der Newsgroup ampr.active gepostet!)
  Jetzt werden alle Newsgroups durchsucht, die Anzahl der vorhandenen Mails
  und die Anzahl der neuen Mails gespeichert. (Kann bei groen Datenbestnden
  etwas dauern.)

  Jetzt bekommen Sie eine Liste, die die vorhandenen Newsgroups angezeigt. Ganz
  Links die Anzahl der neuen Mails, daneben die Anzahl der vorhandenen Mails.

  Wollen Sie jetzt den Inhalt einer Newsgroup angezeigt bekommen, mu der
  Cursor auf der Newsgroup stehen. Wird dann RETURN gedrckt, durchsucht
  das Programm alle Files aus der angegebenen Rubrik und speichert die Titel,
  Absender etc. der Mail.

  Gelesen werden kann eine Mail durch simples bettigen der RETURN-Taste.


6. Posts:
---------
  Soll in eine Newsgroup gepostet werden, mu die Taste 'P' gedrckt werden.
  Der Rechner fragt jetzt die Newsgroup, das Subject der Mail und die
  Distribution ab. Standardvorgabe fr die Newsgroup-Angabe ist die aktuelle
  Newsgroup. Soll die Mail in mehrere Newsgroups geschickt werden, mssen
  die Newsgroups per Komma getrennt werden. Dann wird der Header mitsamt
  des Signature-Files in den Editor geladen. Jetzt kann der Text eingegeben
  werden. Bitte nach dem Header unbedingt eine Zeile frei lassen und den
  Header NICHT ndern! Wird jetzt der Editor verlassen und auf die folgende
  Frage (posten j/n) mit J geantwortet, ist die Mail unterwegs. Soll die
  Mail abgeschickt werden, muss im NOS der Parameter NNTP IHAVE auf 1 oder 2
  stehen. Ist dies nicht der Fall, geht die Mail NICHT ab!!

  Daneben gibt es noch die Mglichkeit, sogenannte Batch-Posts zu machen.
  So kann irgend ein Textfile (auch 7plus) auf der DOS-Ebene verschickt werden.
  Hierzu mu in der ersten Zeile des Files der gewnschte Titel stehen.
  Jetzt wird NNTP-Show mit  NNTPSHOW /P <Newsgroup> <Filename>
  Das Programm verschickt jetzt das angegebene File an die Newsgroup mit
  dem Titel, der in der ersten Zeile des Files steht.


7. SMTP-Replys:
---------------
   Soll ein SMTP-Reply an an eine Station geschickt werden, mu der Cursor
   auf die entsprechende Mail gestellt werden und dann R eintippen. Wenn die
   Mail mitgeschickt werden soll (z.B. um sich auf Teile daraus zu beziehen),
   dann mu die folgende Frage mit J beantwortet werden. Bitte den Header
   NICHT ndern!!
   Ist in der NNTP-Mail, auf die sich das Reply bezieht, keine Reply-To: -
   Zeile enthalten, so wird der Inhalt der From: - Zeile der NNTP-Mail zum
   Empfnger der SMTP-Mail.
   Mit der weiteren Verteilung der SMTP-Mail ist das NOS zustndig. Hier
   mu natrlich auch alles richtig configuriert sein.


8. Mails lschen:
-----------------
   Soll eine Mail gelscht werden, so kann das mittels L-Kommando gemacht
   werden. Nach der Sicherheitsabfrage ist die Mail physikalisch von der
   Festplatte gelscht! Es werden keine Systemfiles (History, Archive...)
   angerhrt. Soll die Mail wieder undeleted werden, so kann dies nur unter
   DOS mit dem Kommando UNDELETE gemacht werden!

   Daneben gibt es noch eine andere Mglichkeit, Mail zu lschen:
   Sie markieren die zu lschenden Mails mit ENTF. Bei Verlassen der News-
   group wird die Mail entgltig gelscht - nach einer Sicherheitsabfrage.
   Wenn Sie es sich vorher doch anders berlegt haben, knnen Sie mit EINFG
   alle Lsch-Markierungen auf einmal lschen.


9. Weiterleiten von NNTP-Mails per SMTP:
----------------------------------------
   Wenn eine NNTP-Mail auch fr andere Stationen interessant scheint, kann
   diese auf Knopfdruck per SMTP weitergeleitet werden, wenn diese Station
   kein NNTP kann.
   Hierzu mu der Cursor auf die weiterzuleitende Mail gestellt und F2
   gedrckt werden. Jetzt wird der SMTP-Pfad eingegeben. Wenn vorher eine
   Liste mit Pfaden angegeben wurde, kann diese Angezeigt werden, indem
   kein Pfad angegeben wird, also direkt RETURN drcken. Die Pfade werden
   im File NNTPSHOW.LST angegeben. Es sind bis zu 50 Pfade mit je 50 Zeichen
   Lnge mglich. Weitere Zeilen bzw. Spalten werden abgeschnitten.


10. Suchen:
-----------
   In der Newsgroup-Liste kann mit F4 ein Fenster geffnet werden, in dem
   alle ntigen Einstellungen fr die Such-Funktion gemacht werden knnen.
   In den einzelnen Feldern kann mit TAB und SHIFT-TAB geblttert werden.


10. Tasten innerhalb des Programms:
-----------------------------------
  10.1 Newsgroup-Liste:
       N      Erffnet eine neue Newsgroup
       P      zum Posten einer Mail in die markierte Newsgroup.
       F1     Hilfe
       F3     Statistik
       F4     Suchen
       TAB    Springt in die nchste Rubrik mit neuen Mails.
       ESC    Beendet das Programm
       ALT-X  Beendet ebenfalls das Programm

  10.2 Mail-Liste:
       H      Diese Taste zeigt den Header des Files an, auf dem der Cursor
              steht.
       R      Schickt ein SMTP-Reply an den Autor der Mail, auf dem der Cursor
              steht.
       U      Markiert die aktuelle Mail (Cursorposition) als ungelesen.
       Y      Markiert die aktuelle Mail als gelesen.
       F      Postet ein Followup zur aktuellen Mail in die aktuelle Newsgroup.
       T      Markiert alle Files in der aktuellen Newsgroup als gelesen.
       N      Markiert alle Files in der aktuellen Newsgroup als ungelesen.
       S      Speichert die markierte Mail unter einem anderen Dateinamen auf
              der Festplatte ab. (Soll dies nicht ins aktuelle Verzeichnis ge-
              schehen, mu ein Verzeichnis mit angegeben werden.)
       P      Postet eine Mail in die aktuelle Newsgroup
       L      Lscht eine Mail physikalisch von der Festplatte
       X      Crosspost einer Message in eine/mehrere Newsgroups
       B      Umschalten zwischen Scrollen und Umbruch-Anzeige einer Mail
       7      Speichert 7plus-Files automatisch mit richtigen Dateinamen ab
              (7plus-dump)
       F1     Hilfe
       F2     Forwardet eine NNTP-Mail per SMTP weiter
       ESC    Zurck in die Newsgroup-Liste
       ALT-X  Beendet das komplette Programm
       ENTF   Message als gelscht Markieren
       EINFG  Alle gelscht-Flags entfernen

  10.3 Mail-Betrachtung:
       S      Speichert die Mail unter einem anderen Dateinamen ab.
       Cursor Scrollen im Text
       CTRL+Cursor  Scrollen von 10 Zeichen auf einmal
       F1     Hilfe
       ESC    Zurck in die Mail-Liste
       ALT-X  Beendet das komplette Programm


11. Neue Features, nderungen usw:
----------------------------------
  Sollte noch jemand eine Funktion vermissen - bitte Mail an mich. Ich bin
  fr jede Anregung dankbar.
  Auerdem habe ich nix dagegen, wenn ein User ein eigenes Manual verfasst.
  Evtl. lege ich es auch spteren Versionen bei. Einfach mal an mich schicken.


12. Sonstiges:
-------------
  - Der Newsreader holt sich die Anzahl der vorhandenen Mails NICHT aus der
    Datei ACTIVE sondern zhlt alle Files '*.' in den einzelnen Directories
    durch. Deshalb bitte in den NNTP-Unterverzeichnissen, in denen die Mails
    stehen, KEINE anderen Files ohne Endung 'reinschreiben!!! Sonst kommt die
    Software durcheinander und es stehen falsche Angaben in der Liste.




BRIGENS:
  Beim 'Raussuchen der berschriften und Autoren der Mails ist SMARTDRV vom
  DOS (oder ein anderer Festplatten-Cache) eine groe Hilfe, d.h. bringt eine
  groe Geschwindigkeitssteigerung! Einfach mal Probieren.



                     Diese Software ist frei kopierbar.
 trotzdem: NNTP-Show Copyright (C) 1994-96 by Jochen Tillmann-Sarrazin, DG6VJ



