@database "BEKUNA"
@index inhalt » Inhaltsverzeichnis
@author "Kuno Naumann"
@$VER: BEKUNA.guide V1.3 (21.03.2002)
@wordwrap

@node main "Begrüßungsprogramm BEKUNA"
@toc

 @{b}@{u}@{fg highlight}Begrüßungsprogramm BEKUNA V1.4 (21.03.2002)@{ub}@{uu}@{fg text}

        @{"Was kann das Programm?" link über}
        @{"Was brauche ich?" link benötigt}
        @{"Wie wird es installiert?" link install}

     @{b}Daten Ein- und Ausgabe@{ub}

        @{"Daten eingeben" link eingabe}
        @{"Daten anzeigen" link anzeige}

     @{b}Das Hauptfenster@{ub}

        @{"Ereignis-Meldungen" link meld}
        @{"Das Projekt-Menü" link pmenü}
        @{"Einstellungen" link einstell}
        @{"Schnellwahl-Knöpfe" link schnell}

     @{b}Sonstiges@{ub}

        @{"Zum Programm" link allgemein}
        @{"Danksagung" link dank}
        @{"Wer hat's gemacht?" link autor}

@endnode
@node über "Eigenschaften"
@toc

  @{b}Was kann das Programm?@{ub}

- Begrüßung abhängig von der Tageszeit.
- Aktuelle Anzeige von Datum, Uhrzeit, Sommerzeit, Mondphase und Sternzeichen.
- Meldung von Geburtstagen und Ereignissen.
- Berechnung und Meldung aller Feiertage und vieler Gedenktage.
- Automatische Umschaltung auf Sommerzeit und zurück.
- Tonmeldungen bei bestimmten Ereignissen.
- Start von Programmen, beim Auftreten von bestimmten Ereignissen.
- Kalender
- Mondgrafik
- viele Einstellmöglichkeiten

@endnode
@node benötigt "Anforderung"
@toc

  @{b}Was brauche ich?@{ub}

- Einen Amiga mit OS3.0 oder höher.
- Für OS3.0 / OS3.1 wird ClassAct und AWNPIPE benötigt.
- RexxMast muss laufen, von der Startup-Sequence aus.
- Etwa 250KB freien Platz auf der Partition SYSTEM:
- Etwa 1-2MB freies RAM.
- 68020 CPU

@{u}Empfohlen:@{uu}

- mind. OS3.5
- mind. 68030
- Grafikkarte
- mind. 8MB RAM

Ein Amiga mit OS3.9 und Boingbag39-1

@{u}Für OS3.0 und OS3.1@{uu}

- ClassAct

Ich habs getestet mit ClassAct2Demo aus dem AMINET.
Dabei treten ein paar kleine GUI-Fehler auf. Ist aber voll funktionstüchtig.

- AWNPIPE Version 2.54 (http://web.ukonline.co.uk/awnpipe/)

@{u}Für OS3.5@{uu}

- AWNPIPE Version 2.54 (http://web.ukonline.co.uk/awnpipe/)
- RexxMathLib.library ab Version 38 (AMINET)
- RexxTricks.library ab Version 38 (AMINET)

@{u}Für OS3.9@{uu}

- RexxTricks.library ab Version 38 (AMINET)

@{u}ACHTUNG!@{uu}

BEKUNA läuft nur korrekt, bei einem vollständig installiertem Betriebssystem. Auch Startup-Sequence überprüfen!
Bei Path müssen die Einträge REXX: und SYS:Rexxc vorhanden sein!

RexxMast muss laufen, von der Startup-Sequence oder der User-Startup aus.
Es muss der Eintrag:
SYS:System/REXXMast >NIL:   oder  REXXMast >NIL:
vorhanden sein.

Nicht in der WB-Startup!

@{u}@{b}Erfolgreich Getestet auf folgenden Rechnern:@{uu}@{ub}

Amiga 1200
OS3.0
CPU 68020 28MHz + FPU
4 MB-FAST-RAM
PAL-Bildschirm + max. Overscan (Auflösung: 724x283)
mit Topaz/8-FONT
ClassAct2Demo
AWNPIPE V2.54

Amiga 4000
OS3.9
CPU 68040 25 MHz
16 MB-FAST-RAM
Grafikkarte (Auflösung: 824x618)

PC mit WINUAE
OS3.9

@endnode
@node install "Installation"
@toc

  @{b}Wie wird es installiert?@{ub}

Ein Doppelklick auf "Install" installiert das Programm in die richtigen Schubladen.
Auch für Update-Installation!
Bitte auch alle Installationshilfen lesen!

  @{b}Was wird alles installiert?@{ub}

Begrüßung --> WBStartup
Begrüßung.info --> WBStartup   (Update)
(Auch Start über User-Startup möglich.)

BEKUNA.rexx --> REXX:   (Update)
showtx --> REXX:   (Update)
errord --> REXX:
frage --> REXX:

Verzeichnis Einfarbig --> Sys:Prefs/Presets/Patterns/
Verzeichnis REXX:Daten wird angelegt.
Smiley1 --> REXX:Daten
Smiley2 --> REXX:Daten
MondanimZ --> REXX:Daten
MondanimA --> REXX:Daten

Wenn nicht vorhanden:
Rexxtricks.library V38 --> Libs:
Rexxmathlib.library V38 --> Libs:

REXX: ist Standardmäßig das Verzeichnis S:
kann aber auch, nach ändern der Startup-Sequence, ein eigenes Verzeichnis sein.

@endnode
@node eingabe "Eingabe"
@toc

  @{b}Daten eingeben@{ub}

  Die Dateneingabe erfolgt über das Menü "Daten eingeben".

        @{"Geburtstage" link gein}
        @{"Vergangene Ereignisse" link vein}
        @{"Kommende Ereignisse" link kein}
        @{"Wiederkehrende Ereignisse" link wein}

        @{"Funktionen des Dateneingabefensters" link fuein}

@endnode
@node gein "Eingabe-Geburtstage"
@toc

  @{b}Geburtstage@{ub}

Hier muß zuerst Dein Vorname und Dein Geburtsdatum eingegeben werden.
(Deine eigenen Daten müssen unbedingt an 1. Stelle stehen!)
Nun können weitere Geburtstage eingegeben werden.
Die Reihenfolge der Eingabe muss nicht in der Reihenfolge der Geburtstage sein.
Es können auch mehrere Personen mit dem gleichen Geburtsdatum eingegeben werden.
Alle Eingaben müssen mit der RETURN-Taste bestätigt werden.

@endnode
@node vein "Eingabe-Ereignisse"
@toc

  @{b}Vergangene Ereignisse@{ub}

Hier können vergangene Ereignisse (z.B. Verlobungstag, Hochzeitstag usw.) eingegeben werden.
Die Reihenfolge der Eingabe muss nicht in der Reihenfolge der Ereignisse sein.
Es können auch Ereignisse mit dem gleichen Datum eingegeben werden.
Alle Eingaben müssen mit der RETURN-Taste bestätigt werden.

@endnode
@node kein "Eingabe-Ereignisse"
@toc

  @{b}Kommende Ereignisse@{ub}

Hier können kommende Ereignisse (z.B. Termine, Urlaub, Ferien usw.) eingegeben werden.
Die Reihenfolge der Eingabe muss nicht in der Reihenfolge der Ereignisse sein.
Es können auch Ereignisse mit dem gleichen Datum eingegeben werden.
Die Eingaben müssen mit der RETURN-Taste bestätigt werden.

Bei diesem Fenster kann das Datum, über das Datumsfeld oder den Kalender eingegeben werden. Das Datum darf nicht kleiner als das heutige Datum sein.
Ein Klick auf "K" öffnet den Kalender. Nun kann das Datum im Kalender ausgewählt werden. Nach schließen des Kalenders, wird das Datum in die Liste aufgenommen.

Wenn bei "Einstellungen", "Abgelaufene Löschen" aktiviert ist, so werden diese Daten in dieser Liste nicht mehr angezeigt. Gelöscht, werden sie erst wenn neue kommende Ereignisse eingegeben werden.

@endnode
@node wein "Eingabe-Ereignisse"
@toc

  @{b}Wiederkehrende Ereignisse@{ub}

Hier können wiederkehrende Ereignisse (z.B. Müllabfuhr alle 14 Tage, Zahltag jeden Monat, usw.) eingegeben werden.
Die Reihenfolge der Eingabe muss nicht in der Reihenfolge der Ereignisse sein.
Es können auch Ereignisse mit dem gleichen Datum eingegeben werden.
Die Eingaben müssen mit der RETURN-Taste bestätigt werden.

Bei diesem Fenster kann das Datum, über das Datumsfeld oder den Kalender eingegeben werden. Das Datum darf nicht kleiner als das heutige Datum sein.
Ein Klick auf "K" öffnet den Kalender. Nun kann das Datum im Kalender ausgewählt werden. Nach schließen des Kalenders, wird das Datum in die Liste aufgenommen.

Es öffnet sich ein Fenster mit folgenden Funktionen:

 @{u}Ereignis:@{uu}

Hier wird das Ereignis eingegeben.
(z.B. Müllabfuhr)

 @{u}Ab Datum:@{uu}

Hier wird angegeben ab welchem Tag das Ereignis gültig ist.
Kann auch über den Kalender(K) eingegeben werden.
Das Datum darf nicht kleiner als das heutige Datum sein.

 @{u}Bis Datum:@{uu}

Hier wird angegeben bis zu welchem Tag das Ereignis gültig ist.
Kann auch über den Kalender(K) eingegeben werden.
Dieses Feld kann auch freigelassen werden.

 @{u}Intervall:@{uu}

Hier wird der Wiederholungszeitraum eingestellt.
(z.B. Jede 2. Woche)
In der Liste wird nur die Nummer angezeigt.
Beim Klick auf einen Eintrag in der Liste, zeigt dann das Cycle-Gadget den dazugehörenden Text an.
Bei neuen oder geänderten Einträgen, wird ein Minus vor der Zahl angezeigt.

 @{u}Speichern:@{uu}

Damit wird die Liste gespeichert. Der 1. Termin eines neuen Eintrags wird in die Liste der kommenden Ereignisse eingetragen.
Ist dieser Termin dann Abgelaufen, wird automatisch der nächste Termin berechnet und in die Liste der kommenden Ereignisse eingetragen.
Ebenso wird auch in der Liste der wiederkehrenden Ereignisse, bei "Ab Datum", immer der nächste Termin eingetragen und angezeigt.

@endnode
@node fuein "Eingabe-Fenster-Funktionen"
@toc

  @{b}Die Funktionen des Eingabefensters@{ub}

 @{u}Das Menü@{uu}

Über das Menü kann die Fenstergröße und die Fensterposition fixiert werden.

"Fenster-Größe fixieren" speichert nur die Größe und das Fenster wird immer in Bildschirmmitte geöffnet.

"Fenster-Größe & Position fixieren" speichert die Größe und die Position des Fensters.

"Fenster-Freigeben" löscht die gespeicherten Werte und das Fenster wird in Bildschirmmitte in minimaler Größe geöffnet.

"Fenster-Schließen" schließt das Fenster. Änderungen werden nicht gespeichert.

 @{u}Hinzufügen:@{uu}

Damit wird ein neuer Eintrag an die Liste angefügt.
Nun kann der Name und das Datum eingegeben werden. Die Eingaben müssen mit der RETURN-Taste bestätigt werden.
Das Datum ist im Format "TT.MM.JJJJ" (z.B. 04.08.1975 oder 4.8.1975) einzugeben.

 @{u}Entfernen:@{uu}

Damit kann ein Eintrag entfernt werden.
Zuerst einen Eintrag auswählen und dann auf "Entfernen" klicken.

 @{u}Eintrag Ändern:@{uu}

Um einen Eintrag zu Ändern, zuerst einen Eintrag auswählen und dann in den unteren Feldern ändern.

 @{u}Speichern:@{uu}

Speichert die Liste so, wie sie angezeigt wird und schließt das Fenster.

 @{u}Abbrechen:@{uu}

Schließt das Fenster ohne die Änderungen zu speichern.

@endnode
@node anzeige "Ausgabe"
@toc

  @{b}Daten anzeigen@{ub}

  Die Datenanzeige erfolgt über das Menü "Daten anzeigen".

        @{"Feiertage" link feier}
        @{"Geburtstage und Ereignisse" link daus}

        @{"Funktionen des Datenanzeigefensters" link fuaus}

@endnode
@node feier "Anzeige-Feiertage"
@toc

  @{b}Feiertage (Jahr)@{ub}

Damit werden alle vom Programm berechneten Feiertage, Festtage, Gedenktage und Sommerzeit-Anfang und -Ende in richtiger Reihenfolge für das aktuelle und das nächste Jahr angezeigt. Die Feiertage für das aktuelle Jahr, werden beim ersten Programmstart und bei Beginn eines neuen Jahres berechnet und gespeichert. Die Feiertage für das nächste Jahr, werden beim ersten Menüaufruf "Feiertage (nächstes Jahr)" berechnet und gespeichert.

Die Feiertagsliste habe ich sorfältig mit mehreren Kalendern überprüft. Dennoch kann ich keine Garantie für die Richtigkeit geben.

@endnode
@node daus "Anzeige-Geburtstage-Ereignisse"
@toc

  @{b}Anzeige der eingegebenen Daten@{ub}

Mit den darauf folgenden drei Menüpunkten, kann man sich alle eingegebenen Geburtstage und Ereignisse, nach Datum sortiert, anzeigen lassen.

Bei allen Fenstern wird auch der Wochentag zu jedem Datum angezeigt.
Bei Geburtstage, auch das Alter und das Sternzeichen.

Wenn bei "Einstellungen", "Abgelaufene kommende Ereignisse Löschen" aktiviert ist, so wird ein "X" vor bereits abgelaufene Ereignisse angezeigt. Diese werden erst gelöscht, sobald neue kommende Ereignisse eingegeben werden.

@endnode
@node fuaus "Anzeige-Fenster-Funktionen"
@toc

  @{b}Die Funktionen des Anzeigefensters@{ub}

 @{u}Das Menü@{uu}

Über das Menü kann die Fenstergröße und die Fensterposition fixiert werden.

"Fenster-Größe fixieren" speichert nur die Größe und das Fenster wird immer in Bildschirmmitte geöffnet.

"Fenster-Größe & Position fixieren" speichert die Größe und die Position des Fensters.

"Fenster-Freigeben" löscht die gespeicherten Werte und das Fenster wird in Bildschirmmitte in minimaler Größe geöffnet.

"Fenster-Schließen" schließt das Fenster. Änderungen werden nicht gespeichert.

@endnode
@node meld "Ereignis-Meldungen"
@toc

  @{b}Ereignis-Meldungen@{ub}

Die Ereignis-Meldungen sind in vier Bereiche eingeteilt und habe folgende Kennzeichnung:

- 1. "G" Geburtstage und vergangene Ereignisse
- 2. "E" Kommende Ereignisse
- 3. "F" Feiertage und Gedenktage
- 4. ohne Kennzeichnung sind allgemeine Meldungen

Wenn mehrere Ereignisse in einem der Bereiche 1 bis 3, im Vorrausmeldezeitraum auftreten, so erscheint rechts ein Cycle-Gadget und die Meldungen werden automatisch Durchgeblättert (Wenn Eingeschaltet). Bei Betätigen eines Cycle-Gadgets wird das automatische Durchblättern gestoppt.
Maximal können 20 Meldungen pro Bereich angezeigt werden.
Alle Meldungen, außer Feiertage, werden auch in das kommende Jahr hinein gemeldet. Feiertage werden erst ab dem 1. Januar des Folgejahres, neu berechnet und gemeldet.

@endnode
@node pmenü "Das Projekt-Menü"
@toc

  @{b}Das Projekt-Menü@{ub}

 @{u}Vorletzter Systemstart@{uu}

Hier wird das Datum und die Zeit des vorletzten Systemstartes angezeigt.
Damit kann kontrolliert werden, ob jemand den Rechner in Deiner Abwesenheit benutzt hat.

 @{u}Fensterposition fixieren@{uu}

Damit kann die Position des Hauptfensters fixiert werden (Nicht die Größe!).
Ein Fixieren der Größe ist nicht möglich, da sich das Fenster automatisch den Meldungen anpasst.

 @{u}Fensterposition freigeben@{uu}

Damit wird die Position des Hauptfensters wieder freigegeben und das Fenster öffnet in Bildschirmmitte.

 @{"Einstellungen" link einstell}

@endnode
@node einstell "Einstellungen"
@toc

  @{b}Einstellungen@{ub}

Dieses Fenster besitzt eine Sprechblasenhilfe.

 @{u}Hintergrund@{uu}

Hier können Hintergrundmuster für die einzelnen Fenster festgelegt werden.
Bei Aktivierung von Standard wird das bei Reaction-Prefs eingestellte Hintergrundmuster verwendet.
Bei einfarbigem Hintergrund werden die Fenster etwas schneller geöffnet, als bei vielfarbigen Hintergrundmustern.

 @{u}Zeichensatz@{uu}

Hier können Zeichensätze für die Anzeige gewählt werden.
Wer nur eine geringe Bildschirmauflösung benutzt, sollte hier nur kleine und schmale Fonts wählen.
Die Einstellung der Schriftstile (Fett und Kursiv) funktioniert nur bei Outline-Fonts (GCTimes/GCTriumvirate/LetterGothic).

 @{u}Tonmeldung@{uu}

Hier kann zu verschiedenen Ereignissen eine Sound-Datei gewählt werden.
Nur kurze Geräusche wählen! Lange Geräusche werden nach einer Sekunde abgebrochen.

 @{u}Programmstart@{uu}

Hier kann beim Auftreten eines Ereignisses ein Programm gestartet werden.
Es können nur Programme gewählt werden, die sich auch von der Shell aus Starten lassen.
Mit Test kann der Start getestet werden.
Der Start erfolgt dann so, wie bei "Vorrausmeldungen" eingestellt und nur beim Beenden von Bekuna.

 @{u}Verschiedenes@{uu}

Bei "Vorausmeldungen" kann eingestellt werden, wie weit im Vorraus Ereignisse gemeldet werden. Wird "Nicht im Vorraus" eingestellt, so wird das Ereignis nur am betreffenden Tag gemeldet.
Alle Einstellungen für "Kommende Ereignisse", gelten auch für "Wiederkehrende Ereignisse". 
Wird "Programmstart nur am eingestellten Tag" aktiviert, so werden Programme nur am eingestellten Tag gestartet. Ansonsten jeden Tag, ab dem eingestellten Tag.

Beispiel:

1 Tag vor einem Geburtstag soll eine EMail geschrieben werden (mit YAM).

Dazu bei "Programmstart" das Häkchen bei "Anderer Geburtstag" setzen.
Jetzt "YAM" auswählen. Beim Klick auf "Test" wird nun "YAM" gestartet.
"YAM" schließen und bei "Verschiedenes", "Programmstart im Vorraus", "Anderer Geburtstag" wählen und "1 Tag" einstellen.
Wird das Häkchen bei "Programmstart nur am eingestellten Tag" gesetzt, so wird "YAM" 1 Tag vor einem Geburtstag beim Schließen von Bekuna gestartet.
Wird das Häkchen nicht gesetzt, so wird "YAM" auch am Geburtstag gestartet.

@{u}Sonstiges@{uu}

Wird "Abgelaufene, kommende Ereignisse löschen" aktiviert, so werden automatisch alle Einträge aus der Liste der kommenden Ereignisse entfernt bzw. markiert, die bereits abgelaufen sind. Bei der Eingabe von neuen, kommenden Ereignissen, werden diese dann gelöscht.

Wird "Automatisch blättern" aktiviert, so werden, beim gleichzeitigem Auftreten von Meldungen, automatisch alle Meldungen durchgeblättert.

Wird "Tonmeldungen blättern" aktiviert, so wird beim Blättern zu jeder Meldung die dazugehörige Tonmeldung abgespielt.

Bei "Mondgrafik benutzen", wird statt der Balkenanzeige für die Mondphase, eine Mondgrafik angezeigt.

@{u}Speichern@{uu}

Speichert alle Einstellungen.
Einstellungen, die das Hauptfenster betreffen, werden erst nach einem neuen Programmstart wirksam. 

@{u}Benutzen@{uu}

Übernimmt alle Einstellungen.
Einstellungen, die das Hauptfenster betreffen, müssen Gespeichert werden und sind erst nach einem neuen Programmstart wirksam. 

@{u}Abbrechen@{uu}

Schließt das Fenster ohne die geänderten Einstellungen zu Übernehmen.

@endnode
@node schnell "Knöpfe"
@toc

  @{b}Schnellwahl-Knöpfe@{ub}

Die Funktionen der Schnellwahl-Knöpfe:

"K" öffnet den Kalender (nur zur Information).
"F" zeigt die Feiertage für das aktuelle Jahr.
"A" Anzeige von kommenden Ereignissen.
"E" Eingabe von kommenden Ereignissen.

@endnode
@node allgemein "Zum Programm"
@toc

  @{b}Zum Programm@{ub}

Sollte das Programmhauptfenster längere Zeit oder über Mitternacht geöffnet bleiben, so ist zu Beachten, dass nur die Uhrzeit aktualisiert wird. Alles andere wird erst nach einem erneuten Programmstart aktualisiert.

"Begrüßung" ist das Startprogramm für Bekuna.rexx.
Es kann beliebig oft kopiert werden und somit kann Bekuna, von mehreren Stellen aus gestartet werden.

Die beigefügte Mondgrafik benutzt 256 Farben. Auf Bildschirmen <64 Farben sieht sie nicht mehr schön aus.

Wer eigene Mondgrafiken benutzen möchte, sollte folgendes Beachten:

Die Mondgrafik muß aus 2 Streifen bestehen.
Zuerst einen Streifen erstellen von Schwarz bis Vollmond. Alle Einzelbilder müssen ohne Zwischenraum direkt aneinandergereiht werden.
Wenn ein Einzelbild 40x40 groß ist und der Streifen aus 17 Bildern besteht, so muss er eine Gesamtgröße von 680x40 haben.
Der Streifen wird gespeichert als "MondanimZ".
Nun den Streifen als Pinsel und ohne Transparenz in ein Zeichenprogramm laden, um 180 Grad drehen und als "MondanimA" speichern.

Am Programm-Anfang werden nun die Daten der eigenen Mondgrafik angegeben:

brate=17    /*Anzahl der Mondbilder (Bilder pro Streifen)*/
mogrb=40   /*Breite der einzelnen Mondbilder (in Bildpunkten)*/
mogrh=40   /*Höhe der einzelnen Mondbilder (in Bildpunkten)*/

------------------------------------------------

Ich wünsche Euch viel Spaß mit diesem Programm und bin dankbar für Kritik, Fehlermeldungen, Verbesserungsvorschläge und Hinweise zum Programmieren.

Wer von Euch weis, wo ich eine Tags-Liste für Gadget-Interconnection herbekomme?

@endnode
@node dank "Dank"
@toc

  @{b}Mein Dank an:@{ub}

- William Parker für AWNPIPE
- Jürgen Kohrmeyer für RexxTricks.library
- Thomas Richter für RexxMathLib.library

und alle die mir Fehlermeldungen und Vorschläge geschrieben haben.

@endnode
@node autor "Autor"
@toc

  @{b}Wer hat's gemacht?@{ub}

Kuno Naumann
63739 Aschaffenburg
Schloßgasse 14

EMAIL:
kuno-n@freenet.de

@endnode