0. eDays (eighty Days) - Version 1.2 (Datums-Differenz-Rechner)
   Copyright (C) 2001 Frank Gehde

   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
   published by the Free Software Foundation; either version 2 of 
   the License, or (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public 
   License along with this program; if not, write to the Free 
   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, 
   MA 02111-1307 USA

   ##############################################################
   Auftretende Fehler, Verbesserungen oder Vorschlge bitte
   per eMail an:  gehde@ag-intra.net
   ##############################################################

1. Was ist eDays ?
   eDays steht fr eightyDays und berechnet, wie der Name schon 
   sagt 80 Tage Differenzen zu gegebenen Datumseingaben. Haupt-
   schlich ist das Programm dafr gedacht, Verfallsdaten zu be-
   rechen. 

2. Verwendung von eDays
   eDays ist einfach zu bedienen. Nach dem Start findet man bereits
   ntzliche Informationen. Unterhalb des Berechnen-Button wird das 
   heutige Datum, sowie das letzte gltige Verfallsdatum angezeigt. 
   Damit sieht man diese Grenze auf den ersten Blick.

   Nun kann man noch ein Datum eingeben. Dies empfiehlt sich zB bei 
   telefonischen Anfragen. Nach Bettigen der Taste [Return], oder 
   Anklicken des Berechnen-Buttons, wird das Alter in Tagen ausge-
   rechnet, sowie das Datum, an dem das dazugehrige Verfallsdatum 
   abluft.

   Sollten es fehlerhafte Eingaben geben, so verweigert das Datums-
   feld automatisch die Annahme der Eingabe, oder im Extremfall
   wird eben in der Statuszeile angezeigt, da etwas mit dem einge-
   gebenen Datum nicht stimmt.

   Daten in der Zukunft knnen brigens zur Zeit nicht eingegeben 
   werden, was aber fr den Anwendungszweck nicht hinderlich sein
   drfte.

   Was evtl. zu etwas Verwirrung fhren knnte, sind die beiden
   Felder "Stichtag dazu:" Hier sollte man nur daran denken, da
   das obere sich auf das Datum im Eingabefeld bezieht, und ein 
   Datum in der Zukunft anzeigt, nmlich das Datum an dem 80 Tage 
   vergangen sein werden, in Bezug auf das eingegebene Datum.
   Der untere Stichtag bezieht sich immer auf Heute und zeigt ein
   Datum in der Vergangenheit an. Nmlich das Datum von Produkten
   vor 80 Tagen, die am heutigen Tage verfallen.

3. Installation von eDays
   eDays wird als Zip-File ausgeliefert. In diesem Zip-File sind 
   normalerweise mindestens folgende Dateien enthalten:

   Edays.jar
   readme.txt
   license.txt

   (In einigen Distributionen sind die Sourcecodes enthalten sowie
   Dokumentationen in anderen Formaten. Sollten die Sourcecodes
   fehlen, finden Sie diese unter http://www.ag-intra.net/edays/)

   Es gibt leider kein Installationsprogramm (wie etwa setup.exe 
   oder so).

   Erster Schritt:
   eDays ist ein Java-Programm. Sollte man zur Zeit weder das JDK 
   (Java Development Kit) oder die JRE (Java Runtime Enviroment) ab 
   der Version 1.2 auf seinem Rechner installiert haben, so mu min-
   destens erst das aktuelle JRE unter www.javasoft.com herunterge-
   laden und nach den dortigen Anweisungen installiert werden. Wer
   dies schon hat, kann diesen ersten Schritt berspringen.

   Zweiter Schritt:
   Am besten legt man vor der Installation an der gewnschten Stelle 
   ein Programmverzeichnis 'edays" an. Beim Entpacken des Zip-Files 
   whlt man als Zielverzeichnis eben dieses Verzeichnis. Nach dem 
   Entpacken kann eDays ab Windows 98 oder bei einem entsprechend
   konfiguriertem Linux-Kernel einfach durch Doppelklick (bzw. Aufruf)
   gestartet werden. Alternativ kann man eDays z.B. ber die MS-DOS 
   Eingabeauforderung durch Eingabe von

   java -jar Edays.jar

   starten (dieser Aufruf sollte auch unter Linux/Java1.2 funktionieren
   (nicht getestet)).

   Bequemer ist das Erstellen einer Verknpfung auf dem Desktop, im
   Startmen oder im Launchbar (Windows). Dazu erstellt man an eben der
   gewnschten Stelle einfach eine Verknpfung zu Edays.jar. Ein 
   Doppelklick auf diese Verknpfung startet eDays nun auch. Vorteil-
   haft (je nach dem, wie man es sieht) ist, da man der Verknpfung
   ein eigenes Icon zuweisen kann, wofr sich das ggf. mitgelieferte 
   Icon anbietet (sieht am besten auf dem Desktop in 32x32 Pixel aus).
   Sollte es Probleme dazu geben, so knnte es sein da Ihre Class- und
   Pathpfade nicht richtig gesetzt sind. Abhilfe dazu finden sie unter

   http://www.javasoft.com
   oder
   http://www.ag-intra.net/java-bsp1.html#pfade

   Beim Installieren der JRE werden die entsprechenden Pfade aber
   normalerweise korrekt gesetzt.

4. Fehler in eDays 1.2
   Keine Software ist fehlerfrei. eDays ist es fast: ) Es ist ja auch
   berschaubar. Denoch ist es nicht zu vermeiden, da bestimmte In-
   konsistenzen auftreten, die aber den Programmablauf nicht beein-
   trchtigen.
   a. Die Datumsangaben und -berechnungen sind korrekt soweit mir
      bekannt ist. Wird eDays im Hintergrund lnger offengehalten, so
      springt das angezeigte heutige Datum und der Stichtag dazu 
      um Mitternacht auf den entsprechenden neuen Wert. Dabei kann es 
      jedoch zu Verzgerungen von bis zu 5 Minuten kommen, da die
      Aktualisierung nur alle 5 Minuten geprft wird (um Rechenlast zu 
      vermeiden).
   b. Weitere Inkonsistenzen knnen bei dem Eingabefeld auftreten. Es 
      ist als spezielles Eingabefeld fr Datumsangaben im deutschen
      Datumsformat programmiert. Whrend der Eingabe wird bereits 
      darauf geachtet, da nur Ziffern eingegeben werden, und an den
      entsprechenden Stellen auch nur theoretisch mgliche Ziffern. Da
      jedoch bei der Eingabe noch nicht erkannt werden kann, welches 
      Datum am Ende dort stehen soll, kann es zu so unsinnigen Eingaben
      kommen, wie z.B. "31.02.2000". Dies wird jedoch vor der Berechnung
      der entsprechenden Stichtage etc. abgefangen und dann angezeigt.
   c. Kein wirklicher Fehler, sondern zur Zeit ein Feature: Es knnen 
      keine Daten in der Zukunft eingegeben werden. Fr den angestrebten
      Verwendungszweck ist das ausreichend. Ggf. wird diese 
      Beschrnkung in Zukunft jedoch aufgehoben. Mal schauen.

5. Sourcecode
   Der Sourcecode ist unter http://www.ag-intra.net/edays/ erhltlich.

6. Lizenz
   Die relevanten lizenzrechtlichen Informationen wurden oben unter
   Punkt 0. genannt und sind konkret gltig. Die folgende Zusammen-
   fassung in deutsch dient Ihrer Information. Die zustzlichen Hin-
   weise berhren die Lizenz nicht, mich wrde die Beachtung jedoch
   freuen:

   eDays - eighty Days 1.2 (Datums-Differenz-Rechner)
   Copyright (C) 2001 Frank Gehde

   Dieses Programm ist freie Software. Sie knnen es unter den Be-
   dingungen der GNU General Public License wie sie von der Free 
   Software Foundation in der Version zwei oder(wenn Sie wollen)
   in einer spteren Version verffentlicht wurde. Die Version 2
   ist diesem Programm als Datei 'license.txt' beigefgt. Wenn
   Sie das 'Programm' weitergeben, men die license.txt und diese
   readme.txt mit weitergegeben werden.

   Das Programm wird in der Hoffnung, da es ntzlich ist weiter-
   gegeben, aber OHNE JEDE GARANTIE; insbesondere ohne impliziete
   Garantie der Verwendbarkeit fr irgendeinen bestimmten Zweck.
   Bitte lesen Sie die GNU General Public License fr mehr 
   Details (beigefgte Datei license.txt).

   Sollte aus irgendwelchen Grnden die Lizenz fehlen, schreiben
   Sie bitte an die Free Software Foundation, Inc., 
   59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

   ##############################################################
   Auftretende Fehler, Verbesserungen oder Vorschlge bitte
   per eMail an:  gehde@ag-intra.net
   ##############################################################

   Zustzliche Hinweise:
   Auch wenn edays kein umfangreiches Programm ist, so betrachte ich
   es doch als Projekt. Sollten Sie nderungen an dem Programm durch-
   fhren, so wrde ich mich darber freuen, wenn Sie mir diese in
   geeigneter Form mitteilen wrden. Diese wrden in die hier bereit-
   gestellte Version von Edays einflieen.


7. FAQ
   Hier gibt es hufig gestellte Fragen. Zur Zeit existiert kaum eine.

   a. Warum kann ich keine Daten in der Zukunft berechnen ?

      Die Differenzberechnung basiert auf der Klasse
      DateDifferenceInDays.class. Diese kann zwar schon Daten in der 
      Zukunft berechnen, vertauscht dabei jedoch intern die bergebenen 
      Daten. In der Version 1.0 von eDays kam es dadurch zu vllig 
      falschen Ergebnissen der Fristen bei mehrfacher Anwendung des
      Programms. Durch den Ausschlu zuknftiger Daten ist das Programm
      in der Hinsicht robuster geworden. Es ist theoretisch mglich die 
      Klasse entsprechend zu ndern. Mglicherweise wird dies im-
      plementiert. Dadurch werden aber bestimmte Vorbereitungen fr die 
      Verwendung der Klasse DateDifferenceInDays.class vorgegeben, und
      die Klasse dadurch beschrnkt. Eine Entscheidung ber diese Er-
      weiterung steht noch aus. Wenn Sie dieses Feature unbedingt
      brauchen, mailen Sie eine Begrndung an gehde@ag-intra.net.

8. History
   Hier knnen Sie Vernderungen des Programms nachvollziehen. Nach
   Verffentlichung von Version 1.0.1 wurde die Versionsnummerierung
   Linux-typisch umgestellt. Releaseversionen haben eine gerade Zahl
   nach der ersten Nachkommastelle, und Entwicklerversionen haben eine
   ungrade Zahl. 1.1.2 ist somit eine Entwicklerversion, die nur zu
   Beta-Zwecken verteilt wird, und 1.0 und 1.2 sind echte Release
   Versionen, von denen angenommen wird, da sie ihren Zweck erfllen,
   und keine Fehler haben.


 Version        ffentlich      Beschreibung
 Release 1.2    Verffentlicht  Gem dem Nummerierungsmodell von Linux     
				wird das die Final-Release Version der
				neuen Implementierung. Diese sollte
				soweit Bug-Frei und komfortabel sein.
				Monate ber 13 sind jetzt gesperrt.
				Eingabe von Tagen ber 31 ist verboten.
				Das heutige Tagesdatum wird angezeigt.

 Release 1.1.2 Nicht Verffentlicht
               (Entwicklerversion)
                          	Aktualisiert das 80-Tage-Stichtag-Datum
				automatisch bis sptestens 5 Minuten
				nach Mitternacht. Auerdem wird fr das
				eingegebene Datum der konkrete 80-Tage- 
				Stichtag angezeigt. Wird nur fr Beta-
				Zwecke verteilt.
 Release 1.1.1  Nicht Verffentlicht
                (Entwicklerversion)
                           	Vllig neu geschrieben. Nur noch ein 	
				Eingabefeld. Dieses Eingabefeld besitzt 
				eigenes datumsspezifisches Dokumentmodell. 
				Das Feld wurde um fr Daten ntzliche 
				Methoden erweitert. Wird nur fr Beta-
				Zwecke verteilt.
 Release 1.0.1  Verffentlicht 
                (Update)
                           	Einige Bugs behoben. Funktioniert ganz gut. 
				Als Update verteilt. Noch unkompfortabel. 
				Fhrt ein erstes Dokumentmodell ein, und 
				macht dadurch die Klasse StringCheck 	
				obsolet. Diese Klasse wird ab Version 
				1.0.1 nicht mehr bentigt, da die Funktion 			
				von der Klasse DateFieldDocument.class mit 
				bernommen wird.
				Kann verwendet werden.
 Release 1.0    Verffentlicht
				Erste Version. Ohne Rcksicht auf 
				Verluste verteilt. War noch buggy und 				
				unkompfortabel.Da es zu eben diesem 				
				genannten Zweck programmiert wurde, 
				kann es die Differenz auch nur zum 
				heutigen Tage berechnen. Die Eingabe
				von Daten aus den Jahren 19xx 
				funktioniert auch nicht, da diese 
				inzwischen sowieso zu alt sind. Die
				Eingabe von 99 im Jahrfeld wrde vom
				Programm als 2099 interpretiert werden.				
				Daten in der Zukunft knnen angegeben
				werden, sie werden programmintern 			
				automatisch vertauscht. Es kann aber
				durch die Vertauschung zu einem neuen 
				offset-Datum kommen. 
				Neustart des Programms nach der Be-
				rechnung von Daten in der Zukunft ist
				somit eine Empfehlung von mir.