@database WaitReturnDocs V1.0
@node MAIN "MOS's WaitReturn V1.0"

                             _ ____________ _________
                            / V   __  ____/---------
                           /    \ \/ (___
                       ___/ /\/\ \  /__  )
                        __\/____\/\/____/





              @{" Was und wozu ist dieses Programm" Link WhatFor }
              @{"      Wie installiert man WR     " Link install }
              @{"         Copyrights u.ä.         " Link Cpr }
              @{"             History             " Link History }
@endnode
@node WhatFor "Erklärungen zum WaitReturn V1.0"

Ich hatte einmal in einer Box mit PCBoard so einen schönen, animierten
Returnprompt gesehen, und genau DEN wollte ich nachmachen.

Da Ambos es leider nicht erlaubt, irgendwelche Systemfunktionen durch
eigene Programme zu ersetzen, gibt es jetzt leider nur in Batches die
Möglichkeit, einen anderen als den Standard-Systemprompt (<RETURN>)
einzusetzen.

Aber was soll's, ist immerhin schon ein Anfang.

@endnode
@node install "Wie man WR installiert..."
Ganz einfach:
Man kopiert einfach WR irgendwohin, wo man es als Sysop wiederfindet, und
dann...
                  AmBoS-Setup -> Befehle -> Neuer Befehl.
Eintragen: Name:WaitReturn (oder so), Shortcut:4 (oder so) Externer Befehl:
WaitReturn.
Und natürlich das Speichern bitte nicht vergessen!!!

Danach geht man nun hin, und bearbeitet alle Batches so um, daß statt dem
bisherigen WaitReturn nun "execute WaitReturn" steht, und schon hat man
einen zufälligen animierten Returnprompt.

Die Returnprompts können editiert werden.
Eine Zeile in einmen Returnpromptfile wird terminiert mit einem Return.
ALLES bis zu diesem Return wird dem User als eine Zeile ausgegeben. Es wird
KEIN Check gemacht, ob der ausgegebene String länger als eine Zeile ist!
Das bedeutet ausch, daß eine nicht terminierte Zeile am Ende eines Files
einen Absturz provozieren kann, denn Waitreturn sucht im Speicher so lange,
bis er ein Return gefunden (was u.U. SEHR lange sein kann... und welches
Programm kann schon 2 MB mit einer einzigen bbs_out-Anweisung ausgeben...?)


Ansonsten: Die Files müssen von Return0.ans an durchnummeriert werden, da
WaitReturn die Files durchzählt. Sobald eine Lücke da ist (z.B.
Return9.ans, Return11.ans), werden nur die Files bis zur Lücke anerkannt.

@endnode
@node cpr "Über Copyrights u.s.w..."
Jau, Copyrights ist da so ein Thema.

Das Copyright für jegliche Version von WaitReturn liegt beim Autor (mir!).

Ich würde zwar zu gerne Geld für dieses Programm verlangen (Geld kann ich
immer gebrauchen :)) ), aber dafür ist es einfach zu simpel und zu schnell
programmiert worden.

Also ist es jetzt Gift-, Share- und Logoffware geworden.

Watten datten nu wieder? Logoffware???
Okay, Giftware sollte jeder kennen (wenn das Programm gefällt, möge man
bitte ein kleines Geschenk an mich senden.), aber Logoffware?
Okay, das bedeutet, daß jeder im Regionaltarif meiner Box, der dieses
Programm gerne benutzt, angehalten ist, im Logoffscreen Werbung für meine
Box zu machen.

In etwa so:
Also call Fool's Paradise - 02241/57705  2400-28800bps V.FC 24h Online

Oder ähnlich, hauptsache meine Nummer und die Onlinezeiten sind da :))

Davon abgesehen darf WR sooft kopiert werden, wie man will, solange dieses
Guidefile noch beim Programm dabei ist...

P.S.: Ihr dürft mir trotzdem GERNE ein paar nette Geschenke schicken, wenn
      das Programm gefällt. Z.B. Festplatten, RAM-Chips, Modems,
      ISDN-Karten, Schokolade, ein Kasten Bier....

                               Florian Heer
                               Aggerstr. 77
                              53721 Siegburg

P.P.S.: Bugreports bitte an MOS@bigben.dssd.sub.org!!
@endnode

@node History "History of WaitReturn..."

08.09.95 - Erste Version überhaupt, gab nur eine einzige Animation aus.
15.09.95 - V0.8 Absturzfrei und Spaß dabei :)

...........Lange Pause, in der ich wegen Geldmangels keine Zeit zum
Programmieren hatte....

07.12.95 - V 1.0 Nach Problemen mit Zufallszahlen, durch meinen Lattice-C
                 Compiler verursachte Abstürze des Programs und später
                 Erkenntnis, daß Dice kürzeren, schnelleren und
                 zuverlässigeren Code erzeugt, kommt nun die vollständig
                 funktionierende Version von WaitReturn.

@endnode
