@database 07906cc0-0
@master Anleitung.guide
@$VER: 1.014
@author "Andreas Rehm"
@(c) "© Andreas Rehm 1994"
@index INDEX
@remark Created with Heddley v1.1 (c) Edd Dumbill 1994

@node "Main" "BER - AmigaGuide Hilfsdatei"

                                   @{b}BER@{ub}

                          @{" Einleitung            " link "Einleitung" 0}  
                          @{" Voraussetzungen       " link "Voraussetzungen" 0}
                          @{" Verwendung            " link "Verwendung" 0}
                          @{" Versionen             " link "Versionen" 0}  
                          @{" Die Theorie           " link "Theorie" 0}
                          @{" SOFTINFO              " link "SOFTINFO" 0}  
                          @{" Copyright             " link "Copyright" 0}  
                          @{" Anschrift des Authors " link "Adresse des Authors" 0}  


 @{u}@{fg shine}BER kann für private Zwecke frei verwendet werden. Kommerzielle Nutzung@{fg text}
@{uu}           @{u}@{fg shine}ohne Zahlung der "Gebühr" von DM 10.- ist untersagt!@{uu}@{fg text}
@endnode

@node "Einleitung" "Einleitung"

                                 @{b}Einleitung:@{ub}

  Was ist eigentlich BER? BER ist ein Programm das für Beamten nützlich
 sein kann. Es berechnet zu einem Datum den Jahrestag, z.B. der 1.1 ist der
 1 Jahrestag; es kann dies natürlich auch in der umgekehrten Richtung.

  Um ein Datum in einen Jahrestag umzurechnen braucht man nur auf die Taste
 @{"Datum -> Jahrestag" link "Verwendung" 0} zu drücken und die Fragen des Programmes beantworten
 und man bekommt das normalerweise richtige Ergebnis. Es sind jedenfalls im
 Laufe der Zeit schon alle Fehler behoben worden, und es könnte eventuell
 bei neuen Funktionen ein Fehler auftreten. Das sollte aber dank der
 Betatester nicht mehr vorkommen!

  Sollten jedoch Fehler auftreten, dann melden Sie sich bitte bei mir.
 (@{"Adresse" link "Adresse des Authors" 0} siehe @{"SOFTINFO" link "SOFTINFO" 0}) 


  @{u}@{fg shine}Features von BER:@{uu}@{fg text}

 - Font sensitiv
 - schnell in seinen Berechnungen
 - relativ kleines Binär File
 - StyleGuide konform
@endnode

@node "Voraussetzungen" "Voraussetzungen"

                              @{b}Voraussetzungen:@{ub}


                 * ReqTools.library (mindestens Version 37+)
                 * DOS 2.xx oder höher
                 * ein schneller Prozessor wäre nicht schlecht, ist aber
                   nicht Voraussetzung -> 68020+
                 * mindestens 90 KB freier Speicher
@endnode

@node "Verwendung" "Verwendung"

                                 @{b}Verwendung:@{ub}

 BER sollte einfach zu bedienen sein. Die GUI (Graphics User Interface) von BER
ist StyleGuide konform.

                               Die Oberfläche:


                          @{"Jahrestag -> Datum" link "JAHRESTAG->Datum" 0}   @{"Information" link "INFO" 0}
                          @{"Datum -> Jahrestag" link "DATUM->JAHRESTAG" 0}   @{"Beenden    " link "Ende" 0}

                          @{"o Monat als Namen anzeigen" link "Monat als Name" 0}
                          @{"o Berechnung für Schaltjahr" link "Schaltjahr" 0}
@endnode

@node "Versionen" "Geschichte"

                                   @{b}Versionen:@{ub}

 V1.000 bis V1.100  - Grundgerüst mit vielen Fehlern.
 V1.120  - erste funktionstüchtige Version.
 V1.121 bis V1.80 - Fehler in den Texten und im Hauptteil behoben.
 V1.188 - Überarbeitete Version ohne Fehler und absolut Bug frei.
 V1.200 - Alle Fehler behoben, neue JUMP Labels und korrigierter Text.
        - Das Programm hat eine geringfügig veränderte Strucktur und ist
          jetzt kürzer!
 V1.201 - Fehler bei EasyRequestArgs() Aufruf behoben.
 V1.2xx bis 1.50 - nicht offizielle Testversionen
 V1.50 - BER hat eine GUI bekommen und der Fehler mit ein paar Daten wurde
         behoben.
 V1.51 - BER hat eine neue, System konforme (Style Guide) @{"Oberfläche" link "Verwendung" 0}
         bekommen.
 V1.52 - BER ist total überarbeitet worden. Ich danke meinen Freunden für
         die Tests und die Korrekturvorschläge. BER ist jetzt kürzer und es
         gibt die Möglichkeit selektiv den Monat als Namen oder Zahl
         anzuzeigen. BER hat neue Konstanten und behält sich immer die
         Ergebnisse.
 V1.53 - BER merkt sich jetzt die Einstellung für den Monatsnamen als
         Konstannte. [-> kein File HANDLE mehr -> BER ist kürzer]
 V1.54 - Berechnung der Woche in das Programm eingefügt. Neuen Versions-
         string in die Programmstrucktur gebracht.
 V1.55 - BER ist jetzt optimiert worden. -> Programm ist etwas kleiner, und
         hat einen neuen Versionsstring. (Der alte hat etwa Platz weg-
         genommen.) Jetzt sind alle Fehleranzeigen auf Requesterbasis.
         Texte sind zum Teil geändert.
 V1.56 - Ein ganz großer Fehler ist jetzt behoben. BER hatte, wegen eines
         Aufteilungsfehlers, das Jahr auf 364 Tage gekürzt. Jetzt sind die
         richtigen Monatsdaten eingegeben.
 V1.57ß- Die Berechnung von Jahresdaten wurde um die Berechnung der Daten
         für Schaltjahre erweitert. Diese Funktion ist als Option
         eingegliedert. (siehe @{"Verwendung" link "Verwendung" 0})
 V1.57 - Berechnung von Jahrestagen optimiert und beschleunigt. Texte zum
         Teil leicht modifiziert. Version STRING korrigiert.
         Neues GUI.
 V1.58 - Neues GUI (Neue EasyGui Version), angepaßt an E3.1a
@endnode

@node "Theorie" "Die Theorie"
                             @{u}@{fg shine}Die Theorie von BER:@{uu}@{fg text}


 Ein Jahr ist aufgeteilt in 365 Tage, 52 (eigentlich 53) Wochen und 12 Monate.
Jede Woche hat 7 Tage; damit kann man die Jahrestage in Wochen umrechnen.

  @{u}Berechnung der Wochen:@{uu}

 label:
 IF Jahrestag<7        ; Wenn die Schleife am Ende ist wird die
  Monat:= Monat + 1    ; Woche dazu gezählt und das Ergebnis ist
 ELSE                  ; die Woche, in der der Jahrestag ist.
  Jahrestag - 7
  Monat:= Moant + 1
  JUMP label           ; Springe an Anfang, um Schleife zu erhalten
 ENDIF

 Die Berechnung der Woche beruht einfach auf der Tatsache, daß eine Woche 7 Tage
hat, und das man dadurch mit einer Schleife, bei der man immer 7 Tage vom
Jahrestag abzieht und eine Woche zu den Wochen hinzuzählt die Woche erhält, in
der der Jahrestag ist.


  @{u}Berechnung des Jahrestages:@{uu}

 Die Berechnung des Jahrestages ist schon etwas komplizierter. Man muß für jeden
Monat eine Art Maske haben, nach der die unterschiedlichen Daten ausgewertet
werden.

 Die Berechnung beruht einfach darauf, daß jeder Monat eine feste Anzahl an
Tagen hat. Diese Anzahl wird als Summe verwendet, um nicht noch extra für jeden
Monat die Anzahl an Tagen im Programm berechnen zu lassen. Es wird also anhand
des Monats, abzüglich 1, die Anzahl an verstrichenen Tagen berechnet, und dann
das Datum (der Tag) addiert und dann erhält man die Jahrestage.


  @{u}Berechnung des Datums:@{uu}

 Die Berechnung des Datums beruht auf der Berchnung des Jahrestages in
umgekehrter Reihenfolge. Nur ist hier die Berechnung noch sehr viel komplexer.
Man hat ja für jeden Monat eine andere Anzahl an Tagen. Es wird also eine
Schleife gemacht, bei der man der Reihe nach die Anzahl an Tagen des
entsprechenden Monats subtrhiert, bis man nur noch eine Anzahl an Tagen hat, die
nicht mehr groß genug ist, um einen anderen Monat abzuziehen. Dann hat man das
Ergebnis des Tages, und man muß für jeden (als Tage) subtrahierten Monat einen
Monat hinzurechen. Das Ergebnis ist dann das Datum
@endnode

@node "SOFTINFO" "Das Informationssystem SOFTINFO"

                                  @{b}SOFTINFO:@{ub}

  SOFTINFO ist ein Informationssystem, das ich als Esatz für Texte
 verwende. Es enthält alle wichtigen Daten.


 ***********************
 * @{"SOFTINFO starten..." system "/SOFTINFO"} *
 ***********************
@endnode

@node "Copyright" "Copyright"

                                  @{b}Copyright:@{ub}

  Das Copyright für dieses Programm liegt ausschlieslich bei dem Author.
 Änderungen am Programm sind untersagt. Hinweise auf Bugs und andere Fehler
 bitte mir zuschicken. (siehe @{"SOFTINFO" link "SOFTINFO" 0})
@endnode

@node "Adresse des Authors" "Adresse des Authors"

                                @{b}Meine Adresse:@{ub}


                                 Andreas Rehm
                               (HAWK-Programme)
                               Kurt-Moosdorf 36
                               63694 Limeshain



           @{i}Für weitere Informationen sehen Sie bitte in@{ui} @{"SOFTINFO" link "SOFTINFO" 0}.
@endnode

@node "JAHRESTAG->Datum" "Verwendung - GUI"
@prev "Verwendung"
Der Knopf Jahrestag -> Datum bewirkt die Umrechnung eines Jahrestages in ein
Datum um. Z.B. 364. Jahrestag in den 12. Dezember.
@endnode

@node "DATUM->JAHRESTAG" "Verwendung - GUI"
@prev "Verwendung"
Der Knopf >Datum -> Jahrestag< bewirkt die Umrechnung von einem Datum in einen
Jahrestag. Z.B. den 1. Januar in den 1. Jahrestag.
@endnode

@node "INFO" "Verwendung - GUI"
@prev "Verwendung"
Zeigt kurze Informationen an.
@endnode

@node "Ende" "Verwendung - GUI"
@prev "Verwendung"
Ende- zum verlassen des Programmes, man kann aber auch das Schließ Sysmbol in
der oberen, linken Ecke zum verlassen verwenden.
@endnode

@node "Monat als Name" "Verwendung - GUI - Option Monat als Name"
@prev "Verwendung"
 Die Check Box >Monat als Namen anzeigen< dient zum (des/)aktivieren der
Funktion von BER, ein Monatsdatum als Monatsnamen anzuzeigen. Das Programm hat
dafür eine kleine Tabelle.
@endnode

@node "Schaltjahr" "Verwendung - GUI- Berechnungsoption Schaltjahr"
@prev "Verwendung"
 Mit dieser Option wird die Berechnung für Schaltjahre aktiviert. Das bedeutet,
daß ab Februar ein Tag mehr eingerechnet wird.
@endnode

@node "INDEX" "INDEX"

                                    @{b}INDEX@{ub}

 @{"Anschrift des Authors" link "Adresse des Authors" 0}
 @{"Copyright" link "Copyright" 0}
 @{"Einleitung" link "Einleitung" 0}
 @{"SOFTINFO" link "SOFTINFO" 0}
 @{"Versionen" link "Versionen" 0}
 @{"Verwendung" link "Verwendung" 0}
 @{"Voraussetzungen" link "Voraussetzungen" 0}
@endnode

