README zum Programm DigestVote
==============================
Programm  : DigestVote
Version   : 0.0.3
Date      : 14.01.1999
Autor     : Karsten Schulz
Kontakt   : kaschu@t800.ping.de
Plattform : Linux 2.0.36, Java JDK 1.1.6, GUI
Aufruf    : java DigestVote
Lizenz    : GPL

Kurzbeschreibung:
 DigestVote vereinfacht die Beurteilung der Beitraege des
 Internet Orakels. Der Digest, der entweder aus der Newsgroup
 de.rec.orakel oder von der Homepage http://olymp.org
 heruntergeladen werden kann, wird von DigestVote so dargestellt,
 dass eine bequeme Beurteilung der Beitraege schon waehrend des
 Lesens vorgenommen werden kann.
 Der Digest sollte als einfache Textdatei auf der lokalen Festplatte
 gespeichert sein. Von dort laedt man ihn in das Programm.
 DigestVote stellt dann ein Inhaltverzeichnis mit den durch-
 nummerierten Beitraegen dar (z.B. 328-01 ... 328-10). Ausserdem
 erscheinen Anfrage und Antwort in getrennten Textfenstern, so
 dass ein bequemes blaettern moeglich ist. Dem jeweiligen Beitrag
 kann eine Beurteilung 1 - miserabel bis 5 - ausgezeichnet zugeordnet
 werden. Sind fuer alle 10 Beitraege des Digest entsprechende 
 Beurteilungen abgegeben, kann diese per Zwischenablage in ein
 Mailprogramm uebertragen werden.
 
Hilfetext:
 Nach dem Start erscheint das leere Programm. Ueber das Menue
 "Datei" - "Digest laden..." kann per Auswahlbox ein Digest
 geladen werden. Links (Liste) und rechts (Buttons) kann
 navigiert werden, in der Mitte ist der jeweilige Beitrag.
 Die Auswahlliste rechts dient der Festlegung der Beurteilung zu 
 dem aktuell angezeigten Beitrag.
 
Das Menue "Datei":
 "Digest laden..."
    einen neuen Digest laden
 "Bewertung ansehen..."  
    (nur aktiv, wenn Digest geladen)
    zeigt in einem kleinen Fenster die aktuellen Bewertungen 
	der Digestartikel an.
 "Optionen..."
    Dialog zum Einstellen der Quotezeichen.(siehe weiter unten)
 "Programminfo..."
    Infobox, wer dieses Programm verbrochen hat
 "Beenden"
    Ende ohne Nachfragen.
 
Optionen:
Mittels "Datei" - "Optionen..." koennen die Quotezeichen geaendert
werden. Die Quotezeichen sind die Zeichen der 1. Spalte, die eine
Frage ">" und eine Antwort "}" kennzeichnen. Anhand dieser Zeichen
erkennt das Programm den Text. Falls es Probleme beim Einlesen
eines Digest geben sollte, kann man hierueber einstellen, ob ein
anderes Quotezeichen benutzt werden soll.

Lizenz:
GPL (siehe LICENSE-Datei)

Arbeitsweise:
 Zunaechst sucht das Programm nach der Zeile "VOTE ", aus der es
 sich die Digestnummer ("XXX") holt. Dann sucht es nacheinander
 eine Zeile, die mit "XXX-" beginnt, das ist der Beginn eines neuen
 Beitrages. Danach sucht das Programm ein Quotezeichen. Findet es
 das Frage-Quotezeichen, dann liest es die Frage ein. Findet es ein
 Antwort-Quotezeichen, liest es die Antwort ein. Falls zu dieser
 Antwort keine Frage existiert, setzt es als Frage die vorhergehende
 ein. 
 Falls das Format der Digest-Datei geaendert wird (z.B. Beginn mit 
 einer Antwort), so ist das Verhalten des Programms undefiniert.

Dateien:
 Quellcode:
   DigestVote.java
   
 Klassendateien:
   DigestVote$1.class
   DigestVote$AboutBox.class
   DigestVote$Artikel.class
   DigestVote$InfoBox.class
   DigestVote$MainMenu.class
   DigestVote$OptionsBox.class
   DigestVote$VoteBox.class
   DigestVote.class
 
 Lizenzbedingungen dieser Software:
   LICENSE
 
 Infodatei (diese hier):
   README

 Ideen fuer Erweiterungen
   TODO

   
Nach dem 1. Programmstart wird eine Datei .digestvoterc im Home-
verzeichnis angelegt. Diese Datei enthaelt die Optionen des Programms.
Bitte nicht manuell aendern. (Es wird in der aktuellen Version mehr 
gespeichert, als man im Programm einstellen kann.)