Kurzbeschreibung zum  Programm RUF.EXE
--------------------------------------
1.Anforderungen
2.Zweck
3.Configuration
4.Aufruf des Programms
5.Die Logdatei
6.Bugs, Problemen
7.Geplante Erweiterungen
8.Schlusswort 
9.Kleingedrucktes
10.Danksagungen
---------------------------------------


1.ANFORDERUNGEN

Das Programm "RUF" mste eigentlich auf jeden Rechner laufen,
auf dem auch STOP luft.
STOP ist ein Packet-Radio Programm das von Marco Loose (DNJ888/DL8NJY)
geschrieben wird. "RUF" drfte nicht mit anderen Programmen zusammen laufen, 
da es fr STOP geschrieben wurde. 
Es knnte hchstens mit TOP oder XPacket noch funktionieren.
Sollte ich mich irren bitte ich um Benachrichtigung.


2.ZWECK

Der einfache Zweck ist mehr oder weniger die Erweiterung des //ring Befehls.
Meist hat man keinen berblick wer, wann einen gerufen hat und warum. Dieses
Problem lst sich damit, denn jeder Aufruf wird in einer Log-Datei fest-
gehalten so das sich jederzeit feststellen lt wer wann und warum einen
gerufen hat. Auerdem wird whrend des Rufes das Call von dem Rufer ange-
zeigt. Es sieht einfach besser aus.
Auerdem kann dieser noch eine kleine Kurznachricht hinterlassen

3.CONFIGURATION

Die Configuration ist im Prinzip ganz einfach.
Im STOP-RUN Verzeichnis wo sich "ruf.exe" befindet mu auch eine Config-
Datei vorhanden sein, namens "ruf.cfg". Ist dies nicht der Fall wird eine
Fehlermeldung angezeigt und das Programm bricht ab.
In dieser Datei, steht in der 1.Zeile der komplette Pfad und Dateiname des
Logfiles. Ich empfehle bei STOP es auf die Datei "info.tmp" im Hautpverzeichnis
zu setzen, da man so vom Programm aus mit ESC INFO jederzeit diese Datei
abfragen kann. Man mu aber beachten das diese Datei nach jedem ESC INFO ge-
lscht wird. Natrlich ist auch jeder andere Name mglich. Existiert diese
Datei nicht, so wird sie erstellt.
Auerem mu RUF in der Remotes.top eingtragen sein. Nheres dazu findet man 
in der Online Dokumentation von STOP
In der 2. Zeile steht ein Tempo-Faktor fr die Melodie die gespielt wird und
gleichzeitig fr das "scrollende Fenster beim Ruf.
Bei ihm ist probieren angesagt (gut macht sich 50 fr einen Pentium 100 Mhz).
Je hher er ist umso langsamer luft das ganze.

In der 3. Zeile wird der Name der Melodie eingetragen die bei einem Ruf ge-
spielt werden soll. Folgende Mglichkeiten stehen zur Verfgung:
spider = Eeensy Spider
in_and_out = In And Out
mulberry = Mulberry Bush
littlel = Little Lamp
twinkle = Twinle Star
pop = Pop Goes Weasel
farmer = Farmer In Dell
old_man = This Old Man
star_wars = Star Wars
mathe = Eine Komposition von DQB489 , Tnx 
wah = Ich glaube da wird jeder munter!
wirr = Ein Wirrwarr von Tnen
Etwas besonderes ist der Eintrag random. Hier wird zufllig eine der 11 Melodien
ausgewhlt (jedesmal eine andere).

In der 4. Zeile wird die Farbe des Fensters festgelegt. Die Werte bitte der
Tabelle entnehmen.

In der 5. Zeile wird die Hintergrundfarbe festgelegt. Die Werte bitte
wieder der jetzt folgenden Tabelle entnehmen.

In der 6. Zeile wird die Textfarbe festgelegt

 dunkle Farben 
(Vordergrund &   helle Farben
 Hintergrund)   (nur Vordergrund)

 Black      0  DarkGray       8
 Blue       1  LightBlue      9
 Green      2  LightGreen    10
 Cyan       3  LightCyan     11
 Red        4  LightRed      12
 Magenta    5  LightMagenta  13
 Brown      6  Yellow        14
 LightGray  7  White         15

Man kann auch andere Farben probieren.


7.-9. Zeile ->
Hier knnen untereinander bis zu 3 ESC Befehle angegeben werden die nach dem
Beenden von RUF ausgefhrt werden sollen. Es sollten Befehle sein, 
die ohne Tastenbettigung beendet werden (z.B. ! NICHT ! => MH o. DOS)


! ACHTUNG !
Es ist sehr wichtig das die genaue Reihenfolge der Eintrge in der Datei 
eingehalten werden, und wirklich auch nur das drin steht! Kommentare usw.
gehren da nicht rein sonst kann das Programm nicht fehlerfrei arbeiten.



4.AUFRUF DES PROGRAMMS

Wenn whrend eines Connects //ruf eingeben wird, wird man mit den
eingestellten Daten gerufen. Wenn hinter //ruf als Parameter noch ein Text der 
max. 255 Zeichen lang sein darf eingegeben wird so erscheint dieser mit in der
Log-Datei. Folgende Parameter bewirken etwas anderes:
hilfe = Zeigt eine Kurzhilfe
ver = Zeigt die Versionsnummer


5.

Bei jedem Aufruf werden in die Logdatei folgende Infos geschrieben:
Ein Beispielauszug aus einer Datei:
--
Mo 30.07.1998 14:35 DQB589 Stephan KANAL_53 DQB123
^Datum        ^Zeit ^Wer?  ^Name?  ^QRG     ^Eigenes Call
Nachricht:  <- selbsterklrend
#
--

6.BUGS, BEI Problemen

6.1. BUGS

Sind mir z.Zt. keine bekannt, auer vielleicht, das BLINK nicht so richtig 
klappt.
Sollte jemand welche finden -> her damit.

6.2 BEI FEHLERN

A. Programm bricht mit der Meldung "ruf.cfg nicht gefunden" ab
-> Die Datei ruf.cfg befindet sich nicht im gleichen Verzeichnis wie ruf.exe 
   oder ist berhaupt nicht vorhanden.
B. Es kommt keine Musik
-> Eintrge in der ruf.cfg nochmals genau berprfen
-> Ist berhaupt ein PC-Speakr vorhanden? (kann ja sein ;-)  )
C. Bei jeglichen anderen Fehlern
-> Bitte erstmal genau die Config-Datei durchgehen und die Doku genau lesen.
   Wenn das immer noch nicht hilft -> Mich benachrichtigen.


7.GEPLANTE ERWEITERUNGEN

- Blinken soll richtig klappen
- Noch mehr Melodien (wenn jemand welche im Pascal Source da hat -> ab zu mir)
- gleichzeitiges Scrollen und Musikspielen 
- ausmerzen aller Fehler


8. SCHLUSSWORT

Dies ist mein erster wirklicher Versuch etwas sinnvolles zu programmieren und
ich denke doch es hat geklappt.
Es existiert eine 2. angespeckte Version von RUF die mit jedem PR-Programm
zusammen laufen sollte. Wer interesse hat meldet sich bei mir.


9. Kleingedrucktes

        Haftung und Copyrightbestimmungen:

        Das Copyright liegt ausschlielich beim Autor.

        *******************************************
        Stephan Kuehn DG7STK/DQB589
        Landsberger Str.39   04157 Leipzig
        E-Mail : stephan.kuehn@gmx.net
        *******************************************

        Die Benutzung der Software ist fr nichtkommerzielle Zwecke
        kostenlos. Das Programm darf fr solche Zwecke ohne besondere
        Erlaubnis benutzt, kopiert und an Dritte weiterge geben werden.
        Achten Sie darauf, da Sie fr die Weitergabe nur die entstandenen
        Selbstkosten verlangen.Es mu bei einer Weitergabe darauf geachtet
        werden, da immer das komplette Programmpacket bestehen bleibt

        Gewerbliche Nutzung sowie die Weitergabe der Software als Beigabe
        zur PR Modem-Hardware, oder der kommerzielle Vertrieb von Share-
        ware-Handlers bedarf der schriftlichen Erlaubnis des Autors.

        Das Programm ist sorgfaltig geprft worden, trotzdem ist es nicht
        auszuschlieen, da noch einige "Bugs" entdeckt werden knnen.
        Es werden keinerlei Funktionen oder Funktionalitten garantiert.

        Ich bernehme keinerlei Haftung fr direkte, indirekte, als Folge
        eintretende Schden, die durch die Benutzung dieses Programms
        entstehen. Sie benutzen das Programm auf eigene Gefahr.





Erreichbarkeit des "Programmierers":(Fragen, Hinweise, Kritik, Vorschlge etc.)
--------------------------------
Drahtlos: CB-PR  -> DQB589@DBO590.#L.SAX.DEU.EU
          AFU-PR -> DG7STK@DB0LPZ.#SAX.DEU.EU
E-Mail:             stephan.kuehn@gmx.net

Homepage: Es sollte bald eine Homepage dafr existieren aber alles mit der Ruhe
            
          
10.DANKSAGUNGEN

Betatester waren:
DQB590/DG1LMK - Matthias (Doku-Leser und Chef-Tester)
LPZ7EB        - Enrico   (Doku-Leser)
DQB489        - Mathias  (Vize-Chef-Tester;danke fr die Melodie 
                          "Mathes Gedudle)

